Documentation de la bibliothèque MED-fichier V2.2 : Guide d'utilisation - Module "MED_Equivalence".
|
Retour à la page de garde du guide utilisateur
Les routines disponibles permettent de :
- Créer une équivalence dans un maillage.
- Ecrire un tableau de correspondances entre binômes d'entités du maillage dans une équivalence.
- Lire le nombre d'équivalence dans un maillage.
- Lire les informations concernant une équivalence.
- Lire le nombre de correspondance existant dans un tableau de correspondances.
- Lire un tableau de correspondances dans une équivalence.
Ces routines sont détaillées dans le guide de référence du module "MED_Equivalence".
La routine MEDequivCr/efequc permet de créer une
équivalence dans un maillage.
Remarques :
- L'écriture des équivalences dans un maillage est optionnelle : un maillage
peut contenir de zéro à plusieurs équivalences.
- Pour chaque équivalence, il s'agit :
- De la créer.
- De lui associer des tableaux de correspondances entre les entités souhaitées.
La routine MEDequivEcr/efeque permet d'écrire un tableau de correspondance dans une
équivalence pour un type d'entité (MED_NOEUD, MED_MAILLE, MED_FACE, MED_ARETE). Si cette
entité correspond à un élément, il faut en plus préciser le type géométrique de l'élément.
Ce type géométrique peut être :
- Pour les noeuds : 0.
- Pour les mailles : MED_POINT1, MED_SEG2, MED_SEG3, MED_TRIA3, MED_TRIA6, MED_QUAD4, MED_QUAD8, MED_POLYGONE.
- Pour les faces : MED_TRIA3, MED_TRIA6, MED_QUAD4, MED_QUAD8, MED_POLYGONE.
- Pour les arêtes : MED_SEG2 et MED_SEG3.
La définition du tableau de correspondance doit respecter la convention définie
dans la rubrique
Conventions sur la définition des correspondances dans une équivalence.
La routine MEDnEquiv/efnequ permet de lire le nombre
d'équivalence dans un maillage.
Remarques :
- La présence des équivalences dans un maillage est optionnelle : un maillage
peut contenir de zéro à plusieurs équivalences.
Dès que l'on connaît le nombre d'équivalence, il est possible d'accéder
à chacune d'entre elles par l'intermédiaire d'une boucle.
Si on a "N" équivalences, cette boucle ira de 1 à N. A chaque itération,
la valeur du compteur de la boucle est un indice permettant
l'accès à une équivalence donnée.
La routine MEDequivInfo/efequi permet de lire les informations
sur une équivalence, à savoir :
Dans une équivalence donnée, l'accès aux tableaux de correspondances
se fait type d'entité par type d'entité de la manière suivante :
- Pour chaque type d'entité du maillage :
- Lire le nombre de correspondance portant sur le type d'entité dans l'équivalence.
- Si ce nombre est positif, lire le tableau des correspondances.
La routine MEDnCorres/efncor permet de lire dans une équivalence
le nombre de correspondance pour
un type d'entité (MED_NOEUD, MED_MAILLE, MED_FACE, MED_ARETE). Si cette
entité correspond à un élément, il faut en plus préciser le type géométrique de l'élément.
Ce type géométrique peut être :
- Pour les noeuds : 0.
- Pour les mailles : MED_POINT1, MED_SEG2, MED_SEG3, MED_TRIA3, MED_TRIA6, MED_QUAD4, MED_QUAD8, MED_POLYGONE.
- Pour les faces : MED_TRIA3, MED_TRIA6, MED_QUAD4, MED_QUAD8, MED_POLYGONE.
- Pour les arêtes : MED_SEG2 et MED_SEG3.
La routine MEDequivLire/efequl permet de lire un tableau de correspondance dans une
équivalence pour un type d'entité (MED_NOEUD, MED_MAILLE, MED_FACE, MED_ARETE). Si cette
entité correspond à un élément, il faut en plus préciser le type géométrique de l'élément.
Ce type géométrique peut être :
- Pour les noeuds : 0.
- Pour les mailles : MED_POINT1, MED_SEG2, MED_SEG3, MED_TRIA3, MED_TRIA6, MED_QUAD4, MED_QUAD8, MED_POLYGONE.
- Pour les faces : MED_TRIA3, MED_TRIA6, MED_QUAD4, MED_QUAD8, MED_POLYGONE.
- Pour les arêtes : MED_SEG2 et MED_SEG3.
La définition du tableau de correspondance récupéré doit respecter la convention définie
dans la rubrique
Conventions sur la définition des correspondances dans une équivalence.
Le programme suivant va :
- Créer le fichier "test12.med".
- Créer dans ce fichier un maillage non structuré.
- Créer dans ce maillage une équivalence.
- Ecrire dans l'équivalence un tableau de correspondances sur les mailles MED_TRIA3.
- Fermer le fichier "test12.med".
Accès aux sources :
Le programme suivant offre un exemple de lecture des
équivalences d'un maillage. Ce programme va :
- Ouvrir le fichier MED dont le nom est passé en argument en mode MED_LECTURE.
- Accéder au premier maillage du fichier.
- Lire le nombre d'équivalence dans ce maillage.
- Pour chaque équivalence :
- Lire les informations sur l'équivalence.
- Lire tous les tableaux de correspondance
sur les noeuds, les différents types géométriques de mailles, de faces et d'arêtes.
- Fermer le fichier MED.
Accès aux sources :
Une équivalence est une liste de correspondances 2 à 2 entre
des entités (noeuds, mailles, faces, arêtes) d'un même type. Les correspondances
entre entités sont stockées 2 à 2 en mémoire dans une équivalence : ainsi
le tableau de correspondances suivant {1,2,3,4,5,6} appliqué à des entités de type MED_TRIA3,
signifie qu'on a les 3 correspondances suivantes :
- Entre le triangle numéro 1 et le triangle numéro 2.
- Entre le triangle numéro 3 et le triangle numéro 4.
- Entre le triangle numéro 5 et le triangle numéro 6.