LSST Applications  21.0.0-147-g0e635eb1+1acddb5be5,22.0.0+052faf71bd,22.0.0+1ea9a8b2b2,22.0.0+6312710a6c,22.0.0+729191ecac,22.0.0+7589c3a021,22.0.0+9f079a9461,22.0.1-1-g7d6de66+b8044ec9de,22.0.1-1-g87000a6+536b1ee016,22.0.1-1-g8e32f31+6312710a6c,22.0.1-10-gd060f87+016f7cdc03,22.0.1-12-g9c3108e+df145f6f68,22.0.1-16-g314fa6d+c825727ab8,22.0.1-19-g93a5c75+d23f2fb6d8,22.0.1-19-gb93eaa13+aab3ef7709,22.0.1-2-g8ef0a89+b8044ec9de,22.0.1-2-g92698f7+9f079a9461,22.0.1-2-ga9b0f51+052faf71bd,22.0.1-2-gac51dbf+052faf71bd,22.0.1-2-gb66926d+6312710a6c,22.0.1-2-gcb770ba+09e3807989,22.0.1-20-g32debb5+b8044ec9de,22.0.1-23-gc2439a9a+fb0756638e,22.0.1-3-g496fd5d+09117f784f,22.0.1-3-g59f966b+1e6ba2c031,22.0.1-3-g849a1b8+f8b568069f,22.0.1-3-gaaec9c0+c5c846a8b1,22.0.1-32-g5ddfab5d3+60ce4897b0,22.0.1-4-g037fbe1+64e601228d,22.0.1-4-g8623105+b8044ec9de,22.0.1-5-g096abc9+d18c45d440,22.0.1-5-g15c806e+57f5c03693,22.0.1-7-gba73697+57f5c03693,master-g6e05de7fdc+c1283a92b8,master-g72cdda8301+729191ecac,w.2021.39
LSST Data Management Base Package
Public Types | Public Member Functions | Static Public Member Functions | List of all members
lsst::afw::table::PointKey< T > Class Template Referenceabstract

A FunctorKey used to get or set a lsst::geom::Point from an (x,y) pair of int or double Keys. More...

#include <aggregates.h>

Inheritance diagram for lsst::afw::table::PointKey< T >:
lsst::afw::table::FunctorKey< lsst::geom::Point< T, 2 > > lsst::afw::table::OutputFunctorKey< T > lsst::afw::table::InputFunctorKey< T >

Public Types

using Value = lsst::geom::Point< T, 2 >
 The data type for get and set. More...
 

Public Member Functions

 PointKey () noexcept
 Default constructor; instance will not be usable unless subsequently assigned to. More...
 
 PointKey (Key< T > const &x, Key< T > const &y) noexcept
 Construct from a pair of Keys. More...
 
 PointKey (PointKey const &) noexcept=default
 
 PointKey (PointKey &&) noexcept=default
 
PointKeyoperator= (PointKey const &) noexcept=default
 
PointKeyoperator= (PointKey &&) noexcept=default
 
 ~PointKey () noexcept override=default
 
 PointKey (SubSchema const &s)
 Construct from a subschema, assuming x and y subfields. More...
 
lsst::geom::Point< T, 2 > get (BaseRecord const &record) const override
 Get a Point from the given record. More...
 
void set (BaseRecord &record, lsst::geom::Point< T, 2 > const &value) const override
 Set a Point in the given record. More...
 
bool operator== (PointKey< T > const &other) const noexcept
 Compare the FunctorKey for equality with another, using the underlying x and y Keys. More...
 
