Documentation de la bibliothèque MED-fichier V2.3 : Guide de référence - Module "MED_Variable_Scalaire".
|
Retour à la page du guide de référence.
Les routines disponibles permettent de :
- Créer une variable scalaire de type entier ou flottant dans un fichier.
- Ecrire une valeur entière ou flottante dans une variable scalaire du type correspondant
selon éventuellement un pas de temps et/ou un numéro d'ordre.
- Lire le nombre de variables scalaires dans un fichier.
- Lire les informations sur une variable scalaire (nom, type, description associée).
- Lire le nombre de pas de temps/numéro d'ordre dans un variable scalaire.
- Lire les informations sur un pas de temps et/ou un numéro d'ordre.
- Lire une valeur entière ou flottante dans une variable scalaire du type correspondant
selon éventuellement un pas de temps et/ou un numéro d'ordre.
- Nom : efscac
- Signature :
subroutine efscac(fid,sca,type,desc,cret)
character *(*) sca,desc
integer fid, cret, type
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- type (IN) : type de la variable scalaire.
- desc (IN) : description associée à la variable.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Création d'un variable scalaire numérique dans un fichier.
- Le nom de la variable scalaire est une chaîne de MED_TAILLE_NOM (32) caractères.
- Le type de la variable est au choix :
- MED_FLOAT64 : flottant 64 bits IEEE.
- MED_INT32 : entier 32 bits.
- MED_INT64 : entier 64 bits
- La description est une chaîne de MED_TAILLE_DESC (200) caractères.
- Nom : MEDscalaireEntierEcr
- Signature :
med_err
MEDscalaireEntierEcr(med_idt fid, char *sca,med_int val, med_int numdt,
char *dtunit, med_float dt, med_int numo)
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- val (IN) : valeur entière.
- numdt (IN) : numéro du pas de temps.
- dtunit (IN) : unité du pas de temps.
- dt (IN) : valeur du pas de temps.
- numo (IN) : numéro d'ordre.
- Code retourné : 0 en cas de succès, -1 sinon.
- Nom : efscee
- Signature :
subroutine efscee(fid,sca,val,numdt,dtunit,dt,numo,cret)
character *32 sca
character*16 dtunit
integer fid,val,n,cret
integer numdt,numo
real*8 dt
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- val (IN) : valeur entière.
- numdt (IN) : numéro du pas de temps.
- dtunit (IN) : unité du pas de temps.
- dt (IN) : valeur du pas de temps.
- numo (IN) : numéro d'ordre.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Ecriture d'une valeur entière dans une variable scalaire de
type entier. Cette valeur entière est éventuellement associée
à un pas de temps et/ou un numéro d'ordre.
- Le nom de la variable scalaire est une chaîne de MED_TAILLE_NOM (32) caractères.
- La présence d'un pas de temps est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun pas de temps, le paramètre numdt doit prendre la
valeur MED_NOPDT (-1). Dans ce cas, les paramètres dt et dtunit ne
sont pas pris en compte.
- L'unité du pas de temps est un chaîne de MED_TAILLE_PNOM (16) caractères.
- La présence d'un numéro d'ordre est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun numéro d'ordre, le paramètre numo doit prendre la
valeur MED_NONOR (-1).
- Nom : MEDscalaireFlottantEcr
- Signature :
med_err
MEDscalaireFlottantEcr(med_idt fid, char *sca,med_float val, med_int numdt,
char *dtunit, med_float dt, med_int numo)
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- val (IN) : valeur flottante.
- numdt (IN) : numéro du pas de temps.
- dtunit (IN) : unité du pas de temps.
- dt (IN) : valeur du pas de temps.
- numo (IN) : numéro d'ordre.
- Code retourné : 0 en cas de succès, -1 sinon.
- Nom : efscfe
- Signature :
subroutine efscfe(fid,sca,val,numdt,dtunit,dt,numo,cret)
character *32 sca
character*16 dtunit
integer fid,n,cret
integer numdt,numo
real*8 val
real*8 dt
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- val (IN) : valeur flottante.
- numdt (IN) : numéro du pas de temps.
- dtunit (IN) : unité du pas de temps.
- dt (IN) : valeur du pas de temps.
- numo (IN) : numéro d'ordre.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Ecriture d'une valeur flottante dans une variable scalaire de
type réel. Cette valeur flottante est éventuellement associée
à un pas de temps et/ou un numéro d'ordre.
- Le nom de la variable scalaire est une chaîne de MED_TAILLE_NOM (32) caractères.
- La présence d'un pas de temps est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun pas de temps, le paramètre numdt doit prendre la
valeur MED_NOPDT (-1). Dans ce cas, les paramètres dt et dtunit ne
sont pas pris en compte.
- L'unité du pas de temps est un chaîne de MED_TAILLE_PNOM (16) caractères.
- La présence d'un numéro d'ordre est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun numéro d'ordre, le paramètre numo doit prendre la
valeur MED_NONOR (-1).
- Nom : efnsca
- Signature :
subroutine efnsca(fid,n,cret)
integer fid,cret,n
- Paramètres :
- fid (IN) : descripteur du fichier.
- n (OUT) : nombre de variable scalaire.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Lecture du nombre de variable scalaire dans un fichier.
Un fichier peut contenir plusieurs variables scalaire de noms
différents.
- Nom : MEDscalaireInfo
- Signature :
med_err
MEDscalaireInfo(med_idt fid,int ind,char *sca,
med_type_champ *type,char *desc)
- Paramètres :
- fid (IN) : descripteur du fichier.
- ind (IN) : indice de la variable dans le fichier.
- sca (OUT) : nom de la variable correspondant à l'indice.
- type (OUT) : type de la variable.
- desc (OUT) : description associée à la variable.
- Code retourné : 0 si réussite, -1 sinon.
- Nom : efscai
- Signature :
subroutine efscai(fid,ind,sca,type,desc,cret)
character *(*) sca,desc
integer fid,ind,type,cret
- Paramètres :
- fid (IN) : descripteur du fichier.
- ind (IN) : indice de la variable dans le fichier.
- sca (OUT) : nom de la variable correspondant à l'indice.
- type (OUT) : type de la variable.
- desc (OUT) : description associée à la variable.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Lecture des informations sur une variable scalaire repérée selon
un indice dans le fichier -i.e. :
- Le nom.
- Le type.
- La description associée.
- Pour un fichier contenant N variables, les numéros d'indice vont de 1 à N.
- Les variables scalaire d'un fichier sont classées selon l'ordre alphabétique
des noms des différents maillages et non selon l'ordre chronologique
de création.
- Le nom de la variable scalaire est une chaîne de MED_TAILLE_NOM (32) caractères.
- Le type de la variable est au choix :
- MED_FLOAT64 : flottant 64 bits IEEE.
- MED_INT32 : entier 32 bits.
- MED_INT64 : entier 64 bits
- La description est une chaîne de MED_TAILLE_DESC (200) caractères.
- Nom : efnspd
- Signature :
subroutine efnspd(fid,sca,n,cret)
integer fid,n,cret
character*32 sca
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- n (OUT) : nombre de pas de temps.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Lecture du nombre de pas de temps dans une variable scalaire.
- Le nom de la variable scalaire est une chaîne de MED_TAILLE_NOM (32) caractères.
- Nom : MEDscalairePasdetempsInfo
- Signature :
med_err
MEDscalairePasdetempsInfo(med_idt fid,char *sca,int ind,
med_int * numdt, char * dtunit, med_float * dt,med_int * numo)
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable correspondant à l'indice.
- ind (IN) : indice du pas de temps dans la variable.
- numdt (OUT) : numéro du pas de temps.
- dtunit (OUT) : unité du pas de temps.
- dt (OUT) : valeur du pas de temps.
- numo (OUT) : numéro d'ordre.
- Code retourné : 0 si réussite, -1 sinon.
- Nom : efspdi
- Signature :
subroutine efspdi(fid,sca,ind,
1 numdt,dtunit,dt,numo,cret)
integer fid,ind,numdt,numo,cret
character*32 sca
character*16 dtunit
real*8 dt
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable correspondant à l'indice.
- ind (IN) : indice du pas de temps dans la variable.
- numdt (OUT) : numéro du pas de temps.
- dtunit (OUT) : unité du pas de temps.
- dt (OUT) : valeur du pas de temps.
- numo (OUT) : numéro d'ordre.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Lecture des informations sur un pas de temps repéré selon
un indice dans une variable scalaire. On lit :
- Le numéro du pas de temps.
- L'unité du pas de temps.
- La valeur du pas de temps.
- La valeur du numéro d'ordre.
- Le nom de la variable scalaire est une chaîne de MED_TAILLE_NOM (32) caractères.
- La présence d'un pas de temps est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun pas de temps, la valeur du paramètre numdt retournée est
MED_NOPDT (-1). Dans ce cas, les paramètres dt et dtunit ne
sont pas à prendre en compte.
- L'unité du pas de temps est un chaîne de MED_TAILLE_PNOM (16) caractères.
- La présence d'un numéro d'ordre est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun numéro d'ordre, la valeur du paramètre numo renvoyée
est MED_NONOR (-1).
- Nom : MEDscalaireEntierLire
- Signature :
med_err
MEDscalaireEntierLire(med_idt fid, char *sca,med_int *val, med_int numdt,med_int numo)
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- val (OUT) : valeur entière.
- numdt (IN) : numéro du pas de temps.
- numo (IN) : numéro d'ordre.
- Code retourné : 0 en cas de succès, -1 sinon.
- Nom : efscel
- Signature :
subroutine efscel(fid,sca,val,numdt,numo,cret)
character *32 sca
integer fid,val,n,cret
integer numdt,numo
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- val (OUT) : valeur entière.
- numdt (IN) : numéro du pas de temps.
- numo (IN) : numéro d'ordre.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Lecture d'une valeur entière dans une variable scalaire de
type entier. Cette valeur entière est éventuellement associée
à un pas de temps et/ou un numéro d'ordre.
- Le nom de la variable scalaire est une chaîne de MED_TAILLE_NOM (32) caractères.
- La présence d'un pas de temps est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun pas de temps, le paramètre numdt doit prendre la
valeur MED_NOPDT (-1).
- La présence d'un numéro d'ordre est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun numéro d'ordre, le paramètre numo doit prendre la
valeur MED_NONOR (-1).
- Nom : MEDscalaireFlottantLire
- Signature :
med_err
MEDscalaireFlottantLire(med_idt fid, char *sca,med_float *val, med_int numdt,med_int numo)
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- val (OUT) : valeur flottante.
- numdt (IN) : numéro du pas de temps.
- numo (IN) : numéro d'ordre.
- Code retourné : 0 en cas de succès, -1 sinon.
- Nom : efscfl
- Signature :
subroutine efscfl(fid,sca,val,numdt,numo,cret)
character *32 sca
integer fid,n,cret
integer numdt,numo
real*8 val
- Paramètres :
- fid (IN) : descripteur du fichier.
- sca (IN) : nom de la variable scalaire.
- val (OUT) : valeur flottante.
- numdt (IN) : numéro du pas de temps.
- numo (IN) : numéro d'ordre.
- cret (OUT) : code de retour, 0 si réussite, -1 sinon.
Lecture d'une valeur flottante dans une variable scalaire de
type réel. Cette valeur flottante est éventuellement associée
à un pas de temps et/ou un numéro d'ordre.
- Le nom de la variable scalaire est une chaîne de MED_TAILLE_NOM (32) caractères.
- La présence d'un pas de temps est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun pas de temps, le paramètre numdt doit prendre la
valeur MED_NOPDT (-1).
- La présence d'un numéro d'ordre est optionnelle. Dans le cas où la valeur entière
n'est associée à aucun numéro d'ordre, le paramètre numo doit prendre la
valeur MED_NONOR (-1).