StiffElasAssemblingP1OptV2.m

Go to the documentation of this file.

function [R]=StiffElasAssemblingP1OptV2(nq,nme,q,me,areas,lambda,mu,Num)
% function K=StiffElasAssemblingP1OptV2(nq,nme,q,me,areas,lambda,mu,Num)
%   Assembly of the Stiffness Elasticity Matrix by `P_1`-Lagrange finite elements
%   using "OptV2" version (see report).
%
%   The Stiffness Elasticity Matrix is given by 
%   ``\StiffElas_{m,l}=\int_{\DOMH} \Odv^t(\BasisFuncTwoD_m) \Ocv(\BasisFuncTwoD_l)dT, \ \forall (m,l)\in\ENS{1}{2\,\nq}^2,``
%   where `\BasisFuncTwoD_m` are `P_1`-Lagrange vector basis functions.
%   Here `\Ocv=(\Occ_{xx},\Occ_{yy},\Occ_{xy})^t` and `\Odv=(\Odc_{xx},\Odc_{yy},2\Odc_{xy})^t`
%   are the elastic stress and strain tensors respectively. 
%
% Parameters:
%  nq: total number of nodes in the mesh, also denoted by `\nq`.
%  nme: total number of triangles, also denoted by `\nme`.
%  q: Array of vertices coordinates, `2\times\nq` array. <br/>
%  `{\q}(\il,j)` is the
%  `\il`-th coordinate of the `j`-th vertex, `\il\in\{1,2\}` and
%  `j\in\ENS{1}{\nq}`
%  me: Connectivity array, `3\times\nme` array. <br/>
%  `\me(\jl,k)` is the storage index of the
%  `\jl`-th  vertex of the `k`-th triangle in the array `\q`, `\jl\in\{1,2,3\}` and
%       `k\in{\ENS{1}{\nme}}`.
%  areas: Array of areas, `1\times\nme` array. areas(k) is the area of the `k`-th triangle.
%  lambda: the first Lame coefficient in Hooke's law
%  mu: the second Lame coefficient in Hooke's law
%  Num: 
%    - 0 global alternate numbering with local alternate numbering (classical method), 
%    - 1 global block numbering with local alternate numbering,
%    - 2 global alternate numbering with local block numbering,
%    - 3 global block numbering with local block numbering.
%
% Return values:
%  K: `2\nq\times 2\nq` stiffness elasticity sparse matrix
%
% Example:
%  @verbatim 
%    Th=SquareMesh(10);
%    lambda=1; mu=1;
%    Num = 0; 
%    KK=StiffElasAssemblingP1OptV2(Th.nq,Th.nme,Th.q,Th.me,Th.areas,lambda,mu,Num);@endverbatim
%  
% See also:
%   #BuildIgJgP1VF, #ElemStiffElasMatBaVecP1
% Copyright:
%   See \ref license
[Ig,Jg]=BuildIgJgP1VF(Num,me,nq);
switch Num
case {0,1}
  Kg=ElemStiffElasMatBaVecP1(q,me,areas,lambda,mu);
case {2,3}
  Kg=ElemStiffElasMatBbVecP1(q,me,areas,lambda,mu);
end
R = sparse(Ig(:),Jg(:),Kg(:),2*nq,2*nq);