lsst::meas::base::ShapeResultKey Class Reference

A FunctorKey for ShapeResult. More...

#include <ShapeUtilities.h>

Inheritance diagram for lsst::meas::base::ShapeResultKey:

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

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. More...

Private Attributes
afw::table::QuadrupoleKey	_shape
afw::table::CovarianceMatrixKey < ErrElement, 3 >	_shapeErr

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 115 of file ShapeUtilities.h.

Constructor & Destructor Documentation

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

inline

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

Definition at line 138 of file ShapeUtilities.h.

: _shape(), _shapeErr() {}

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 141 of file ShapeUtilities.h.

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

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"]);
*  

Definition at line 141 of file ShapeUtilities.cc.

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

Member Function Documentation

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]	schema	Schema to add fields to.
[in]	name	Name prefix for all fields; "_xx", "_yy", etc. will be appended to this to form the full field names.
[in]	doc	String used as the documentation for the xx, yy, xy fields.
[in]	uncertainty	Enum 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 75 of file ShapeUtilities.cc.

  {
    ShapeResultKey r;
    r._shape = afw::table::QuadrupoleKey::addFields(
        schema,
        name,
        doc,
        coordType
    );
    if (uncertainty != NO_UNCERTAINTY) {
        std::vector< afw::table::Key<ErrElement> > sigma(3);
        std::vector< afw::table::Key<ErrElement> > cov;
        sigma[0] = schema.addField<ErrElement>(
            schema.join(name, "xxSigma"), "1-sigma uncertainty on xx moment",
            coordType == afw::table::CoordinateType::PIXEL ? "pixels^2" : "radians^2"
        );
        sigma[1] = schema.addField<ErrElement>(
            schema.join(name, "yySigma"), "1-sigma uncertainty on yy moment",
            coordType == afw::table::CoordinateType::PIXEL ? "pixels^2" : "radians^2"
        );
        sigma[2] = schema.addField<ErrElement>(
            schema.join(name, "xySigma"), "1-sigma uncertainty on xy moment",
            coordType == afw::table::CoordinateType::PIXEL ? "pixels^2" : "radians^2"
        );
        if (uncertainty == FULL_COVARIANCE) {
            cov.push_back(
                schema.addField<ErrElement>(
                    schema.join(name, "xx_yy_Cov"), "uncertainty covariance in xx and yy",
                    coordType == afw::table::CoordinateType::PIXEL ? "pixels^4" : "radians^4"
                )
            );
            cov.push_back(
                schema.addField<ErrElement>(
                    schema.join(name, "xx_xy_Cov"), "uncertainty covariance in xx and xy",
                    coordType == afw::table::CoordinateType::PIXEL ? "pixels^4" : "radians^4"
                )
            );
            cov.push_back(
                schema.addField<ErrElement>(
                    schema.join(name, "yy_xy_Cov"), "uncertainty covariance in yy and xy",
                    coordType == afw::table::CoordinateType::PIXEL ? "pixels^4" : "radians^4"
                )
            );
        }
        r._shapeErr = afw::table::CovarianceMatrixKey<ErrElement,3>(sigma, cov);
    }
    return r;
}

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 150 of file ShapeUtilities.cc.

                                                                       {
    ShapeResult r;
    r.setShape(record.get(_shape));
    if (_shapeErr.isValid()) {
        r.setShapeErr(record.get(_shapeErr));
    }
    return r;
}

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

inline

Return a Key for the xx moment.

Definition at line 183 of file ShapeUtilities.h.

{ return _shape.getIxx(); }

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

inline

Return a Key for the xy moment.

Definition at line 189 of file ShapeUtilities.h.

{ return _shape.getIxy(); }

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

inline

Return a Key for the yy moment.

Definition at line 186 of file ShapeUtilities.h.

{ return _shape.getIyy(); }

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

inline

Return a FunctorKey to just the shape value.

Definition at line 177 of file ShapeUtilities.h.

{ return _shape; }

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

inline

Return a FunctorKey to just the uncertainty matrix.

Definition at line 180 of file ShapeUtilities.h.

{ return _shapeErr; }

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

inline

Return True if the shape key is valid.

Definition at line 174 of file ShapeUtilities.h.

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

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 170 of file ShapeUtilities.h.

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

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 167 of file ShapeUtilities.h.

                                                        {
        return _shape == other._shape && _shapeErr == other._shapeErr;
    }

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 159 of file ShapeUtilities.cc.

                                                                                     {
    record.set(_shape, value.getShape());
    if (_shapeErr.isValid()) {
        record.set(_shapeErr, value.getShapeErr());
    }
}

Member Data Documentation

afw::table::QuadrupoleKey lsst::meas::base::ShapeResultKey::_shape

private

Definition at line 192 of file ShapeUtilities.h.

afw::table::CovarianceMatrixKey<ErrElement,3> lsst::meas::base::ShapeResultKey::_shapeErr

private

Definition at line 193 of file ShapeUtilities.h.

---

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

• /home/lsstsw/stack/Linux64/meas_base/11.0+1/include/lsst/meas/base/ShapeUtilities.h
• /home/lsstsw/stack/Linux64/meas_base/11.0+1/src/ShapeUtilities.cc