Salome HOME
Documentation update
[modules/med.git] / doc / doxygen / doxfiles / interptools.dox
1 /*!
2 \page interptools Interpolation algorithms
3
4 \section Presentation
5 The InterpKernel algorithms are part of the MED tool suite. They
6 answer to the following basic problem : given a source mesh \f$M_s\f$, a
7 source field \f$F_s\f$ and a target mesh \f$M_t\f$, reconstruct a field \f$F_t\f$
8 that uses \f$M_t\f$ as a support. The InterpKernel suite gives a number of
9 possibilities to compute the target field, depending on a variety of
10 user constraints.
11
12 \image html interpolationimage.png "General interpolation scheme" width=10cm
13
14 The starting point for using the tools is the description of the two main different APIs.
15 - \subpage RemapperClasses "remapper class" and the underlying \subpage interpkernel library for sequential codes using \ref medcoupling fields or other data structures.
16 - \ref paramedmem for parallel MPI based codes using \c ParaMEDMEM distributed fields, and the algorithms of the \ref interpkernel library.
17
18 The possibilities encompass:
19 - 1D, 2D lines, 2D (\ref interpolation2D), 3D surfaces(\ref interpolation3Dsurf) and 3D(\ref interpolation3D) handling,
20 - computation via node localization (\ref pointlocator) or via cell intersection (\ref ConsInterp),
21 - treatment of extended polygons (where edges can be arcs or segments)
22 for 2D intersection computations via \subpage interpkernelGeo2D,
23 - management of fields with P0,P1 or P2 representations. P0<->P0, P1<->P0, P1<->P1 and P2->P0 (non conservative) interpolators are available.
24
25 In case of non \ref MeshOverlap "overlapping meshes", it is important to specify whether the field represents an extensive or intensive physical quantity through
26 the \ref NatureOfField attribute of the \ref medcoupling field.
27
28 */