# Guide de référence du module MEDequivalence

## Fonctions

med_err | MEDequivalenceComputingStepInfo (const med_idt fid, const char *const meshname, const char *const equivname, const int csit, med_int *const numdt, med_int *const numit, med_int *const nocstpncorrespondence)
| Cette routine permet de lire les informations relatives à une équivalence pour une séquence de calcul donnée.
med_err | MEDequivalenceCorrespondenceRd (const med_idt fid, const char *const meshname, const char *const equivname, const med_int numdt, const med_int numit, const med_entity_type entitype, const med_geometry_type geotype, med_int *const correspondence)
| 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.
med_err | MEDequivalenceCorrespondenceSize (const med_idt fid, const char *const meshname, const char *const equivname, const med_int numdt, const med_int numit, const med_entity_type entitype, const med_geometry_type geotype, med_int *const nentity)
| 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.
med_err | MEDequivalenceCorrespondenceSizeInfo (const med_idt fid, const char *const meshname, const char *const equivname, const med_int numdt, const med_int numit, const int corit, med_entity_type *const entitype, med_geometry_type *const geotype, med_int *const nentity)
| Cette routine permet de lire les informations relatives à un tableau de correspondances dans une équivalence pour une séquence de calcul donnée.
med_err | MEDequivalenceCorrespondenceWr (const med_idt fid, const char *const meshname, const char *const equivname, const med_int numdt, const med_int numit, const med_entity_type entitype, const med_geometry_type geotype, const med_int const nentity, const med_int *const correspondence)
| 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.
med_err | MEDequivalenceCr (const med_idt fid, const char *const meshname, const char *const equivname, const char *const description)
| Cette routine permet la création d'une équivalence portant sur les entités d'un maillage.
med_err | MEDequivalenceInfo (const med_idt fid, const char *const meshname, const int equivit, char *const equivname, char *const equivdescription, med_int *const nstep, med_int *const nocstpncorrespondence)
| Cette routine permet lire les informations d'une équivalence portant sur les entités d'un maillage.
med_int | MEDnEquivalence (const med_idt fid, const char *const meshname)
| Cette routine permet de lire le nombre d'équivalence dans un fichier.

## Documentation des fonctions

med_err MEDequivalenceComputingStepInfo | ( | const med_idt | fid,
|  | const char *const | meshname,
|  | const char *const | equivname,
|  | const int | csit,
|  | med_int *const | numdt,
|  | med_int *const | numit,
|  | med_int *const | nocstpncorrespondence |
| ) |  |  |

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

Paramètres:

  | fid | Identificateur du fichier.
  | meshname | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | equivname | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | csit | 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).
  | nocstpncorrespondence | Nombre de tableau de correspondances sur la séquence de calcul.

Valeurs retournées:

  | med_err | 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 40 du fichier MEDequivalenceComputingStepInfo.c.

med_err MEDequivalenceCorrespondenceRd | ( | const med_idt | fid,
|  | const char *const | meshname,
|  | const char *const | equivname,
|  | const med_int | numdt,
|  | const med_int | numit,
|  | const med_entity_type | entitype,
|  | const med_geometry_type | geotype,
|  | med_int *const | correspondence |
| ) |  |  |

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.
  | meshname | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | equivname | 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).
  | entitype | Type d'entité (med_entity_type).
  | geotype | Type géométrique de l'entité (med_geometry_type).
  | correspondence | Tableau de correspondances sur les entités.

Valeurs retournées:

  | med_err | 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 41 du fichier MEDequivalenceCorrespondenceRd.c.

med_err MEDequivalenceCorrespondenceSize | ( | const med_idt | fid,
|  | const char *const | meshname,
|  | const char *const | equivname,
|  | const med_int | numdt,
|  | const med_int | numit,
|  | const med_entity_type | entitype,
|  | const med_geometry_type | geotype,
|  | med_int *const | nentity |
| ) |  |  |

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.
  | meshname | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | equivname | 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).
  | entitype | Type d'entité (med_entity_type).
  | geotype | Type géométrique de l'entité (med_geometry_type).
  | nentity | Nombre de correspondance.

Valeurs retournées:

  | med_err | 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 41 du fichier MEDequivalenceCorrespondenceSize.c.

med_err MEDequivalenceCorrespondenceSizeInfo | ( | const med_idt | fid,
|  | const char *const | meshname,
|  | const char *const | equivname,
|  | const med_int | numdt,
|  | const med_int | numit,
|  | const int | corit,
|  | med_entity_type *const | entitype,
|  | med_geometry_type *const | geotype,
|  | med_int *const | nentity |
| ) |  |  |

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.
  | meshname | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | equivname | 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.
  | entitype | Type d'entité (med_entity_type).
  | geotype | Type géométrique de l'entité (med_geometry_type).
  | nentity | Nombre de correspondance.

Valeurs retournées:

  | med_err | 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 42 du fichier MEDequivalenceCorrespondenceSizeInfo.c.

med_err MEDequivalenceCorrespondenceWr | ( | const med_idt | fid,
|  | const char *const | meshname,
|  | const char *const | equivname,
|  | const med_int | numdt,
|  | const med_int | numit,
|  | const med_entity_type | entitype,
|  | const med_geometry_type | geotype,
|  | const med_int const | nentity,
|  | const med_int *const | correspondence |
| ) |  |  |

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.
  | meshname | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | equivname | 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).
  | entitype | Type d'entité (med_entity_type).
  | geotype | Type géométrique de l'entité (med_geometry_type).
  | nentity | Nombre de correspondance.
  | correspondence | Tableau de correspondances sur les entités.

Valeurs retournées:

  | med_err | 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 42 du fichier MEDequivalenceCorrespondenceWr.c.

med_err MEDequivalenceCr | ( | const med_idt | fid,
|  | const char *const | meshname,
|  | const char *const | equivname,
|  | const char *const | description |
| ) |  |  |

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

Paramètres:

  | fid | Identificateur du fichier.
  | meshname | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | equivname | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | description | Description, chaîne de caractères de taille maximum MED_COMMENT_SIZE caractères.

Valeurs retournées:

  | med_err | 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 37 du fichier MEDequivalenceCr.c.

med_err MEDequivalenceInfo | ( | const med_idt | fid,
|  | const char *const | meshname,
|  | const int | equivit,
|  | char *const | equivname,
|  | char *const | equivdescription,
|  | med_int *const | nstep,
|  | med_int *const | nocstpncorrespondence |
| ) |  |  |

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

Paramètres:

  | fid | Identificateur du fichier.
  | meshname | Nom du maillage, de longueur maximum MED_NAME_SIZE .
  | equivit | Itérateur sur les équivalences du maillage.
  | equivname | Nom de l'équivalence de longueur maximum MED_NAME_SIZE .
  | equivdescription | Description, chaîne de caractères de taille maximum MED_COMMENT_SIZE caractères.
  | nstep | Nombre de séquence de calcul.
  | nocstpncorrespondence | Nombre de tableau de correspondances sur la séquence de calcul.

Valeurs retournées:

  | med_err | 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 40 du fichier MEDequivalenceInfo.c.

med_int MEDnEquivalence | ( | const med_idt | fid,
|  | const char *const | meshname |
| ) |  |  |

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

Paramètres:

  | fid | Identificateur du fichier.
  | meshname | Nom du maillage, de longueur maximum MED_NAME_SIZE .

Valeurs retournées:

  | med_int | Nombre d'équivalence

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

Définition à la ligne 36 du fichier MEDnEquivalence.c.