# Guide de référence du module MEDinterp

## Fonctions

med_int | MEDinterpBaseFunctionCoefSize (const med_idt fid, const char *const interpname, const med_int basisfuncit)
| Cette routine retourne ne nombre de coefficients/monômes de la fonction de base/forme n° basisfunctit de l'interpolation interpname.
med_err | MEDinterpBaseFunctionRd (const med_idt fid, const char *const interpname, const int basisfuncit, med_int *nbofcoef, med_int *const power, med_float *const coefficient)
| Cette routine permet la lecture d'une fonction de base/forme de l'interpolation interpname.
med_err | MEDinterpBaseFunctionWr (const med_idt fid, const char *const interpname, const med_int basisfuncit, const med_int nbofcoef, const med_int *const power, const med_float *const coefficient)
| Cette routine permet l'écriture d'une fonction de base/forme de l'interpolation interpname.
med_err | MEDinterpCr (const med_idt fid, const char *const interpname, const med_geometry_type geotype, const med_bool cellnode, const med_int nbofvariable, const med_int maxdegree, const med_int nmaxcoef)
| Cette routine permet de créer une nouvelle fonction d'interpolation polynômiale nommée interpname.
med_err | MEDinterpInfo (const med_idt fid, const int interpit, char *const interpname, med_geometry_type *const geotype, med_bool *const cellnode, med_int *const nbofbasisfunc, med_int *const nbofvariable, med_int *const maxdegree, med_int *const nmaxcoef)
| Cette fonction informe des caractéristiques de la fonction d'interpolation n° interpit.
med_err | MEDinterpInfoByName (const med_idt fid, const char *const interpname, med_geometry_type *geotype, med_bool *const cellnode, med_int *const nbofbasisfunc, med_int *const nbofvariable, med_int *const maxdegree, med_int *const nmaxcoef)
| Cette fonction informe des caractéristiques de la fonction d'interpolation nommée interpname.
med_int | MEDnInterp (const med_idt fid)
| Cette routine renvoie le nombre d'interpolations disponibles dans le fichier.

## Documentation des fonctions

med_int MEDinterpBaseFunctionCoefSize | ( | const med_idt | fid,
|  | const char *const | interpname,
|  | const med_int | basisfuncit |
| ) |  |  |

Cette routine retourne ne nombre de coefficients/monômes de la fonction de base/forme n° basisfunctit de l'interpolation interpname.

Paramètres:

  | fid | Identificateur du fichier.
  | interpname | Nom de la fonction d'interpolation
  | basisfuncit | Itérateur sur les fonctions de base/forme (>0).

Valeurs retournées:

  | Nombre | de coefficients (non null) du polynômes. Nombre de monômes de la fonction de base

Renvoie:
  retour négatif en cas d'erreur, Zéro sinon.

Cette routine retourne ne nombre de coefficients/monômes de la fonction de base/forme n° basisfunctit de l'interpolation interpname.

Voir également:
  MEDinterpBaseFunctionRd

Définition à la ligne 37 du fichier MEDinterpBaseFunctionCoeffSize.c.

med_err MEDinterpBaseFunctionRd | ( | const med_idt | fid,
|  | const char *const | interpname,
|  | const int | basisfuncit,
|  | med_int * | nbofcoef,
|  | med_int *const | power,
|  | med_float *const | coefficient |
| ) |  |  |

Cette routine permet la lecture d'une fonction de base/forme de l'interpolation interpname.

Paramètres:

  | fid | Identificateur du fichier.
  | interpname | Nom de la fonction d'interpolation
  | basisfuncit | Itérateur sur les fonctions de base/forme (>0).
  | nbofcoef | Nombre de coefficients (non null) du polynômes. Nombre de monômes de la fonction de base
  | power | Tableau des puissances des monômes d'un polynôme (taille minimum nbofcoef * nbofvariable)
  | coefficient | Tableau contenant le coefficient multiplicateur de chaque monôme (taille minimum nbofcoef)

Renvoie:
  retour négatif en cas d'erreur, Zéro sinon.

Cette routine lit la fonction de base/forme n° basisfuncit de la fonction d'inerpolation interpname. Cette fonction possède nbofcoef monômes dont les coefficients sont lus dans coefficient et les puissances dans power.

Remarques:
  - L'allocation des tableaux power et coefficient peut être faite une fois à la plus grande taille en utilisant les paramètres nmaxcoef et nbofvariable (cf. MEDinterpInfo).
  - L'allocation des tableaux power et coefficient peut être faite nbofbasisfunc fois au plus juste en appelant au préalable MEDinterpBaseFunctionCoefSize.

Définition à la ligne 41 du fichier MEDinterpBaseFunctionRd.c.

med_err MEDinterpBaseFunctionWr | ( | const med_idt | fid,
|  | const char *const | interpname,
|  | const med_int | basisfuncit,
|  | const med_int | nbofcoef,
|  | const med_int *const | power,
|  | const med_float *const | coefficient |
| ) |  |  |

Cette routine permet l'écriture d'une fonction de base/forme de l'interpolation interpname.

Paramètres:

  | fid | Identificateur du fichier.
  | interpname | Nom de la fonction d'interpolation
  | basisfuncit | Itérateur sur les fonctions de base/forme (>0).
  | nbofcoef | Nombre de coefficients (non null) du polynômes. Nombre de monômes de la fonction de base
  | power | Tableau des puissances des monômes d'un polynôme (taille minimum nbofcoef * nbofvariable)
  | coefficient | Tableau contenant le coefficient multiplicateur de chaque monôme (taille minimum nbofcoef)

Renvoie:
  retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet l'écriture de la fonction de base/forme n° basisfuncit de l'interpolation interpname. Cette fonction de base est un polynôme qui possède nbofcoef monômes dont les coefficients sont donnés dans le tableau coefficient et les puissances dans le tableau power.

Remarques:
  - Lorsque la fonction d'interpolation est contruite au noeuds d'un élément de référence, le numéro basisfuncit (>0) doit décrire le polynôme associé au noeud basisfuncit de la maille en suivant l'ordre de parcours des mailles MED.
  - L'ordre d'apparition des variables dans le tableau power suit l'ordre des axes du repère de l'espace.

Définition à la ligne 41 du fichier MEDinterpBaseFunctionWr.c.

med_err MEDinterpCr | ( | const med_idt | fid,
|  | const char *const | interpname,
|  | const med_geometry_type | geotype,
|  | const med_bool | cellnode,
|  | const med_int | nbofvariable,
|  | const med_int | maxdegree,
|  | const med_int | nmaxcoef |
| ) |  |  |

Cette routine permet de créer une nouvelle fonction d'interpolation polynômiale nommée interpname.

Paramètres:

  | fid | Identificateur du fichier.
  | interpname | Nom de la fonction d'interpolation
  | geotype | Type géométrique de l'entité (med_geometry_type).
  | cellnode | Indique si les points de construction de l'interpolation sont aux noeuds de la maille de référence
  | nbofvariable | Nombre de variables différentes apparaissant dans les polynômes (fonctions de formes/fonctions de base) C'est aussi égal à la dimension de l'espace de la maille de construction
  | maxdegree | Degré maximum de l'ensemble des polynômes (fonctions de forme/fonctions de base)
  | nmaxcoef | Nombre maximum de coefficients de l'ensemble des polynômes (fonctions de forme/fonctions de base)

Renvoie:
  retour négatif en cas d'erreur, Zéro sinon.

Cette routine permet de créer une nouvelle fonction d'interpolation polynômiale nommée interpname. Cette interpolation est adaptée à des champs reposants sur des éléments de type géométrique geotype. L'ensemble de ses fonctions de base utilisent un maximum de nbofvariable variables et un maximum de nmaxcoef coefficients et sont d'un degrée maximum maxdegree.

Voir également:
  MEDinterpBaseFunctionWr

Remarques:
  - L'utilisation directe de l'interpolation ainsi définie pour calculer la valeur d'un champ en tout point de n'importe quel élément réel n'est possible que si les valeurs du champ résultat sont données aux points de construction de la fonction d'interpolation ( cellnode doit valoir MED_TRUE ). Ce n'est généralement pas le cas lorsque le champ résultat est donnée aux points d'intégrations (cf. Guide de référence du module MEDlocalization ).
  - Lorsque cellnode vaut MED_FALSE, l'interpolation peut par exemple être utilisée pour le calcul de l'intégrale du champ.

Définition à la ligne 43 du fichier MEDinterpCr.c.

