## Documentation de la bibliothèque MED-fichier V2.3 : Guide de référence - Module "MED_Joint".

Sommaire de la page
- - Liste des routines Accès direct par le nom Interface C
    MEDjointCr MEDnJoint MEDjointInfo | MEDjointEcr MEDjointLire MEDjointnCorres MEDjointTypeCorres | MEDglobalNumEcr MEDglobalNumLire
| Interface FORTRAN
efjntc efnjnt efjnti | efjntl efjntl efjnco efjtco | efgnme efgnml

- Accès thématique

  Création d'un joint Interface C : MEDjointCr Interface FORTRAN : efjntc Lecture du nombre de joints associés à un maillage Interface C : MEDnJoint Interface FORTRAN : efnjnt Information à propos d'un joint Interface C : MEDjointInfo Interface FORTRAN : efjnti Ecriture d'un tableau de correspondance Interface C : MEDjointEcr Interface FORTRAN : efjnte Lecture d'un tableau de correspondance Interface C : MEDjointLire Interface FORTRAN : efjntl | Lecture du nombre de correspondances dans un joint Interface C : MEDjointnCorres Interface FORTRAN : efjnco Information sur un couple d'entités dans une correspondance Interface C : MEDjointTypeCorres Interface FORTRAN : efjtco Ecriture de la numérotation globale associées à un type d'entité Interface C : MEDglobalEcr Interface FORTRAN : efgnme Lecture de la numérotation globale associées à un type d'entité Interface C : MEDglobalLire Interface FORTRAN : efgnml

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

  # Liste des routines

  Les routines disponibles permettent de :

  - Créer un joint dans un maillage.
  - Lire le nombre de joints dans un maillage.
  - Lire les informations concernant un joint.
  - Lire le nombre de correspondance d'un type donné existant dans un joint.
  - Lire un tableau de correspondances dans un joint.
  - Ecrire un tableau de correspondances dans un joint.
  - Obtenir les informations sur les types d'entités en regard mis en correspondance dans un joint.
  - Ecrire ou lire la numerotation globale associée aux entités pour pouvoir les repérer dans le maillage global.

  # Création d'un joint

  ### Interface C

  - Nom : MEDjointCr
  - Signature :

        med_err
        MEDjointCr(med_idt fid,char *maa_lcl, char *jn, char *desc, med_int dom, char *maa_dist)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa_lcl (IN) : nom du maillage local.
    - jn (IN) : nom du joint.
    - desc (IN) : description du joint.
    - dom (IN) : numero du sous-domaine distant.
    - maa_dist (IN) : nom du sous-domaine distant.
  - Code retourné : 0 si réussite, -1 sinon.

  ### Interface FORTRAN

  - Nom : efjntc
  - Signature :

              subroutine efjntc ( fid , maalcl, jn , desc , dom,  maadst ,cret)
              character *(*) maalcl, maadst, desc, jn
              integer fid, dom, cret

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maalcl (IN) : nom du maillage local.
    - jn (IN) : nom de l'équivalence.
    - desc (IN) : description du joint.
    - dom (IN) : numero du sous-domaine distant.
    - desc (IN) : description du joint.
    - dom (IN) : numero du sous-domaine distant.
    - maa_dist (IN) : nom du sous-domaine distant.
    - cret (OUT) : : 0 si réussite, -1 sinon.

  ### Description

  Création d'un joint dans un maillage.

  ### Remarques

  - Le nom des maillages local ou distant sont des chaînes de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Le nom du joint est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - La description est une chaîne de MED_TAILLE_DESC (200) caractères.

  # Lecture du nombre de joints dans un maillage

  ### Interface C

  - Nom : MEDnJoint
  - Signature :

        med_int
        MEDnJoint(med_idt fid, char *maa)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage.
  - Code retourné : nombre de joints si réussite, -1 sinon.

  ### Interface FORTRAN

  - Nom : efnjnt
  - Signature :

              subroutine efnjnt(fid,maa,n,cret)
              character *(*) maa
              integer fid, cret, n

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage.
    - n (OUT) : nombre de joints.
    - cret (OUT) : code retour, 0 si réussite, -1 sinon.

  ### Description

  Lecture du nombre de joints dans un maillage.

  ### Remarques

  - Le nom du maillage est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).

  # Lecture des informations relatives à un joint

  ### Interface C

  - Nom : MEDjointInfo
  - Signature :

        med_err
        MEDjointInfo(int fid, char *maa_lcl, int ind, char *jn, char *desc,
                     med_int *dom, char *maa_dist)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa_lcl (IN) : nom du maillage local.
    - ind (IN) : indice du joint dans le maillage.
    - jn (OUT)) : nom du joint.
    - desc (OUT) : description du joint.
    - dom (OUT) : numero du sous-domaine distant.
    - maa_dist (OUT) : nom du maillage distant.
  - Code retourné : 0 si réussite, -1 sinon.

  ### Interface FORTRAN

  - Nom : efjnti
  - Signature :

              subroutine efjnti(fid, maalcl, ind, jn, desc, dom, maadst,cret)
              character *(*) maalcl,maadst,jn,desc
              integer fid, cret,ind,dom

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maalcl (IN) : nom du maillage local.
    - ind (IN) : indice du joint dans le maillage.
    - jn (OUT)) : nom du joint.
    - desc (OUT) : description du joint.
    - dom (OUT)) : numero du domaine distant.
    - maadst (OUT) : nom du maillage distant.
    - cret (OUT) : code retour, 0 si réussite, -1 sinon.

  ### Description

  Lecture des informations sur un joint. Les données lues sont :

  - Le nom.
  - La description.
  - Les noms des maillages local et distant auquel il se rapporte.
  - Le numéro du domaine distant.
  - Le nombre de correspondances dans le joint.

  ### Remarques

  - Le nom des maillages local et distant sont des chaînes de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Le nom du joint est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - La chaîne de description est une chaîne de MED_TAILLE_DESC (200) caractères.
  - Si un maillage contient "n" joints, les indices vont de 1 à "n".

  # Ecriture d'une correspondance dans un joint pour un type de couple d'entité en regard

  ### Interface C

  - Nom : MEDjointEcr
  - Signature :

        med_err
        MEDjointEcr(med_idt fid, char *maa, char *jn, med_int *corrtab, med_int n,
        	    med_entite_maillage typ_ent_local,   med_geometrie_element typ_geo_local,
        	    med_entite_maillage typ_ent_distant, med_geometrie_element typ_geo_distant)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage local.
    - jn (IN) : nom du joint.
    - cortab (IN) : tableau des correspondances.
    - n (IN) : nombre de correspondances dans le tableau.
    - typ_ent_local (IN) : type des entités du sous-domaine local mises en correspondance .
    - typ_geo_local (IN) : type géométrique des entités du sous-domaine local.
    - typ_ent_distant (IN) : type des entités du sous-domaine en vis à vis mises en correspondance.
    - typ_geo_distant (IN) : type géométrique des entités du sous-domaine en vis à vis
  - Code retourné : 0 si réussite, -1 sinon.

  ### Interface FORTRAN

  - Nom : efjnte
  - Signature :

              subroutine efjnte ( fid , maalcl , jn , corrtab, n,
                                  entlcl, geolcl, entdst, geodst,
                                  cret)
              character *(*) maalcl, jn, corr
              integer n, fid, dom, cret, corrtab(*)
              integer entlcl, entdst, geolcl, geodst
              integer edfjcol

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maalcl (IN) : nom du maillage local.
    - jn (IN) : nom du joint.
    - cortab (IN) : tableau des correspondances.
    - n (IN) : nombre de correspondances dans le tableau.
    - entlcl (IN) : type des entités du sous-domaine local mises en correspondance .
    - geolcl (IN) : type géométrique des entités du sous-domaine local.
    - entdst (IN) : type des entités du sous-domaine en vis à vis mises en correspondance.
    - geodst (IN) : type géométrique des entités du sous-domaine en vis à vis
    - cret (OUT) : code de retour, 0 si réussite, -1 sinon.

  ### Description

  Ecriture du contenu d'une correspondance dans un joint pour les couples de type passés en paramètres.

  ### Remarques

  - Le nom du maillages local est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Les noms du joint et de la correspondance sont des chaînes de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Si un joint contient "n" correspondances, les indices vont de 1 à "n".
  - Le tableau des correspondances "corrtab" est un tableau à 1 dimension de taille égale à "2 * n". Les correspondances y sont rangées 2 à 2.
  - Le type de l'entite "typent" est soit MED_NOEUD,MED_MAILLE, MED_FACE ou MED_ARETE.
  - Le type géométrique peut être :
    - Pour les noeuds : MED_NONE.
    - 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.

  # Lecture d'une correspondance dans un joint pour un type de couple d'entité en regard

  ### Interface C

  - Nom : MEDjointLire
  - Signature :

        med_err
        MEDjointLire(med_idt fid, char *maa, char *jn, char *corr,med_int *corrtab,med_int n,
        	         med_entite_maillage typ_ent_local,   med_geometrie_element typ_geo_local,
        	         med_entite_maillage typ_ent_distant, med_geometrie_element typ_geo_distant)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage local.
    - jn (IN) : nom du joint.
    - corr (IN) : nom de la correspondance.
    - cortab (OUT) : tableau des correspondances.
    - n (IN) : nombre de correspondances dans le tableau.
    - typ_ent_local (IN) : type des entités du sous-domaine local mises en correspondance .
    - typ_geo_local (IN) : type géométrique des entités du sous-domaine local.
    - typ_ent_distant (IN) : type des entités du sous-domaine en vis à vis mises en correspondance.
    - typ_geo_distant (IN) : type géométrique des entités du sous-domaine en vis à vis
  - Code retourné : 0 si réussite, -1 sinon.

  ### Interface FORTRAN

  - Nom : efjntl
  - Signature :

              subroutine efjntl ( fid , maalcl , jn , corr, corrtab, n ,
                                  entlcl, geolcl, entdst, geodst,
                                  cret)
              character *(*) maalcl, jn, corr
              integer n, fid, dom, cret, corrtab(*)
              integer entlcl, entdst, geolcl, geodst
              integer edfjcol

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maalcl (IN) : nom du maillage local.
    - jn (IN) : nom du joint.
    - corr (IN) : nom de la correspondance.
    - cortab (OUT) : tableau des correspondances.
    - n (IN) : nombre de correspondances dans le tableau.
    - entlcl (IN) : type des entités du sous-domaine local mises en correspondance .
    - geolcl (IN) : type géométrique des entités du sous-domaine local.
    - entdst (IN) : type des entités du sous-domaine en vis à vis mises en correspondance.
    - geodst (IN) : type géométrique des entités du sous-domaine en vis à vis
    - cret (OUT) : code de retour, 0 si réussite, -1 sinon.

  ### Description

  Lecture du contenu d'une correspondance dans un joint pour les couples de type passés en paramètres.

  ### Remarques

  - Le nom du maillages local est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Les noms du joint et de la correspondance sont des chaînes de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Si un joint contient "n" correspondances, les indices vont de 1 à "n".
  - Le tableau des correspondances "corrtab" est un tableau à 1 dimension de taille égale à "2 * n". Les correspondances y sont rangées 2 à 2.
  - Le type de l'entite "typent" est soit MED_NOEUD,MED_MAILLE, MED_FACE ou MED_ARETE.
  - Le type géométrique peut être :
    - Pour les noeuds : MED_NONE.
    - 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.

  # Lecture du nombre de correspondances dans un joint

  ### Interface C

  - Nom : MEDjointnCorres
  - Signature :

        med_int
        MEDjointnCorres (med_idt fid, char *maa, char *jn,
        		 med_entite_maillage typ_ent_local,   med_geometrie_element typ_geo_local,
        		 med_entite_maillage typ_ent_distant, med_geometrie_element typ_geo_distant)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage local.
    - jn (IN) : nom du joint.
    - typ_ent_local (IN) : type des entités du sous-domaine local mises en correspondance .
    - typ_geo_local (IN) : type géométrique des entités du sous-domaine local.
    - typ_ent_distant (IN) : type des entités du sous-domaine en vis à vis mises en correspondance.
    - typ_geo_distant (IN) : type géométrique des entités du sous-domaine en vis à vis
  - Code retourné : nombre de correspondances de ce type dans le joint.

  ### Interface FORTRAN

  - Nom : efjnco
  - Signature :

              subroutine efjnco(fid,maalcl,jn,entlcl,geolcl,entdst,geodst,nc,cret)
              character *(*) maalcl,maadst, jn
              integer fid, entlcl,geolcl,entdst,geodst,cret, n

  - Paramètres :
  - fid (IN) : descripteur du fichier MED.
  - maalcl (IN) : nom du maillage local.
  - jn (IN) : nom du joint.
  - entlcl (IN) : type des entités du sous-domaine local mises en correspondance .
  - geolcl (IN) : type géométrique des entités du sous-domaine local.
  - entdst (IN) : type des entités du sous-domaine en vis à vis mises en correspondance.
  - geodst (IN) : type géométrique des entités du sous-domaine en vis à vis
  - nc (OUT) : nombre de correspondances dans le joint.
  - cret (OUT) : code retour, 0 si réussite, -1 sinon.

  ### Description

  Lecture du nombre de correspondance dans un joint pour deux types donnés en regard.

  ### Remarques

  - Les noms des maillages local et distant sont des chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Le nom du joint est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Le type de l'entite "typent" est soit MED_NOEUD, MED_MAILLE, MED_FACE ou MED_ARETE.

  # Lecture des types en regard pour une correspondances dans un joint

  ### Interface C

  - Nom : MEDjointTypeCorres
  - Signature :

        med_err
        MEDjointTypeCorres (med_idt fid, char *maa, char *jn, med_int int,
          		    med_entite_maillage *typ_ent_local,   med_geometrie_element *typ_geo_local,
        		    med_entite_maillage *typ_ent_distant, med_geometrie_element *typ_geo_distant)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage local.
    - jn (IN) : nom du joint
    - ind (IN) : numéro de la correspondance dans le joint.
    - typ_ent_local (OUT) : type des entités du sous-domaine local mises en correspondance .
    - typ_geo_local (OUT) : type géométrique des entités du sous-domaine local.
    - typ_ent_distant (OUT) : type des entités du sous-domaine en vis à vis mises en correspondance.
    - typ_geo_distant (OUT) : type géométrique des entités du sous-domaine en vis à vis
  - Code retourné : 0 si réussite, -1 sinon.

  ### Interface FORTRAN

  - Nom : efjtco
  - Signature :

              subroutine efjtco(fid,maalcl,jn,entlcl, geolcl, entdst, geodst, cret)
              character *(*) maalcl,maadst, jn
              integer fid, entlcl,geolcl,entdst,geodst,cret, n

  - Paramètres :
  - fid (IN) : descripteur du fichier MED.
  - maalcl (IN) : nom du maillage local.
  - jn (IN) : nom du joint.
  - ind (IN) : numéro de la correspondance dans le joint.
  - entlcl (OUT) : type des entités du sous-domaine local mises en correspondance .
  - geolcl (OUT) : type géométrique des entités du sous-domaine local.
  - entdst (OUT) : type des entités du sous-domaine en vis à vis mises en correspondance.
  - geodst (OUT) : type géométrique des entités du sous-domaine en vis à vis
  - cret (OUT) : code retour, 0 si réussite, -1 sinon.

  ### Description

  Lecture du type des données en regard dans une correspondance.

  ### Remarques

  - Les noms des maillages local et distant sont des chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Le nom du joint est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Le type de l'entite "typent" est soit MED_NOEUD, MED_MAILLE, MED_FACE ou MED_ARETE.

  # Ecriture d'une numérotation globale.

  ### Interface C

  - Nom : MEDglobalNumEcr
  - Signature :

        med_err
        MEDglobalNumEcr(med_idt fid,char *maa, med_int *num, med_int n,
        	        med_entite_maillage type_ent, med_geometrie_element type_geo)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage local.
    - num (IN) : tableau des numéros.
    - n (IN) : nombre d'entités numérotées.
    - typ_ent (IN) : type des entités du sous-domaine local mises en correspondance .
    - typ_geo (IN) : type géométrique des entités du sous-domaine local.
  - Code retourné : 0 si réussite, -1 sinon.

  ### Interface FORTRAN

  - Nom : efgnme
  - Signature :

              subroutine efgnme ( fid , maa , numtab, n,
                                  ent, geo, cret)
              character *(*) maa
              integer n, fid,  cret, numtab(*)
              integer ent, geo

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage local.
    - numtab (IN) : tableau des numéros.
    - n (IN) : nombre d'entités numérotées.
    - ent (IN) : type des entités du sous-domaine local mises en correspondance .
    - geo (IN) : type géométrique des entités du sous-domaine local.
    - cret (OUT) : code de retour, 0 si réussite, -1 sinon.

  ### Description

  Ecriture d'une numérotation globale sur un maillage pour un type d'entité et un type géométrique donné.

  ### Remarques

  - Le nom du maillage local est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Le tableau des numéros "num" est un tableau à 1 dimension de taille égale à "n".
  - Les numéros globaux sont obligatoirement supérieur à 1
  - Le type de l'entite "typent" est soit MED_NOEUD,MED_MAILLE, MED_FACE ou MED_ARETE.
  - Le type géométrique peut être :
    - Pour les noeuds : MED_NONE.
    - 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.

  # Lecture d'une numérotation globale.

  ### Interface C

  - Nom : MEDglobalNumLire
  - Signature :

        med_err
        MEDglobalNumLire(med_idt fid,char *maa, med_int *num, med_int n,
        	         med_entite_maillage type_ent, med_geometrie_element type_geo)

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage local.
    - num (OUT) : tableau des numéros.
    - n (IN) : nombre d'entités numérotées.
    - typ_ent (IN) : type des entités du sous-domaine local mises en correspondance .
    - typ_geo (IN) : type géométrique des entités du sous-domaine local.
  - Code retourné : 0 si réussite, -1 sinon.

  ### Interface FORTRAN

  - Nom : efgnml
  - Signature :

              subroutine efgnml ( fid , maa , numtab, n,
                                  ent, geo, cret)
              character *(*) maa
              integer n, fid,  cret, numtab(*)
              integer ent, geo

  - Paramètres :
    - fid (IN) : descripteur du fichier MED.
    - maa (IN) : nom du maillage local.
    - numtab (OUT) : tableau des numéros.
    - n (IN) : nombre d'entités numérotées.
    - ent (IN) : type des entités du sous-domaine local mises en correspondance .
    - geo (IN) : type géométrique des entités du sous-domaine local.
    - cret (OUT) : code de retour, 0 si réussite, -1 sinon.

  ### Description

  Lecture d'une numérotation globale sur un maillage pour un type d'entité et un type géométrique donné.

  ### Remarques

  - Le nom du maillage local est une chaîne de MED_TAILLE_NOM caractères en Fortran (au plus MED_TAILLE_NOM en C).
  - Le tableau des numéros "num" est un tableau à 1 dimension de taille égale à "n".
  - Les numéros globaux sont obligatoirement supérieur à 1
  - Le type de l'entite "typent" est soit MED_NOEUD,MED_MAILLE, MED_FACE ou MED_ARETE.
  - Le type géométrique peut être :
    - Pour les noeuds : MED_NONE.
    - 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.