Download extr.notice

Back to the list

Display this manual page in
$$$$ EXTR     NOTICE  JC220346  12/12/13    21:15:12     7610           
                                             DATE     12/12/13


    EXTRAIRE operator                       See also : EXCO  ENLE
    -----------------


                OBJET1 = EXTRAIRE OBJET2 OBJET3 ;


    Description :
    ____________

    The EXTRAIRE operator is used to extract the OBJET3 type
  component from the OBJET2 object.


    Possible operations :
    _____________________

------------------------------------------------------------------
|    OBJET2     |   OBJET3                      |    OBJET1      |
------------------------------------------------------------------
|   MOT         |                               |    TABLE       |
|   MOT         |  ENTI1 (ENTI2)  OU  LISTENTI  |    MOT         |
------------------------------------------------------------------
|   LISTREEL    |  ENTIER                       |    FLOTTANT    |
|   LISTREEL    |  LISTENTI                     |    LISTREEL    |
|   LISTENTI    |  ENTIER                       |    ENTIER      |
|   LISTENTI    |  LISTENTI                     |    LISTENTI    |
------------------------------------------------------------------
|   LISTMOTS    |  ENTIER                       |    MOT         |
|   LISTMOTS    |  LISTENTI                     |    LISTMOTS    |
------------------------------------------------------------------
|   LISTCHPO    |  ENTIER                       |    CHPOINT     |
|   LISTCHPO    |  LISTENTI                     |    LISTCHPO    |
------------------------------------------------------------------
|   MCHAML      |  MOT ENTIER ENTIER ENTIER     |    FLOTTANT    |
|   MCHAML      |  MOT ENTIER ENTIER ENTIER     |    OBJET       |
|   MCHAML      |  'TITR' OU 'TYPE'             |    LISTMOTS    |
|   MCHAML      |  'MAIL'                       |    MAILLAGE    |
|   MCHAML      |  'COMP' ( MODL1 )             |    LISTMOTS    |
|   MCHAML      |  'CONS' ( MODL1 )             |    LISTMOTS    |
|   MCHAML      |  'DEVA'                       |    LISTMOTS    |
|   MCHAML      |  'COVA'                       |    LISTMOTS    |
------------------------------------------------------------------
|   MMODEL      |  'MAIL'                       |    MAILLAGE    |
|   MMODEL      |  'ZONE'                       |    TABLE       |
|   MMODEL      |   MOT1   MOT2                 |    MMODEL      |
|   MMODEL      |   MOT1                        |    LISTMOTS    |
|   MMODEL      |  'PARA'                       |    LISTMOTS    |
------------------------------------------------------------------
|   EVOLUTION   |  MOT ou 'ORDO' 'ABSC' N       |    LISTREEL    |
|   EVOLUTION   |  'COUR' N ou MOT1             |    EVOLUTION   |
|   EVOLUTION   |  'PAS'  ENTI1                 |    EVOLUTION   |
|   EVOLUTION   |  MOT1  'ENTI' ENTI1 ('ZERO')  |    EVOLUTION   |
|   EVOLUTION   |  MOT1   FLOT2       ('ZERO')  |    EVOLUTION   |
------------------------------------------------------------------
|   SUPERELE    |  MOT                          |    RIGIDITE    |
------------------------------------------------------------------
|   RIGIDITE    |  MOT1   ( MOT2 )  (MOT3)      |    MAILLAGE    |
|   RIGIDITE    |  MOT1   ( MOT2 )              |    RIGIDITE    |
|   RIGIDITE    |  'CONT'                       |    TABLE       |
|   RIGIDITE    |  'COMP' ('DUAL')              |    LISTMOTS    |
|   RIGIDITE    |  'DIAG'                       |    CHPOINT     |
|   RIGIDITE    |   | LISTMOT1 LISTMOT2 |       |    RIGIDITE    |
|   RIGIDITE    |   |   MOT1    MOT2    |       |    RIGIDITE    |
------------------------------------------------------------------
|   MATRIK      |  'COMP' ('DUAL')              |    LISTMOTS    |
|   MATRIK      |  'DIAG'                       |    CHPOINT     |
|   MATRIK      |   | LISTMOT1 LISTMOT2 |       |    MATRIK      |
|   MATRIK      |   |   MOT1    MOT2    |       |    MATRIK      |
------------------------------------------------------------------
|   CHPOINT     |  'MAIL' ('NOMU')              |    MAILLAGE    |
|   CHPOINT     |   MOT1  POIN1                 |    FLOTTANT    |
|   CHPOINT     |  'VALE' (MOT1|LMOT1) (MAIL1)  |    LISTREEL    |
|   CHPOINT     |  'TITR'                       |    MOT         |
|   CHPOINT     |  'COMP'                       |    LISTMOTS    |
|   CHPOINT     |  'TYPE'                       |    MOT         |
|   CHPOINT     |  'NATU'                       |    MOT         |
------------------------------------------------------------------
|   BASEMODA    |  MOT                          |    SOLUTION    |
|   BASEMODA    |  MOT                          |    RIGIDITE    |
------------------------------------------------------------------
|   DEFORME     |  MOT                          |    FLOTTANT    |
------------------------------------------------------------------
|   CHARGEME    |  'CHAR' (ENTIER)              |    CHARGEME    |
|   CHARGEME    |  'CHAM' (ENTIER)              | CHPOINT,MCHAML |
|   CHARGEME    |  'TRAJ' (ENTIER)              |    CHPOINT     |
|   CHARGEME    |  'EVOL' (ENTIER)              |    EVOLUTIO    |
|   CHARGEME    |  'VITE' (ENTIER)              |    EVOLUTIO    |
|   CHARGEME    |  'COMP'                       |    LISTMOTS    |
|   CHARGEME    |  'LIE '                       |    CHARGEME    |
|   CHARGEME    |  'LIBR'                       |    CHARGEME    |
|   CHARGEME    |   MOT                         |    CHARGEME    |
|   CHARGEME    |   LISTMOTS                    |    CHARGEME    |
|   CHARGEME    |   MOT  'TABL'                 |    TABLES      |
------------------------------------------------------------------
|   NUAGE       |  'COMP'                       |    LISTMOTS    |
|   NUAGE       |  'MAXI' MOT                   |    NUAGE1      |
|   NUAGE       |  'MINI' MOT                   |    NUAGE1      |
|   NUAGE       |  'INFE' MOT FLOTTANT          |    NUAGE1      |
|   NUAGE       |  'SUPE' MOT FLOTTANT          |    NUAGE1      |
|   NUAGE       |  'ENTR' MOT FLOT1 FLOT2       |    NUAGE       |
|   NUAGE1      |   MOT                         |    OBJET TYPE  |
|   NUAGE1 = NUAGE ne comportant qu'un seul n-uplet              |
------------------------------------------------------------------


    Preliminary note :
    __________________

    If the operator is applied to a single object (ex: LISTREEL), it
    will therefore create a new object (in this ex.: a FLOTTANT object).
    If, on the contrary, it is applied to a series of objects
    (ex: LISTCHPO or TABLE), it will only assign a name to an already
    existing object (ex: a CHPOINT object for a LISTCHPO one).



 >> CASE OF 'MOT' TYPE OBJECTS
    __________________________

    1) The request is to give back a TABLE object which contains all the
       named objects of the read type. The table is indexed by integers
       1, 2, 3, etc...


    2) Substring extraction :

        - either from the ENTI1-th character included to the last one
        - either from ENTI1-th to ENTI2-th characters (included)
        - either the characters indicated in a LISTENTI object

       In any case, ENTI1 equals to 1 for the first character. The
       string length is given by the DIME operator.



 >> CASE OF 'MCHAML' TYPE OBJECTS
    _____________________________

    1) Extraction of a component value in a given place :

       In this case, several elements are required : one word
       specifying the component, a first integer specifying the
       number of the subspace, a second specifying the number of
       the element, and a third specifying the number of Gauss points.
       The component may be a real number or an integer, in which case
       a pointed object may be extracted.


    2) Extraction of the title ( or of the type ) of a MCHAML object


    3) Extraction of the MAILLAGE support


    4) Extraction of the component names of a MCHAML object :

       A MMODEL (MODL1) object may therefore be assigned to a subspace.
       If the MMODEL is composed of several regions, all the names of
       component of the different subpackets will come one after the
       other in the same LISTMOTS object even if the model is missing.


    5) Extraction of the constituent names of a MCHAML object :

       A MMODEL (MODL1) object may therefore be assigned to a subspace.
       If the MMODEL is composed of several regions, all the names of
       component of the different subpackets will come one after the
       other in the same LISTMOTS object even if the model is missing.
       As the LISTMOTS object is composed of 4 letters words,
       the word '    ' matches a constituent which is a number or
       unspecified.


    6) Extraction of the variable names of a MCHAML object :
       The MCHAML object have components which types can be
       FLOTTANT,EVOLUTIO, NUAGE or LISTMOTS. (keyword DEVA)


    7) Extraction of the variable names witch are not constant.
       (keyword COVA)



 >> CASE OF 'EVOLUTION' TYPE OBJECTS
    ________________________________

    1) Extraction of a list of real numbers :

      a/ The title of LISTREEL is a 12-letter word at the most.
         The first progression encountered with this title will
         be provided. (For instance, the titles may be read out on
         the evolution drawing)

      b/ The abscissa (or the ordinate) and the N number of the curve
         will be specified in the EVOLUTION object (by default 1)

        examples: EVOL1  = EVOL MANU 'TEMPS (S) ' LDT FORCE LFX ;
                  LISTDT = EXTR EVOL1 'TEMPS (S)'  ;
                  LISTDT = EXTR EVOL1 'ABSC'       ;
                  LISTFX = EXTR EVOL1 'ORDO' 1     ;
                  LISTFX = EXTR EVOL1 'FORCE'      ;


    2) Extraction of curves from the EVOLUTION object

      a/ Extraction of the Nith curve :
         example : EVOL3   = EXTR EVOL2 'COUR' 3 ;

      b/ Extraction of all the curves that their list of abscissa
         or ordinate has a given name
         example : EVOL3   = EXTR EVOL2 'COUR' 'FX' ;


    3) Extraction of some couples from the EVOLUTION object
       according to OBJET3 defined as follows :

         |  'PAS '  ENTI1                    |
         |  'AVAN'  FLOT2          ('ZERO')  |
         |          'ENTI'  ENTI2            |
         |  'APRE'  FLOT2                    |
         |          'ENTI'  ENTI2  ('ZERO')  |

       ENTI1 : ENTIER defining the step of the extracted couples

       FLOT2 : value of the abscissa (FLOTTANT) from which (option
               'APRE') or up to which (option 'AVAN') the couples
               are extracted. With the option 'APRE', the key word
               'ZERO' enables to redefine the origin of the abscissas
               at 0.

       ENTI2 : index (ENTIER) of the couple from which (option
               'APRE') or up to which (option 'AVAN') the couples
               are extracted. With the option 'APRE', the key word
               'ZERO' enables to redefine the origin of the abscissas
               at 0.


    4) Extraction of the legend  for the Nith curve
       exemples: EVOL1  = EVOL MANU 'TEMPS (S) ' LDT 'Debit' LFX ;
                 LEGT   = EXTR EVOL1 'LEGX' 1     ;
                 LEGD   = EXTR EVOL1 'LEGY' 1     ;
        => LEGT contains the string 'TEMPS (S) '
           LEGD contains the string 'Debit'



 >> CASE OF 'SUPERELE' TYPE OBJECTS
    _______________________________

    In this case, MOT indicates what must be extracted, i.e 'RIGT'
    for the global stiffness, 'RIGI' for the stiffness, 'MASS' for the
    mass and 'BLOQ' for the restraints.

     example: SUP  = SUPER  RI  GEO ;
              RIEQU = EXTRAI  SUP 'RIGI' ;
              RITOT = EXTRAI  SUP 'RIGT' ;



 >> CASE OF 'RIGIDITE' TYPE OBJECTS
    _______________________________

    1) If MOT1 is equivalent to the word 'MAIL', MOT2 becomes optional.
       If it is not specified, the mesh will be composed of all the
       nodes, including those associated with Lagrangian multipliers.
       If MOT2 is:

       - 'NOMU'  indicates that the mesh requested is the one composed
                 of all the nodes except those associated with
                 Lagrangian multipliers
       - 'MULT'  indicates that the mesh requested is the one composed
                 of the nodes associated with Lagrangian multipliers
                 only.
       - 'UNIL'  indicates that only unilateral constraints are
                 concerned. By default a mesh is generated that
                 contains all the nodes that supports Lagrangian
                 multipliers involved in unilateral constraints.
                 If the word (MOT3) 'TRI3' is specified a mesh of TRI3
                 elements is generated. The points of those elemnets
                 are the geometric nodes involved in 3-node unilateral
                 constraints in RIG1 (namely contact elements
                 in 2D created by IMPO )

       OBJET2 is the mesh which subtends the stiffness :


    2) If MOT1 is equivalent to the word 'RIGI', MOT2 becomes
       compulsory and equals :

       - 'NOMU' if the extraction of the stiffness without the
                restraints is requested
       - 'MULT' if the extraction of the stiffness associated
                with the restraints is requested

       In this case, OBJET2 is a RIGIDITE type object.


    3) If MOT1 equals

       - 'SYME'  it is requested that the symmetrical elementary
                 matrices be extracted from the global stiffness

       - 'ANTI'  it is requested that the antisymmetrical elementary
                 matrices be extracted from the global stiffness

       In this case, OBJET2 is a RIGIDITE type object.


    4) If MOT1 is equivalent to 'CONT' the TABLE used for unilateral
       supports is extracted from the stiffness.


    5) If MOT1 is equivalent to 'COMP', the list of names of component
       is extracted from the stiffness. If the word 'DUAL' is added, it
       is the list of dual names that will be extracted.


    6) If MOT1 is 'DIAG', the diagonal of the matrix is extracted in a
       CHPOINT type object.


    7) If two LISTMOTS (resp. two MOT) are given, the submatrix with
       primal component names LISTMOT1 (resp. MOT1) and dual component
       names LISTMOT2 (resp. MOT2) is extracted.



 >> CASE OF 'MATRIK' TYPE OBJECTS
    _____________________________

    1) If MOT1 is 'COMP', the list of names of component is extracted
       from the matrix. If the word 'DUAL' is added, it is the list of
       dual names that will be extracted.


    2) If MOT1 is 'DIAG', the diagonal of the matrix is extracted in a
       CHPOINT type object.


    3) If two LISTMOTS (resp. two MOT) are given, the submatrix with
       primal component names LISTMOT1 (resp. MOT1) and dual component
       names LISTMOT2 (resp. MOT2) is extracted.



 >> CASE OF 'CHPOINT' TYPE OBJECTS
    ______________________________

    1) Extraction of the MAILLAGE which subtends the CHPOINT.

       The points associated with Lagrange's multipliers may be excluded
       by using the 'NOMU' keyword.


    2) Extraction of a component value at one point

       MOT1 is therefore equivalent to the name of the component to be
       extracted at the POIN1 point.


    3) Extraction of the values contained in a CHPOINT.

       The values are placed in a LISTREEL object. The output order can
       be defined by providing a mesh MAIL1 of type POI1. The nodes in
       MAIL1 which are not part of the CHPOINT geometric support will
       yield a zero value in the LISTREEL. When the CHPOINT has several
       components, those to be listed can be specified by giving the
       word MOT1 or the words list LMOT1. The order is defined by :

          (Comp1,Pt1);(Comp1,Pt2);...;(Comp2,Pt1);(Comp2,Pt2);...


    4) Extraction of the title of a CHPOINT object


    5) Extraction of the component names. The result is an object of
       LISTMOTS type composed of 4-letter names of component.


    6) Extraction of the type of a CHPOINT object. The result is an
       object of MOT type composed of 8 letters.


    7) Extraction of the nature of a CHPOINT object. The result is an
       object of MOT type composed of 11 letters.



 >> CASE OF 'BASEMODA' TYPE OBJECTS
    _______________________________

    1) Extraction of a SOLUTION object

       MOT is either equivalent to 'MODE' to extract a SOLUTION
       object of MODE subtype, or to 'STAT' to extract a SOLUTION object
       of SOLUSTAT subtype, or else to 'PSMO' to extract a SOLUTION
       object of PSEUMODE subtype.


    2) Extraction of a RIGIDITE object

       MOT is either equivalent to 'RIGI' to extract a RIGIDITE
       object of RIGIDITE subtype, or to 'MASS' to extract a RIGIDITE
       object of MASSE subtype.



 >> CASE OF 'DEFORME' TYPE OBJECTS
    ______________________________

    MOT is therefore equivalent to 'AMPL'. The amplification
    coefficient for the deformed shape is extracted.



 >> CASE OF 'MMODEL' TYPE OBJECTS
    _____________________________

    1) Extraction of the MAILLAGE which subtends the MMODEL.


    2) Extraction of all the regions of the model and the meshes
       by storing them into a table indexed by integers.
       Index 1 MMODEL object of the first region, index 2 MAILLAGE
       object of the first region, index 3 MMODEL object of the
       second region...


    3) Extraction of the MMODEL regions corresponding to a given
       formulation. In this case, MOT1 becomes equivalent to 'FORM',
       and MOT2 to one or several words specifying the formulation.


    4) Extraction of the MMODEL regions corresponding to one or several
       given constituents. In this case, MOT1 becomes equivalent to
       'CONS' and MOT2 is equivalent to one or several words specifying
       the constituents. When the constituent is expressed by a number,
       MOT2 is the number between quotes (ex: '123456').


    5) Extraction of the MMODEL regions corresponding to one or several
       given finite elements. In this case, MOT1 becomes equivalent to
       'ELEM' and MOT2 is equivalent to one or several words specifying
       the finite elements.


    6) Extraction of the component names corresponding to one given
       type of variable. The result is an object of LISTMOTS type
       composed of 4-letter names of component. In this case MOT1
       must be equivalent to one of the eleven words specifying the
       variable:
         'GEOM' : Component names of geometrical characteristics
         'CONT' : Component names of stress
         'DEFO' : Component names of deformation
         'DEPL' : Component names of displacement
         'FORC' : Component names of force
         'GRAD' : Component names of gradient
         'GRAF' : Component names of flexural gradient
         'MATE' : Component names of material
         'CONP' : Component names of main stresses
         'TEMP' : Component names of temperature
         'VARI' : Component names of internal variable


    7) Extraction of the names of the external parameters of the MMODEL.
       The extraction is made all over the subspaces of the MMODEL, by
       eliminating redundant parameters. The result is an object of
       LISTMOTS type composed of 4-letter names of parameter.
       If external parameters do not exist, the result is an empty
       object of LISTMOTS type.


    8) Extraction of the MMODEL regions for which the material behaviour is
       described by the word MOT2. In that case MOT1 must be 'COMP'.



 >> CASE OF 'CHARGEME' TYPE OBJECTS
    _______________________________

    1) 'CHAR' extracts the CHARGEME object of the number indicated in
       OBJET3 from the OBJET2 object. The first CHARGEME object is
       extracted by default.


    2) 'CHAM' extracts the CHPOINT or MCHAML object of the number
       indicated in OBJET3 from the OBJET2 object. The first CHPOINT
       or MCHAML object is extracted by default.


    3) 'TRAJ' extracts the CHPOINT object describing the displacement
       of the component of number indicated in OBJET3 from the OBJET2
       object. The CHPOINT is extracted from the first component by
       default.


    4) 'EVOL' extracts the EVOLUTIO object of the number indicated in
       OBJET3 from the OBJET2 object. The first EVOLUTIO object is
       extracted by default.


    5) 'VITE' extracts the EVOLUTIO object describing the displacement
       of the component of number indicated in OBJET3 from the OBJET2
       object. The EVOLUTIO object is extracted from the first component
        by default.


    6) 'COMP' extracts the names of the elementary CHARGEMENT objects.


    7) 'LIE ' (resp. 'LIBR') extracts from OBJET2 the CHARGEME object
       collecting all the CHARGEME of this kind.


    8) MOT extracts the elementary CHARGEMENT object called MOT.
       LISTMOTS extracts the elementary CHARGEMENT objects whose
       name is included in the LISTMOTS objet.


    9) MOT followed by 'TABL' return the two TABLES objects giving the
       list of time and the corresponding map of the scalar quantity
       whose name is MOT. (Often used with the temperature 'T   ' = MOT)



 >> CASE OF 'NUAGE' TYPE OBJECTS
    ____________________________

    1) Extraction of the component names. The result is an object of
       LISTMOTS type composed of 8-letter component names.


    2) Extraction of the n-uplet corresponding to the real value inferior
       to the given FLOTTANT ,for a specific component name.
       The result is a NUAGE object "column".


    3) Extraction of the n-uplet corresponding to the real value superior
       to the given FLOTTANT ,for a specific component name.
       The result is a NUAGE object "column".


    4) Extraction of the n-uplet corresponding to the smallest real value
       characterized by a component name.
       The result is a NUAGE object "column".


    5) Extraction of the n-uplet corresponding to the biggest real value
       characterized by a component name.
       The result is a NUAGE object "column".


    6)  Extraction of a object NUAGE characterized by two given real
        values corresponding to a specific component name. the new NUAGE
        object has all its real values (corresponding to the specific
        component name) between the two given real values.


    7) Extraction of the object corresponding to a given component name
       from a NUAGE object "column".

$$$$


 

© Cast3M 2003 - All rights reserved.
Disclaimer