Documentation de la biliothèque MED-fichier V2.2 : Guide de référence - Module "MED_Champ".


Sommaire de la page

Retour à la page du guide de référence.


Liste des routines

Les routines disponibles permettent de :

Création d'un champ

Interface C

Interface FORTRAN

Description

Création d'un champ dans un fichier.

Remarques

Ecriture des valeurs d'un champ

Interface C

Interface FORTRAN

Description

Ecriture de valeurs dans un champ de résultat :

Classement des valeurs du champ par étape de calcul

Entrelacement des données en mémoire

Si le champ a plus d'une composante, deux modes de représentation en mémoire sont disponibles :

  1. MED_FULL_INTERLACE : Les différentes composantes d'une entité apparaissent avant celles de l'entité suivante (X1Y1Z1X2Y2Z2.....).
  2. MED_NO_INTERLACE : Les composantes de n°i de toutes les entités apparaissent avant celles de n°i+1 (X1X2....Y1Y2....Z1Z2...).

Maillage local ou distant

Sélection d'une composante et/ou d'un sous-ensemble  d'entités de même type géométrique (profil)

Il est possible de sélectionner une composante et/ou un sous ensemble d'entités pour lequelles  <val> contient les valeurs  associées :

  1. Sélection d'une composante. Le paramètre <numco> indique  le numéro de la composante du champ considérée pour chaque entité. Le mot clé  MED_ALL sélectionne toutes les composantes. Par appels successifs à la routine il est possible d'écrire les différentes composantes sans perdre les précédentes (si le fichier est ouvert en mode MED_LECTURE_ECRITURE). Cette sélection prend en compte le mode de stockage <modswt> utilisé en mémoire.
  2. Sélection d'un sous-ensemble d'entités de même type géométrique. La définition préalable d'un profil (par appel à MEDprofilEcr/efpfle) permet d'indiquer à MEDchampEcr/efchae le nom de profil <profil> qui décrit le sous-ensemble des entités <typent> de type géométrique <typgeo>  pour lesquelles <val> définit des valeurs. Quelque soit la taille du profil, <nbelem> indique la taille du champ sans profil. En effet la taille du profil utilisé est connue depuis l'écriture du profil et le profil doit exister avant l'appel à MEDchampEcr/efchae. Les profils utilisés par un ensemble de champs doivent être stockés dans le même fichier que ces champs.
L'utilisation conjointe des deux modes de sélection est possible. Il est possible d'utiliser les deux modes de sélection et une localisation des points de Gauss.

Le paramètre <pflmod> permet la sélection en mémoire des valeurs relatives au <profil> selon deux modes :
  1. MED_COMPACT : Seules les valeurs relatives aux <profil> sont en mémoire. Les points de Gauss apparaissent  normalement en mémoire. L'entrelacement est pris en compte.
  2. MED_GLOBAL (en test) : La totalité des valeurs du champ sont en mémoire. MED s'occupe de sélectionner les valeurs en fonction des numéros indiqués à l'écriture du profil (MEDprofilEcr/efpfle). Les points de Gauss apparaissent  normalement en mémoire. L'entrelacement est pris en compte.
