Loading [MathJax]/extensions/tex2jax.js
LSST Applications g04a91732dc+a777afbe81,g07dc498a13+7e3c5f68a2,g12483e3c20+0145ec33cd,g1409bbee79+7e3c5f68a2,g1a7e361dbc+7e3c5f68a2,g1fd858c14a+9f35e23ec3,g35bb328faa+fcb1d3bbc8,g3ad4f90e5c+0145ec33cd,g3bd4b5ce2c+cbf1bea503,g4e0f332c67+5d362be553,g53246c7159+fcb1d3bbc8,g5477a8d5ce+db04660fe6,g60b5630c4e+0145ec33cd,g623d845a50+0145ec33cd,g6f0c2978f1+3526b51a37,g75b6c65c88+d54b601591,g78460c75b0+2f9a1b4bcd,g786e29fd12+cf7ec2a62a,g7b71ed6315+fcb1d3bbc8,g8852436030+4639f750a5,g89139ef638+7e3c5f68a2,g9125e01d80+fcb1d3bbc8,g919ac25b3e+6220c5324a,g95236ca021+f7a31438ed,g989de1cb63+7e3c5f68a2,g9f33ca652e+2d6fa11d35,gaaedd4e678+7e3c5f68a2,gabe3b4be73+1e0a283bba,gb1101e3267+4a428ef779,gb4a253aaf5+0122250889,gb58c049af0+f03b321e39,gc99c83e5f0+76d20ab76d,gcf25f946ba+4639f750a5,gd6cbbdb0b4+c8606af20c,gde0f65d7ad+3d8a3b7e46,ge278dab8ac+932305ba37,gf795337580+03b96afe58,gfba249425e+fcb1d3bbc8,w.2025.08
LSST Data Management Base Package
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Modules Pages
lsst::meas::base::ShapeResultKey Class Referenceabstract

A FunctorKey for ShapeResult. More...

#include <ShapeUtilities.h>

Inheritance diagram for lsst::meas::base::ShapeResultKey:
lsst::afw::table::FunctorKey< ShapeResult > lsst::afw::table::OutputFunctorKey< ShapeResult > lsst::afw::table::InputFunctorKey< ShapeResult >

Public Types

using Value
 The data type for get and set.
 

Public Member Functions

 ShapeResultKey ()
 Default constructor; instance will not be usuable unless subsequently assigned to.
 
 ShapeResultKey (afw::table::QuadrupoleKey const &shape, afw::table::CovarianceMatrixKey< ErrElement, 3 > const &shapeErr)
 Construct from a pair of Keys.
 
 ShapeResultKey (afw::table::SubSchema const &s)
 Construct from a subschema, assuming _xx, _yy, etc.
 
virtual ShapeResult get (afw::table::BaseRecord const &record) const
 Get a ShapeResult from the given record.
 
virtual void set (afw::table::BaseRecord &record, ShapeResult const &value) const
 Set a ShapeResult in the given record.
 
bool operator== (ShapeResultKey const &other) const
 Compare the FunctorKey for equality with another, using the underlying Keys.
 
bool operator!= (ShapeResultKey const &other) const
 
bool isValid () const
 Return True if the shape key is valid.
 
afw::table::QuadrupoleKey getShape () const
 Return a FunctorKey to just the shape value.
 
afw::table::CovarianceMatrixKey< ErrElement, 3 > getShapeErr () const
 Return a FunctorKey to just the uncertainty matrix.
 
afw::table::Key< ShapeElementgetIxx () const
 Return a Key for the xx moment.
 
afw::table::Key< ShapeElementgetIyy () const
 Return a Key for the yy moment.
 
afw::table::Key< ShapeElementgetIxy () const
 Return a Key for the xy moment.
 
virtual void set (BaseRecord &record, ShapeResult const &value) const=0
 
virtual void set (BaseRecord &record, ShapeResult const &value) const=0
 

Static Public Member Functions

static ShapeResultKey addFields (afw::table::Schema &schema, std::string const &name, std::string const &doc, UncertaintyEnum uncertainty, afw::table::CoordinateType coordType=afw::table::CoordinateType::PIXEL)
 Add the appropriate fields to a Schema, and return a ShapeResultKey that manages them.
 

