| 1 |
<A NAME="____Concepts et fonctionnalités avancés sur les champs de résultat____"> |
| 2 |
</A> |
| 3 |
<A HREF="#1.">Créer et lire des champs avec gestion des |
| 4 |
profils</A> |
| 5 |
</P> |
| 6 |
<P><A HREF="#2.">Lire des champs créés avec MED 2.x et |
| 7 |
définis sur plusieurs maillages</A> |
| 8 |
</P> |
| 9 |
<P><A HREF="#3.">Créer et lire un champ aux points |
| 10 |
d'intégration des éléments</A> |
| 11 |
</P> |
| 12 |
<P><A HREF="#4.">Créer et lire un champ aux noeuds des |
| 13 |
éléments</A> |
| 14 |
</P> |
| 15 |
<P><A HREF="#5.">Créer et lire un champ lié à un |
| 16 |
maillage contenant des éléments de structure </A> |
| 17 |
</P> |
| 18 |
<P><A HREF="#6.">Ecrire et lire un maillage ou un champ en filtrant |
| 19 |
les données</A> |
| 20 |
</P> |
| 21 |
<P><A HREF="#7.">Ecriture et lecture en parallèle dans un seul |
| 22 |
fichier</A> |
| 23 |
</P> |
| 24 |
<H3><A NAME="1."></A>Créer et lire des champs avec gestion des |
| 25 |
profils |
| 26 |
</H3> |
| 27 |
<P>Au même titre que pour un maillage évolutif, il est |
| 28 |
possible d'utiliser les profils pour sélectionner les valeurs |
| 29 |
des champs de résultats. Les champs ne peuvent être |
| 30 |
definis que sur une partie du maillage. Le profil d'un champ indique |
| 31 |
sur quelles entités du maillage se trouvent les valeurs.</P> |
| 32 |
<P>A l'écriture des champs, l'utilisation des profils est |
| 33 |
possible pour l'é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équence |
| 38 |
de calcul donnée. La routine \ref MEDfieldnValueWithProfile / |
| 39 |
\ref mfdnvp permet de lire le nombre de valeurs à lire en |
| 40 |
tenant compte du profil et mode de stockage des données en |
| 41 |
mé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éés avec MED 2.x |
| 46 |
et définis sur plusieurs maillages</H3> |
| 47 |
<P>Dans MED 2.x, les champs pouvaient être définis sur |
| 48 |
plusieurs maillages. Cette possibilité disparaît avec |
| 49 |
MED 3.0 et l'apparition des maillages évolutifs. MED 3.0 |
| 50 |
fournit néanmoins des routines permettant la lecture de |
| 51 |
fichier MED 2.x pouvant contenir des champs définis sur |
| 52 |
plusieurs maillages. Ces routines spécifiques sont à |
| 53 |
utiliser en lieu et place de celles utilisées dans le cas |
| 54 |
d'utilisation précédent (ces routines peuvent |
| 55 |
évidemment é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énérique |
| 60 |
pour lire les champs d'un fichier MED, basés sur un ou |
| 61 |
plusieurs maillages.</P> |
| 62 |
<P>\include test11b.c</P> |
| 63 |
<H3><A NAME="3."></A>Créer et lire un champ aux points |
| 64 |
d'intégration des éléments |
| 65 |
</H3> |
| 66 |
<P>MED fournit la possibilité d'exprimer les champs de |
| 67 |
résultat sur les points de Gauss (ou points d'intégration) |
| 68 |
des éléments d'un maillage. Dans ce cadre, il est |
| 69 |
possible de localiser ces points sur des éléments de |
| 70 |
référence en des lieux différents selon la |
| 71 |
modélisation numérique choisie. Pour chaque type de |
| 72 |
modélisation, il est possible de spécifier cette |
| 73 |
localisation sur des éléments de référence. |
| 74 |
On distingue différentes familles de points de Gauss en |
| 75 |
fonction du nombre de points d'intégration. Chaque point |
| 76 |
d'intégration est localisé au sein d'un élément |
| 77 |
de référence par ses coordonnées et se voit |
| 78 |
associer un poids. |
| 79 |
</P> |
| 80 |
<P>La localisation des points de Gauss pour un élément |
| 81 |
de référence nécessite donc de connaître |
| 82 |
le type géométrique de l'élément, les |
| 83 |
coordonnées des noeuds de l'élément, les |
| 84 |
coordonnées et le poids de chaque point de Gauss. L'expression |
| 85 |
des coordonnées d'un élément de référence |
| 86 |
peut se faire dans un repère de coordonnées dont la |
| 87 |
dimension est supérieure à celle de l'élément |
| 88 |
de référence. La référence à un |
| 89 |
élément de référence se fait à |
| 90 |
l'appel des routines d'écriture et lecture des valeurs des |
| 91 |
champs. |
| 92 |
</P> |
| 93 |
<P>Si les points de Gauss se confondent avec les noeuds de l'élément, |
| 94 |
il est inutile de créer une localisation factice avec des |
| 95 |
poids qui ne signifient rien et des coordonnées des points de |
| 96 |
Gauss identiques à celles des noeuds. Dans ce cas de figure, |
| 97 |
il faut utiliser le mot clé réservé \ref |
| 98 |
MED_GAUSS_ELNO à l'écriture des valeurs d'un champ pour |
| 99 |
indiquer le type de localisation.</P> |
| 100 |
<P>Il est possible pour une même type géométrique |
| 101 |
d'élément d'associer plusieurs éléments |
| 102 |
de référence. Il suffit pour cela d'associer chaque |
| 103 |
localisation avec un profil lors de l'appel d'écriture et |
| 104 |
lecture des valeurs des champs.</P> |
| 105 |
<P>MED permet é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é. |
| 108 |
Chacune des interpolations est décrite par des fonctions de |
| 109 |
forme polynomiales. Le nombre de variable des fonctions de forme est |
| 110 |
égale à la dimension de l'espace de la maille de |
| 111 |
référence utilisée pour le construire. Il est |
| 112 |
donc possible d'associer à un champ plusieurs interpolations |
| 113 |
définies sur des mailles de référence des |
| 114 |
différents types géométriques du maillage de |
| 115 |
calcul sur lequel repose le champ de résultat.</P> |
| 116 |
<P>L'écriture des fonctions de forme et des familles |
| 117 |
d'interpolation est optionnelle pour échanger des champs aux |
| 118 |
points d'intégration. |
| 119 |
</P> |
| 120 |
<P>A l'écriture, la création d'un élément |
| 121 |
de référence se fait avec la routine \ref |
| 122 |
MEDlocalizationWr / \ref mlclow. Un élément de |
| 123 |
référence peut être associé à une |
| 124 |
famille d'interpolation. La création d'une fonction |
| 125 |
d'interpolation se fait avec la routine \ref MEDinterpBaseFunctionWr |
| 126 |
/ \ref mipcre. L'é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 à un champ résultat.</P> |
| 130 |
<P>Le cas d'utilisation suivant montre un exemple d'écriture |
| 131 |
des valeurs des champs aux points de Gauss avec définition des |
| 132 |
éléments de référence et référence |
| 133 |
à 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 à un élément |
| 138 |
de référence dont on connaît le nom. Une autre |
| 139 |
possibilité est de lire le nombre d'élément de |
| 140 |
référence avec la routine \ref MEDnLocalization / \ref |
| 141 |
mlcnlc et d'itérer afin de récupérer à |
| 142 |
chaque itération les informations relatives à l'élément |
| 143 |
de référence avec la routine \ref MEDlocalizationInfo / |
| 144 |
\ref mlclci et lire l'élément de réfé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éristiques |
| 148 |
de la fonction d'interpolation dont on connaît le nom. Il est |
| 149 |
également possible de lire le nombre de famille |
| 150 |
d'interpolation avec la routine \ref MEDnInterp / \ref mipnip et |
| 151 |
d'itérer sur ces familles. Ces deux fonctions renvoie le |
| 152 |
nombre de fonctions de forme. Il reste donc à itérer |
| 153 |
sur chacune d'entre elles et d'appeler la routine \ref |
| 154 |
MEDinterpBaseFunctionRd / \ref mipbfr pour lire chaque polynôme.</P> |
| 155 |
<P>Dans un champ de résultat, il est possible de lire le |
| 156 |
nombre de famille d'interpolation associé aux champ avec la |
| 157 |
routine \ref MEDfieldnInterp / \ref mfdnin . En ité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énérique |
| 161 |
pour lire des champs aux points de Gauss dé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é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î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érative.</P> |
| 172 |
<P>\include UsesCase_MEDinterp_3.c</P> |
| 173 |
<H3><A NAME="4."></A>Créer et lire un champ aux noeuds des |
| 174 |
éléments</H3> |
| 175 |
<P>MED permet d'écrire et lire des champs aux noeuds des |
| 176 |
éléments d'un maillage. Pour cela, il suffit d'indiquer |
| 177 |
le mot clé \ref MED_NODE_ELEMENT comme type d'entité |
| 178 |
lors de l'appel des routines d'é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éer |
| 183 |
et lire un champ lié à un maillage contenant des |
| 184 |
éléments de structure |
| 185 |
</H3> |
| 186 |
<P>Au même titre que pour types d'éléments |
| 187 |
pré-définis dans le modèle MED, MED permet |
| 188 |
l'écriture et la lecture de champs sur les éléments |
| 189 |
de structure. Pour cela, il suffit d'indiquer le mot clé \ref |
| 190 |
MED_STRUCT_ELEMENT comme type d'entité lors de l'appel des |
| 191 |
routines d'é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 également possible de définir des champs aux |
| 196 |
points d'intégration des éléments de structure. |
| 197 |
Dans ce cas là, l'élément de référence |
| 198 |
est déjà décrit à la définition de |
| 199 |
l'élément de structure. Les coordonnées des |
| 200 |
points d'intégration y sont relatives. Il est possible |
| 201 |
d'indiquer l'utilisation d'un maillage support définissant une |
| 202 |
section du modèle d'élément de structure. Ce |
| 203 |
maillage support est alors utilisé comme section de l'élément |
| 204 |
de structure à chaque point d'intégration. Auquel cas |
| 205 |
un champ utilisant cette localisation définira autant de |
| 206 |
valeur par élément qu'il y a de maille dans le maillage |
| 207 |
section de chaque point d'inté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ées</H3> |
| 213 |
<P>Dans MED, un filtre de données peut être utilisé |
| 214 |
pour contrôler un sous-ensemble d'entités concernées |
| 215 |
par un appel à l'API. |
| 216 |
</P> |
| 217 |
<P>En mode séquentiel, la routine \ref MEDfilterEntityCr / |
| 218 |
\ref mfrcre permet de créer un filtre élémentaire |
| 219 |
en sélectionnant les entités pour lesquelles on veut |
| 220 |
lire/écrire des valeurs. Cette sélection permet une |
| 221 |
lecture/écriture avancée vers/depuis les emplacements |
| 222 |
mémoire sélectionnés. Elle s'utilise uniquement |
| 223 |
en mode séquentiel (un seul processus).</P> |
| 224 |
<P>Une fois créé un filtre peut être passé |
| 225 |
en arguments aux routines avancées de l'API. Ces routines ne |
| 226 |
manipuleront que les données filtrées. Ces routines |
| 227 |
avancées sont celles qui permettent d'écrire et lire |
| 228 |
les coordonnées des noeuds, la connectivité des |
| 229 |
éléments d'un maillage non structuré, les |
| 230 |
valeurs des champs de ré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é-allouer |
| 238 |
avec la routine \ref MEDfilterDeAllocate / \ref mfrdea. |
| 239 |
</P> |
| 240 |
<H3><A NAME="7."></A>Ecriture et lecture en parallèle dans un |
| 241 |
seul fichier</H3> |
| 242 |
<P>En mode parallèle, le filtre est un moyen de définir |
| 243 |
le domaine concerné par chacun des processeurs. Les écritures |
| 244 |
et lectures peuvent donc se faire en parallèle entre plusieurs |
| 245 |
processeurs dans un seul et même fichier MED. |
| 246 |
</P> |
| 247 |
<P>La routine \ref MEDfilterBlockOfEntityCr / \ref mfrblc permet de |
| 248 |
créer un filtre en sélectionnant les entités par |
| 249 |
blocs continus de taille constante pour lesquelles on veut |
| 250 |
lire/écrire des valeurs. Cette sélection permet une |
| 251 |
lecture/écriture avancée vers/depuis les emplacements |
| 252 |
mémoire sélectionnés. Elle s'utilise aussi bien |
| 253 |
en mode séquentiel qu'en mode parallèle (un ou |
| 254 |
plusieurs processus).</P> |
| 255 |
<P>Dans ce cadre d'utilisation, le fichier doit être ouvert |
| 256 |
avec la routine \ref MEDparFileOpen / mfipfo.</P> |
| 257 |
<P>L'exemple suivant montre un cas d'utilisation en parallèle |
| 258 |
en écriture et lecture de champs de résultats.</P> |
| 259 |
<P>\include filterBlockOfentities.c</P> |
| 260 |
<P><BR><BR> |
| 261 |
</P> |