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 Types | Public Member Functions | Static Public Member Functions | List of all members
lsst::afw::table::EllipseKey Class Referenceabstract

A FunctorKey used to get or set a geom::ellipses::Ellipse from an (xx,yy,xy,x,y) tuple of Keys. More...

#include <aggregates.h>

Inheritance diagram for lsst::afw::table::EllipseKey:
lsst::afw::table::FunctorKey< lsst::afw::geom::ellipses::Ellipse > lsst::afw::table::OutputFunctorKey< T > lsst::afw::table::InputFunctorKey< T >

Public Types

using Value = lsst::afw::geom::ellipses::Ellipse
 The data type for get and set. More...
 

Public Member Functions

 EllipseKey () noexcept
 Default constructor; instance will not be usable unless subsequently assigned to. More...
 
 EllipseKey (QuadrupoleKey const &qKey, PointKey< double > const &pKey) noexcept
 Construct from individual Keys. More...
 
 EllipseKey (SubSchema const &s)
 Construct from a subschema, assuming (xx, yy, xy, x, y) subfields. More...
 
 EllipseKey (EllipseKey const &) noexcept=default
 
 EllipseKey (EllipseKey &&) noexcept=default
 
EllipseKeyoperator= (EllipseKey const &) noexcept=default
 
EllipseKeyoperator= (EllipseKey &&) noexcept=default
 
 ~EllipseKey () noexcept override=default
 
geom::ellipses::Ellipse get (BaseRecord const &record) const override
 Get an Ellipse from the given record. More...
 
void set (BaseRecord &record, geom::ellipses::Ellipse const &value) const override
 Set an Ellipse in the given record. More...
 
bool operator== (EllipseKey const &other) const noexcept
 Compare the FunctorKey for equality with another, using the underlying Ixx, Iyy, Ixy Keys. More...
 
bool operator!= (EllipseKey const &other) const noexcept
 
std::size_t hash_value () const noexcept
 Return a hash of this object. More...
 
bool isValid () const noexcept
 Return True if all the constituent Keys are valid. More...
 
QuadrupoleKey getCore () const noexcept
 Return constituent FunctorKeys. More...
 
PointKey< double > getCenter () const noexcept
 
virtual void set (BaseRecord &record, T const &value) const =0
 

Static Public Member Functions

static EllipseKey addFields (Schema &schema, std::string const &name, std::string const &doc, std::string const &unit)
 Add a set of _xx, _yy, _xy, _x, _y fields to a Schema, and return an EllipseKey that points to them. More...
 

Detailed Description

A FunctorKey used to get or set a geom::ellipses::Ellipse from an (xx,yy,xy,x,y) tuple of Keys.

Definition at line 360 of file aggregates.h.

Member Typedef Documentation

◆ Value

The data type for get and set.

Definition at line 77 of file FunctorKey.h.

Constructor & Destructor Documentation

◆ EllipseKey() [1/5]

lsst::afw::table::EllipseKey::EllipseKey ( )
inlinenoexcept

Default constructor; instance will not be usable unless subsequently assigned to.

Definition at line 376 of file aggregates.h.

376 : _qKey(), _pKey() {}

◆ EllipseKey() [2/5]

lsst::afw::table::EllipseKey::EllipseKey ( QuadrupoleKey const &  qKey,
PointKey< double > const &  pKey 
)
inlinenoexcept

Construct from individual Keys.

Definition at line 379 of file aggregates.h.

379 : _qKey(qKey), _pKey(pKey) {}

◆ EllipseKey() [3/5]

lsst::afw::table::EllipseKey::EllipseKey ( SubSchema const &  s)
inline

Construct from a subschema, assuming (xx, yy, xy, x, y) subfields.

If a schema has "a_xx", "a_yy", "a_xy", "a_x", and "a_y" fields, this constructor allows you to construct an EllipseKey via:

EllipseKey k(schema["a"]);

Definition at line 389 of file aggregates.h.

389 : _qKey(s), _pKey(s) {}

◆ EllipseKey() [4/5]

lsst::afw::table::EllipseKey::EllipseKey ( EllipseKey const &  )
defaultnoexcept

◆ EllipseKey() [5/5]

lsst::afw::table::EllipseKey::EllipseKey ( EllipseKey &&  )
defaultnoexcept

◆ ~EllipseKey()

lsst::afw::table::EllipseKey::~EllipseKey ( )
overridedefaultnoexcept

Member Function Documentation

◆ addFields()

EllipseKey lsst::afw::table::EllipseKey::addFields ( Schema schema,
std::string const &  name,
std::string const &  doc,
std::string const &  unit 
)
static

Add a set of _xx, _yy, _xy, _x, _y fields to a Schema, and return an EllipseKey that points to them.

