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

## Fonctions

subroutine | mlclow (fid, lname, gtype, sdim, ecoo, swm, nip, ipcoo, wght, giname, isname, cret)
| Cette routine permet l'écriture dans un fichier d'un élément de référence de localisation de points d'intégration pour un type géométrique donné.
subroutine | mlcnlc (fid, n, cret)
| Cette routine permet de lire le nombre d'élements de références de localisation de points d'intégration dans un fichier.
subroutine | mlclci (fid, it, lname, gtype, sdim, nip, giname, isname, nsmc, sgtype, cret)
| Cette routine permet la lecture des informations relatives à un élement de référence de localisation de points d'intégration.
subroutine | mlclni (fid, lname, gtype, sdim, nip, giname, isname, nsmc, sgtype, cret)
| Cette routine permet la lecture des informations relatives à un élement de référence de localisation de points d'intégration.
subroutine | mlclor (fid, lname, swm, ecoo, ipcoo, wght, cret)
| Cette routine permet la lecture dans un fichier d'un élément de référence de localisation de points d'intégration pour un type géométrique donné.

## Documentation des fonctions

subroutine mlclci | ( | integer | fid,
|  | integer | it,
|  | character*(*) | lname,
|  | integer | gtype,
|  | integer | sdim,
|  | integer | nip,
|  | character*(*) | giname,
|  | character*(*) | isname,
|  | integer | nsmc,
|  | integer | sgtype,
|  | integer | cret |
| ) |  |  |

Cette routine permet la lecture des informations relatives à un élement de référence de localisation de points d'intégration.

Paramètres:

  | fid | Identificateur du fichier.
  | it | Iterateur
  | lname | Nom de la localisation, de longueur maximum MED_NAME_SIZE .
  | gtype | Type géométrique de l'entité (med_geometry_type).
  | sdim | Dimension de l'espace des coordonnées des points d'intégration.
  | nip | Nombre de points d'intégration dans l'élément de référence.
  | giname | Nom de la fonction de transformation géométrique (MED_NO_INTERPOLATION si pas de transformation).
  | isname | Nom du maillage support à la section d'élément de structure à utiliser à chaque point d'intégration (MED_NO_MESH_SUPPORT si pas de section).
  | nsmc | Nombre de maille dans le maillage support (0 si pas de section).
  | sgtype | Type géométrique des mailles du maillage support (MED_UNDEF_GEOTYPE si pas de section).
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet la lecture des informations relatives à un élement de référence de localisation de points d'intégration. L'accès à l'élément se fait via un itérateur. Les données lues sont : le nom de l'élément de localisation, le type géométrique de l'élément, la dimension de l'espace du repère des coordonnées, le nombre de points d'intégration, le nom de la transformation géométrique, le nom de maillage support à la section d'élément de structure le nombre de maille de ce maillage support et le type géométrique de ces mailles.

Définition
  Dans le cadre des échanges de champs de résultats exprimés sur des points d'intégration, MED permet la localisation de ces points dans des éléments de référence en des lieux définis par la modélisation numérique choisie.Pour chaque type de modélisation, il est possible de spécifier cette localisation sur des éléments de référence. Chaque point d'intégration est localisé au sein d'un élément de référence par ses coordonnées et se voit associer un poids.

Remarques:
  - Si les points d'intégration se confondent avec les noeuds de l'élément, il est inutile de créer une localisation factice avec des poids qui ne signifient rien et des coordonnées des points d'intégration identiques à celles des noeuds. Dans ce cas de figure, il faut utiliser mot clé réservé MED_GAUSS_ELNO comme nom de localisation (sans guillemets) à l'écriture des valeurs d'un champ.
  - Il est possible d'associer à une localisation de points d'intégration une fonction de transformation/ d'interpolation géométrique qui projette les points de la maille de référence vers ceux de la maille réelle.
  - Si le type géométrique geotype utilisé est celui d'un MED_STRUCT_ELEMENT, il est possible d'indiquer l'utilisation d'un maillage support définissant une section du modèle d'élément de structure. Ce maillage support est alors utilisé comme section de l'élément de structure à chaque point d'intégration. Auquel cas un champ utilisant cette localisation définira autant de valeur par élément qu'il y a de mailles dans le maillage section de chaque point d'intégration.

Définition à la ligne 58 du fichier medlocalization.f.

subroutine mlclni | ( | integer | fid,
|  | character*(*) | lname,
|  | integer | gtype,
|  | integer | sdim,
|  | integer | nip,
|  | character*(*) | giname,
|  | character*(*) | isname,
|  | integer | nsmc,
|  | integer | sgtype,
|  | integer | cret |
| ) |  |  |

Cette routine permet la lecture des informations relatives à un élement de référence de localisation de points d'intégration.

