Syntaxe
=======

.. code-block:: text

    / fonction_c
    / fonction
    / nappe = LIRE_FONCTION(
        ◇ FORMAT = / "LIBRE" (par défaut),
                   / "NUMPY",
        ◇ TYPE = / "FONCTION" (par défaut),
                 / "FONCTION_C",
                 / "NAPPE",
        ◇ SEPARATEUR = text (défaut: "None"),
        ◇ INDIC_PARA = int (défaut: [1, 1]),
        # Si: equal_to("TYPE", 'FONCTION')
            ◇ INDIC_RESU = int (défaut: [1, 2]),
        # Si: equal_to("TYPE", 'FONCTION_C')
            ◇ FORMAT_C = / "REEL_IMAG" (par défaut),
                         / "MODULE_PHASE",
            # Si: equal_to("FORMAT_C", 'REEL_IMAG')
                ◇ INDIC_REEL = int (défaut: [1, 2]),
                ◇ INDIC_IMAG = int (défaut: [1, 3]),
            # Si: equal_to("FORMAT_C", 'MODULE_PHASE')
                ◇ INDIC_MODU = int (défaut: [1, 2]),
                ◇ INDIC_PHAS = int (défaut: [1, 3]),
        # Si: equal_to("TYPE", 'NAPPE')
            ◆ NOM_PARA_FONC = / "DX",
                              / "DY",
                              / "DZ",
                              / "DRX",
                              / "DRY",
                              / "DRZ",
                              / "DTAN",
                              / "TEMP",
                              / "TSEC",
                              / "INST",
                              / "X",
                              / "Y",
                              / "Z",
                              / "EPSI",
                              / "META",
                              / "FREQ",
                              / "PULS",
                              / "DSP",
                              / "AMOR",
                              / "ABSC",
                              / "SIGM",
                              / "HYDR",
                              / "SECH",
                              / "PORO",
                              / "SAT",
                              / "IRRA",
                              / "PGAZ",
                              / "PCAP",
                              / "PLIQ",
                              / "PVAP",
                              / "PAD",
                              / "VITE",
                              / "ENDO",
                              / "NORM",
                              / "EPAIS",
                              / "EXCENT",
                              / "NEUT1",
                              / "NEUT2",
                              / "NEUT3",
                              / "NEUT4",
                              / "XF",
                              / "YF",
                              / "ZF",
                              / "NUME_ORDRE",
            ◆ INDIC_ABSCISSE = int,
            ◇ INTERPOL_FONC = / "LIN" (par défaut),
                              / "LOG",
            ◇ PROL_DROITE_FONC = / "CONSTANT",
                                 / "LINEAIRE",
                                 / "EXCLU" (par défaut),
            ◇ PROL_GAUCHE_FONC = / "CONSTANT",
                                 / "LINEAIRE",
                                 / "EXCLU" (par défaut),
            ◇ DEFI_FONCTION = _F(
                 ◆ INDIC_RESU = int,
              ),
        ◆ UNITE = unit,
        ◆ NOM_PARA = / "DX",
                     / "DY",
                     / "DZ",
                     / "DRX",
                     / "DRY",
                     / "DRZ",
                     / "DTAN",
                     / "TEMP",
                     / "TSEC",
                     / "INST",
                     / "X",
                     / "Y",
                     / "Z",
                     / "EPSI",
                     / "META",
                     / "FREQ",
                     / "PULS",
                     / "DSP",
                     / "AMOR",
                     / "ABSC",
                     / "SIGM",
                     / "HYDR",
                     / "SECH",
                     / "PORO",
                     / "SAT",
                     / "IRRA",
                     / "PGAZ",
                     / "PCAP",
                     / "PLIQ",
                     / "PVAP",
                     / "PAD",
                     / "VITE",
                     / "ENDO",
                     / "NORM",
                     / "EPAIS",
                     / "EXCENT",
                     / "NEUT1",
                     / "NEUT2",
                     / "NEUT3",
                     / "NEUT4",
                     / "XF",
                     / "YF",
                     / "ZF",
                     / "NUME_ORDRE",
        ◇ NOM_RESU = text (défaut: "TOUTRESU"),
        ◇ INTERPOL = / "LIN" (par défaut),
                     / "LOG",
        ◇ PROL_DROITE = / "CONSTANT",
                        / "LINEAIRE",
                        / "EXCLU" (par défaut),
        ◇ PROL_GAUCHE = / "CONSTANT",
                        / "LINEAIRE",
                        / "EXCLU" (par défaut),
        ◇ VERIF = / "CROISSANT" (par défaut),
                  / "NON",
        ◇ INFO = / 1 (par défaut),
                 / 2,
        ◇ TITRE = text,
    )
    
    ◆ : obligatoire
    ◇ : optionnel
    ⟐ : présent par défaut
    & : ensemble
    / : un seul parmi
    | : plusieurs choix possibles