LSST Applications g04a91732dc+a777afbe81,g07dc498a13+7e3c5f68a2,g12483e3c20+0145ec33cd,g1409bbee79+7e3c5f68a2,g1a7e361dbc+7e3c5f68a2,g1fd858c14a+9f35e23ec3,g31cf31e263+9c59251d59,g35bb328faa+fcb1d3bbc8,g3ad4f90e5c+0145ec33cd,g3bd4b5ce2c+9e43d17133,g4e0f332c67+5d362be553,g53246c7159+fcb1d3bbc8,g5477a8d5ce+d2270fb7b7,g60b5630c4e+0145ec33cd,g623d845a50+0145ec33cd,g6f0c2978f1+a406a63c6f,g75b6c65c88+d54b601591,g78460c75b0+2f9a1b4bcd,g786e29fd12+cf7ec2a62a,g7b71ed6315+fcb1d3bbc8,g8852436030+4639f750a5,g89139ef638+7e3c5f68a2,g9125e01d80+fcb1d3bbc8,g95236ca021+f7a31438ed,g989de1cb63+7e3c5f68a2,g9f33ca652e+2d6fa11d35,gaaedd4e678+7e3c5f68a2,gabe3b4be73+1e0a283bba,gb1101e3267+4a428ef779,gb4a253aaf5+0122250889,gb58c049af0+f03b321e39,gc99c83e5f0+76d20ab76d,gcf25f946ba+4639f750a5,gd0fa69b896+890c3b4faa,gd6cbbdb0b4+c8606af20c,gde0f65d7ad+c2b4c879fb,ge278dab8ac+932305ba37,gfba249425e+fcb1d3bbc8,w.2025.07
LSST Data Management Base Package
|
#include <aggregates.h>
Public Types | |
using | ErrKeyArray = std::vector<Key<T>> |
using | CovarianceKeyArray = std::vector<Key<T>> |
using | NameArray = std::vector<std::string> |
using | Value |
The data type for get and set. | |
Public Member Functions | |
CovarianceMatrixKey () | |
Construct an invalid instance; must assign before subsequent use. | |
CovarianceMatrixKey (ErrKeyArray const &err, CovarianceKeyArray const &cov=CovarianceKeyArray()) | |
Construct a from arrays of per-element Keys. | |
CovarianceMatrixKey (SubSchema const &s, NameArray const &names) | |
Construct from a subschema and an array of names for each parameter of the matrix. | |
CovarianceMatrixKey (CovarianceMatrixKey const &) | |
CovarianceMatrixKey (CovarianceMatrixKey &&) | |
CovarianceMatrixKey & | operator= (CovarianceMatrixKey const &) |
CovarianceMatrixKey & | operator= (CovarianceMatrixKey &&) |
~CovarianceMatrixKey () noexcept override | |
Eigen::Matrix< T, N, N > | get (BaseRecord const &record) const override |
Get a covariance matrix from the given record. | |
void | set (BaseRecord &record, Eigen::Matrix< T, N, N > const &value) const override |
Set a covariance matrix in the given record (uses only the lower triangle of the given matrix) | |
T | getElement (BaseRecord const &record, int i, int j) const |
Return the element in row i and column j. | |
void | setElement (BaseRecord &record, int i, int j, T value) const |
Set the element in row i and column j. | |
bool | isValid () const noexcept |
Return True if all the constituent error Keys are valid. | |
bool | operator== (CovarianceMatrixKey const &other) const noexcept |
Compare the FunctorKey for equality with another, using its constituent Keys. | |
bool | operator!= (CovarianceMatrixKey const &other) const noexcept |
std::size_t | hash_value () const noexcept |
Return a hash of this object. | |
virtual void | set (BaseRecord &record, T const &value) const=0 |
Static Public Member Functions | |
static CovarianceMatrixKey | addFields (Schema &schema, std::string const &prefix, NameArray const &names, std::string const &unit, bool diagonalOnly=false) |
Add covariance matrix fields to a Schema, and return a CovarianceMatrixKey to manage them. | |
static CovarianceMatrixKey | addFields (Schema &schema, std::string const &prefix, NameArray const &names, NameArray const &units, bool diagonalOnly=false) |
Add covariance matrix fields to a Schema, and return a CovarianceMatrixKey to manage them. | |
Definition at line 519 of file aggregates.h.
using lsst::afw::table::CovarianceMatrixKey< T, N >::CovarianceKeyArray = std::vector<Key<T>> |
Definition at line 522 of file aggregates.h.
using lsst::afw::table::CovarianceMatrixKey< T, N >::ErrKeyArray = std::vector<Key<T>> |
Definition at line 521 of file aggregates.h.
using lsst::afw::table::CovarianceMatrixKey< T, N >::NameArray = std::vector<std::string> |
Definition at line 523 of file aggregates.h.
|
inherited |
The data type for get and set.
Definition at line 77 of file FunctorKey.h.
|
default |
Construct an invalid instance; must assign before subsequent use.
|
explicit |
Construct a from arrays of per-element Keys.
The err array Keys should point to the square root of the diagonal of the covariance matrix. The cov array Keys should point to the off-diagonal elements of the lower-triangle, packed first in rows, then in columns (or equivalently, in the upper-triangle, packed first in columns, then in rows). For a 4x4 matrix, the order is is:
err[0]^2 cov[0] cov[1] cov[3] cov[0] err[1]^2 cov[2] cov[4] cov[1] cov[2] err[2]^2 cov[5] cov[3] cov[4] cov[5] err[3]^2
The cov array may also be empty, to indicate that no off-diagonal elements are stored, and should be set to zero. If not empty, the size of the cov matrix must be exactly n*(n-1)/2, where n is the size of the err matrix.
Definition at line 222 of file aggregates.cc.
lsst::afw::table::CovarianceMatrixKey< T, N >::CovarianceMatrixKey | ( | SubSchema const & | s, |
NameArray const & | names ) |
Construct from a subschema and an array of names for each parameter of the matrix.
The field names should match the following convention:
Definition at line 240 of file aggregates.cc.
|
default |
|
default |
|
overridedefaultnoexcept |
|
static |
Add covariance matrix fields to a Schema, and return a CovarianceMatrixKey to manage them.
[out] | schema | Schema to add fields to. |
[in] | prefix | String used to form the first part of all field names. Suffixes of the form '_xErr' and '_x_y_Cov' will be added to form the full field names (using names={'x', 'y'} as an example). |
[in] | units | Vector of units for for error (standard deviation) values; covariance matrix elements will have "{units[i]} {units[j]}" or "{units[i]}^2", depending on whether units[i] == units[j]. |
[in] | names | Vector of strings containing the names of the quantities the covariance matrix represents the uncertainty of. |
[in] | diagonalOnly | If true, only create fields for the error values. |
Definition at line 183 of file aggregates.cc.
|
static |
Add covariance matrix fields to a Schema, and return a CovarianceMatrixKey to manage them.
[out] | schema | Schema to add fields to. |
[in] | prefix | String used to form the first part of all field names. Suffixes of the form '_xErr' and '_x_y_Cov' will be added to form the full field names (using names={'x', 'y'} as an example). |
[in] | unit | Unit for for error (standard deviation) values; covariance matrix elements will be unit^2. |
[in] | names | Vector of strings containing the names of the quantities the covariance matrix represents the uncertainty of. |
[in] | diagonalOnly | If true, only create fields for the error values. |
Definition at line 175 of file aggregates.cc.
|
overridevirtual |
Get a covariance matrix from the given record.
Implements lsst::afw::table::OutputFunctorKey< T >.
Definition at line 293 of file aggregates.cc.
T lsst::afw::table::CovarianceMatrixKey< T, N >::getElement | ( | BaseRecord const & | record, |
int | i, | ||
int | j ) const |
Return the element in row i and column j.
Definition at line 370 of file aggregates.cc.
|
noexcept |
Return a hash of this object.
Definition at line 363 of file aggregates.cc.
|
noexcept |
Return True if all the constituent error Keys are valid.
Note that if the only one or more off-diagonal keys are invalid, we assume that means those terms are zero, not that the whole FunctorKey is invalid.
Definition at line 328 of file aggregates.cc.
|
inlinenoexcept |
Definition at line 624 of file aggregates.h.
|
default |
|
default |
|
noexcept |
Compare the FunctorKey for equality with another, using its constituent Keys.
Definition at line 338 of file aggregates.cc.
|
override |
Set a covariance matrix in the given record (uses only the lower triangle of the given matrix)
Definition at line 312 of file aggregates.cc.
|
pure virtualinherited |
void lsst::afw::table::CovarianceMatrixKey< T, N >::setElement | ( | BaseRecord & | record, |
int | i, | ||
int | j, | ||
T | value ) const |
Set the element in row i and column j.
Definition at line 383 of file aggregates.cc.