# Guide de référence du module fortran MEDequivalence

## Fonctions

subroutine | meqcre (fid, maa, eq, des, cret)
| Cette routine permet la création d'une équivalence portant sur les entités d'un maillage.
subroutine | meqcow (fid, maa, eq, numdt, numit, typent, typgeo, n, corr, cret)
| Cette routine permet d'écrire un tableau de correspondances entre les entités d'un maillage dans une équivalence pour une séquence de calcul et un type d'entité donnés.
subroutine | meqneq (fid, maa, n, cret)
| Cette routine permet de lire le nombre d'équivalence dans un fichier.
subroutine | meqeqi (fid, maa, ind, eq, des, nstep, nctcor, cret)
| Cette routine permet lire les informations d'une équivalence portant sur les entités d'un maillage.
subroutine | meqcsz (fid, maa, eq, numdt, numit, typent, typgeo, n, cret)
| Cette routine permet de lire le nombre de correspondances dans une équivalence pour une séquence de calcul et un type d'entité donnés.
subroutine | meqszi (fid, maa, eq, numdt, numit, corit, typent, typgeo, n, cret)
| Cette routine permet de lire les informations relatives à un tableau de correspondances dans une équivalence pour une séquence de calcul donnée.
subroutine | meqcor (fid, maa, eq, numdt, mumit, typent, typgeo, corr, cret)
| Cette routine permet de lire un tableau de correspondances entre les entités d'un maillage dans une équivalence pour une séquence de calcul et un type d'entité donnés.
subroutine | meqcsi (fid, maa, eq, ind, numdt, numit, ncor, cret)
| Cette routine permet de lire les informations relatives à une équivalence pour une séquence de calcul donnée.

## Documentation des fonctions

subroutine meqcor | ( | integer | fid,
|  | character *(*) | maa,
|  | character *(*) | eq,
|  | integer | numdt,
|  | integer | numit,
|  | integer | typent,
|  | integer | typgeo,
|  | integer:dimension(*) | corr,
|  | integer | cret |
| ) |  |  |

Cette routine permet de lire un tableau de correspondances entre les entités d'un maillage dans une équivalence pour une séquence de calcul et un type d'entité donnés.

Paramètres:

  | fid | Identificateur du fichier.
  | maa | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | eq | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | numdt | Numéro de pas de temps de la séquence de calcul (MED_NO_DT si pas de pas de temps).
  | numit | Numéro d'itération de la séquence de calcul (MED_NO_IT si pas de numéro d'itération).
  | typent | Type d'entité (med_entity_type).
  | typgeo | Type géométrique de l'entité (med_geometry_type).
  | corr | Tableau de correspondances sur les entités.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet de lire un tableau de correspondances entre les entités d'un maillage dans une équivalence pour une séquence de calcul et un type d'entité donnés. Le tableau des correspondances est un tableau à 1 dimension où les correspondances sont rangées 2 à 2. Le type géométrique peut être :

- Pour les noeuds (MED_NODE) : MED_NONE.
- Pour les mailles (MED_CELL) : MED_POINT1, MED_SEG2, MED_SEG3, MED_SEG4, MED_TRIA3, MED_TRIA6, MED_TRIA7, MED_QUAD4, MED_QUAD8, MED_QUAD9, MED_POLYGON.
- Pour les faces (MED_DESCENDING_FACE) : MED_TRIA3, MED_TRIA6, MED_TRIA7, MED_QUAD4, MED_QUAD8, MED_QUAD9, MED_POLYGON.
- Pour les arêtes (MED_DESCENDING_EDGE) : MED_SEG2, MED_SEG3, MED_SEG4.

Définition à la ligne 136 du fichier medequivalence.f.

subroutine meqcow | ( | integer | fid,
|  | character *(*) | maa,
|  | character *(*) | eq,
|  | integer | numdt,
|  | integer | numit,
|  | integer | typent,
|  | integer | typgeo,
|  | integer | n,
|  | integer:dimension(*) | corr,
|  | integer | cret |
| ) |  |  |

Cette routine permet d'écrire un tableau de correspondances entre les entités d'un maillage dans une équivalence pour une séquence de calcul et un type d'entité donnés.

