lsst.astshim 22.0.1-2-g545b398+1b4e7dc7c0
Public Member Functions | Protected Member Functions | Friends | List of all members
ast::MatrixMap Class Reference

#include <MatrixMap.h>

Inheritance diagram for ast::MatrixMap:
ast::Mapping ast::Object

Public Member Functions

 MatrixMap (ConstArray2D const &matrix, std::string const &options="")
 
 MatrixMap (std::vector< double > const &diag, std::string const &options="")
 
virtual ~MatrixMap ()
 
 MatrixMap (MatrixMap const &)=default
 Copy constructor: make a deep copy. More...
 
 MatrixMap (MatrixMap &&)=default
 
MatrixMapoperator= (MatrixMap const &)=delete
 
MatrixMapoperator= (MatrixMap &&)=default
 
std::shared_ptr< MatrixMapcopy () const
 Return a deep copy of this object. More...
 
- Public Member Functions inherited from ast::Mapping
virtual ~Mapping ()
 
 Mapping (Mapping const &)=default
 Copy constructor: make a deep copy. More...
 
 Mapping (Mapping &&)=default
 
Mappingoperator= (Mapping const &)=delete
 
Mappingoperator= (Mapping &&)=default
 
std::shared_ptr< Mappingcopy () const
 Return a deep copy of this object. More...
 
int getNIn () const
 
int getNOut () const
 
bool getIsSimple () const
 
bool isInverted () const
 
bool getIsLinear () const
 
bool getReport () const
 
bool hasForward () const
 
bool hasInverse () const
 
std::shared_ptr< Mappinginverted () const
 
Array2D linearApprox (PointD const &lbnd, PointD const &ubnd, double tol) const
 
SeriesMap then (Mapping const &next) const
 
ParallelMap under (Mapping const &next) const
 
double rate (PointD const &at, int ax1, int ax2) const
 
void setReport (bool report)
 
std::shared_ptr< Mappingsimplified () const
 
void applyForward (ConstArray2D const &from, Array2D const &to) const
 
Array2D applyForward (ConstArray2D const &from) const
 
std::vector< double > applyForward (std::vector< double > const &from) const
 
void applyInverse (ConstArray2D const &from, Array2D const &to) const
 
Array2D applyInverse (ConstArray2D const &from) const
 
std::vector< double > applyInverse (std::vector< double > const &from) const
 
void tranGridForward (PointI const &lbnd, PointI const &ubnd, double tol, int maxpix, Array2D const &to) const
 
Array2D tranGridForward (PointI const &lbnd, PointI const &ubnd, double tol, int maxpix, int nPts) const
 
void tranGridInverse (PointI const &lbnd, PointI const &ubnd, double tol, int maxpix, Array2D const &to) const
 
Array2D tranGridInverse (PointI const &lbnd, PointI const &ubnd, double tol, int maxpix, int nPts) const
 
- Public Member Functions inherited from ast::Object
virtual ~Object ()
 
 Object (Object const &object)
 Copy constructor: make a deep copy. More...
 
 Object (Object &&)=default
 
Objectoperator= (Object const &)=delete
 
Objectoperator= (Object &&)=default
 
bool operator== (Object const &rhs) const
 
bool operator!= (Object const &rhs) const
 
std::shared_ptr< Objectcopy () const
 Return a deep copy of this object. More...
 
void clear (std::string const &attrib)
 
bool hasAttribute (std::string const &attrib) const
 
std::string getClassName () const
 
std::string getID () const
 Get ID: object identification string that is not copied. More...
 
std::string getIdent () const
 Get Ident: object identification string that is copied. More...
 
int getNObject () const
 
int getObjSize () const
 Get ObjSize: the in-memory size of the AST object in bytes. More...
 
int getRefCount () const
 
bool getUseDefs () const
 Get UseDefs: allow use of default values for Object attributes? More...
 
void lock (bool wait)
 
bool same (Object const &other) const
 
void setID (std::string const &id)
 Set ID: object identification string that is not copied. More...
 
void setIdent (std::string const &ident)
 Set Ident: object identification string that is copied. More...
 
void setUseDefs (bool usedefs)
 Set UseDefs: allow use of default values for Object attributes? More...
 
void show (std::ostream &os, bool showComments=true) const
 
std::string show (bool showComments=true) const
 
bool test (std::string const &attrib) const
 
void unlock (bool report=false)
 
AstObject const * getRawPtr () const
 
AstObject * getRawPtr ()
 

Protected Member Functions

