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