Paramètres:

  | fid | Identificateur du fichier.
  | maa | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | eq | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | numdt | Numéro de pas de temps de la séquence de calcul (MED_NO_DT si pas de pas de temps).
  | numit | Numéro d'itération de la séquence de calcul (MED_NO_IT si pas de numéro d'itération).
  | typent | Type d'entité (med_entity_type).
  | typgeo | Type géométrique de l'entité (med_geometry_type).
  | n | Nombre de correspondance.
  | corr | Tableau de correspondances sur les entités.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet d'écrire un tableau de correspondances entre les entités d'un maillage dans une équivalence pour une séquence de calcul et un type d'entité donnés. Le tableau des correspondances est un tableau à 1 dimension où les correspondances sont rangées 2 à 2. Le type géométrique peut être :

- Pour les noeuds (MED_NODE) : MED_NONE.
- Pour les mailles (MED_CELL) : MED_POINT1, MED_SEG2, MED_SEG3, MED_SEG4, MED_TRIA3, MED_TRIA6, MED_TRIA7, MED_QUAD4, MED_QUAD8, MED_QUAD9, MED_POLYGON.
- Pour les faces (MED_DESCENDING_FACE) : MED_TRIA3, MED_TRIA6, MED_TRIA7, MED_QUAD4, MED_QUAD8, MED_QUAD9, MED_POLYGON.
- Pour les arêtes (MED_DESCENDING_EDGE) : MED_SEG2, MED_SEG3, MED_SEG4.

Définition à la ligne 34 du fichier medequivalence.f.

subroutine meqcre | ( | integer | fid,
|  | character *(*) | maa,
|  | character *(*) | eq,
|  | character *(*) | des,
|  | integer | cret |
| ) |  |  |

Cette routine permet la création d'une équivalence portant sur les entités d'un maillage.

Paramètres:

  | fid | Identificateur du fichier.
  | maa | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | eq | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | des | Description, chaîne de caractères de taille maximum MED_COMMENT_SIZE caractères.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet la création d'une équivalence portant sur les entités d'un maillage. Une équivalence est identifiée par son nom et se voit associée une description.

Définition à la ligne 18 du fichier medequivalence.f.

subroutine meqcsi | ( | integer | fid,
|  | character *(*) | maa,
|  | character *(*) | eq,
|  | integer | ind,
|  | integer | numdt,
|  | integer | numit,
|  | integer | ncor,
|  | integer | cret |
| ) |  |  |

Cette routine permet de lire les informations relatives à une équivalence pour une séquence de calcul donnée.

Paramètres:

  | fid | Identificateur du fichier.
  | maa | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | eq | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | ind | Itérateur sur le numéro de séquence de calcul. L'itérateur commence à 1.
  | numdt | Numéro de pas de temps de la séquence de calcul (MED_NO_DT si pas de pas de temps).
  | numit | Numéro d'itération de la séquence de calcul (MED_NO_IT si pas de numéro d'itération).
  | ncor | Nombre de tableau de correspondances sur la séquence de calcul.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet de lire les informations relatives à une équivalence pour une séquence de calcul donnée. L'accès à la séquence de calcul se fait via un itérateur. Les informations lues sont :

- Le numéro de pas de temps de la séquence de calcul,
- Le numéro d'ordre de la séquence de calcul,
- Le nombre de tableau de correspondances dans cette séquence de calcul.

Définition à la ligne 154 du fichier medequivalence.f.

subroutine meqcsz | ( | integer | fid,
|  | character *(*) | maa,
|  | character *(*) | eq,
|  | integer | numdt,
|  | integer | numit,
|  | integer | typent,
|  | integer | typgeo,
|  | integer | n,
|  | integer | cret |
| ) |  |  |

Cette routine permet de lire le nombre de correspondances dans une équivalence pour une séquence de calcul et un type d'entité donnés.

Paramètres:

  | fid | Identificateur du fichier.
  | maa | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | eq | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | numdt | Numéro de pas de temps de la séquence de calcul (MED_NO_DT si pas de pas de temps).
  | numit | Numéro d'itération de la séquence de calcul (MED_NO_IT si pas de numéro d'itération).
  | typent | Type d'entité (med_entity_type).
  | typgeo | Type géométrique de l'entité (med_geometry_type).
  | n | Nombre de correspondance.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet de lire le nombre de correspondances dans une équivalence pour une séquence de calcul et un type d'entité donnés. Le type géométrique peut être :