bool operator!= (PointKey< T > 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 both the x and y Keys are valid. More...
 
Key< T > getX () const noexcept
 Return the underlying x Key. More...
 
Key< T > getY () const noexcept
 Return the underlying y Key. More...
 
virtual void set (BaseRecord &record, T const &value) const =0
 

Static Public Member Functions

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

Detailed Description

template<typename T>
class lsst::afw::table::PointKey< T >

A FunctorKey used to get or set a lsst::geom::Point from an (x,y) pair of int or double Keys.

Definition at line 49 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

◆ PointKey() [1/5]

template<typename T >
lsst::afw::table::PointKey< T >::PointKey ( )
inlinenoexcept

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

Definition at line 64 of file aggregates.h.

64 : _x(), _y() {}

◆ PointKey() [2/5]

template<typename T >
lsst::afw::table::PointKey< T >::PointKey ( Key< T > const &  x,
Key< T > const &  y 
)
inlinenoexcept

Construct from a pair of Keys.

Definition at line 67 of file aggregates.h.

67 : _x(x), _y(y) {}
double x
int y
Definition: SpanSet.cc:48

◆ PointKey() [3/5]

template<typename T >
lsst::afw::table::PointKey< T >::PointKey ( PointKey< T > const &  )
defaultnoexcept

◆ PointKey() [4/5]

template<typename T >
lsst::afw::table::PointKey< T >::PointKey ( PointKey< T > &&  )
defaultnoexcept

◆ ~PointKey()

template<typename T >
lsst::afw::table::PointKey< T >::~PointKey ( )
overridedefaultnoexcept

◆ PointKey() [5/5]

template<typename T >
lsst::afw::table::PointKey< T >::PointKey ( SubSchema const &  s)
inline

Construct from a subschema, assuming x and y subfields.

If a schema has "a_x" and "a_y" fields, this constructor allows you to construct a PointKey via:

PointKey<T> k(schema["a"]);

Definition at line 83 of file aggregates.h.

83 : _x(s["x"]), _y(s["y"]) {}

Member Function Documentation

◆ addFields()

template<typename T >
PointKey< T > lsst::afw::table::PointKey< T >::addFields ( Schema schema,
std::string const &  name,
std::string const &  doc,
std::string const &  unit 
)
static

Add a pair of _x, _y fields to a Schema, and return a PointKey that points to them.

Parameters
[in,out]schemaSchema to add fields to.
[in]nameName prefix for all fields; "_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 all fields.

Definition at line 36 of file aggregates.cc.

37  {
38  Key<T> xKey = schema.addField<T>(schema.join(name, "x"), doc, unit);
39  Key<T> yKey = schema.addField<T>(schema.join(name, "y"), doc, unit);
40  return PointKey<T>(xKey, yKey);
41 }
table::Key< std::string > name
Definition: Amplifier.cc:116
table::Schema schema
Definition: python.h:134

◆ get()

template<typename T >
lsst::geom::Point< T, 2 > lsst::afw::table::PointKey< T >::get ( BaseRecord const &  record) const
overridevirtual

Get a Point from the given record.

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

Definition at line 44 of file aggregates.cc.

44  {
45  return lsst::geom::Point<T, 2>(record.get(_x), record.get(_y));
46 }
A coordinate class intended to represent absolute positions (2-d specialization).
Definition: Point.h:211

◆ getX()

template<typename T >
Key<T> lsst::afw::table::PointKey< T >::getX ( ) const
inlinenoexcept

Return the underlying x Key.

Definition at line 107 of file aggregates.h.

107 { return _x; }

◆ getY()

template<typename T >
Key<T> lsst::afw::table::PointKey< T >::getY ( ) const
inlinenoexcept

Return the underlying y Key.

Definition at line 110 of file aggregates.h.

110 { return _y; }

◆ hash_value()

template<typename T >
std::size_t lsst::afw::table::PointKey< T >::hash_value ( ) const
inlinenoexcept

Return a hash of this object.

Definition at line 98 of file aggregates.h.

98  {
99  // Completely arbitrary seed
100  return utils::hashCombine(17, _x, _y);
101  }
std::size_t hashCombine(std::size_t seed) noexcept
Combine hashes.
Definition: hashCombine.h:35

◆ isValid()

template<typename T >
bool lsst::afw::table::PointKey< T >::isValid ( ) const
inlinenoexcept

Return True if both the x and y Keys are valid.

Definition at line 104 of file aggregates.h.

104 { return _x.isValid() && _y.isValid(); }

◆ operator!=()

template<typename T >
bool lsst::afw::table::PointKey< T >::operator!= ( PointKey< T > const &  other) const
inlinenoexcept

Definition at line 94 of file aggregates.h.

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

◆ operator=() [1/2]

template<typename T >
PointKey& lsst::afw::table::PointKey< T >::operator= ( PointKey< T > &&  )
defaultnoexcept

◆ operator=() [2/2]

template<typename T >
PointKey& lsst::afw::table::PointKey< T >::operator= ( PointKey< T > const &  )
defaultnoexcept

◆ operator==()

template<typename T >
bool lsst::afw::table::PointKey< T >::operator== ( PointKey< T > const &  other) const
inlinenoexcept

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

Definition at line 93 of file aggregates.h.

93 { return _x == other._x && _y == other._y; }

◆ set() [1/2]

template<typename T >
void lsst::afw::table::PointKey< T >::set ( BaseRecord record,
lsst::geom::Point< T, 2 > const &  value 
) const
override

Set a Point in the given record.

Definition at line 49 of file aggregates.cc.

49  {
50  record.set(_x, value.getX());
51  record.set(_y, value.getY());
52 }

◆ 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: