Debian Codegraph @

doc/html/maillage_utilisateur.html

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