LSST Applications  21.0.0-172-gfb10e10a+18fedfabac,22.0.0+297cba6710,22.0.0+80564b0ff1,22.0.0+8d77f4f51a,22.0.0+a28f4c53b1,22.0.0+dcf3732eb2,22.0.1-1-g7d6de66+2a20fdde0d,22.0.1-1-g8e32f31+297cba6710,22.0.1-1-geca5380+7fa3b7d9b6,22.0.1-12-g44dc1dc+2a20fdde0d,22.0.1-15-g6a90155+515f58c32b,22.0.1-16-g9282f48+790f5f2caa,22.0.1-2-g92698f7+dcf3732eb2,22.0.1-2-ga9b0f51+7fa3b7d9b6,22.0.1-2-gd1925c9+bf4f0e694f,22.0.1-24-g1ad7a390+a9625a72a8,22.0.1-25-g5bf6245+3ad8ecd50b,22.0.1-25-gb120d7b+8b5510f75f,22.0.1-27-g97737f7+2a20fdde0d,22.0.1-32-gf62ce7b1+aa4237961e,22.0.1-4-g0b3f228+2a20fdde0d,22.0.1-4-g243d05b+871c1b8305,22.0.1-4-g3a563be+32dcf1063f,22.0.1-4-g44f2e3d+9e4ab0f4fa,22.0.1-42-gca6935d93+ba5e5ca3eb,22.0.1-5-g15c806e+85460ae5f3,22.0.1-5-g58711c4+611d128589,22.0.1-5-g75bb458+99c117b92f,22.0.1-6-g1c63a23+7fa3b7d9b6,22.0.1-6-g50866e6+84ff5a128b,22.0.1-6-g8d3140d+720564cf76,22.0.1-6-gd805d02+cc5644f571,22.0.1-8-ge5750ce+85460ae5f3,master-g6e05de7fdc+babf819c66,master-g99da0e417a+8d77f4f51a,w.2021.48
LSST Data Management Base Package
Public Member Functions | Public Attributes | List of all members
ast::MapBox Class Reference

Object to compute the bounding box which just encloses another box after it has been transformed by a mapping. More...

#include <MapBox.h>

Public Member Functions

 MapBox (Mapping const &map, std::vector< double > const &lbnd, std::vector< double > const &ubnd, int minOutCoord=1, int maxOutCoord=0)
 Find a bounding box for a Mapping. More...
 
 MapBox (MapBox const &)=default
 
 MapBox (MapBox &&)=default
 
MapBoxoperator= (MapBox const &)=default
 
MapBoxoperator= (MapBox &&)=default
 

Public Attributes

std::vector< double > lbndIn
 Lower bound of the input box. More...
 
std::vector< double > ubndIn
 Upper bound of the input box. More...
 
int minOutCoord
 Minimum output coordinate axis for which to compute an output bounding box, starting from 1. More...
 
int maxOutCoord
 Maximum output coordinate axis for which to compute an output bounding box, starting from 1. More...
 
std::vector< double > lbndOut
 Lower bound of the output box. More...
 
std::vector< double > ubndOut
 Upper bound of the output box. More...
 
Array2D xl
 2-d array of [out coord, an input point at which the lower bound occurred] More...
 
Array2D xu
 2-d array of [out coord, an input point at which the upper bound occurred] More...
 

Detailed Description

Object to compute the bounding box which just encloses another box after it has been transformed by a mapping.

Warning
The points in xl and xu are not predictable if more than one input value gives the same output boundary value.

Definition at line 42 of file MapBox.h.

Constructor & Destructor Documentation

◆ MapBox() [1/3]

ast::MapBox::MapBox ( Mapping const &  map,
std::vector< double > const &  lbnd,
std::vector< double > const &  ubnd,
int  minOutCoord = 1,
int  maxOutCoord = 0 
)
explicit

Find a bounding box for a Mapping.

Find the "bounding box" which just encloses another box after it has been transformed by a mapping. A typical use might be to calculate the size which an image would have after being transformed by this mapping.