L'ensemble de numéros d'entités utilisé pour définir le profil utilise la numérotation implicite (ordre d'apparition des entités par index croissant) des entités. Elle ne prend pas en compte l'écriture des numéros optionnels d'entités (MEDnumEcr/efnume).

Définition des points de Gauss

Remarques

Lecture du nombre de champs dans un fichier

Interface C

Interface FORTRAN

Description

Retourne le nombre de champ dans le fichier si "ind" est égal à 0 ou le nombre de composantes du champ correspondant à l'indice "ind".

Remarques

Pour un fichier contenant "N" champs, la valeur de "ind" peut aller de 1 à "N".

Lecture des informations sur un champ

Interface C

Interface FORTRAN

Description

Retourne les informations propres à l'identification d'un champ :

Remarques

Lecture du nombre de pas de temps dans un champ

Interface C

Interface FORTRAN

Description

Cette routine permet de découvrir pour le champ <cha> (précédemment identifié par MEDchampInfo/efchai) l'existence de valeurs sur les entités <typent> de type géométrique <typegeo> :

Gestion des étapes de calcul et/ou de plusieurs maillages associés

Pour la suite des traitements, différents cas d'utilisation se présentent selon les choix opérés :

Remarques

Lecture des informations sur un pas de temps

Interface C

Interface FORTRAN

Description

Lecture des informations caractérisant une séquence de calcul (pas de temps, numéro d'ordre) :

Gestion des étapes de calcul et/ou de plusieurs maillages associés

Pour la suite des traitements, différents cas d'utilisation se présentent selon les choix opérés :

  1. L'ensemble de vos interlocuteurs ne gére pas les références multiples aux maillages ou votre propre code n'est pas en mesure de les traiter :
  2. Vous gérez les références multiples aux maillages dans une même séquence de calcul :

Remarques

Lecture du nombre de maillage référencés dans une séquence de calcul

Interface C

Paramètres :

Interface FORTRAN


Description

Cette routine renvoie le nombre de maillages associés au champ <cha> sur les entités <typent> de type géométrique <typgeo> à l'étape de calcul (<numdt>,<numo>).

Remarques

Lecture du nombre de valeurs dans un champ

Interface C

Interface FORTRAN

Description

Retourne le nombre de valeurs du champ <cha> à l'étape de calcul (<numdt>,<numo>) sur les entités <tyent> de type géométrique <typgeo> du maillage <maa>.

Si un profil existe pour ce champ, cette routine calcule le nombre de valeurs pour une future lecture en mode :

  1. MED_COMPACT : Seules les valeurs relatives au <profil> (renvoyé par MEDchampLire/efchal ) seront en mémoire. Si aucun profil n'existe l'appel est équivalent à MED_GLOBAL.
  2. MED_GLOBAL : La totalité des valeurs du champ seront lues en mémoire. La routine MEDchampLire/efchal s'occupera de placer en mémoire les valeurs en fonction des numéros indiqués par le  <profil>.

Si vous ne gérez pas les références multiples aux maillages :

Remarques

Lecture des valeurs dans un champ

Interface C

Interface FORTRAN

Description

Lecture des valeurs dans un champ de résultat :

Lecture des valeurs du champ pour différentes étapes de calcul

Entrelacement des données en mémoire

Si le champ a plus d'une composante, il est possible de définir le mode de représentation mémoire attendu :

  1. MED_FULL_INTERLACE : Les différentes composantes d'une entité apparaissent avant celles de l'entité suivante (X1Y1Z1X2Y2Z2.....).
  2. MED_NO_INTERLACE : Les composantes de n°i de toutes les entités apparaissent avant celles de n°i+1 (X1X2....Y1Y2....Z1Z2...).

Maillage local ou distant

Lecture d'une composante et/ou d'un sous-ensemble d'entités de même type géométrique (profil)

Il est possible de lire uniquement une composante et/ou un sous ensemble d'entités :

  1. Lecture d'une composante : Le paramètre <numco> indique  le numéro de la composante à lire parmi les composantes disponibles. Même pour la relecture d'une seule composante, <val> doit avoir un emplacement mémoire réservé pour toutes les composantes. Le mot clé  MED_ALL sélectionne toutes les composantes. Par appels successifs à la routine il est possible de lire les différentes composantes. Cette sélection prend en compte le mode de stockage <modswt> utilisé en mémoire.
  2. Lecture d'un sous-ensemble d'entités de même type géométrique. Si le champ à été préalablement écrit avec un profil  le nom du <profil> est retourné. Il décrit le sous-ensemble des entités <typent> de type géométrique <typgeo>  pour lesquelles <val> contient des valeurs.  Les profils utilisés par un ensemble de champs doivent être stockés dans le même fichier que ces champs.

L'utilisation conjointe des deux modes de sélection est possible. Il est également possible d'utiliser les deux modes de sélection et une localisation des points de Gauss.

Le paramètre <pflmod> permet l'enregistrement en mémoire des valeurs relatives au <profil> selon deux modes :

  1. MED_COMPACT :
  2. MED_GLOBAL (en test) :
L'ensemble de numéros d'entités utilisé pour définir le profil utilise la numérotation implicite (ordre d'apparition des entités par index croissant) des entités. Elle ne prend pas en compte l'écriture des numéros optionnels d'entités.

Lecture des valeurs aux points de Gauss


Remarques

Précisions supplémentaires sur les paramètres :

Lecture des information sur un maillage référencé dans une séquence de calcul

Interface C

Interface FORTRAN

Description

La routine MEDchampRefInfo/efrefi permet d'identifier un maillage référencé dans une séquence de calcul. Les données lues sont :

Remarques

Ecriture d'un lien sur fichier distant dans un fichier

Interface C

Interface FORTRAN

Description

Cette routine permet de référencer le fichier <lienval> comme étant celui qui porte le maillage <maa>.

Remarques

Lecture du nombre de lien sur fichier distant dans un fichier

Interface C

Interface FORTRAN

Description

Cette routine renvoie le nombre de lien sur fichier distant dans un fichier.

Remarques

Lecture des informations sur un lien sur fichier distant

Interface C

Interface FORTRAN

Description

Cette routine lit les informations sur un lien sur fichier distant. Les informations lues sont :

Remarques

Lecture de la taille d'un lien sur fichier distant

Interface C


Interface FORTRAN

Description

Cette routine permet de connaître la taille du lien associée au maillage distant <maa>.

Remarques

Lecture d'un lien sur fichier distant dans un fichier

Interface C


Interface FORTRAN

Description

Permet de lire le lien <lienval> associé au maillage distant <maa>.

Remarques