Detailed Description

A FunctorKey for ShapeResult.

This class makes it easy to copy shapes and their uncertainties to and from records, and provides a method to add the appropriate fields to a Schema.

Definition at line 113 of file ShapeUtilities.h.

Member Typedef Documentation

◆ Value

using lsst::afw::table::FunctorKey< ShapeResult >::Value
inherited

The data type for get and set.

Definition at line 77 of file FunctorKey.h.

Constructor & Destructor Documentation

◆ ShapeResultKey() [1/3]

lsst::meas::base::ShapeResultKey::ShapeResultKey ( )
inline

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

Definition at line 131 of file ShapeUtilities.h.

131: _shape(), _shapeErr() {}

◆ ShapeResultKey() [2/3]

lsst::meas::base::ShapeResultKey::ShapeResultKey ( afw::table::QuadrupoleKey const & shape,
afw::table::CovarianceMatrixKey< ErrElement, 3 > const & shapeErr )
inline

Construct from a pair of Keys.

Definition at line 134 of file ShapeUtilities.h.

136 : _shape(shape), _shapeErr(shapeErr) {}

◆ ShapeResultKey() [3/3]

lsst::meas::base::ShapeResultKey::ShapeResultKey ( afw::table::SubSchema const & s)

Construct from a subschema, assuming _xx, _yy, etc.

subfields

If a schema has "a_xx", "a_yy", etc. fields, this constructor allows you to construct a ShapeResultKey via:

ShapeResultKey k(schema["a"]);
ShapeResultKey()
Default constructor; instance will not be usuable unless subsequently assigned to.

Definition at line 119 of file ShapeUtilities.cc.

119 : _shape(s) {
120 static std::vector<std::string> names = getNameVector(); // C++11 TODO: just use initializer list
121 try {
122 _shapeErr = afw::table::CovarianceMatrixKey<ErrElement, 3>(s, names);
123 } catch (pex::exceptions::NotFoundError &) {
124 }
125}

Member Function Documentation

◆ addFields()

ShapeResultKey lsst::meas::base::ShapeResultKey::addFields ( afw::table::Schema & schema,
std::string const & name,
std::string const & doc,
UncertaintyEnum uncertainty,
afw::table::CoordinateType coordType = afw::table::CoordinateType::PIXEL )
static

Add the appropriate fields to a Schema, and return a ShapeResultKey that manages them.

Parameters
[in,out]schemaSchema to add fields to.
[in]nameName prefix for all fields; "_xx", "_yy", etc. will be appended to this to form the full field names.
[in]docString used as the documentation for the xx, yy, xy fields.
[in]uncertaintyEnum indicating which (if any) uncertainty values will be saved.

The unit for all fields will be pixels^2 (pixels^4 for covariances).

Definition at line 74 of file ShapeUtilities.cc.

76 {
78 r._shape = afw::table::QuadrupoleKey::addFields(schema, name, doc, coordType);
79 if (uncertainty != NO_UNCERTAINTY) {
80 std::vector<afw::table::Key<ErrElement> > sigma(3);
81 std::vector<afw::table::Key<ErrElement> > cov;
82 sigma[0] = schema.addField<ErrElement>(
83 schema.join(name, "xxErr"), "Standard deviation of xx moment",
84 coordType == afw::table::CoordinateType::PIXEL ? "pixel^2" : "rad^2");
85 sigma[1] = schema.addField<ErrElement>(
86 schema.join(name, "yyErr"), "Standard deviation of yy moment",
87 coordType == afw::table::CoordinateType::PIXEL ? "pixel^2" : "rad^2");
88 sigma[2] = schema.addField<ErrElement>(
89 schema.join(name, "xyErr"), "Standard deviation of xy moment",
90 coordType == afw::table::CoordinateType::PIXEL ? "pixel^2" : "rad^2");
91 if (uncertainty == FULL_COVARIANCE) {
92 cov.push_back(schema.addField<ErrElement>(
93 schema.join(name, "xx_yy_Cov"), "uncertainty covariance in xx and yy",
94 coordType == afw::table::CoordinateType::PIXEL ? "pixel^4" : "rad^4"));
95 cov.push_back(schema.addField<ErrElement>(
96 schema.join(name, "xx_xy_Cov"), "uncertainty covariance in xx and xy",
97 coordType == afw::table::CoordinateType::PIXEL ? "pixel^4" : "rad^4"));
98 cov.push_back(schema.addField<ErrElement>(
99 schema.join(name, "yy_xy_Cov"), "uncertainty covariance in yy and xy",
100 coordType == afw::table::CoordinateType::PIXEL ? "pixel^4" : "rad^4"));
101 }
102 r._shapeErr = afw::table::CovarianceMatrixKey<ErrElement, 3>(sigma, cov);
103 }
104 return r;
105}
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.
@ FULL_COVARIANCE
The full covariance matrix is provided.
Definition constants.h:46
@ NO_UNCERTAINTY
Algorithm provides no uncertainy information at all.
Definition constants.h:44
T push_back(T... args)