Parameters
[in]mapMapping for which to find the output bounding box.
[in]lbndLower bound of the input box.
[in]ubndUpper bound of the input box. Note that it is permissible for the lower bound to exceed the corresponding upper bound, as the values will simply be swapped before use.
[in]minOutCoordMinimum output coordinate axis for which to compute an output bounding box, starting from 1
[in]maxOutCoordMaximum output coordinate axis for which to compute an output bounding box, starting from 1, or 0 for all remaining output coordinate axes (in which case the field of the same name will be set to the number of outputs)
Returns
A MapBox containing the computed outputs and a copy of the inputs.
Exceptions
std::invalid_argumentif minOutCoord is not in the range [1, getNOut()] or maxOutCoord is neither 0 nor in the range [minOutCoord, getNOut()].
std::runtime_errorif the required output bounds cannot be found. Typically, this might occur if all the input points which the function considers turn out to be invalid (see above). The number of points considered before generating such an error is quite large, however, so this is unlikely to occur by accident unless valid points are restricted to a very small subset of the input coordinate space.

Notes

  • Any input points which are transformed by the Mapping to give output coordinates containing the value AST__BAD are regarded as invalid and are ignored, They will make no contribution to determining the output bounds, even although the nominated output coordinate might still have a valid value at such points.

Definition at line 34 of file MapBox.cc.

36  : lbndIn(lbnd),
37  ubndIn(ubnd),
39  maxOutCoord(maxOutCoord), // if 0 then _compute will set it to # of outputs
40  lbndOut(),
41  ubndOut(),
42  xl(),
43  xu() {
44  _compute(map, lbnd, ubnd, minOutCoord, maxOutCoord);
45 }
std::vector< double > ubndIn
Upper bound of the input box.
Definition: MapBox.h:93
int minOutCoord
Minimum output coordinate axis for which to compute an output bounding box, starting from 1.
Definition: MapBox.h:95
std::vector< double > lbndIn
Lower bound of the input box.
Definition: MapBox.h:92
Array2D xu
2-d array of [out coord, an input point at which the upper bound occurred]
Definition: MapBox.h:101
std::vector< double > ubndOut
Upper bound of the output box.
Definition: MapBox.h:99
int maxOutCoord
Maximum output coordinate axis for which to compute an output bounding box, starting from 1.
Definition: MapBox.h:97
Array2D xl
2-d array of [out coord, an input point at which the lower bound occurred]
Definition: MapBox.h:100
std::vector< double > lbndOut
Lower bound of the output box.
Definition: MapBox.h:98

◆ MapBox() [2/3]

ast::MapBox::MapBox ( MapBox const &  )
default

◆ MapBox() [3/3]

ast::MapBox::MapBox ( MapBox &&  )
default

Member Function Documentation

◆ operator=() [1/2]

MapBox& ast::MapBox::operator= ( MapBox &&  )
default

◆ operator=() [2/2]

MapBox& ast::MapBox::operator= ( MapBox const &  )
default

Member Data Documentation

◆ lbndIn

std::vector<double> ast::MapBox::lbndIn

Lower bound of the input box.

Definition at line 92 of file MapBox.h.

◆ lbndOut

std::vector<double> ast::MapBox::lbndOut

Lower bound of the output box.

Definition at line 98 of file MapBox.h.

◆ maxOutCoord

int ast::MapBox::maxOutCoord

Maximum output coordinate axis for which to compute an output bounding box, starting from 1.

Definition at line 97 of file MapBox.h.

◆ minOutCoord

int ast::MapBox::minOutCoord

Minimum output coordinate axis for which to compute an output bounding box, starting from 1.

Definition at line 95 of file MapBox.h.

◆ ubndIn

std::vector<double> ast::MapBox::ubndIn

Upper bound of the input box.

Definition at line 93 of file MapBox.h.

◆ ubndOut

std::vector<double> ast::MapBox::ubndOut

Upper bound of the output box.

Definition at line 99 of file MapBox.h.

◆ xl

Array2D ast::MapBox::xl

2-d array of [out coord, an input point at which the lower bound occurred]

Definition at line 100 of file MapBox.h.

◆ xu

Array2D ast::MapBox::xu

2-d array of [out coord, an input point at which the upper bound occurred]

Definition at line 101 of file MapBox.h.


The documentation for this class was generated from the following files: