StiffAssemblingP1OptV1.m

Go to the documentation of this file.

function R=StiffAssemblingP1OptV1(nq,nme,q,me,areas)
% function R=StiffAssemblingP1OptV1(nq,nme,q,me,areas)
%   Assembling Stiff Matrix by `P_1`-Lagrange finite elements
%   using "OptV1" version (see report).
%
%   The Stiff Matrix is given by 
%   ``\Stiff_{i,j}=\int_\DOMH \DOT{\GRAD\FoncBase_i(\q)}{\GRAD\FoncBase_j(\q)}d\q,\ \forall (i,j)\in\ENS{1}{\nq}^2``
%   where `\FoncBase_i` are `P_1`-Lagrange basis functions.
%
% Parameters:
%  nq: total number of nodes of the mesh, also noted `\nq`.
%  nme: number of triangles, also noted `\nme`.
%  'q': `2\times\nq` array, `{\q}(\il,j)` is the  `\il`-th coordinate of the `j`-th vertex, `\il\in\{1,2\}` and `j\in\{1,\hdots,n_q\}.`
%       Also noted `\q`.
%  me: `3\times\nme` 'int32' array,`\me(\jl,k)` index of storage, in the array `\q`, of the `\jl`-th
%       vertex of the triangle of index `k`, `\jl\in\{1,2,3\}` and `k\in\{1,\hdots,\nme\}.`
%       Also noted `\me`.
%  areas: `1\times\nme` array, areas(k) is the area of triangle k.
%
% Return values:
%  R: `\nq\times\nq` sparse matrix
%
% Example:
%  @verbatim 
%    Th=SquareMesh(10);
%    R=StiffAssemblingP1OptV1(Th.nq,Th.nme,Th.me,Th.q,Th.areas);@endverbatim
%  
% See also:
%   #SquareMesh
% @author Francois Cuvelier @date 2011-11-18
%
% @new{1,1,fc,2012-11-22} Added doxygen documentation using mtoc++ tool
%
% Copyright (c) 2012, Francois Cuvelier, Gilles Scarella
% All rights reserved.
%
% Redistribution and use in source and binary forms, with or without
% modification, are permitted only in compliance with the BSD license, see
% http://www.opensource.org/licenses/bsd-license.php
Ig=zeros(nme*9,1);Jg=zeros(nme*9,1);
Kg=zeros(nme*9,1);

ii=[1 2 3 1 2 3 1 2 3];
jj=[1 1 1 2 2 2 3 3 3];
kk=1:9;
for k=1:nme
  Me=ElemStiffMatP1(q(:,me(1,k)),q(:,me(2,k)),q(:,me(3,k)),areas(k));
  Ig(kk)=me(ii,k); 
  Jg(kk)=me(jj,k);
  Kg(kk)=Me(:);
  kk=kk+9;
end
R=sparse(Ig,Jg,Kg,nq,nq);