| Intrepid
    | 
Computes F, the reference-to-physical frame map. More...
#include <Intrepid_CellTools.hpp>
Computes F, the reference-to-physical frame map.
There are 3 use cases:
 for a specified physical cell
 for a specified physical cell  from a cell workset to a single point set stored in a rank-2 (P,D) array;
 from a cell workset to a single point set stored in a rank-2 (P,D) array;  for all cells in a cell workset to a single point set stored in a rank-2 (P,D) array;
 for all cells in a cell workset to a single point set stored in a rank-2 (P,D) array;  for all cells in a cell workset to multiple point sets having the same number of points, indexed by cell ordinal, and stored in a rank-3 (C,P,D) array;
 for all cells in a cell workset to multiple point sets having the same number of points, indexed by cell ordinal, and stored in a rank-3 (C,P,D) array;For a single point set in a rank-2 array (P,D) and whichCell set to a valid cell ordinal relative to cellWorkset returns a rank-2 (P,D) array such that 
![\[ \mbox{physPoints}(p,d) = \Big(F_c(\mbox{refPoint}(p,*)) \Big)_d \quad \mbox{for $0\le c < C$ - fixed} \]](form_43.png) 
 For a single point set in a rank-2 array (P,D) and whichCell=-1 (default value) returns a rank-3 (C,P,D) array such that 
![\[ \mbox{physPoints}(c,p,d) = \Big(F_c(\mbox{refPoint}(p,*)) \Big)_d \quad c=0,\ldots, C \]](form_44.png) 
For multiple point sets in a rank-3 (C,P,D) array returns a rank-3 (C,P,D) array such that
![\[ \mbox{physPoints}(c,p,d) = \Big(F_c(\mbox{refPoint}(c,p,*)) \Big)_d \quad c=0,\ldots, C \]](form_45.png) 
 This corresponds to mapping multiple sets of reference points to a matching number of physical cells and requires the default value whichCell=-1.
Requires cell topology with a reference cell. See Section Reference-to-physical cell mapping for definition of the mapping function. Presently supported cell topologies are
Line<2> Triangle<3>, Triangle<6>, Quadrilateral<4>, Quadrilateral<9> Tetrahedron<4>, Tetrahedron<10>, Hexahedron<8>, Hexahedron<27>     The default \c whichCell = -1 requires rank-3 output array and
    forces application of all reference-to-physical frame mappings corresponding to the
    cells stored in \c cellWorkset. Application of a single mapping is forced by selecting 
    a valid cell ordinal \c whichCell and requires rank-2 input/output point arrays.  
refPoints represents an arbitrary set of points in the reference frame that are not required to be in the reference cell corresponding to the specified cell topology. As a result, the images of these points under a given reference-to-physical map are not necessarily contained in the physical cell that is the image of the reference cell under that map. CellTools provides several inclusion tests methods to check whether or not the points are inside a reference cell.| physPoints | [out] - rank-3/2 array with dimensions (C,P,D)/(P,D) with the images of the ref. points | 
| refPoints | [in] - rank-3/2 array with dimensions (C,P,D)/(P,D) with points in reference frame | 
| cellWorkset | [in] - rank-3 array with dimensions (C,N,D) with the nodes of the cell workset | 
| cellTopo | [in] - cell topology of the cells stored in cellWorkset | 
| whichCell | [in] - ordinal of the cell that defines the reference-to-physical map; default is -1 | 
Definition at line 570 of file Intrepid_CellTools.hpp.
 1.8.5
 1.8.5