CHPOINT.m

%--------------------------------------------------------------------------
% CHPOINT
%--------------------------------------------------------------------------
% Creation of a CHPOINT object.

%--------------------------------------------------------------------------
% Syntax
%--------------------------------------------------------------------------
% Creation of the CHPOINT from geometrical label, local number of the dof
% and the corresponding values
CHP1 = CHPOINT('LABEL',label1,loc1,val1,...
                              locn,valn);

% Creation of the CHPOINT its properties
CHP1 = CHPOINT('NODE',support1,loc_dof1,dof_val1);

% Creation of the null CHPOINT
CHP1 = CHPOINT('NULL');

% Creation of the spatially distributed CHPOINT
CHP1 = CHPOINT('DISTRI',label1,loc_dof2,distr1);

%--------------------------------------------------------------------------
% Description
%--------------------------------------------------------------------------
% CHPOINT creates a CHPOINT object. This type of object is used to
% describe a field defined at the nodes. The field is
% supported by a geometry. A CHPOINT object has the following
% properties: 
%      - support :  vector of NODE objects - [no1 ... non], 
%                   where nok stands for the NODE object supporting the
%                   CHPOINT
%      - loc_dof :  scalar, vector - [loc1 ... locn], where lock
%                   stands for the local number of the dof (type of the
%                   dof)
%      - dof_val :  scalar, vector - nodal values of the CHPOINT object
% 
% The length of the array support, loc_dof and dof_val must be the same.

%--------------------------------------------------------------------------
% Input arguments
%--------------------------------------------------------------------------
% label1     : STRING object describing the name of the physical group of
%              finite elements which support the CHPOINT
% loc1, locn : local number of the dofs
% val1, valn : values of the dofs
% support1   : vector of NODE objects - [no1 ... non], 
%              where nok stands for the NODE object supporting the CHPOINT
% loc_dof1   : scalar, vector - [loc1 ... locn], where lock
%              stands for the local number of the dof (type of the dof)
% dof_val1   : scalar, vector - nodal values of the CHPOINT object
% loc_dof2   : scalar, vector - [loc1 loc2 loc3], where lock
%              stands for the local number of the dof (type of the dof)
% distr1     : function handle - function y = f(x) discribing the spatial
%              variation of the CHPOINT

%--------------------------------------------------------------------------
% Output arguments
%--------------------------------------------------------------------------
% CHP1       : CHPOINT object

%--------------------------------------------------------------------------
% Example
%--------------------------------------------------------------------------
% Null CHPOINT
CHP1 = CHPOINT('NULL')

CHP1 = 

  CHPOINT with properties:

    support: [1x435 NODE]
    loc_dof: [435x1 double]
    dof_val: [435x1 double]

% CHPOINT supported by the physical group SB whose the values are -5 and 10
% for the dofs of type 1 and 2 respectively
CHP2 = CHPOINT('LABEL','SB',1,-5,2,10)

CHP2 = 

  CHPOINT with properties:

    support: [1x286 NODE]
    loc_dof: [286x1 double]
    dof_val: [286x1 double]