Syntaxe
=======
               

.. code-block:: text

    resultat = CALC_ERREUR(
        ◇ reuse = <objet de RESULTAT>,
        ◇ MODELE = modele,
        ◇ CHAM_MATER = cham_mater,
        ◆ RESULTAT = resultat,
        ◇ / TOUT_ORDRE = "OUI" (ou non renseigné),
          / NUME_ORDRE = int,
          / INST = float,
          / FREQ = float,
          / NUME_MODE = int,
          / NOEUD_CMP = text,
          / LIST_INST = listr8,
          / LIST_FREQ = listr8,
          / LIST_ORDRE = listis,
          / NOM_CAS = text,
        ◇ CRITERE = / "ABSOLU",
                    / "RELATIF" (par défaut),
        # Si: (equal_to("CRITERE", 'RELATIF'))
            ◇ PRECISION = float (défaut: 1e-06),
        # Si: (equal_to("CRITERE", 'ABSOLU'))
            ◆ PRECISION = float,
        ◇ TOUT = "OUI",
        ◇ CARA_ELEM = cara_elem,
        ◇ EXCIT = _F(
             ◆ CHARGE = char_cine_meca / char_meca,
             ◇ FONC_MULT = fonction / formule / nappe,
          ),
        ◆ OPTION = / "ERME_ELEM",
                   / "ERME_ELNO",
                   / "ERME_NOEU",
                   / "ERTH_ELEM",
                   / "ERTH_ELNO",
                   / "ERTH_NOEU",
                   / "ERZ1_ELEM",
                   / "ERZ2_ELEM",
                   / "QIRE_ELEM",
                   / "QIRE_ELNO",
                   / "QIRE_NOEU",
                   / "QIZ1_ELEM",
                   / "QIZ2_ELEM",
                   / "SING_ELEM",
                   / "SING_ELNO",
                   / "SIZ1_NOEU",
                   / "SIZ2_NOEU",
        # Si: is_in('OPTION', ('QIRE_ELEM','QIZ1_ELEM','QIZ2_ELEM','QIRE_ELNO','QIRE_NOEU'))
            ◆ RESU_DUAL = resultat,
        # Si: is_in('OPTION', 'SING_ELEM')
            ◆ PREC_ERR = float,
            ◇ TYPE_ESTI = / "ERME_ELEM",
                          / "ERZ1_ELEM",
                          / "ERZ2_ELEM",
                          / "QIRE_ELEM",
                          / "QIZ1_ELEM",
                          / "QIZ2_ELEM",
        ⟐ SOLVEUR = _F(
             ◇ METHODE = / "GCPC",
                         / "LDLT",
                         / "MULT_FRONT",
                         / "MUMPS" (par défaut),
                         / "PETSC",
             # Si: equal_to("METHODE", 'MULT_FRONT')
                 ◇ RENUM = / "MD",
                           / "MDA" (par défaut),
                 ◇ NPREC = int (défaut: 8),
                 ◇ ELIM_LAGR = / "NON" (par défaut),
                               / "OUI",
                 ◇ STOP_SINGULIER = / "NON",
                                    / "OUI" (par défaut),
             # Si: equal_to("METHODE", 'LDLT')
                 ◇ RENUM = "RCMK",
                 ◇ NPREC = int (défaut: 8),
                 ◇ ELIM_LAGR = / "NON" (par défaut),
                               / "OUI",
                 ◇ STOP_SINGULIER = / "NON",
                                    / "OUI" (par défaut),
             # Si: equal_to("METHODE", 'MUMPS')
                 ◇ RENUM = / "AMD",
                           / "AMF",
                           / "AUTO" (par défaut),
                           / "METIS",
                           / "PARMETIS",
                           / "PORD",
                           / "PTSCOTCH",
                           / "QAMD",
                           / "SCOTCH",
                 ◇ NPREC = int (défaut: 8),
                 ◇ ELIM_LAGR = / "LAGR2" (par défaut),
                               / "NON",
                               / "OUI",
                 ◇ STOP_SINGULIER = / "NON",
                                    / "OUI" (par défaut),
                 ◇ TYPE_RESOL = / "AUTO" (par défaut),
                                / "NONSYM",
                                / "SYMDEF",
                                / "SYMGEN",
                 ◇ ACCELERATION = / "AUTO" (par défaut),
                                  / "FR",
                                  / "FR+",
                                  / "FR++",
                                  / "LR",
                                  / "LR+",
                                  / "LR++",
                 ◇ LOW_RANK_SEUIL = float (défaut: 0.0),
                 ◇ PRETRAITEMENTS = / "AUTO" (par défaut),
                                    / "SANS",
                 ◇ POSTTRAITEMENTS = / "AUTO" (par défaut),
                                     / "FORCE",
                                     / "MINI",
                                     / "SANS",
                 ◇ PCENT_PIVOT = int (défaut: 35),
                 ◇ REDUCTION_MPI = int (défaut: 0),
                 ◇ NB_RHS = int (défaut: 1),
                 ◇ RESI_RELA = float (défaut: 1e-06),
                 ◇ GESTION_MEMOIRE = / "AUTO" (par défaut),
                                     / "EVAL",
                                     / "IN_CORE",
                                     / "OUT_OF_CORE",
             # Si: equal_to("METHODE", 'GCPC')
                 ◇ ELIM_LAGR = / "NON" (par défaut),
                               / "OUI",
                 ◇ PRE_COND = / "LDLT_DP",
                              / "LDLT_INC" (par défaut),
                              / "LDLT_SP",
                 ◇ RESI_RELA = float (défaut: 1e-06),
                 ◇ NMAX_ITER = int (défaut: 0),
                 # Si: equal_to("PRE_COND", 'LDLT_INC')
                     ◇ RENUM = "RCMK",
                     ◇ NIVE_REMPLISSAGE = int (défaut: 0),
                 # Si: is_in("PRE_COND", ('LDLT_SP', 'LDLT_DP'))
                     ◇ RENUM = / "METIS",
                               / "PARMETIS" (par défaut),
                               / "SANS",
                     ◇ REAC_PRECOND = int (défaut: 30),
                     ◇ PCENT_PIVOT = int (défaut: 20),
                     ◇ GESTION_MEMOIRE = / "AUTO" (par défaut),
                                         / "IN_CORE",
                     ◇ LOW_RANK_SEUIL = float (défaut: 0.0),
             # Si: equal_to("METHODE", 'PETSC')
                 ◇ ELIM_LAGR = / "NON" (par défaut),
                               / "OUI",
                 ◇ ALGORITHME = / "CG",
                                / "CR",
                                / "FGMRES" (par défaut),
                                / "GCR",
                                / "GMRES",
                                / "GMRES_LMP",
                 ◇ OPTION_PETSC = text (défaut: ""),
                 ◇ PRE_COND = / "BLOC_LAGR",
                              / "BOOMER",
                              / "FIELDSPLIT",
                              / "GAMG",
                              / "HPDDM",
                              / "JACOBI",
                              / "LDLT_DP",
                              / "LDLT_INC",
                              / "LDLT_SP" (par défaut),
                              / "ML",
                              / "SANS",
                              / "SOR",
                              / "UTILISATEUR",
                 ◇ RESI_RELA = float (défaut: 1e-06),
                 ◇ NMAX_ITER = int (défaut: 0),
                 # Si: equal_to("PRE_COND", 'LDLT_INC')
                     ◇ RENUM = "RCMK",
                     ◇ NIVE_REMPLISSAGE = int (défaut: 0),
                     ◇ REMPLISSAGE = float (défaut: 1.0),
                 # Si: is_in("PRE_COND", ('LDLT_SP', 'LDLT_DP'))
                     ◇ RENUM = / "METIS",
                               / "PARMETIS" (par défaut),
                               / "SANS",
                     ◇ REAC_PRECOND = int (défaut: 30),
                     ◇ PCENT_PIVOT = int (défaut: 20),
                     ◇ GESTION_MEMOIRE = / "AUTO" (par défaut),
                                         / "IN_CORE",
                     ◇ LOW_RANK_SEUIL = float (défaut: 0.0),
                 # 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 = / "RCMK",
                               / "SANS" (par défaut),
          ),
        ◇ INFO = / 1 (par défaut),
                 / 2,
        ◇ TITRE = text,
    )
    
    ◆ : obligatoire
    ◇ : optionnel
    ⟐ : présent par défaut
    & : ensemble
    / : un seul parmi
    | : plusieurs choix possibles