Debian Codegraph @

doc/html/champ_avances.html

raw
1 <A NAME="____Concepts et fonctionnalit&eacute;s avanc&eacute;s sur les champs de r&eacute;sultat____">
2 </A>
3 <A HREF="#1.">Cr&eacute;er et lire des champs avec gestion des
4 profils</A>
5 </P>
6 <P><A HREF="#2.">Lire des champs cr&eacute;&eacute;s avec MED 2.x et
7 d&eacute;finis sur plusieurs maillages</A>
8 </P>
9 <P><A HREF="#3.">Cr&eacute;er et lire un champ aux points
10 d'int&eacute;gration des &eacute;l&eacute;ments</A>
11 </P>
12 <P><A HREF="#4.">Cr&eacute;er et lire un champ aux noeuds des
13 &eacute;l&eacute;ments</A>
14 </P>
15 <P><A HREF="#5.">Cr&eacute;er et lire un champ li&eacute; &agrave; un
16 maillage contenant des &eacute;l&eacute;ments de structure </A>
17 </P>
18 <P><A HREF="#6.">Ecrire et lire un maillage ou un champ en filtrant
19 les donn&eacute;es</A>
20 </P>
21 <P><A HREF="#7.">Ecriture et lecture en parall&egrave;le dans un seul
22 fichier</A>
23 </P>
24 <H3><A NAME="1."></A>Cr&eacute;er et lire des champs avec gestion des
25 profils
26 </H3>
27 <P>Au m&ecirc;me titre que pour un maillage &eacute;volutif, il est
28 possible d'utiliser les profils pour s&eacute;lectionner les valeurs
29 des champs de r&eacute;sultats. Les champs ne peuvent &ecirc;tre
30 definis que sur une partie du maillage. Le profil d'un champ indique
31 sur quelles entit&eacute;s du maillage se trouvent les valeurs.</P>
32 <P>A l'&eacute;criture des champs, l'utilisation des profils est
33 possible pour l'&eacute;criture des valeurs du champ avec les
34 routines \ref MEDfieldValueWithProfileWr / \ref mfdrpw, \ref mfdipw.</P>
35 <P>\include UsesCase_MEDfield_7.c</P>
36 <P>A la lecture, la routine \ref MEDfieldnProfile / \ref mfdnpf
37 permet de lire le nombre de profil dans un champ pour une s&eacute;quence
38 de calcul donn&eacute;e. La routine \ref MEDfieldnValueWithProfile /
39 \ref mfdnvp permet de lire le nombre de valeurs &agrave; lire en
40 tenant compte du profil et mode de stockage des donn&eacute;es en
41 m&eacute;moire (\ref MED_GLOBAL_STMODE ou \ref MED_COMPACT_STMODE).
42 Les routines \ref MEDfieldValueWithProfileRd / \ref mfdrpr, \ref
43 mfdipr permettent de lire les valeurs du champ avec ou sans profil.</P>
44 <P>\include UsesCase_MEDfield_9.c</P>
45 <H3><A NAME="2."></A>Lire des champs cr&eacute;&eacute;s avec MED 2.x
46 et d&eacute;finis sur plusieurs maillages</H3>
47 <P>Dans MED 2.x, les champs pouvaient &ecirc;tre d&eacute;finis sur
48 plusieurs maillages. Cette possibilit&eacute; dispara&icirc;t avec
49 MED 3.0 et l'apparition des maillages &eacute;volutifs. MED 3.0
50 fournit n&eacute;anmoins des routines permettant la lecture de
51 fichier MED 2.x pouvant contenir des champs d&eacute;finis sur
52 plusieurs maillages. Ces routines sp&eacute;cifiques sont &agrave;
53 utiliser en lieu et place de celles utilis&eacute;es dans le cas
54 d'utilisation pr&eacute;c&eacute;dent (ces routines peuvent
55 &eacute;videmment &eacute;galement lire des champs dans des fichiers
56 MED 3.0), il s'agit de \ref MEDfield23ComputingStepMeshInfo / \ref
57 mfdoci, \ref MEDfield23nValueWithProfile / \ref mfdonv, \ref
58 MEDfield23ValueWithProfileRd / \ref mfdorr, \ref mfdoir.</P>
59 <P>Le cas d'utilisation suivant propose une approche g&eacute;n&eacute;rique
60 pour lire les champs d'un fichier MED, bas&eacute;s sur un ou
61 plusieurs maillages.</P>
62 <P>\include test11b.c</P>
63 <H3><A NAME="3."></A>Cr&eacute;er et lire un champ aux points
64 d'int&eacute;gration des &eacute;l&eacute;ments
65 </H3>
66 <P>MED fournit la possibilit&eacute; d'exprimer les champs de
67 r&eacute;sultat sur les points de Gauss (ou points d'int&eacute;gration)
68 des &eacute;l&eacute;ments d'un maillage. Dans ce cadre, il est
69 possible de localiser ces points sur des &eacute;l&eacute;ments de
70 r&eacute;f&eacute;rence en des lieux diff&eacute;rents selon la
71 mod&eacute;lisation num&eacute;rique choisie. Pour chaque type de
72 mod&eacute;lisation, il est possible de sp&eacute;cifier cette
73 localisation sur des &eacute;l&eacute;ments de r&eacute;f&eacute;rence.
74 On distingue diff&eacute;rentes familles de points de Gauss en
75 fonction du nombre de points d'int&eacute;gration. Chaque point
76 d'int&eacute;gration est localis&eacute; au sein d'un &eacute;l&eacute;ment
77 de r&eacute;f&eacute;rence par ses coordonn&eacute;es et se voit
78 associer un poids.
79 </P>
80 <P>La localisation des points de Gauss pour un &eacute;l&eacute;ment
81 de r&eacute;f&eacute;rence n&eacute;cessite donc de conna&icirc;tre
82 le type g&eacute;om&eacute;trique de l'&eacute;l&eacute;ment, les
83 coordonn&eacute;es des noeuds de l'&eacute;l&eacute;ment, les
84 coordonn&eacute;es et le poids de chaque point de Gauss. L'expression
85 des coordonn&eacute;es d'un &eacute;l&eacute;ment de r&eacute;f&eacute;rence
86 peut se faire dans un rep&egrave;re de coordonn&eacute;es dont la
87 dimension est sup&eacute;rieure &agrave; celle de l'&eacute;l&eacute;ment
88 de r&eacute;f&eacute;rence. La r&eacute;f&eacute;rence &agrave; un
89 &eacute;l&eacute;ment de r&eacute;f&eacute;rence se fait &agrave;
90 l'appel des routines d'&eacute;criture et lecture des valeurs des
91 champs.
92 </P>
93 <P>Si les points de Gauss se confondent avec les noeuds de l'&eacute;l&eacute;ment,
94 il est inutile de cr&eacute;er une localisation factice avec des
95 poids qui ne signifient rien et des coordonn&eacute;es des points de
96 Gauss identiques &agrave; celles des noeuds. Dans ce cas de figure,
97 il faut utiliser le mot cl&eacute; r&eacute;serv&eacute; \ref
98 MED_GAUSS_ELNO &agrave; l'&eacute;criture des valeurs d'un champ pour
99 indiquer le type de localisation.</P>
100 <P>Il est possible pour une m&ecirc;me type g&eacute;om&eacute;trique
101 d'&eacute;l&eacute;ment d'associer plusieurs &eacute;l&eacute;ments
102 de r&eacute;f&eacute;rence. Il suffit pour cela d'associer chaque
103 localisation avec un profil lors de l'appel d'&eacute;criture et
104 lecture des valeurs des champs.</P>
105 <P>MED permet &eacute;galement la prise en compte des fonctions de
106 forme et des familles d'interpolation. Une famille d'interpolation
107 est l'ensemble d'interpolations disponibles pour un champ donn&eacute;.
108 Chacune des interpolations est d&eacute;crite par des fonctions de
109 forme polynomiales. Le nombre de variable des fonctions de forme est
110 &eacute;gale &agrave; la dimension de l'espace de la maille de
111 r&eacute;f&eacute;rence utilis&eacute;e pour le construire. Il est
112 donc possible d'associer &agrave; un champ plusieurs interpolations
113 d&eacute;finies sur des mailles de r&eacute;f&eacute;rence des
114 diff&eacute;rents types g&eacute;om&eacute;triques du maillage de
115 calcul sur lequel repose le champ de r&eacute;sultat.</P>
116 <P>L'&eacute;criture des fonctions de forme et des familles
117 d'interpolation est optionnelle pour &eacute;changer des champs aux
118 points d'int&eacute;gration.
119 </P>
120 <P>A l'&eacute;criture, la cr&eacute;ation d'un &eacute;l&eacute;ment
121 de r&eacute;f&eacute;rence se fait avec la routine \ref
122 MEDlocalizationWr / \ref mlclow. Un &eacute;l&eacute;ment de
123 r&eacute;f&eacute;rence peut &ecirc;tre associ&eacute; &agrave; une
124 famille d'interpolation. La cr&eacute;ation d'une fonction
125 d'interpolation se fait avec la routine \ref MEDinterpBaseFunctionWr
126 / \ref mipcre. L'&eacute;criture d'une fonction de forme se fait avec
127 la routine \ref MEDinterpBaseFunctionWr / \ref mipbfw. La routine
128 \ref MEDfieldInterpWr / \ref mfdinw permet d'associer une famille
129 d'interpolation &agrave; un champ r&eacute;sultat.</P>
130 <P>Le cas d'utilisation suivant montre un exemple d'&eacute;criture
131 des valeurs des champs aux points de Gauss avec d&eacute;finition des
132 &eacute;l&eacute;ments de r&eacute;f&eacute;rence et r&eacute;f&eacute;rence
133 &agrave; une famille d'interpolation.
134 </P>
135 <P>\include UsesCase_MEDfield_10.c</P>
136 <P>A la lecture, la routine \ref MEDlocalizationInfoByName / \ref
137 mlclni permet de lire les informations relatives &agrave; un &eacute;l&eacute;ment
138 de r&eacute;f&eacute;rence dont on conna&icirc;t le nom. Une autre
139 possibilit&eacute; est de lire le nombre d'&eacute;l&eacute;ment de
140 r&eacute;f&eacute;rence avec la routine \ref MEDnLocalization / \ref
141 mlcnlc et d'it&eacute;rer afin de r&eacute;cup&eacute;rer &agrave;
142 chaque it&eacute;ration les informations relatives &agrave; l'&eacute;l&eacute;ment
143 de r&eacute;f&eacute;rence avec la routine \ref MEDlocalizationInfo /
144 \ref mlclci et lire l'&eacute;l&eacute;ment de r&eacute;f&eacute;rence
145 avec la routine \ref MEDlocalizationRd / \ref mlclor.</P>
146 <P>Pour les fonctions d'interpolation, la routine \ref
147 MEDinterpInfoByName / \ref mipiin informe des caract&eacute;ristiques
148 de la fonction d'interpolation dont on conna&icirc;t le nom. Il est
149 &eacute;galement possible de lire le nombre de famille
150 d'interpolation avec la routine \ref MEDnInterp / \ref mipnip et
151 d'it&eacute;rer sur ces familles. Ces deux fonctions renvoie le
152 nombre de fonctions de forme. Il reste donc &agrave; it&eacute;rer
153 sur chacune d'entre elles et d'appeler la routine \ref
154 MEDinterpBaseFunctionRd / \ref mipbfr pour lire chaque polyn&ocirc;me.</P>
155 <P>Dans un champ de r&eacute;sultat, il est possible de lire le
156 nombre de famille d'interpolation associ&eacute; aux champ avec la
157 routine \ref MEDfieldnInterp / \ref mfdnin . En it&eacute;rant sur
158 toutes ces familles, on peut lire le nom de chacune d'entre elles
159 avec la routine \ref MEDfieldInterpInfo / \ref mfdini.</P>
160 <P>Le cas d'utilisation suivant propose une approche g&eacute;n&eacute;rique
161 pour lire des champs aux points de Gauss d&eacute;finies sur les
162 mailles d'un maillage.</P>
163 <P>\include UsesCase_MEDfield_12.c</P>
164 <P>Le cas d'utilisation suivant montre un exemple de cr&eacute;ation
165 d'une famille d'interpolation.</P>
166 <P>\include UsesCase_MEDinterp_1.c</P>
167 <P>Le cas d'utilisation suivant montre un exemple de lecture de
168 famille d'interpolation dont on conna&icirc;t le nom.</P>
169 <P>\include UsesCase_MEDinterp_2.c</P>
170 <P>Le cas d'utilisation suivant montre un exemple de lecture de
171 famille d'interpolation par une approche it&eacute;rative.</P>
172 <P>\include UsesCase_MEDinterp_3.c</P>
173 <H3><A NAME="4."></A>Cr&eacute;er et lire un champ aux noeuds des
174 &eacute;l&eacute;ments</H3>
175 <P>MED permet d'&eacute;crire et lire des champs aux noeuds des
176 &eacute;l&eacute;ments d'un maillage. Pour cela, il suffit d'indiquer
177 le mot cl&eacute; \ref MED_NODE_ELEMENT comme type d'entit&eacute;
178 lors de l'appel des routines d'&eacute;criture / lecture des valeurs
179 des champs comme le montrent les deux cas d'utilisation suivants.</P>
180 <P>\include UsesCase_MEDfield_13.c</P>
181 <P>\include UsesCase_MEDfield_14.c</P>
182 <H3 STYLE="page-break-before: always"><A NAME="5."></A>Cr&eacute;er
183 et lire un champ li&eacute; &agrave; un maillage contenant des
184 &eacute;l&eacute;ments de structure
185 </H3>
186 <P>Au m&ecirc;me titre que pour types d'&eacute;l&eacute;ments
187 pr&eacute;-d&eacute;finis dans le mod&egrave;le MED, MED permet
188 l'&eacute;criture et la lecture de champs sur les &eacute;l&eacute;ments
189 de structure. Pour cela, il suffit d'indiquer le mot cl&eacute; \ref
190 MED_STRUCT_ELEMENT comme type d'entit&eacute; lors de l'appel des
191 routines d'&eacute;criture / lecture des valeurs des champs comme le
192 montrent les deux cas d'utilisation suivants.</P>
193 <P>\include UsesCase_MEDfield_15.c</P>
194 <P>\include UsesCase_MEDfield_16.c</P>
195 <P>Il est &eacute;galement possible de d&eacute;finir des champs aux
196 points d'int&eacute;gration des &eacute;l&eacute;ments de structure.
197 Dans ce cas l&agrave;, l'&eacute;l&eacute;ment de r&eacute;f&eacute;rence
198 est d&eacute;j&agrave; d&eacute;crit &agrave; la d&eacute;finition de
199 l'&eacute;l&eacute;ment de structure. Les coordonn&eacute;es des
200 points d'int&eacute;gration y sont relatives. Il est possible
201 d'indiquer l'utilisation d'un maillage support d&eacute;finissant une
202 section du mod&egrave;le d'&eacute;l&eacute;ment de structure. Ce
203 maillage support est alors utilis&eacute; comme section de l'&eacute;l&eacute;ment
204 de structure &agrave; chaque point d'int&eacute;gration. Auquel cas
205 un champ utilisant cette localisation d&eacute;finira autant de
206 valeur par &eacute;l&eacute;ment qu'il y a de maille dans le maillage
207 section de chaque point d'int&eacute;gration comme montrent les deux
208 cas d'utilisation suivants.</P>
209 <P>\include UsesCase_MEDfield_17.c</P>
210 <P>\include UsesCase_MEDfield_18.c</P>
211 <H3><A NAME="6."></A>Ecrire et lire un maillage ou un champ en
212 filtrant les donn&eacute;es</H3>
213 <P>Dans MED, un filtre de donn&eacute;es peut &ecirc;tre utilis&eacute;
214 pour contr&ocirc;ler un sous-ensemble d'entit&eacute;s concern&eacute;es
215 par un appel &agrave; l'API.
216 </P>
217 <P>En mode s&eacute;quentiel, la routine \ref MEDfilterEntityCr /
218 \ref mfrcre permet de cr&eacute;er un filtre &eacute;l&eacute;mentaire
219 en s&eacute;lectionnant les entit&eacute;s pour lesquelles on veut
220 lire/&eacute;crire des valeurs. Cette s&eacute;lection permet une
221 lecture/&eacute;criture avanc&eacute;e vers/depuis les emplacements
222 m&eacute;moire s&eacute;lectionn&eacute;s. Elle s'utilise uniquement
223 en mode s&eacute;quentiel (un seul processus).</P>
224 <P>Une fois cr&eacute;&eacute; un filtre peut &ecirc;tre pass&eacute;
225 en arguments aux routines avanc&eacute;es de l'API. Ces routines ne
226 manipuleront que les donn&eacute;es filtr&eacute;es. Ces routines
227 avanc&eacute;es sont celles qui permettent d'&eacute;crire et lire
228 les coordonn&eacute;es des noeuds, la connectivit&eacute; des
229 &eacute;l&eacute;ments d'un maillage non structur&eacute;, les
230 valeurs des champs de r&eacute;sultats : \ref MEDfieldValueAdvancedWr
231 / \ref mfdraw, \ref mfdiaw, \ref MEDfieldValueAdvancedRd / \ref
232 mfdrar, \ref mfdiar, \ref MEDmeshElementConnectivityAdvancedWr / \ref
233 mmhyaw, \ref MEDmeshElementConnectivityAdvancedRd / \ref mmhyar, \ref
234 MEDmeshNodeCoordinateAdvancedWr / \ref mmhcaw, \ref
235 MEDmeshNodeCoordinateAdvancedRd / \ref mmhcar.</P>
236 <P>Il est possible d'allouer un tableau de filtre avec la routine
237 \ref MEDfilterAllocate / \ref mfrall, puis de le d&eacute;-allouer
238 avec la routine \ref MEDfilterDeAllocate / \ref mfrdea.
239 </P>
240 <H3><A NAME="7."></A>Ecriture et lecture en parall&egrave;le dans un
241 seul fichier</H3>
242 <P>En mode parall&egrave;le, le filtre est un moyen de d&eacute;finir
243 le domaine concern&eacute; par chacun des processeurs. Les &eacute;critures
244 et lectures peuvent donc se faire en parall&egrave;le entre plusieurs
245 processeurs dans un seul et m&ecirc;me fichier MED.
246 </P>
247 <P>La routine \ref MEDfilterBlockOfEntityCr / \ref mfrblc permet de
248 cr&eacute;er un filtre en s&eacute;lectionnant les entit&eacute;s par
249 blocs continus de taille constante pour lesquelles on veut
250 lire/&eacute;crire des valeurs. Cette s&eacute;lection permet une
251 lecture/&eacute;criture avanc&eacute;e vers/depuis les emplacements
252 m&eacute;moire s&eacute;lectionn&eacute;s. Elle s'utilise aussi bien
253 en mode s&eacute;quentiel qu'en mode parall&egrave;le (un ou
254 plusieurs processus).</P>
255 <P>Dans ce cadre d'utilisation, le fichier doit &ecirc;tre ouvert
256 avec la routine \ref MEDparFileOpen / mfipfo.</P>
257 <P>L'exemple suivant montre un cas d'utilisation en parall&egrave;le
258 en &eacute;criture et lecture de champs de r&eacute;sultats.</P>
259 <P>\include filterBlockOfentities.c</P>
260 <P><BR><BR>
261 </P>