med_err MEDinterpInfo | ( | const med_idt | fid,
|  | const int | interpit,
|  | char *const | interpname,
|  | med_geometry_type *const | geotype,
|  | med_bool *const | cellnode,
|  | med_int *const | nbofbasisfunc,
|  | med_int *const | nbofvariable,
|  | med_int *const | maxdegree,
|  | med_int *const | nmaxcoef |
| ) |  |  |

Cette fonction informe des caractéristiques de la fonction d'interpolation n° interpit.

Paramètres:

  | fid | Identificateur du fichier.
  | interpit | Iterateur sur les fonctions d'interpolations
  | interpname | Nom de la fonction d'interpolation
  | geotype | Type géométrique de l'entité (med_geometry_type).
  | cellnode | Indique si les points de construction de l'interpolation sont aux noeuds de la maille de référence
  | nbofbasisfunc | Nombre de fonctions de forme/base d'une interpolation
  | nbofvariable | Nombre de variables différentes apparaissant dans les polynômes (fonctions de formes/fonctions de base) C'est aussi égal à la dimension de l'espace de la maille de construction
  | maxdegree | Degré maximum de l'ensemble des polynômes (fonctions de forme/fonctions de base)
  | nmaxcoef | Nombre maximum de coefficients de l'ensemble des polynômes (fonctions de forme/fonctions de base)

Renvoie:
  retour négatif en cas d'erreur, Zéro sinon.

Cette fonction informe des caractéristiques de la fonction d'interpolation n° interpit. La fonction interpname opère sur des champs résultats qui reposent sur des éléments de type geotype. Cette fonction est constituée d'un ensemble de nbofbasisfunc fonctions de base/forme de degrée maximum maxdegree avec un maximum de maxcoefficient monômes a nbofvariable variables. Si les points de construction de la fonction d'interpolation sont les noeuds de l'élément de référence le paramètre cellnode vaut MED_TRUE.

Voir également:
  MEDinterpInfoByName

Définition à la ligne 43 du fichier MEDinterpInfo.c.

med_err MEDinterpInfoByName | ( | const med_idt | fid,
|  | const char *const | interpname,
|  | med_geometry_type * | geotype,
|  | med_bool *const | cellnode,
|  | med_int *const | nbofbasisfunc,
|  | med_int *const | nbofvariable,
|  | med_int *const | maxdegree,
|  | med_int *const | nmaxcoef |
| ) |  |  |

Cette fonction informe des caractéristiques de la fonction d'interpolation nommée interpname.

Paramètres:

  | fid | Identificateur du fichier.
  | interpname | Nom de la fonction d'interpolation
  | geotype | Type géométrique de l'entité (med_geometry_type).
  | cellnode | Indique si les points de construction de l'interpolation sont aux noeuds de la maille de référence
  | nbofbasisfunc | Nombre de fonctions de forme/base d'une interpolation
  | nbofvariable | Nombre de variables différentes apparaissant dans les polynômes (fonctions de formes/fonctions de base) C'est aussi égal à la dimension de l'espace de la maille de construction
  | maxdegree | Degré maximum de l'ensemble des polynômes (fonctions de forme/fonctions de base)
  | nmaxcoef | Nombre maximum de coefficients de l'ensemble des polynômes (fonctions de forme/fonctions de base)

Renvoie:
  retour négatif en cas d'erreur, Zéro sinon.

Cette fonction informe des caractéristiques de la fonction d'interpolation nommée interpname. La fonction interpname opère sur des champs résultats qui reposent sur des éléments de type geotype. Cette fonction est constituée d'un ensemble de nbofbasisfunc fonctions de base/forme de degrée maximum maxdegree avec un maximum de maxcoefficient monômes a nbofvariable variables. Si les points de construction de la fonction d'interpolation sont les noeuds de l'élément de référence le paramètre cellnode vaut MED_TRUE.

Voir également:
  MEDinterpInfo

Définition à la ligne 41 du fichier MEDinterpInfoByName.c.

med_int MEDnInterp | ( | const med_idt | fid | ) |

Cette routine renvoie le nombre d'interpolations disponibles dans le fichier.

Paramètres:

  | fid | Identificateur du fichier.

Valeurs retournées:

  | Nombre | d'interpolations.

Renvoie:
  retour négatif en cas d'erreur, Zéro sinon.

Cette routine renvoie le nombre d'interpolations disponibles dans le fichier.

Voir également:
  MEDinterpInfo
  MEDfieldnInterp

Définition à la ligne 34 du fichier MEDnInterp.c.