Paramètres:

  | fid | Identificateur du fichier.
  | lname | Nom de la localisation, de longueur maximum MED_NAME_SIZE .
  | gtype | Type géométrique de l'entité (med_geometry_type).
  | sdim | Dimension de l'espace des coordonnées des points d'intégration.
  | nip | Nombre de points d'intégration dans l'élément de référence.
  | giname | Nom de la fonction de transformation géométrique (MED_NO_INTERPOLATION si pas de transformation).
  | isname | Nom du maillage support à la section d'élément de structure à utiliser à chaque point d'intégration (MED_NO_MESH_SUPPORT si pas de section).
  | nsmc | Nombre de maille dans le maillage support (0 si pas de section).
  | sgtype | Type géométrique des mailles du maillage support (MED_UNDEF_GEOTYPE si pas de section).
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet la lecture des informations relatives à un élement de référence de localisation de points d'intégration. Un élément de référence est identifié par son nom. Les données lues sont : le type géométrique de l'élément, la dimension de l'espace du repère des coordonnées, le nombre de points d'intégration, le nom de la transformation géométrique, le nom de maillage support à la section d'élément de structure, le nombre de maille de ce maillage support et le type géométrique de ces mailles.

Définition
  Dans le cadre des échanges de champs de résultats exprimés sur des points d'intégration, MED permet la localisation de ces points dans des éléments de référence en des lieux définis par la modélisation numérique choisie.Pour chaque type de modélisation, il est possible de spécifier cette localisation sur des éléments de référence. Chaque point d'intégration est localisé au sein d'un élément de référence par ses coordonnées et se voit associer un poids.

Remarques:
  - Si les points d'intégration se confondent avec les noeuds de l'élément, il est inutile de créer une localisation factice avec des poids qui ne signifient rien et des coordonnées des points d'intégration identiques à celles des noeuds. Dans ce cas de figure, il faut utiliser mot clé réservé MED_GAUSS_ELNO comme nom de localisation (sans guillemets) à l'écriture des valeurs d'un champ.
  - Il est possible d'associer à une localisation de points d'intégration une fonction de transformation/ d'interpolation géométrique qui projette les points de la maille de référence vers ceux de la maille réelle.
  - Si le type géométrique geotype utilisé est celui d'un MED_STRUCT_ELEMENT, il est possible d'indiquer l'utilisation d'un maillage support définissant une section du modèle d'élément de structure. Ce maillage support est alors utilisé comme section de l'élément de structure à chaque point d'intégration. Auquel cas un champ utilisant cette localisation définira autant de valeur par élément qu'il y a de mailles dans le maillage section de chaque point d'intégration.

Définition à la ligne 77 du fichier medlocalization.f.

subroutine mlclor | ( | integer | fid,
|  | character*(*) | lname,
|  | integer | swm,
|  | real*8:dimension(*) | ecoo,
|  | real*8:dimension(*) | ipcoo,
|  | real*8:dimension(*) | wght,
|  | integer | cret |
| ) |  |  |

Cette routine permet la lecture dans un fichier d'un élément de référence de localisation de points d'intégration pour un type géométrique donné.

Paramètres:

  | fid | Identificateur du fichier.
  | lname | Nom de la localisation, de longueur maximum MED_NAME_SIZE .
  | swm | Mode d'entrelacement utilisé pour le stockage de valeurs med_switch_mode.
  | ecoo | Coordonnées des noeuds de l'éléments de référence.
  | ipcoo | Coordonnées des points d'intégration.
  | wght | Poids des points d'intégration.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet la lecture dans un fichier d'un élément de référence de localisation de points d'intégration pour un type géométrique donné. Un élément de référence est identifié par son nom. Les données lues sont : les coordonnées des noeuds de l'élément de référence, le coordonnées des points d'intégration, les poids associés aux points d'intégration.

Définition
  Dans le cadre des échanges de champs de résultats exprimés sur des points d'intégration, MED permet la localisation de ces points dans des éléments de référence en des lieux définis par la modélisation numérique choisie.Pour chaque type de modélisation, il est possible de spécifier cette localisation sur des éléments de référence. Chaque point d'intégration est localisé au sein d'un élément de référence par ses coordonnées et se voit associer un poids.

Remarques:
  - Si les points d'intégration se confondent avec les noeuds de l'élément, il est inutile de créer une localisation factice avec des poids qui ne signifient rien et des coordonnées des points d'intégration identiques à celles des noeuds. Dans ce cas de figure, il faut utiliser mot clé réservé MED_GAUSS_ELNO comme nom de localisation (sans guillemets) à l'écriture des valeurs d'un champ.
  - Il est possible d'associer à une localisation de points d'intégration une fonction de transformation/ d'interpolation géométrique qui projette les points de la maille de référence vers ceux de la maille réelle.
  - Si le type géométrique geotype utilisé est celui d'un MED_STRUCT_ELEMENT, il est possible d'indiquer l'utilisation d'un maillage support définissant une section du modèle d'élément de structure. Ce maillage support est alors utilisé comme section de l'élément de structure à chaque point d'intégration. Auquel cas un champ utilisant cette localisation définira autant de valeur par élément qu'il y a de mailles dans le maillage section de chaque point d'intégration.
  - Si le type géométrique geotype utilisé est celui d'un MED_STRUCT_ELEMENT, les coordonnées elementcoordinate des noeuds de l'élément de référence renvoyées sont celles des noeuds du maillage support du modèle de cet élément. En effet l'élément de référence est déjà décrit à la définition de l'élément de structure. Les coordonnées des points d'intégration y sont relatives.

