u4.33.02 Opérateur CREA_TABLE#
Syntaxe#
Détail de la syntaxe
/ table_fonction
/ table
/ table_container = CREA_TABLE(
◇ / LISTE = _F(
# Si: not exists("LISTE_CO")
◆ PARA = text,
◇ TYPE_K = / "K8" (par défaut),
/ "K16",
/ "K24",
◇ NUME_LIGN = int,
◆ / LISTE_I = int,
/ LISTE_R = float,
/ LISTE_K = text,
/ LISTE_CO = cham_elem / vect_elem_depl_r / nappe / carte / table / cham_no / matr_elem_temp_r / fonction / vect_elem_temp_r / matr_asse_gene_r / cham_gd / matr_elem_depl_r / fonction_c / mode_meca,
),
/ FONCTION = _F(
◆ FONCTION = fonction_c / fonction,
◇ PARA = text,
),
/ RESU = _F(
◆ / CHAM_GD = cham_gd,
/ RESULTAT = resultat,
◇ INTITULE = text (défaut: " "),
# Si: exists('RESULTAT')
◆ NOM_CHAM = / "ACCE",
/ "ACCE_ABSOLU",
/ "COEF_H",
/ "COHE_ELEM",
/ "COMPORTEMENT",
/ "COMPORTHER",
/ "CONT_ELEM",
/ "CONT_NOEU",
/ "DEGE_ELGA",
/ "DEGE_ELNO",
/ "DEGE_NOEU",
/ "DEPL",
/ "DEPL_ABSOLU",
/ "DEPL_ELGA",
/ "DEPL_VIBR",
/ "DERA_ELGA",
/ "DERA_ELNO",
/ "DERA_NOEU",
/ "DISS_ELEM",
/ "DISS_ELGA",
/ "DISS_ELNO",
/ "DISS_NOEU",
/ "DIVU",
/ "DURT_ELNO",
/ "DURT_NOEU",
/ "ECIN_ELEM",
/ "EFGE_ELGA",
/ "EFGE_ELNO",
/ "EFGE_NOEU",
/ "EGRU_ELNO",
/ "ENDO_ELGA",
/ "ENDO_ELNO",
/ "ENDO_NOEU",
/ "ENEL_ELEM",
/ "ENEL_ELGA",
/ "ENEL_ELNO",
/ "ENEL_NOEU",
/ "ENTR_ELEM",
/ "EPEQ_ELGA",
/ "EPEQ_ELNO",
/ "EPEQ_NOEU",
/ "EPFD_ELGA",
/ "EPFD_ELNO",
/ "EPFD_NOEU",
/ "EPFP_ELGA",
/ "EPFP_ELNO",
/ "EPFP_NOEU",
/ "EPGQ_ELGA",
/ "EPGQ_ELNO",
/ "EPGQ_NOEU",
/ "EPME_ELGA",
/ "EPME_ELNO",
/ "EPME_NOEU",
/ "EPMG_ELGA",
/ "EPMG_ELNO",
/ "EPMG_NOEU",
/ "EPMQ_ELGA",
/ "EPMQ_ELNO",
/ "EPMQ_NOEU",
/ "EPOT_ELEM",
/ "EPSA_ELNO",
/ "EPSA_NOEU",
/ "EPSG_ELGA",
/ "EPSG_ELNO",
/ "EPSG_NOEU",
/ "EPSI_ELGA",
/ "EPSI_ELNO",
/ "EPSI_NOEU",
/ "EPSL_ELGA",
/ "EPSL_ELNO",
/ "EPSL_NOEU",
/ "EPSP_ELGA",
/ "EPSP_ELNO",
/ "EPSP_NOEU",
/ "EPVC_ELGA",
/ "EPVC_ELNO",
/ "EPVC_NOEU",
/ "ERME_ELEM",
/ "ERME_ELNO",
/ "ERME_NOEU",
/ "ERTH_ELEM",
/ "ERTH_ELNO",
/ "ERTH_NOEU",
/ "ERZ1_ELEM",
/ "ERZ2_ELEM",
/ "ETHE_ELEM",
/ "ETOT_ELEM",
/ "ETOT_ELGA",
/ "ETOT_ELNO",
/ "ETOT_NOEU",
/ "FERR_ELEM",
/ "FLHN_ELGA",
/ "FLUX_ELGA",
/ "FLUX_ELNO",
/ "FLUX_NOEU",
/ "FORC_NODA",
/ "FSUR_2D",
/ "FSUR_3D",
/ "FVOL_2D",
/ "FVOL_3D",
/ "HHO_DEPL",
/ "HHO_TEMP",
/ "HHO_VITE",
/ "HYDR_ELGA",
/ "HYDR_ELNO",
/ "HYDR_NOEU",
/ "INDL_ELGA",
/ "INTE_ELNO",
/ "INTE_NOEU",
/ "IRRA",
/ "MATE_ELEM",
/ "MATE_ELGA",
/ "META_ELNO",
/ "META_NOEU",
/ "MODE_FLAMB",
/ "MODE_STAB",
/ "NEUT",
/ "PDIL_ELGA",
/ "PRAC_ELNO",
/ "PRAC_NOEU",
/ "PRES",
/ "PRES_NOEU",
/ "PRME_ELNO",
/ "PTOT",
/ "QIRE_ELEM",
/ "QIRE_ELNO",
/ "QIRE_NOEU",
/ "QIZ1_ELEM",
/ "QIZ2_ELEM",
/ "REAC_NODA",
/ "RESI_NOEU",
/ "RESI_RELA_NOEU",
/ "SIEF_ELGA",
/ "SIEF_ELNO",
/ "SIEF_NOEU",
/ "SIEQ_ELGA",
/ "SIEQ_ELNO",
/ "SIEQ_NOEU",
/ "SIGM_ELGA",
/ "SIGM_ELNO",
/ "SIGM_NOEU",
/ "SIMY_ELGA",
/ "SING_ELEM",
/ "SING_ELNO",
/ "SIPM_ELNO",
/ "SIPO_ELNO",
/ "SIPO_NOEU",
/ "SIRO_ELEM",
/ "SISE_ELNO",
/ "SIZ1_NOEU",
/ "SIZ2_NOEU",
/ "SOUR_ELGA",
/ "STRX_ELGA",
/ "TEMP",
/ "TEMP_ELGA",
/ "T_EXT",
/ "UT01_CART",
/ "UT01_ELEM",
/ "UT01_ELGA",
/ "UT01_ELNO",
/ "UT01_NOEU",
/ "UT02_CART",
/ "UT02_ELEM",
/ "UT02_ELGA",
/ "UT02_ELNO",
/ "UT02_NOEU",
/ "UT03_CART",
/ "UT03_ELEM",
/ "UT03_ELGA",
/ "UT03_ELNO",
/ "UT03_NOEU",
/ "UT04_CART",
/ "UT04_ELEM",
/ "UT04_ELGA",
/ "UT04_ELNO",
/ "UT04_NOEU",
/ "UT05_CART",
/ "UT05_ELEM",
/ "UT05_ELGA",
/ "UT05_ELNO",
/ "UT05_NOEU",
/ "UT06_CART",
/ "UT06_ELEM",
/ "UT06_ELGA",
/ "UT06_ELNO",
/ "UT06_NOEU",
/ "UT07_CART",
/ "UT07_ELEM",
/ "UT07_ELGA",
/ "UT07_ELNO",
/ "UT07_NOEU",
/ "UT08_CART",
/ "UT08_ELEM",
/ "UT08_ELGA",
/ "UT08_ELNO",
/ "UT08_NOEU",
/ "UT09_CART",
/ "UT09_ELEM",
/ "UT09_ELGA",
/ "UT09_ELNO",
/ "UT09_NOEU",
/ "UT10_CART",
/ "UT10_ELEM",
/ "UT10_ELGA",
/ "UT10_ELNO",
/ "UT10_NOEU",
/ "VARC_ELGA",
/ "VARI_ELGA",
/ "VARI_ELNO",
/ "VARI_NOEU",
/ "VITE",
/ "VITE_ABSOLU",
/ "VITE_VENT",
◇ / TOUT_ORDRE = "OUI" (ou non renseigné),
/ NUME_ORDRE = int,
/ LIST_ORDRE = listis,
/ INST = float,
/ LIST_INST = listr8,
/ MODE = int,
/ LIST_MODE = listis,
/ FREQ = float,
/ LIST_FREQ = listr8,
◇ CRITERE = / "RELATIF" (par défaut),
/ "ABSOLU",
# Si: equal_to('CRITERE', 'RELATIF')
◇ PRECISION = float (défaut: 1e-06),
# Si: equal_to('CRITERE', 'ABSOLU')
◆ PRECISION = float,
# Si: exists('CHAM_GD')
◇ CARA_ELEM = cara_elem,
◆ / TOUT_CMP = "OUI" (ou non renseigné),
/ NOM_CMP = text,
/ NOM_VARI = text,
◆ | TOUT = "OUI" (ou non renseigné),
| GROUP_MA = grma,
| GROUP_NO = grno,
),
◇ TYPE_TABLE = / "TABLE" (par défaut),
/ "TABLE_FONCTION",
/ "TABLE_CONTAINER",
◇ TITRE = text,
)
◆ : obligatoire
◇ : optionnel
⟐ : présent par défaut
& : ensemble
/ : un seul parmi
| : plusieurs choix possibles
Opérandes#
Mot clé FONCTION#
Opérande FONCTION#
La table est créée à partir d’une fonction. La première colonne de la table contient les abscisses de la fonction et la seconde les valeurs de la fonction aux abscisses correspondantes.
Opérande PARA#
Noms des paramètres de la table. Ce mot clé est facultatif: les noms des paramètres sont alors identiques aux NOM_PARA et NOM_RESU de la fonction. S’il est renseigné, son cardinal doit être égal à 2: nom de paramètre pour la colonne associée aux abscisses, nom de paramètre pour la colonne associée aux ordonnées.
Mot clé LISTE#
Ce mot clé doit être fourni au moins 2 fois: chaque occurrence permet de définir une colonne de la table.
Les listes n’ont pas nécessairement le même cardinal, on utilise le mot clé NUME_LIGN pour indiquer quelles lignes doivent être remplies.
Opérande LISTE_R#
Une colonne est créée dans la table à partir d’une liste de réels.
Opérande LISTE_I#
Une colonne est créée dans la table à partir d’une liste d’entiers.
Opérande LISTE_K#
Une colonne est créée dans la table à partir d’une liste de chaînes de caractères.
Opérande TYPE_K#
Longueur des chaînes de caractères pour le cas LISTE_K.
Opérande LISTE_CO#
Cette opérande permet de définir une liste de concepts. La table créée à partir d’une liste de concepts est obligatoirement une table de type TABLE_CONTENEUR. La liste de concepts est utilisée pour créer deux colonnes de la table: une colonne de paramètre NOM_SDet une colonne de paramètre TYPE_OBJET.
Si l’opérandeLISTE_COest renseignée, l’utilisateur doit également définir une colonne de paramètre NOM_OBJETcontenant une clé unique pour chaque concept de la liste de concepts.
Opérande NUME_LIGN#
Quand les listes n’ont pas toutes le même cardinal ou bien pour construire une table à trous, on utilise ce mot clé pour préciser quelles lignes sont remplies.
Opérande PARA#
Nom du paramètre de la table associé à la liste fournie.
Mot clé RESU#
Ce mot-clé ne doit être utilisé qu’une seule fois. Il permet de créer une table à partir des composantes d’un champ isolé (mot clé CHAM_GD) ou des champs d’une structure de données résultat (mot clé RESULTAT). Les champs traités doivent avoir des valeurs réelles.
Opérande CHAM_GD#
Cet opérande permet de recueillir le nom du champ qui sera lu pour créer la table. Ce champ peut provenir par exemple de la commande CREA_CHAMP.
Opérandes RESULTAT/NOM_CHAM/TOUT_ORDRE/NUME_ORDRE/LIST_ORDRE /INST/LIST_INST/MODE/LIST_MODE/FREQ/LIST_FREQ/CRITERE/PRECISION#
Ces opérandes permettent de choisir les champs de la structure de données résultats à traiter. On peut limiter les numéros d’ordre avec les mots clés INST, LIST_INST, … ainsi que les noms de champs (“DEPL”, “SIEF_ELGA”, …) avec le mot clé NOM_CHAM.
Pour plus d’informations concernant ces mot-clés, veuillez consulter la doc [U4.71.00]
Opérande INTITULE#
Cet opérande permet de surcharger le nom du RESULTATou du CHAM_GDdans la table. Par défaut, on prend le nom de la variable utilisateur.
Opérandes TOUT_CMP/NOM_CMP/NOM_VARI#
Ces opérandes permettent de choisir les composantes que l’on veut voir dans la table.
Soit on utilise TOUT_CMP=”OUI” pour choisir toutes les composantes du champs, soit on utilise NOM_CMPou NOM_VARI pour n’en retenir que certaines.
◊ NOM_CMP = nocmp, [Kn]
Nom de la composante que l’on veut voir dans la table.
◊ NOM_VARI= novari, [Kn]
Pour les champs des variables internes (VARI_* ), on peut donner le nom de la variable interne que l’on veut voir dans la table (voir [U4.51.11] pour les règles de nommage des variables internes).
Opérandes TOUT/GROUP_MA/GROUP_NO#
Ces opérandes permettent de choisir les entités du maillage sur lesquelles on va récupérer les valeurs des composantes du champ.
L’opérande TOUT =”OUI” permet de considérer tout le maillage.
Pour restreindre une partie de maillage, il faut utiliser les opérandes restantes.
Pour un champ de type:
NOEU: on peut choisir GROUP_MAet/ou GROUP_NO.
ELNO/ELGA: on peut choisir GROUP_MA.
Opérande TYPE_TABLE#
Détermine le type de la table produite. Les choix sont :
TABLE : une table ordinaire
TABLE_FONCTION : une table qui contient une colonne dont le paramètre est FONCTION ou FONCTION_C dans laquelle on trouve des noms de concept fonction.
Opérande TITRE#
Titre qui sera donné à la table produite.
Exemples#
Création d’une table à partir d’une fonction#
FCT=DEFI_FONCTION(NOM_PARA=”X”,
VALE=(0.0,5.0,4.0,17.5)) ;
T_FCT=CREA_TABLE(FONCTION=_F(FONCTION=FCT));
IMPR_TABLE(TABLE=T_FCT) ;
L’impression de la table créée est la suivante :
X TOUTRESU
0.00000E+00 5.00000E+00
4.00000E+00 1.75000E+01
Création d’une table à partir de trois listes, de types hétérogènes#
T_LST=CREA_TABLE(LISTE=(
_F(LISTE_R=(0.0,4.0),PARA=”X”),
_F(LISTE_R =(5.0,17.5),PARA=”Y”) ,);
_F(LISTE_I =(6.7),PARA=”K”)
IMPR_TABLE(TABLE=T_LST) ;
L’impression de la table créée est la suivante:
X Y K
0.00000E+00 5.00000E+00 6
4.00000E+00 1.75000E+01 7
Création d’une table à trous#
TAB=CREA_TABLE(
LISTE=( _F( PARA=”NUME_ORDRE”, LISTE_I=(8,15,156,67), ), _F( PARA=”VAR”, LISTE_R=(2.,15.,18), NUME_LIGN=(1,3,4), ), _F( PARA=”COMMENT”, LISTE_K=(“VALEUR”,), TYPE_K=”K24”, NUME_LIGNE=1, ), ),
L’impression de la table créée est la suivante:
NUME_ORDRE VAR COMMENT
8 2.00000E+00 VALEUR
15 – -
156 1.50000E+01 -
67 1.80000E+01 -
Création d’une table à partir d’un champ#
TB01=CREA_TABLE(RESU=_F(RESULTAT=TEMP0,
TOUT=”OUI”,
NUME_ORDRE=4,
TOUT_CMP=”OUI”,
NOM_CHAM=”TEMP”,),)
L'impression de la table créée est la suivante:
#TABLE_SDASTER
RESULTAT NOM_CHAM NUME_ORDRE NOEUD COOR_X COOR_Y TEMP
TEMP0 TEMP 4 N1 1.0 0.0 85.0
TEMP0 TEMP 4 N2 2.0 0.0 85.0
TEMP0 TEMP 4 N3 2.0 4.0 85.0
TEMP0 TEMP 4 N4 1.0 4.0 85.0