A rectangular lattice maps all of space (of dimension NDIMS) into a rectangular grid of cells identified by integer coordinates. More...
#include </home/docs/checkouts/readthedocs.org/user_builds/axom/checkouts/v0.9.1/src/axom/spin/RectangularLattice.hpp>
Public Types | |
| using | GridCell = primal::Point< CellCoordType, NDIMS > |
| using | SpacePoint = primal::Point< SpaceCoordType, NDIMS > |
| using | SpaceVector = primal::Vector< SpaceCoordType, NDIMS > |
| using | SpatialBoundingBox = primal::BoundingBox< SpaceCoordType, NDIMS > |
Public Member Functions | |
| RectangularLattice () | |
| Default constructor. More... | |
| RectangularLattice (const SpacePoint &origin) | |
| Constructor from a given origin. More... | |
| RectangularLattice (const SpacePoint &origin, const SpaceVector &spacing) | |
| Constructor from a given origin and spacing. More... | |
| RectangularLattice (SpaceCoordType *origin_data, SpaceCoordType *spacing_data) | |
| Constructor from SpaceCoordType arrays. More... | |
| const SpacePoint & | origin () const |
| const SpaceVector & | spacing () const |
| AXOM_HOST_DEVICE GridCell | gridCell (const SpacePoint &pt) const |
| SpacePoint | spacePoint (const GridCell &cell) const |
| SpatialBoundingBox | cellBounds (const GridCell &cell) const |
| Find the spatial bounding box of a lattice cell. More... | |
| std::ostream & | print (std::ostream &os) const |
Detailed Description
template<int NDIMS, typename SpaceCoordType = double, typename CellCoordType = int>
class axom::spin::RectangularLattice< NDIMS, SpaceCoordType, CellCoordType >
A rectangular lattice maps all of space (of dimension NDIMS) into a rectangular grid of cells identified by integer coordinates.
- Template Parameters
-
NDIMS the dimension of the space SpaceCoordType the type of the spatial coordinates. Default: double CellCoordType the type of the integral lattice coordinates. Default: int
A rectangular lattice maps every point in space (a SpacePoint) to a unique rectangular cell with integral coordinates (a GridCell). Each lattice cell is identified with the integer grid point at its lowest corner in each dimension.
RectangularLattice also maps GridCell coordinates back to spatial coordinates or to the bounding box of the GridCell.
GridCells follow a half-open boundary convention. Points on their lower boundaries get mapped to the cell, while points on their upper boundaries get mapped to neighboring cells.
A RectangularLattice is defined by an origin (a SpacePoint) and a grid spacing (a SpaceVector).
- Note
- Grid spacing coordinates that are really small (magnitude less than primal::PRIMAL_TINY := 1e-50) are snapped to zero to avoid division by zero.
- See also
- primal::PRIMAL_TINY
Member Typedef Documentation
◆ GridCell
| using axom::spin::RectangularLattice< NDIMS, SpaceCoordType, CellCoordType >::GridCell = primal::Point<CellCoordType, NDIMS> |
◆ SpacePoint
| using axom::spin::RectangularLattice< NDIMS, SpaceCoordType, CellCoordType >::SpacePoint = primal::Point<SpaceCoordType, NDIMS> |
◆ SpaceVector
| using axom::spin::RectangularLattice< NDIMS, SpaceCoordType, CellCoordType >::SpaceVector = primal::Vector<SpaceCoordType, NDIMS> |
◆ SpatialBoundingBox
| using axom::spin::RectangularLattice< NDIMS, SpaceCoordType, CellCoordType >::SpatialBoundingBox = primal::BoundingBox<SpaceCoordType, NDIMS> |
Constructor & Destructor Documentation
◆ RectangularLattice() [1/4]
|
inline |
Default constructor.
- Note
- Sets the origin to 0 and spacing to 1 in each dimension
◆ RectangularLattice() [2/4]
|
inline |
Constructor from a given origin.
- Parameters
-
origin The lattice's origin
- Note
- Spacing will be set to default (vector of ones)
◆ RectangularLattice() [3/4]
|
inline |
Constructor from a given origin and spacing.
- Parameters
-
origin The lattice's origin spacing The lattice's spacing
- Note
- The magnitude of the spacing coordinates should be greater than zero. If they are less than primal::PRIMAL_TINY, the lattice will be degenerate in that dimension.
◆ RectangularLattice() [4/4]
|
inline |
Constructor from SpaceCoordType arrays.
- Parameters
-
origin_date An array containing the origin's coordinates spacing_data An array containing the spacing coordinates
- Precondition
- When origin_data is not NULL, it must have at least NDIMS entries
- Note
- Origin will be set to the zero vector if origin_data pointer is NULL
- Precondition
- When spacing_data is not NULL, it must have at least NDIMS entries
- Note
- Spacing will be set to vector or ones if pointer is NULL
- The magnitude of the spacing coordinates should be greater than zero. If they are less than EPS = primal::PRIMAL_TINY, the lattice will be degenerate in that dimension.
References axom::primal::Point< T, NDIMS >::zero().
Member Function Documentation
◆ origin()
|
inline |
Accessor for lattice origin
◆ spacing()
|
inline |
Accessor for lattice spacing
◆ gridCell()
|
inline |
Returns the lattice cell associated with the given space point pt
References axom::utilities::floor().
◆ spacePoint()
|
inline |
Returns the space point associated with lowest corner of GridCell cell
◆ cellBounds()
|
inline |
Find the spatial bounding box of a lattice cell.
- Note
- The bounding box covers all points in space that map to gridCell
References axom::primal::Point< T, NDIMS >::array(), and axom::spin::RectangularLattice< NDIMS, SpaceCoordType, CellCoordType >::spacePoint().
◆ print()
|
inline |
Simple formatted print of a rectangular lattice
The documentation for this class was generated from the following file:
- /home/docs/checkouts/readthedocs.org/user_builds/axom/checkouts/v0.9.1/src/axom/spin/RectangularLattice.hpp
