-- Data Exchange Channel(aka DEC, abstract class) : \ref dec, and its implementations :
- - \ref intersectiondec for a \ref InterpKerRemapGlobal based on intersecting elems volume computation,
- - NonCoincident DEC for a non-conservative interpolation based on element localization : \ref noncoincidentdec,
- - Explicit Coincident DEC for remapping coincident meshes on a one-to-one basis. This class applies to unstructured topologies: \ref explicit_coincident_dec,
- - Structured Coincident DEC for remapping coincident meshes on a one-to-one basis. This class applies to structured topologies : \ref structuredcoincidentdec.
+- Data Exchange Channel \ref dec, and its implementations :
+ - \ref interpkerneldec for a \ref InterpKerRemapGlobal based on intersecting elements volume computation,
+ - \ref overlapdec based on intersecting elems volume
+ computation when source and target meshes are on same process id
+
+Given two groups of processors groupA (source) and groupB (target), the following code excerpt gives a typical use of the InterpKernelDEC class.
+
+ \code
+ ...
+ InterpKernelDEC dec(groupA, groupB);//creates the data exchange channel
+ dec.attachLocalField(field);//associate the local field
+ dec.synchronize();//builds the interpolation matrix
+ if (groupA.containsMyRank())
+ dec.recvData();//receive the target field
+ else if (groupB.containsMyRank())
+ dec.sendData();//send the source field
+ ...
+ \endcode
+The generation of the \ref interpolationmatrix "interpolation matrix" and the corresponding matrix-vector products are performed either on the source, either on the target side.