Manual pages | Cast3M

$$$$ VIDE     NOTICE  JC220346  12/10/12    21:15:05     7528           
                                             DATE     12/10/12

    Operateur VIDE                         Voir aussi : ZERO, LECT, PROG
    --------------                                      SUIT MOTS MANU   
                                                        TABL   

    Description :
    _____________

    The VIDE operator allows to create one or more empty objects of
    given types/subtypes



    Syntax :
    ________

    There are two ways to retrieve the empty objects :


      1) As separated objects :

        OBJ1,...,OBJn = VIDE [GROUP1,...,GROUPn]


      2) As objects listed in a table :

        TAB1 = VIDE ('TABULATE' ( |LENTI1| ) ) [GROUPE1,...,GROUPEn]
                                  |LREEL1|
                                  |LMOTS1|


    In both cases, GROUPi is a pattern of the following form :

                         MOTAi(/MOTBi)(*ENTIi)



   Comments :
   __________

   1) The creation of empty objects can be usefull whenever you have
      to build a main object in an iterative way. Indeed, the VIDE
      operator makes it possible to initialize this main object, thus
      avoiding any conditional test before calling the ET operator.
      This should be particularly appreciated when the first ET can
      occur alternatively at different locations.

   2) If the 'TABULATE' option is present, it is possible to specify
      the indexes to be used in a list of the LISTENTI or LISTREEL or
      LISTMOTS type.

      Should that list be too short, the missing indexes would be
      integers (ENTIER) reflecting the order of creation of the empty
      objects.

      /!\ WARNING : The user must personally check that no index is
                    going to be erased during the process. This will
                    always occur if the list he/she provided contains
                    duplicates. It may also happen if this is a
                    LISTENTI which is not long enough.

   3) The GROUPi patterns consist of a type MOTAi, and possibly a
      subtype MOTBi and/or the amount of objects to create. The table
      below gives the list of the allowed values :

        MOTAi      |   MOTBi
      +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
       'MAILLAGE'  |   Any valid element type
                   |   (Default: value returned by VALE 'ELEM')
      -------------+---------------------------------------------------
       'CHPOINT '  |   Object nature: 'DISCRET' or 'DIFFUS'
                   |   (Default: 'INDETERMINE')
      -------------+---------------------------------------------------
       'MCHAML  '  |   NONE
      -------------+---------------------------------------------------
       'MMODEL  '  |   NONE
      -------------+---------------------------------------------------
       'RIGIDITE'  |   The subtype attributed to the matrix
                   |   (Default: an empty string '        ')
      -------------+---------------------------------------------------
       'EVOLUTIO'  |   NONE
      -------------+---------------------------------------------------
       'LISTENTI'  |   NONE
      -------------+---------------------------------------------------
       'LISTREEL'  |   NONE
      -------------+---------------------------------------------------
       'LISTMOTS'  |   NONE
      -------------+---------------------------------------------------
       'LISTCHPO'  |   NONE
      -------------+---------------------------------------------------
       'TABLE   '  |   The subtype attributed to the table
                   |   (Default: table has no subtype)
      -------------+---------------------------------------------------
       'DEFORME '  |   NONE
      -------------+---------------------------------------------------
       'VECTEUR '  |   NONE
      -------------+---------------------------------------------------
       'CHARGEME'  |   NONE


   Examples :
   __________


   a) MAIL1 = VIDE 'MAILLAGE' ;
      MAIL2 = VIDE 'MAILLAGE'/'SEG2' ;
      MAIL3 = VIDE 'MAILLAGE'/'TRI3' ;

      Here, MAIL1 is an empty mesh made of the default element. MAIL2
      is an empty mesh composed of segments while MAIL3 is an empty
      mesh composed of triangles.


   b) RIG1 RIG2 = VIDE 'RIGIDITE'*'RIGIDITE' 'RIGIDITE'*'MASSE' ;

      RIG1 is an empty matrix of subtype 'RIGIDITE', RIG2 is an empty
      matrix of subtype 'MASSE'.


   c) LENTI1 LENTI2 LENTI3 = VIDE 'LISTENTI'*3 ;
      TAB1 = VIDE 'TABU' 'LISTENTI'*3 ;
      TAB2 = VIDE 'TABU' (MOTS 'UX' 'UY' 'UZ') 'LISTENTI'*3 ;

      LENTI1, LENTI2 et LENTI3 are three empty lists of integers.
      TAB1 contains three elements 1, 2 and 3, each referencing a
      separate empty list of integers. In TAB3, the lists are rather
      indexed by 'UX', 'UY' and 'UZ'.


   d) MAIL1 MAIL2 = VIDE 'MAILLAGE'/'CUB8'*2 ;
      MAIL1 MAIL2 = VIDE 'MAILLAGE'*2/'CUB8' ;

      The order of special characters is indifferent : MAIL1 and MAIL2
      are empty meshes consituted by cubes.