MaterialWrapper

Purpose

wrapper element that passes on arguments to the material state determination

Synopsis

ElemResp = MaterialWrapper (action,el_no,xyz,ElemData,ElemState)

Description

MATERIALWRAPPER wrapper element that passes on arguments to the material state determination
  ELEMRESP = MATERIALWRAPPER (ACTION,EL_NO,XYZ,ELEMDATA,ELEMSTATE)
  the function determines the response of the material MATNAME in ELEMDATA
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  the character variable ACTION should have one of the following values
  ACTION = 'size' function reports size of element arrays in variable ARSZ
           'chec' function checks element property data for omissions
                  and returns default values in ELEMDATA
           'init' function returns element history variables in ELEMSTATE
           'forc' function returns element resisting forces in ELEMSTATE
           'stif' function returns element stiffness matrix and resisting forces in ELEMSTATE
           'post' function returns data structure ELEMPOST with post-processing information
  depending on value of character variable ACTION the function returns information
  in data structure ELEMRESP for the element with number EL_NO and end node coordinates XYZ;
  the data structure ELEMDATA supplies the element property data.
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  data structure ELEMRESP stands for the following data object depending on value of ACTION 
  ELEMRESP = ARSZ       for action = 'size' 
  ELEMRESP = ELEMDATA   for action = 'chec'
  ELEMRESP = ELEMSTATE  for action = 'init'
  ELEMRESP = ELEMSTATE  for action = 'stif'
  ELEMRESP = ELEMSTATE  for action = 'forc'
  ELEMRESP = ELEMPOST   for action = 'post'
  ELEMRESP is empty     for unsupported keywords
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  ARSZ   is an Boolean array of size NDF x NEN,
         where NDF = number of DOFs/node, NEN = number of nodes,
         with unit values corresponding to the active element DOFs
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  ELEMSTATE is a data structure with the current element state; it has the fields
         u     = vector of total element displacements in global reference
         Du    = vector of element displacement increments from last convergence
         DDu   = vector of element displacement increments from last iteration
         ke    = element stiffness matrix in global reference; updated under ACTION = 'stif'
         p     = element resisting force vector in global reference; updated under ACTION = 'stif' or 'forc'
         Past  = element history variables at last converged state
         Pres  = current element history variables
         lamda = row vector of current load factor(s)
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  ELEMPOST is a data structure with element response information for post-processing in fields
         v     = eps = material strains 
         q     = sig = material stresses

Cross-Reference Information

This function calls:

• Extract_El2MatState extract material state from element state