Syntaxe
=======

.. code-block:: text

    / macr_elem_dyna
    / nume_ddl = CREA_ELEM_SSD(
        ◆ MODELE = modele,
        ◆ CHAM_MATER = cham_mater,
        ◇ CARA_ELEM = cara_elem,
        ◇ NUME_DDL = co,
        ◇ CHARGE = char_ther / char_meca / char_acou,
        ◆ INTERFACE = _F(
             ◇ & NOM = text,
               & TYPE = / "MNEAL",
                        / "CRAIGB",
                        / "CB_HARMO",
             ◆ / GROUP_NO = grno,
             ◇ FREQ = float (défaut: 1.0),
             ◇ MASQUE = text,
          ),
        ◆ BASE_MODALE = _F(
             ◆ TYPE = / "CLASSIQUE",
                      / "RITZ",
             # Si: equal_to("TYPE", 'RITZ')
                 ◇ TYPE_MODE = / "STATIQUE",
                               / "INTERFACE" (par défaut),
                 # Si: equal_to("TYPE_MODE", 'INTERFACE')
                     ◇ NMAX_MODE_INTF = int (défaut: 10),
          ),
        ◇ INFO = / 1 (par défaut),
                 / 2,
        ⟐ SOLVEUR = _F(
             ◇ METHODE = / "MULT_FRONT",
                         / "LDLT",
                         / "MUMPS" (par défaut),
             # Si: equal_to("METHODE", 'MULT_FRONT')
                 ◇ RENUM = / "MD",
                           / "MDA" (par défaut),
                 ◇ NPREC = int (défaut: 8),
                 ◇ ELIM_LAGR = / "OUI",
                               / "NON" (par défaut),
                 ◇ STOP_SINGULIER = / "OUI" (par défaut),
                                    / "NON",
             # Si: equal_to("METHODE", 'LDLT')
                 ◇ RENUM = "RCMK",
                 ◇ NPREC = int (défaut: 8),
                 ◇ ELIM_LAGR = / "OUI",
                               / "NON" (par défaut),
                 ◇ STOP_SINGULIER = / "OUI" (par défaut),
                                    / "NON",
             # Si: equal_to("METHODE", 'MUMPS')
                 ◇ RENUM = / "AMD",
                           / "AMF",
                           / "PORD",
                           / "METIS",
                           / "QAMD",
                           / "SCOTCH",
                           / "AUTO" (par défaut),
                           / "PARMETIS",
                           / "PTSCOTCH",
                 ◇ NPREC = int (défaut: 8),
                 ◇ ELIM_LAGR = / "OUI",
                               / "NON",
                               / "LAGR2" (par défaut),
                 ◇ STOP_SINGULIER = / "OUI" (par défaut),
                                    / "NON",
                 ◇ TYPE_RESOL = / "NONSYM",
                                / "SYMGEN",
                                / "SYMDEF",
                                / "AUTO" (par défaut),
                 ◇ ACCELERATION = / "AUTO",
                                  / "FR" (par défaut),
                                  / "FR+",
                                  / "FR++",
                                  / "LR",
                                  / "LR+",
                                  / "LR++",
                 ◇ LOW_RANK_SEUIL = float,
                 ◇ PRETRAITEMENTS = / "SANS",
                                    / "AUTO" (par défaut),
                 ◇ POSTTRAITEMENTS = / "SANS",
                                     / "AUTO" (par défaut),
                                     / "FORCE",
                                     / "MINI",
                 ◇ PCENT_PIVOT = int (défaut: 35),
                 ◇ NB_RHS = int (défaut: 1),
                 ◇ RESI_RELA = float (défaut: -1.0),
                 ◇ GESTION_MEMOIRE = / "IN_CORE",
                                     / "OUT_OF_CORE",
                                     / "AUTO" (par défaut),
                                     / "EVAL",
             # Si: equal_to("METHODE", 'GCPC')
                 ◇ ELIM_LAGR = / "OUI",
                               / "NON" (par défaut),
                 ◇ PRE_COND = / "LDLT_INC" (par défaut),
                              / "LDLT_SP",
                              / "LDLT_DP",
                 ◇ RESI_RELA = float (défaut: 1e-06),
                 ◇ NMAX_ITER = int,
                 # Si: equal_to("PRE_COND", 'LDLT_INC')
                     ◇ RENUM = "RCMK",
                     ◇ NIVE_REMPLISSAGE = int,
                 # Si: is_in("PRE_COND", ('LDLT_SP', 'LDLT_DP'))
                     ◇ RENUM = / "SANS",
                               / "METIS",
                               / "PARMETIS" (par défaut),
                     ◇ REAC_PRECOND = int (défaut: 30),
                     ◇ PCENT_PIVOT = int (défaut: 20),
                     ◇ GESTION_MEMOIRE = / "IN_CORE",
                                         / "AUTO" (par défaut),
                     ◇ LOW_RANK_SEUIL = float,
             # Si: equal_to("METHODE", 'PETSC')
                 ◇ ELIM_LAGR = / "OUI",
                               / "NON" (par défaut),
                 ◇ ALGORITHME = / "CG",
                                / "CR",
                                / "GMRES",
                                / "GCR",
                                / "FGMRES" (par défaut),
                                / "GMRES_LMP",
                 ◇ OPTION_PETSC = text,
                 ◇ PRE_COND = / "LDLT_INC",
                              / "LDLT_SP" (par défaut),
                              / "LDLT_DP",
                              / "JACOBI",
                              / "SOR",
                              / "ML",
                              / "BOOMER",
                              / "GAMG",
                              / "BLOC_LAGR",
                              / "FIELDSPLIT",
                              / "UTILISATEUR",
                              / "HPDDM",
                              / "SANS",
                 ◇ RESI_RELA = float (défaut: 1e-06),
                 ◇ NMAX_ITER = int,
                 # Si: equal_to("PRE_COND", 'LDLT_INC')
                     ◇ RENUM = "RCMK",
                     ◇ NIVE_REMPLISSAGE = int,
                     ◇ REMPLISSAGE = float (défaut: 1.0),
                 # Si: is_in("PRE_COND", ('LDLT_SP', 'LDLT_DP'))
                     ◇ RENUM = / "SANS",
                               / "METIS",
                               / "PARMETIS" (par défaut),
                     ◇ REAC_PRECOND = int (défaut: 30),
                     ◇ PCENT_PIVOT = int (défaut: 20),
                     ◇ GESTION_MEMOIRE = / "IN_CORE",
                                         / "AUTO" (par défaut),
                     ◇ LOW_RANK_SEUIL = float,
                 # Si: equal_to("PRE_COND", 'ML')
                     ◇ RENUM = "SANS",
                 # Si: equal_to("PRE_COND", 'BOOMER')
                     ◇ RENUM = "SANS",
                 # Si: equal_to("PRE_COND", 'GAMG')
                     ◇ RENUM = "SANS",
                 # Si: equal_to("PRE_COND", 'HPDDM')
                     ◇ RENUM = "SANS",
                 # Si: equal_to("PRE_COND", 'BLOC_LAGR')
                     ◇ RENUM = "SANS",
                 # Si: is_in("PRE_COND", ('FIELDSPLIT'))
                     ◇ RENUM = "SANS",
                     ◇ PARTITION_CMP = int,
                     ◇ NOM_CMP = text,
                 # Si: is_in("PRE_COND", ('UTILISATEUR'))
                     ◇ KSP_UTIL = not_checked,
                     ◇ RENUM = "SANS",
                 # Si: is_in("PRE_COND", ('JACOBI','SOR','SANS'))
                     ◇ RENUM = / "SANS" (par défaut),
                               / "RCMK",
          ),
        ⟐ CALC_FREQ = _F(
             ◇ STOP_ERREUR = / "OUI" (par défaut),
                             / "NON",
             ◇ OPTION = / "PLUS_PETITE" (par défaut),
                        / "BANDE",
                        / "CENTRE",
                        / "SANS",
             # Si: equal_to("OPTION", 'PLUS_PETITE')
                 ◇ NMAX_FREQ = int (défaut: 10),
             # Si: equal_to("OPTION", 'CENTRE')
                 ◆ FREQ = float,
                 ◇ AMOR_REDUIT = float,
                 ◇ NMAX_FREQ = int (défaut: 10),
             # Si: (equal_to("OPTION", 'BANDE'))
                 ◇ NMAX_FREQ = int (défaut: 9999),
                 ◆ FREQ = float,
             ◇ APPROCHE = / "REEL" (par défaut),
                          / "IMAG",
                          / "COMPLEXE",
             ◇ DIM_SOUS_ESPACE = int,
          ),
    )
    
    ◆ : obligatoire
    ◇ : optionnel
    ⟐ : présent par défaut
    & : ensemble
    / : un seul parmi
    | : plusieurs choix possibles