GROUP.m

%--------------------------------------------------------------------------
% GROUP
%--------------------------------------------------------------------------
% Creation of a GROUP object.


%--------------------------------------------------------------------------
% Syntax
%--------------------------------------------------------------------------
GR = GROUP(name,elem_type,zone_number,node_number,elem_number,elem_connec)

%--------------------------------------------------------------------------
% Description
%--------------------------------------------------------------------------
% GROUP creates a GROUP object. This type of object can be used to
% describe a physical group of finite elements. This concept is crucial 
% when affecting different constitutive laws to the analuzed domain. 
% A GROUP object has the following properties: 
%       - name        : STRING - name of the physical group
%       - elem_type   : STRING - type of the finite element. When
%                       several types of finite elements are used in the 
%                       same group, the elem_type is set up to 'COMP' 
%       - zone_number : empty, scalar, vector - when the type of the finite
%                       element is 'COMP', the number of subdomains in
%                       which the type of finite elements is the same is
%                       stored.
%       - node_number : scalar - number of nodes of the finite elements
%                       composing the GROUP object. In case of a 'COMP' 
%                       GROUP object, this field remains empty.
%       - elem_number : scalar - number of finite elements. In case of a 
%                       'COMP' GROUP object, this field remains empty.
%       - elem_connec : matrix - connectivity matrix. In case of a 
%                       'COMP' GROUP object, this field contains the 
%                       reference to the subdomains in which the type of 
%                       finite elements is the same.

%--------------------------------------------------------------------------
% Input arguments
%--------------------------------------------------------------------------
% name        : STRING - name of the GROUP object
% elem_type   : STRING - type of the element composing the GROUP object
% zone_number : used in case of a 'COMP' type GROUP. See above.
% node_number : scalar - number of node of each finite element composing
%               the GROUP object.
% elem_number : scalar - number of finite elements
% elem_connec : matrix - connectivity matrix

%--------------------------------------------------------------------------
% Output arguments
%--------------------------------------------------------------------------
% GR     : GROUP object

%--------------------------------------------------------------------------
% Example
%--------------------------------------------------------------------------
% Elementary GROUP
GR

GR = 

  GROUP with properties:

           name: 'objet-1'
      elem_type: 'QUA4'
    zone_number: 0
    node_number: 4
    elem_number: 500
    elem_connec: [500x4 double]

% 'COMP' type GROUP
GRT

GRT 

  1x8 GROUP array with properties:

    name
    elem_type
    zone_number
    node_number
    elem_number
    elem_connec

GR1

GR1 = 

  GROUP with properties:

           name: 'ST'
      elem_type: 'COMP'
    zone_number: 2
    node_number: 0
    elem_number: 0
    elem_connec: [2 3]

GRT(2)

GRT(2) = 

  GROUP with properties:

           name: 'objet-2'
      elem_type: 'TRI3'
    zone_number: 0
    node_number: 3
    elem_number: 8
    elem_connec: [8x3 double]

GRT(3)

GRT(3) 

  GROUP with properties:

           name: 'objet-3'
      elem_type: 'QUA4'
    zone_number: 0
    node_number: 4
    elem_number: 197
    elem_connec: [197x4 double]