| 1 |
<A NAME="____Concepts et fonctionnalités de base pour créer et lire un maillage____"> |
| 2 |
</A> |
| 3 |
<A HREF="#1.">Créer un maillage non structuré</A> |
| 4 |
</P> |
| 5 |
<P><A HREF="#2.">Lire un maillage non structuré</A> |
| 6 |
</P> |
| 7 |
<P><A HREF="#3.">Créer un maillage structuré</A> |
| 8 |
</P> |
| 9 |
<P><A HREF="#4.">Lire un maillage structuré</A> |
| 10 |
</P> |
| 11 |
<P><A HREF="#5.">Créer un maillage avec des familles</A> |
| 12 |
</P> |
| 13 |
<P><A HREF="#6.">Lire un maillage avec des familles</A> |
| 14 |
</P> |
| 15 |
<H3 STYLE="font-style: normal"><A NAME="1."></A>Créer un |
| 16 |
maillage non structuré</H3> |
| 17 |
<P>La routine \ref MEDmeshCr / \ref mmhcre permet de créer un |
| 18 |
maillage dans un fichier MED. Un maillage est identifié par |
| 19 |
son nom qui est une chaîne de \ref MED_NAME_SIZE caractères |
| 20 |
(comme tous les noms d'objets du modèle). Lors de la création |
| 21 |
du maillage, il est nécessaire de préciser outre son |
| 22 |
nom, sa dimension, la dimension de l'espace de calcul, son type |
| 23 |
(structuré ou non structuré), l'unité des pas de |
| 24 |
temps et mode de tri de ces pas de temps (utile pour les maillages |
| 25 |
évolutifs), ainsi que le type de repère des |
| 26 |
coordonnées. Dans un premier temps nous ne travaillerons que |
| 27 |
sur des maillages non évolutifs.</P> |
| 28 |
<P>A minima il est nécessaire de définir pour un tel |
| 29 |
maillage les coordonnées de ses noeuds, ainsi que la |
| 30 |
connectivité de ses mailles (cf. \ref connectivites). |
| 31 |
</P> |
| 32 |
<P>L'écriture des coordonnées des noeuds d'un maillage |
| 33 |
non structuré se fait par l'intermédiaire de la routine |
| 34 |
\ref MEDmeshNodeCoordinateWr / \ref mmhcow. Cette routine permet |
| 35 |
l'écriture d'un tableau de coordonnées selon un pas de |
| 36 |
temps et/ou un numéro d'itération donnés. Comme |
| 37 |
pour d'autres routines prenant en paramètre des données |
| 38 |
multi-composantes, on peut choisir le mode de stockage de ces données |
| 39 |
en mémoire -i.e. \ref MED_FULL_INTERLACE (les composantes |
| 40 |
d'une entité apparaissent avant celles de l'entité |
| 41 |
suivante : X1Y1Z1X2Y2Z2...), ou \ref MED_NO_INTERLACE (les |
| 42 |
composantes n°i de toutes les entités apparaissent avant |
| 43 |
les composantes n°i+1 (X1X2....Y1Y2....Z1Z2...).</P> |
| 44 |
<P>La routine \ref MEDmeshElementConnectivityWr / \ref mmhcyw permet |
| 45 |
d'écrire les connectivités d'un type géométrique |
| 46 |
correspondant à un élément d'un maillage selon |
| 47 |
un pas de temps et/ou un numéro d'itération donnés. |
| 48 |
L'écriture s'effectue donc type géométrique par |
| 49 |
type géométrique pour tous les types d'élements |
| 50 |
: maille (\ref MED_CELL), face (\ref MED_DESCENDING_FACE) ou arête |
| 51 |
(\ref MED_DESCENDING_EDGE). Une maille est décrite soit par |
| 52 |
connectivité nodale (\ref MED_NODAL : liste ordonnée |
| 53 |
des numéros des noeuds), soit par connectivité |
| 54 |
descendante (\ref MED_DESCENDING : liste ordonnée des numéros |
| 55 |
des noeuds, arêtes ou faces selon la dimension de la maille |
| 56 |
considérée). A noter qu'en connectivité nodale, |
| 57 |
on ne doit écrire que les mailles, les entités faces et |
| 58 |
arêtes n'étant utilisées que pour la connectivité |
| 59 |
descendante. Dans le modèle MED, toutes les entités |
| 60 |
d'un maillage ont une numérotation globale implicite qui |
| 61 |
débute à 1. Pour les éléments, la |
| 62 |
numérotation implicite s'obtient en parcourant l'ensemble des |
| 63 |
types géométriques selon l'ordre de définition |
| 64 |
du modèle de données. La règle à |
| 65 |
appliquer pour définir la taille mémoire "T" |
| 66 |
nécessaire au stockage de la connectivité d'une entité |
| 67 |
géométrique est la suivante. Dans le cas de la |
| 68 |
connectivité nodale, on a "T" = nombre de noeuds. |
| 69 |
Dans le cas de la connectivité descendante, pour une entité |
| 70 |
de dimension 3 on a "T" = nombre de faces ; pour une entité |
| 71 |
de dimension 2, on a "T" = nombre d'arêtes, pour une |
| 72 |
entité de dimension 1, on a "T" = nombre de noeuds. |
| 73 |
</P> |
| 74 |
<P>Même si on ne définit aucun repérage sur les |
| 75 |
entités d'un maillage, il est nécessaire de créer |
| 76 |
la famille de numéro zéro qui ne comporte aucun groupe. |
| 77 |
Par défaut, toutes les entités du maillage, se |
| 78 |
rattachent à cette famille. Cette création se fait avec |
| 79 |
la routine \ref MEDfamilyCr / \ref mfacre. |
| 80 |
</P> |
| 81 |
<P>Le premier exemple suivant permet de créer dans un fichier |
| 82 |
MED, un maillage non structuré 2D.</P> |
| 83 |
<P>\include UsesCase_MEDmesh_1.c</P> |
| 84 |
<H3><A NAME="2."></A>Lire un maillage non structuré</H3> |
| 85 |
<P>Dans MED, l'accès aux objets du modèle stockés |
| 86 |
dans un fichier se fait via deux approches possibles : accès |
| 87 |
par le nom ou via un itérateur. Pour ce qui concerne les |
| 88 |
maillages, la routine \ref MEDmeshInfoByName / \ref mmhmin permet de |
| 89 |
lire les informations relatives à un maillage dont on connaît |
| 90 |
le nom. Les informations lues correspondent à celles écrites |
| 91 |
par la routine \ref MEDmeshCr / \ref mmhcre. |
| 92 |
</P> |
| 93 |
<P>Il est ensuite nécessaire pour chaque type d'entité, |
| 94 |
de lire le nombre d'éléments présents dans le |
| 95 |
maillage. Cette lecture se faite avec la routine \ref MEDmeshnEntity |
| 96 |
/ \ref mmhnme. |
| 97 |
</P> |
| 98 |
<P>Une fois les nombres d'entités connus (noeuds, mailles, et |
| 99 |
éventuellement faces et arêtes), il est nécessaire |
| 100 |
de lire les coordonnées des noeuds avec la routine \ref |
| 101 |
MEDmeshNodeCoordinateRd / \ref mmhcor et la connectivité de |
| 102 |
chacun des types géométriques d'éléments |
| 103 |
présents dans le fichier avec la routine \ref |
| 104 |
MEDmeshElementConnectivityRd / \ref mmhcyr. |
| 105 |
</P> |
| 106 |
<P>L'exemple suivant permet la lecture du maillage créé |
| 107 |
avec le premier cas d'utilisation.</P> |
| 108 |
<P>\include UsesCase_MEDmesh_2.c</P> |
| 109 |
<P>Une approche plus générique dans la lecture d'un |
| 110 |
maillage non structuré est donnée dans l'exemple |
| 111 |
suivant. La routine \ref MEDnMesh / \ref mmhnmh va lire le nombre de |
| 112 |
maillage dans le fichier. Il s'agit ensuite d'itérer sur ces |
| 113 |
maillages. La routine \ref MEDmeshInfo / \ref mmhmii permet de lire |
| 114 |
les informations relatives à un maillage à partir d'un |
| 115 |
itérateur. La routine \ref MEDmeshnAxis / \ref mmhnax permet |
| 116 |
de récupérer la dimension de l'espace de calcul en vue |
| 117 |
de dimensionner la taille des paramètres utiles à la |
| 118 |
routine MEDmeshInfo.</P> |
| 119 |
<P>Comme dans le cas précédent, il est nécessaire |
| 120 |
de lire les coordonnées des noeuds et la connectivité |
| 121 |
des mailles du maille (on se place dans le cas d'une connectivité |
| 122 |
définie en mode nodal). Les routines \ref MEDmeshnEntity / |
| 123 |
\ref mmhnme et \ref MEDmeshNodeCoordinateRd / \ref mmhcor permettent |
| 124 |
respectivement de connaître le nombre de noeuds et lire leurs |
| 125 |
coordonnées. Pour ce qui concerne la lecture de la |
| 126 |
connectivité des mailles, l'approche proposée est ici |
| 127 |
plus générique que précédemment. La |
| 128 |
routine \ref MEDmeshnEntity / \ref mmhnme est d'abord utilisée |
| 129 |
pour connaître le nombre de type géométriques de |
| 130 |
mailles présents dans le maillage. Il s'agit ensuite d'itérer |
| 131 |
sur ce nombre afin de récupérer à chaque |
| 132 |
itération : le nom et le type géométrique avec |
| 133 |
la routine \ref MEDmeshEntityInfo / \ref mmheni, le nombre d'élément |
| 134 |
avec la routine \ref MEDmeshnEntity / \ref mmhnme et le tableau de |
| 135 |
connectivité avec la routine \ref MEDmeshElementConnectivityRd |
| 136 |
/ \ref mmhcyr.</P> |
| 137 |
<P>\include UsesCase_MEDmesh_3.c</P> |
| 138 |
<H3><A NAME="3."></A>Créer un maillage structuré</H3> |
| 139 |
<P>La création d'un maillage structuré s'effectue avec |
| 140 |
la routine \ref MEDmeshCr / \ref mmhcre, en précisant qu'il |
| 141 |
s'agit d'un maillage de type \ref MED_STRUCTURED_MESH. La géométrie |
| 142 |
d'un maillage structuré est uniquement définie par ses |
| 143 |
noeuds. La connectivité entre les noeuds est de type (i,j,k) |
| 144 |
en 3D, (i,j) en 2D et (i) en 1D. On distingue 3 catégories de |
| 145 |
maillage structuré : les grilles cartésiennes définies |
| 146 |
dans un repère de coordonnées cartésien (\ref |
| 147 |
MED_CARTESIAN_GRID), les grilles définies selon un repère |
| 148 |
de coordonnées polaire (\ref MED_POLAR_GRID), et les grilles |
| 149 |
curvilignes (\ref MED_CURVILINEAR_GRID).</P> |
| 150 |
<P STYLE="margin-bottom: 0cm">Dans un maillage structuré, la |
| 151 |
connaissance des indices d'un noeud en donne la position relative. |
| 152 |
Nous adopterons le système d'indexation suivant pour ce type |
| 153 |
de maillage : |
| 154 |
</P> |
| 155 |
<P ALIGN=CENTER><IMG SRC="./png/indexation_grille.png" NAME="Image1" ALIGN=BOTTOM WIDTH=358 HEIGHT=193 BORDER=0> |
| 156 |
</P> |
| 157 |
<P>Par convention également, le noeud "origine" |
| 158 |
d'une grille a pour index (1,1,1) en 3D, (1,1) en 2D et (1) en 1D. |
| 159 |
</P> |
| 160 |
<P>Voici par exemple le résultat obtenu pour une grille "5x3". |
| 161 |
</P> |
| 162 |
<P ALIGN=CENTER><IMG SRC="./png/exemple_grille_cartesienne.png" NAME="Image2" ALIGN=BOTTOM WIDTH=620 HEIGHT=274 BORDER=0> |
| 163 |
</P> |
| 164 |
<P>Dans un maillage structuré, la numérotation des |
| 165 |
noeuds et des éléments est implicite. Considérons |
| 166 |
un maillage structuré 2D dont le premier axe comporte "n" |
| 167 |
points et le second axe "p" points : le noeud d'index (i,j) |
| 168 |
a pour numéro (i + (j-1) *n) ; l'élément d'index |
| 169 |
(i,j) (élément porté par le noeud d'index (i,j)) |
| 170 |
a pour numéro (i + (j-1) * (n-1). |
| 171 |
</P> |
| 172 |
<P ALIGN=CENTER><IMG SRC="./png/numerotation_grille.png" NAME="Image3" ALIGN=BOTTOM WIDTH=345 HEIGHT=244 BORDER=0> |
| 173 |
</P> |
| 174 |
<P>Si on reporte cette convention de numérotation des noeuds |
| 175 |
et des éléments sur notre grille "5x3", on |
| 176 |
obtient : |
| 177 |
</P> |
| 178 |
<P ALIGN=CENTER STYLE="margin-bottom: 0cm"><IMG SRC="./png/exemple_numerotation_grille.png" NAME="Image4" ALIGN=BOTTOM WIDTH=668 HEIGHT=327 BORDER=0> |
| 179 |
</P> |
| 180 |
<P><BR><BR> |
| 181 |
</P> |
| 182 |
<P>L'écriture des coordonnées d'un maillage structuré |
| 183 |
correspondant à une grille MED_CARTESIAN_GRID ou |
| 184 |
MED_POLAR_GRID ne nécessite que l'écriture des indices |
| 185 |
de coordonnées selon chacun des axes du repère de |
| 186 |
coordonnées. La routine \ref MEDmeshGridIndexCoordinateWr / |
| 187 |
\ref mmhgcw permet l'écriture des indices d'un axe donné. |
| 188 |
Cette routine doit être appelé pour chaque axe du repère |
| 189 |
de coordonnées. Pour ce qui concerne une grille |
| 190 |
MED_CURVILINEAR_GRID, il est nécessaire d'écrire toutes |
| 191 |
les coordonnées des noeuds au même titre que pour un |
| 192 |
maillage non structuré avec la routine \ref |
| 193 |
MEDmeshNodeCoordinateWr / \ref mmhcow. |
| 194 |
</P> |
| 195 |
<P>Il est inutile dans un maillage structuré d'écrire |
| 196 |
la connectivité des mailles dont la définition est |
| 197 |
implicite. Cependant ces mailles existent bien. Elles sont de type |
| 198 |
MED_POINT1 pour un maillage 0D, MED_SEG2 pour un maillage 1D, |
| 199 |
MED_QUAD4 pour un maillage 2D et MED_HEXA8 pour un maillage 3D. Il |
| 200 |
est possible d'associer à ces mailles tout comme pour les |
| 201 |
éléments d'un maillage non structuré, les |
| 202 |
attributs des entités d'un maillage : un numéro |
| 203 |
(optionnel), un nom (optionnel) de taille \ref MED_SNAME_SIZE |
| 204 |
caractères, un numéro de famille. La routine \ref |
| 205 |
MEDmeshEntityNumberWr / \ref mmhenw permet d'écrire un tableau |
| 206 |
de numéro pour un type d'entité donné. La |
| 207 |
routine \ref MEDmeshEntityNameWr / \ref mmheaw permet d'écrire |
| 208 |
un tableau de noms pour un type d'entité donné. |
| 209 |
L'écriture des noms et numéros des entités d'un |
| 210 |
maillage est optionnelle. La routine \ref MEDmeshEntityFamilyNumberWr |
| 211 |
/ \ref mmhfnw permet quant à elle l'écriture des |
| 212 |
numéros de famille. L'écriture des numéros de |
| 213 |
famille est optionnelle uniquement lorsque toutes les entités |
| 214 |
du maillage sont rattachés à la famille 0.</P> |
| 215 |
<P>\include UsesCase_MEDmesh_4.c</P> |
| 216 |
<H3><A NAME="4."></A>Lire un maillage structuré</H3> |
| 217 |
<P>Une fois le type de maillage identifié avec la routine \ref |
| 218 |
MEDmeshInfoByName / \ref mmhmin ou \ref MEDmeshInfo / \ref mmhmii, il |
| 219 |
est nécessaire de lire à quelle catégorie |
| 220 |
correspond le maillage structuré via la routine \ref |
| 221 |
MEDmeshGridTypeRd / \ref mmhgtr. Pour les grilles MED_CARTESIAN_GRID |
| 222 |
ou MED_POLAR_GRID, il est nécessaire de lire les indices de |
| 223 |
coordonnées selon chaque axes du repère de coordonnées |
| 224 |
: la routine \ref MEDmeshnEntity / \ref mmhnme permet de lire le |
| 225 |
nombre d'indices selon un axe donné, la routine \ref |
| 226 |
MEDmeshGridIndexCoordinateRd / \ref mmhgcr permet la lecture des |
| 227 |
indices de coordonnées selon les axes de coordonnées du |
| 228 |
repère. Pour ce qui concerne une grille MED_CURVILINEAR_GRID, |
| 229 |
il est nécessaire de lire toutes les coordonnées des |
| 230 |
noeuds au même titre que pour un maillage non structuré |
| 231 |
avec la routine \ref MEDmeshNodeCoordinateRd / \ref mmhcor. |
| 232 |
</P> |
| 233 |
<P STYLE="font-style: normal">L'exemple suivant permet la lecture du |
| 234 |
maillage structuré créé dans le cas |
| 235 |
d'utilisation précédent.</P> |
| 236 |
<P>\include UsesCase_MEDmesh_5.c</P> |
| 237 |
<H3><A NAME="5."></A>Créer un maillage avec des familles</H3> |
| 238 |
<P>Dans MED, les familles constituent une partition de l'ensemble des |
| 239 |
entités du maillage : chaque entité du maillage (noeud, |
| 240 |
maille, face ou arête) appartient à une seule famille. |
| 241 |
Une famille permet de repérer des zones à |
| 242 |
particulariser pour le calcul : propriétés physiques, |
| 243 |
conditions aux limites, extraction des résultats, etc. Un |
| 244 |
objet famille est identifié par son nom (chaîne de \ref |
| 245 |
MED_NAME_SIZE caractères) et son numéro. Une famille |
| 246 |
est décrite par une liste de groupes auxquels les entités |
| 247 |
de la famille appartiennent. Un groupe est identifié par une |
| 248 |
chaîne de caractères de \ref MED_LNAME_SIZE caractères.</P> |
| 249 |
<P>Une famille donnée ne peut porter que sur un seul type |
| 250 |
d'entité, une famille est donc soit (exclusif) : une famille |
| 251 |
de noeuds, une famille d'éléments |
| 252 |
(mailles/faces/arêtes). Dans un maillage MED, on trouve trois |
| 253 |
types de familles: la famille de numéro 0 qui ne comporte |
| 254 |
aucun groupe ; zéro ou plusieurs familles de noeuds dont le |
| 255 |
numéro doit être strictement positif ; zéro ou |
| 256 |
plusieurs familles d'éléments (mailles/faces/arêtes) |
| 257 |
dont le numéro doit être strictement négatif. |
| 258 |
</P> |
| 259 |
<P>La définition de la famille vide de numéro 0 est |
| 260 |
obligatoire, elle constitue la famille de référence |
| 261 |
pour tous les noeuds et les éléments qui |
| 262 |
n'appartiennent à aucun groupe. Une famille de noeuds peut |
| 263 |
porter le même nom qu'un famille d'éléments. Par |
| 264 |
contre les familles d'éléments (respectivement de |
| 265 |
noeuds) doivent toutes avoir des noms différents. La création |
| 266 |
d'une famille dans un maillage se fait à l'aide de la routine |
| 267 |
\ref MEDfamilyCr / \ref mfacre. |
| 268 |
</P> |
| 269 |
<P>Le numéro de famille est le lien existant entre la famille |
| 270 |
considérée et une entité du maillage (noeud, |
| 271 |
maille, face ou arête). Ce numéro doit être unique |
| 272 |
dans chaque maillage. La routine \ref MEDmeshEntityFamilyNumberWr / |
| 273 |
\ref mmhfnw permet l'écriture des numéros de famille |
| 274 |
pour un type d'entité donné.</P> |
| 275 |
<P>Le cas d'utilisation suivant créé dans un maillage |
| 276 |
non structuré 2D, une famille associée aux noeuds |
| 277 |
situés sur le bord du maillage. Cette famille porte le numéro |
| 278 |
1 et tous les noeuds situés au bord sont rattachés à |
| 279 |
cette famille. Les numéro de famille des autres noeuds reste à |
| 280 |
0.</P> |
| 281 |
<P>\include UsesCase_MEDmesh_10.c</P> |
| 282 |
<H3><A NAME="6."></A>Lire un maillage avec des familles</H3> |
| 283 |
<P>Pour lire un maillage MED de façon générique, |
| 284 |
il est nécessaire de lire les familles qui outre la famille 0, |
| 285 |
existent potentiellement dans le maillage. De plus pour chaque type |
| 286 |
d'entité présent dans le maillage, il est nécessaire |
| 287 |
de lire le numéro de famille.</P> |
| 288 |
<P>La routine \ref MEDnFamily / \ref mfanfa lit le nombre de famille |
| 289 |
dans un maillage. Il s'agit ensuite d'itérer sur chacune de |
| 290 |
ces familles. A chaque itération, la routine \ref |
| 291 |
MEDnFamilyGroup / \ref mfanfg permet de lire le nombre de groupe |
| 292 |
d'une famille et la routine \ref MEDfamilyInfo / \ref mfafai permet |
| 293 |
de récupérer les informations relatives à une |
| 294 |
famille : nom, numéro, liste des groupes. A noter qu'il est |
| 295 |
également possible d'utiliser la routine \ref MEDfamily23Info |
| 296 |
/ \ref mfaofi pour lire les informations relatives aux familles des |
| 297 |
fichiers MED 2.3 qui en plus des groupes pouvaient comporter une |
| 298 |
liste d'attributs entiers (notion devenue obsolète dans MED |
| 299 |
3.0), le nombre d'attribut d'une famille pouvant être récupéré |
| 300 |
avec la routine \ref MEDnFamily23Attribute / \ref mfaona.</P> |
| 301 |
<P>Il est possible de lire les numéros de famille pour chaque |
| 302 |
type d'entité du maillage avec la routine \ref |
| 303 |
MEDmeshEntityFamilyNumberRd / \ref mmhfnr. Si le tableau de numéro |
| 304 |
n'est pas présent, cela indique que toutes les entités |
| 305 |
concernées portent le numéro de famille 0.</P> |
| 306 |
<P>Le cas d'utilisation suivant offre un exemple de lecture des |
| 307 |
familles d'un maillage. |
| 308 |
</P> |
| 309 |
<P>\include UsesCase_MEDmesh_11.c</P> |
| 310 |
<P>L'exemple suivant propose une approche similaire avec les routines |
| 311 |
permettant la lecture des fichiers MED 2.3.</P> |
| 312 |
<P>\include test9.c</P> |
| 313 |
<P><BR><BR> |
| 314 |
</P> |