Intrepid::CellTools< Scalar >::mapToPhysicalFrameTempSpec< ArrayPhysPoint, ArrayRefPoint, ArrayCell, refRank, phyptsrank > Struct Template Reference

Computes F, the reference-to-physical frame map. More...

#include <Intrepid_CellTools.hpp>

Detailed Description

template<class Scalar>
template<class ArrayPhysPoint, class ArrayRefPoint, class ArrayCell, int refRank, int phyptsrank>
struct Intrepid::CellTools< Scalar >::mapToPhysicalFrameTempSpec< ArrayPhysPoint, ArrayRefPoint, ArrayCell, refRank, phyptsrank >

Computes F, the reference-to-physical frame map.

    There are 3 use cases:

• Applies for a specified physical cell from a cell workset to a single point set stored in a rank-2 (P,D) array;
• Applies for all cells in a cell workset to a single point set stored in a rank-2 (P,D) array;
• Applies 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

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

For multiple point sets in a rank-3 (C,P,D) array returns a rank-3 (C,P,D) array such that

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

• 1D: Line<2>
• 2D: Triangle<3>, Triangle<6>, Quadrilateral<4>, Quadrilateral<9>
• 3D: 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.  
  

Warning

The array 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.

Parameters

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

Todo:

Implement method for non-standard (shell, beam, etc) topologies.

Definition at line 553 of file Intrepid_CellTools.hpp.

---

The documentation for this struct was generated from the following file:

• http://docs.trilinos.org/dev/packages/intrepid/src/Cell/Intrepid_CellTools.hpp