◆ get()

ShapeResult lsst::meas::base::ShapeResultKey::get ( afw::table::BaseRecord const & record) const
virtual

Get a ShapeResult from the given record.

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

Definition at line 127 of file ShapeUtilities.cc.

127 {
128 ShapeResult r;
129 r.setShape(record.get(_shape));
130 if (_shapeErr.isValid()) {
131 r.setShapeErr(record.get(_shapeErr));
132 }
133 return r;
134}

◆ getIxx()

afw::table::Key< ShapeElement > lsst::meas::base::ShapeResultKey::getIxx ( ) const
inline

Return a Key for the xx moment.

Definition at line 173 of file ShapeUtilities.h.

173{ return _shape.getIxx(); }

◆ getIxy()

afw::table::Key< ShapeElement > lsst::meas::base::ShapeResultKey::getIxy ( ) const
inline

Return a Key for the xy moment.

Definition at line 179 of file ShapeUtilities.h.

179{ return _shape.getIxy(); }

◆ getIyy()

afw::table::Key< ShapeElement > lsst::meas::base::ShapeResultKey::getIyy ( ) const
inline

Return a Key for the yy moment.

Definition at line 176 of file ShapeUtilities.h.

176{ return _shape.getIyy(); }

◆ getShape()

afw::table::QuadrupoleKey lsst::meas::base::ShapeResultKey::getShape ( ) const
inline

Return a FunctorKey to just the shape value.

Definition at line 167 of file ShapeUtilities.h.

167{ return _shape; }

◆ getShapeErr()

afw::table::CovarianceMatrixKey< ErrElement, 3 > lsst::meas::base::ShapeResultKey::getShapeErr ( ) const
inline

Return a FunctorKey to just the uncertainty matrix.

Definition at line 170 of file ShapeUtilities.h.

170{ return _shapeErr; }

◆ isValid()

bool lsst::meas::base::ShapeResultKey::isValid ( ) const
inline

Return True if the shape key is valid.

Definition at line 164 of file ShapeUtilities.h.

164{ return _shape.isValid() && _shapeErr.isValid(); }

◆ operator!=()

bool lsst::meas::base::ShapeResultKey::operator!= ( ShapeResultKey const & other) const
inline

Definition at line 160 of file ShapeUtilities.h.

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

◆ operator==()

bool lsst::meas::base::ShapeResultKey::operator== ( ShapeResultKey const & other) const
inline

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

Definition at line 157 of file ShapeUtilities.h.

157 {
158 return _shape == other._shape && _shapeErr == other._shapeErr;
159 }

◆ set() [1/3]

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

◆ set() [2/3]

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

◆ set() [3/3]

void lsst::meas::base::ShapeResultKey::set ( afw::table::BaseRecord & record,
ShapeResult const & value ) const
virtual

Set a ShapeResult in the given record.

Definition at line 136 of file ShapeUtilities.cc.

136 {
137 record.set(_shape, value.getShape());
138 if (_shapeErr.isValid()) {
139 record.set(_shapeErr, value.getShapeErr());
140 }
141}

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