Définition à la ligne 97 du fichier medlocalization.f.

subroutine mlclow | ( | integer | fid,
|  | character*(*) | lname,
|  | integer | gtype,
|  | integer | sdim,
|  | real*8:dimension(*) | ecoo,
|  | integer | swm,
|  | integer | nip,
|  | real*8:dimension(*) | ipcoo,
|  | real*8:dimension(*) | wght,
|  | character*(*) | giname,
|  | character*(*) | isname,
|  | integer | cret |
| ) |  |  |

Cette routine permet l'écriture dans un fichier d'un élément de référence de localisation de points d'intégration pour un type géométrique donné.

Paramètres:

  | fid | Identificateur du fichier.
  | lname | Nom de la localisation, de longueur maximum MED_NAME_SIZE .
  | gtype | Type géométrique de l'entité (med_geometry_type).
  | sdim | Dimension de l'espace des coordonnées des points d'intégration.
  | ecoo | Coordonnées des noeuds de l'éléments de référence.
  | swm | Mode d'entrelacement utilisé pour le stockage de valeurs med_switch_mode.
  | nip | Nombre de points d'intégration dans l'élément de référence.
  | ipcoo | Coordonnées des points d'intégration.
  | wght | Poids des points d'intégration.
  | giname | Nom de la fonction de transformation géométrique (MED_NO_INTERPOLATION si pas de transformation).
  | isname | Nom du maillage support à la section d'élément de structure à utiliser à chaque point d'intégration (MED_NO_MESH_SUPPORT si pas de section).
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet l'écriture dans un fichier d'un élément de référence de localisation de points d'intégration pour un type géométrique donné. Un élément de référence est identifié par son nom. Les données écrites sont : les coordonnées des noeuds de l'élément de référence, le coordonnées des points d'intégration, les poids associés aux points d'intégration.

Définition
  Dans le cadre des échanges de champs de résultats exprimés sur des points d'intégration, MED permet la localisation de ces points dans des éléments de référence en des lieux définis par la modélisation numérique choisie.Pour chaque type de modélisation, il est possible de spécifier cette localisation sur des éléments de référence. Chaque point d'intégration est localisé au sein d'un élément de référence par ses coordonnées et se voit associer un poids.

Remarques:
  - Si les points d'intégration se confondent avec les noeuds de l'élément, il est inutile de créer une localisation factice avec des poids qui ne signifient rien et des coordonnées des points d'intégration identiques à celles des noeuds. Dans ce cas de figure, il faut utiliser mot clé réservé MED_GAUSS_ELNO comme nom de localisation (sans guillemets) à l'écriture des valeurs d'un champ.
  - Il est possible d'associer à une localisation de points d'intégration une fonction de transformation/ d'interpolation géométrique qui projette les points de la maille de référence vers ceux de la maille réelle.
  - Si le type géométrique geotype utilisé est celui d'un MED_STRUCT_ELEMENT, il est possible d'indiquer l'utilisation d'un maillage support définissant une section du modèle d'élément de structure. Ce maillage support est alors utilisé comme section de l'élément de structure à chaque point d'intégration. Auquel cas un champ utilisant cette localisation définira autant de valeur par élément qu'il y a de mailles dans le maillage section de chaque point d'intégration.
  - Si le type géométrique geotype utilisé est celui d'un MED_STRUCT_ELEMENT, le paramètre des coordonnées des noeuds de l'élément de référence elementcoordinate n'est pas utilisé. En effet l'élément de référence est déjà décrit à la définition de l'élément de structure. Les coordonnées des points d'intégration y sont relatives.

Définition à la ligne 20 du fichier medlocalization.f.

subroutine mlcnlc | ( | integer | fid,
|  | integer | n,
|  | integer | cret |
| ) |  |  |

Cette routine permet de lire le nombre d'élements de références de localisation de points d'intégration dans un fichier.

Paramètres:

  | fid | Identificateur du fichier.
  | n | Nombre d'éléments de référence de localisation de points d'intégration dans le fichier.
  | cret | retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet de lire le nombre d'élements de références de localisation de points d'intégration dans un fichier.

Remarques
  Dans le cadre des échanges de champs de résultats exprimés sur des points d'intégration, MED permet la localisation de ces points dans des éléments de référence en des lieux définis par la modélisation numérique choisie.Pour chaque type de modélisation, il est possible de spécifier cette localisation sur des éléments de référence. Chaque point d'intégration est localisé au sein d'un élément de référence par ses coordonnées et se voit associer un poids.

Définition à la ligne 38 du fichier medlocalization.f.