CHAMELEM_EXTRAP.m

%--------------------------------------------------------------------------
% CHAMELEM.EXTRAP
%--------------------------------------------------------------------------
% Creation of a CHAMELEM coming from the extrapolation of two CHAMELEM

%--------------------------------------------------------------------------
% Syntax
%--------------------------------------------------------------------------
CHAM4 = CHAMELEM.EXTRAP(MO1,opt,dt0,dt1,dt2,CHAM1,CHAM2,CHAM3)

%--------------------------------------------------------------------------
% Description
%--------------------------------------------------------------------------
% CHAMELEM.EXTRAP allows to extrapolate a CHAMELEM, given this CHAMELEM at
% two different pseudo times. This static method is specifically used when
% the IMPLEX soving method is used. 

%--------------------------------------------------------------------------
% Input arguments
%--------------------------------------------------------------------------
% MO1    : MODEL object
% opt    : integer, index to be set up according to the type of
%           extrapolation to perform. opt can be equal to:
%           - 1 : linear extrapolation
%
% dt0    : scalar, pseudo time n - 2
% dt1    : scalar, pseudo time n - 1
% dt2    : scalar, pseudo time n (current pseudo time)
% CHAM1  : CHAMELEM describing the material parameters
% CHAM2  : CHAMELEM to be extrapolated at pseudo time n - 2
% CHAM3  : CHAMELEM to be extrapolated at pseudo time n - 1

%--------------------------------------------------------------------------
% Output arguments
%--------------------------------------------------------------------------
% CHAM4  : CHAMELEM object describing the extrapoolated CHAMELEM

%--------------------------------------------------------------------------
% Example
%--------------------------------------------------------------------------
SOL

SOL = 

  SOLUTION with properties:

            problem: [1x1 PROBLEM]
               mesh: [1x1 MESH]
           topology: [1x1 TOPOLOGY]
       displacement: [1x100 CHPOINT]
           velocity: []
       acceleration: []
       cham_element: [1x100 struct]
           reaction: [1x100 CHPOINT]
    internal_forces: [1x100 CHPOINT]
     eigenfrequency: []
          modeshape: []

CHAM1 = SOL.cham_element(end - 2).cham

CHAM1 = 

  CHAMELEM with properties:

       model: [1x1 MODEL]
    cham_val: [1x2 struct]

CHAM2 = SOL.cham_element(end - 1).cham

CHAM2 = 

  CHAMELEM with properties:

       model: [1x1 MODEL]
    cham_val: [1x2 struct]
    
CHAM3 = CHAMELEM.EXTRAP(MOT,1,0.5,0.6,0.6,CHAM1,CHAM2,CHAM2)

CHAM3 = 

  CHAMELEM with properties:

       model: [1x1 MODEL]
    cham_val: [1x2 struct]