virtual std::shared_ptr< ObjectcopyPolymorphic () const override
 
 MatrixMap (AstMatrixMap *rawptr)
 Construct a MatrixMap from a raw AST pointer. More...
 
- Protected Member Functions inherited from ast::Mapping
 Mapping (AstMapping *rawMap)
 
template<typename Class >
std::shared_ptr< Class > decompose (int i, bool copy) const
 
- Protected Member Functions inherited from ast::Object
 Object (AstObject *object)
 
template<typename T , typename AstT >
std::shared_ptr< T > copyImpl () const
 
bool getB (std::string const &attrib) const
 
std::string const getC (std::string const &attrib) const
 
double getD (std::string const &attrib) const
 
float getF (std::string const &attrib) const
 
int getI (std::string const &attrib) const
 
long int getL (std::string const &attrib) const
 
void set (std::string const &setting)
 
void setB (std::string const &attrib, bool value)
 
void setC (std::string const &attrib, std::string const &value)
 
void setD (std::string const &attrib, double value)
 
void setF (std::string const &attrib, float value)
 
void setI (std::string const &attrib, int value)
 
void setL (std::string const &attrib, long int value)
 

Friends

class Object
 

Additional Inherited Members

- Public Types inherited from ast::Object
using ObjectPtr = std::unique_ptr< AstObject, Deleter >
 unique pointer holding an AST raw pointer More...
 
- Static Public Member Functions inherited from ast::Object
static std::shared_ptr< ObjectfromString (std::string const &str)
 
template<typename Class >
static std::shared_ptr< Class > fromAstObject (AstObject *rawObj, bool copy)
 
- Static Protected Member Functions inherited from ast::Object
template<typename ShimT , typename AstT >
static std::shared_ptr< ShimT > makeShim (AstObject *p)
 

Detailed Description

MatrixMap is a form of Mapping which performs a general linear transformation.

Each set of input coordinates, regarded as a column-vector, are pre-multiplied by a matrix (whose elements are specified when the MatrixMap is created) to give a new column-vector containing the output coordinates. If appropriate, the inverse transformation may also be performed.

Constructor & Destructor Documentation

◆ MatrixMap() [1/5]

ast::MatrixMap::MatrixMap ( ConstArray2D const &  matrix,
std::string const &  options = "" 
)
inlineexplicit

Construct a MatrixMap from a 2-d matrix

Note
The inverse transformation will only be available if matrix is square and non-singular.
Parameters
[in]matrixThe transformation matrix, where:
  • The number of input coordinates is the number of columns.
  • The number of output coordinates is the number of rows.
[in]optionsComma-separated list of attribute assignments.

◆ MatrixMap() [2/5]

ast::MatrixMap::MatrixMap ( std::vector< double > const &  diag,
std::string const &  options = "" 
)
inlineexplicit

Construct a MatrixMap from a 1-d vector of diagonal elements of a diagonal matrix

Note
The inverse transformation will always be available when constructed from a diagonal matrix.
Parameters
[in]diagThe diagonal elements of a diagonal matrix as a vector; the number of input and output coordinates is the length of the vector.
[in]optionsComma-separated list of attribute assignments.

◆ ~MatrixMap()

virtual ast::MatrixMap::~MatrixMap ( )
inlinevirtual

◆ MatrixMap() [3/5]

ast::MatrixMap::MatrixMap ( MatrixMap const &  )
default

Copy constructor: make a deep copy.

◆ MatrixMap() [4/5]

ast::MatrixMap::MatrixMap ( MatrixMap &&  )
default

◆ MatrixMap() [5/5]

ast::MatrixMap::MatrixMap ( AstMatrixMap *  rawptr)
inlineexplicitprotected

Construct a MatrixMap from a raw AST pointer.

Member Function Documentation

◆ copy()

std::shared_ptr< MatrixMap > ast::MatrixMap::copy ( ) const
inline

Return a deep copy of this object.

◆ copyPolymorphic()

virtual std::shared_ptr< Object > ast::MatrixMap::copyPolymorphic ( ) const
inlineoverrideprotectedvirtual

Return a deep copy of this object. This is called by copy.

Each subclass must override this method. The standard implementation is:

return copyImpl<astshim_class, ast_class>();

for example Frame implements this as:

return copyImpl<Frame, AstFrame>();

Reimplemented from ast::Mapping.

◆ operator=() [1/2]

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

◆ operator=() [2/2]

MatrixMap & ast::MatrixMap::operator= ( MatrixMap const &  )
delete

Friends And Related Function Documentation

◆ Object

friend class Object
friend

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