- Pour les noeuds (MED_NODE) : MED_NONE.
- Pour les mailles (MED_CELL) : MED_POINT1, MED_SEG2, MED_SEG3, MED_TRIA3, MED_TRIA6, MED_QUAD4, MED_QUAD8, MED_POLYGON.
- Pour les faces (MED_DESCENDING_FACE) : MED_TRIA3, MED_TRIA6, MED_QUAD4, MED_QUAD8, MED_POLYGON.
- Pour les arêtes (MED_DESCENDING_EDGE) : MED_SEG2 et MED_SEG3.

Définition à la ligne 93 du fichier medequivalence.f.

subroutine meqeqi | ( | integer | fid,
|  | character *(*) | maa,
|  | integer | ind,
|  | character *(*) | eq,
|  | character *(*) | des,
|  | integer | nstep,
|  | integer | nctcor,
|  | integer | cret |
| ) |  |  |

Cette routine permet lire les informations d'une équivalence portant sur les entités d'un maillage.

Paramètres:

  | fid | Identificateur du fichier.
  | maa | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | ind | Itérateur sur les équivalences du maillage.
  | eq | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | des | Description, chaîne de caractères de taille maximum MED_COMMENT_SIZE caractères.
  | nstep | Nombre de séquence de calcul.
  | nctcor | Nombre de tableau de correspondances sur la séquence de calcul.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet lire les informations d'une équivalence portant sur les entités d'un maillage. L'accès à chaque équivalence se fait via un itérateur. Les informations lues sont :

- Le nom de l'équivalence (une équivalence est identifiée par son nom),
- La description de l'équivalence,
- Le nombre de séquence de calcul dans le maillage sur lesquelles sont dédinies des tableaux de correspondance pour cette équivalence,
- Le nombre de tableau de correspondances sur la première séquence de calcul.

Définition à la ligne 76 du fichier medequivalence.f.

subroutine meqneq | ( | integer | fid,
|  | character *(*) | maa,
|  | integer | n,
|  | integer | cret |
| ) |  |  |

Cette routine permet de lire le nombre d'équivalence dans un fichier.

Paramètres:

  | fid | Identificateur du fichier.
  | maa | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | n | Nombre d'équivalence
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet de lire le nombre d'équivalence dans un fichier.

Définition à la ligne 55 du fichier medequivalence.f.

subroutine meqszi | ( | integer | fid,
|  | character *(*) | maa,
|  | character *(*) | eq,
|  | integer | numdt,
|  | integer | numit,
|  | integer | corit,
|  | integer | typent,
|  | integer | typgeo,
|  | integer | n,
|  | integer | cret |
| ) |  |  |

Cette routine permet de lire les informations relatives à un tableau de correspondances dans une équivalence pour une séquence de calcul donnée.

Paramètres:

  | fid | Identificateur du fichier.
  | maa | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | eq | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | numdt | Numéro de pas de temps de la séquence de calcul (MED_NO_DT si pas de pas de temps).
  | numit | Numéro d'itération de la séquence de calcul (MED_NO_IT si pas de numéro d'itération).
  | corit | Itérateur sur les tableaux de correspondances. L'itérateur commence à 1.
  | typent | Type d'entité (med_entity_type).
  | typgeo | Type géométrique de l'entité (med_geometry_type).
  | n | Nombre de correspondance.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet de lire les informations relatives à un tableau de correspondances dans une équivalence pour une séquence de calcul donnée. L'accès au tableau de correspondances se fait via un itérateur, les informations lues sont : le type d'entité, le type géométrique de l'entité, le nombre de correspondances. Le type géométrique peut être :

- Pour les noeuds (MED_NODE) : MED_NONE.
- Pour les mailles (MED_CELL) : MED_POINT1, MED_SEG2, MED_SEG3, MED_SEG4, MED_TRIA3, MED_TRIA6, MED_TRIA7, MED_QUAD4, MED_QUAD8, MED_QUAD9, MED_POLYGON.
- Pour les faces (MED_DESCENDING_FACE) : MED_TRIA3, MED_TRIA6, MED_TRIA7, MED_QUAD4, MED_QUAD8, MED_QUAD9, MED_POLYGON.
- Pour les arêtes (MED_DESCENDING_EDGE) : MED_SEG2, MED_SEG3, MED_SEG4.

Définition à la ligne 117 du fichier medequivalence.f.