Parameters
[in,out]schemaSchema to add fields to.
[in]nameName prefix for all fields; "_xx", "_yy", "_xy", "_x" ,"_y", will be appended to this to form the full field names.
[in]docString used as the documentation for the fields.
[in]unitString used as the unit for x and y fields; "<unit>^2" will be used for xx, yy, and xy fields.

Definition at line 122 of file aggregates.cc.

123  {
124  QuadrupoleKey qKey = QuadrupoleKey::addFields(schema, name, doc, CoordinateType::PIXEL);
125  PointKey<double> pKey = PointKey<double>::addFields(schema, name, doc, unit);
126  return EllipseKey(qKey, pKey);
127 }
table::Key< std::string > name
Definition: Amplifier.cc:116
table::Schema schema
Definition: python.h:134
EllipseKey() noexcept
Default constructor; instance will not be usable unless subsequently assigned to.
Definition: aggregates.h:376
static PointKey addFields(Schema &schema, std::string const &name, std::string const &doc, std::string const &unit)
Add a pair of _x, _y fields to a Schema, and return a PointKey that points to them.
Definition: aggregates.cc:36
static QuadrupoleKey addFields(Schema &schema, std::string const &name, std::string const &doc, CoordinateType coordType=CoordinateType::PIXEL)
Add a set of quadrupole subfields to a schema and return a QuadrupoleKey that points to them.
Definition: aggregates.cc:100

◆ get()

geom::ellipses::Ellipse lsst::afw::table::EllipseKey::get ( BaseRecord const &  record) const
overridevirtual

Get an Ellipse from the given record.

Implements lsst::afw::table::OutputFunctorKey< T >.

Definition at line 129 of file aggregates.cc.

129  {
130  return geom::ellipses::Ellipse(record.get(_qKey), record.get(_pKey));
131 }

◆ getCenter()

PointKey<double> lsst::afw::table::EllipseKey::getCenter ( ) const
inlinenoexcept

Definition at line 423 of file aggregates.h.

423 { return _pKey; }

◆ getCore()

QuadrupoleKey lsst::afw::table::EllipseKey::getCore ( ) const
inlinenoexcept

Return constituent FunctorKeys.

Definition at line 422 of file aggregates.h.

422 { return _qKey; }

◆ hash_value()

std::size_t lsst::afw::table::EllipseKey::hash_value ( ) const
inlinenoexcept

Return a hash of this object.

Definition at line 412 of file aggregates.h.

412  {
413  // Completely arbitrary seed
414  return utils::hashCombine(17, _qKey, _pKey);
415  }
std::size_t hashCombine(std::size_t seed) noexcept
Combine hashes.
Definition: hashCombine.h:35

◆ isValid()

bool lsst::afw::table::EllipseKey::isValid ( ) const
inlinenoexcept

Return True if all the constituent Keys are valid.

Definition at line 418 of file aggregates.h.

418 { return _qKey.isValid() && _pKey.isValid(); }
bool isValid() const noexcept
Return True if both the x and y Keys are valid.
Definition: aggregates.h:104
bool isValid() const noexcept
Return True if all the constituent Keys are valid.
Definition: aggregates.h:342

◆ operator!=()

bool lsst::afw::table::EllipseKey::operator!= ( EllipseKey const &  other) const
inlinenoexcept

Definition at line 408 of file aggregates.h.

408 { return !(*this == other); }

◆ operator=() [1/2]

EllipseKey& lsst::afw::table::EllipseKey::operator= ( EllipseKey &&  )
defaultnoexcept

◆ operator=() [2/2]

EllipseKey& lsst::afw::table::EllipseKey::operator= ( EllipseKey const &  )
defaultnoexcept

◆ operator==()

bool lsst::afw::table::EllipseKey::operator== ( EllipseKey const &  other) const
inlinenoexcept

Compare the FunctorKey for equality with another, using the underlying Ixx, Iyy, Ixy Keys.

Definition at line 405 of file aggregates.h.

405  {
406  return _qKey == other._qKey && _pKey == other._pKey;
407  }

◆ set() [1/2]

void lsst::afw::table::EllipseKey::set ( BaseRecord record,
geom::ellipses::Ellipse const &  value 
) const
override

Set an Ellipse in the given record.

Definition at line 133 of file aggregates.cc.

133  {
134  _qKey.set(record, value.getCore());
135  _pKey.set(record, value.getCenter());
136 }
void set(BaseRecord &record, lsst::geom::Point< T, 2 > const &value) const override
Set a Point in the given record.
Definition: aggregates.cc:49
void set(BaseRecord &record, geom::ellipses::Quadrupole const &value) const override
Set a Quadrupole in the given record.
Definition: aggregates.cc:114

◆ set() [2/2]

template<typename T >
virtual void lsst::afw::table::InputFunctorKey< T >::set ( BaseRecord record,
T const &  value 
) const
pure virtualinherited

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