LSSTApplications
10.0-2-g4f67435,11.0.rc2+1,11.0.rc2+12,11.0.rc2+3,11.0.rc2+4,11.0.rc2+5,11.0.rc2+6,11.0.rc2+7,11.0.rc2+8
LSSTDataManagementBasePackage
|
Table class that contains measurements made on a single exposure. More...
#include <Source.h>
Classes | |
struct | MinimalSchema |
Public Types | |
typedef SourceRecord | Record |
typedef SourceColumnViewT < SourceRecord > | ColumnView |
typedef SortedCatalogT< Record > | Catalog |
typedef SortedCatalogT< Record const > | ConstCatalog |
Public Types inherited from lsst.afw.table::SimpleTable | |
typedef SimpleRecord | Record |
typedef ColumnViewT< SimpleRecord > | ColumnView |
typedef SortedCatalogT< Record > | Catalog |
typedef SortedCatalogT< Record const > | ConstCatalog |
Public Types inherited from lsst.afw.table::BaseTable | |
typedef BaseRecord | Record |
The associated record class. More... | |
typedef BaseColumnView | ColumnView |
The associated ColumnView class. More... | |
typedef CatalogT< Record > | Catalog |
Template of CatalogT used to hold records of the associated type. More... | |
typedef CatalogT< Record const > | ConstCatalog |
Template of CatalogT used to hold const records of the associated type. More... | |
Public Types inherited from lsst::daf::base::Citizen | |
enum | { magicSentinel = 0xdeadbeef } |
typedef unsigned long | memId |
Type of the block's ID. More... | |
typedef memId(* | memNewCallback )(const memId cid) |
A function used to register a callback. More... | |
typedef memId(* | memCallback )(const Citizen *ptr) |
Public Member Functions | |
boost::shared_ptr< SourceTable > | clone () const |
Return a polymorphic deep copy of the table. More... | |
boost::shared_ptr< SourceRecord > | makeRecord () |
Default-construct an associated record. More... | |
boost::shared_ptr< SourceRecord > | copyRecord (BaseRecord const &other) |
Deep-copy a record, requiring that it have the same schema as this table. More... | |
boost::shared_ptr< SourceRecord > | copyRecord (BaseRecord const &other, SchemaMapper const &mapper) |
Deep-copy a record, requiring that it have the same schema as this table. More... | |
FluxSlotDefinition const & | getPsfFluxSlot () const |
void | definePsfFlux (std::string const &name) |
Set the measurement used for the PsfFlux slot. More... | |
std::string | getPsfFluxDefinition () const |
Return the name of the field used for the PsfFlux slot. More... | |
bool | hasPsfFluxSlot () const |
Return true if the PsfFlux slot corresponds to a valid field. More... | |
FluxSlotDefinition::MeasKey | getPsfFluxKey () const |
Return the key used for the PsfFlux slot measurement value. More... | |
FluxSlotDefinition::ErrKey | getPsfFluxErrKey () const |
Return the key used for the PsfFlux slot uncertainty. More... | |
Key< Flag > | getPsfFluxFlagKey () const |
Return the key used for the PsfFlux slot failure flag. More... | |
FluxSlotDefinition const & | getModelFluxSlot () const |
void | defineModelFlux (std::string const &name) |
Set the measurement used for the ModelFlux slot. More... | |
std::string | getModelFluxDefinition () const |
Return the name of the field used for the ModelFlux slot. More... | |
bool | hasModelFluxSlot () const |
Return true if the ModelFlux slot corresponds to a valid field. More... | |
FluxSlotDefinition::MeasKey | getModelFluxKey () const |
Return the key used for the ModelFlux slot measurement value. More... | |
FluxSlotDefinition::ErrKey | getModelFluxErrKey () const |
Return the key used for the ModelFlux slot uncertainty. More... | |
Key< Flag > | getModelFluxFlagKey () const |
Return the key used for the ModelFlux slot failure flag. More... | |
FluxSlotDefinition const & | getApFluxSlot () const |
void | defineApFlux (std::string const &name) |
Set the measurement used for the ApFlux slot. More... | |
std::string | getApFluxDefinition () const |
Return the name of the field used for the ApFlux slot. More... | |
bool | hasApFluxSlot () const |
Return true if the ApFlux slot corresponds to a valid field. More... | |
FluxSlotDefinition::MeasKey | getApFluxKey () const |
Return the key used for the ApFlux slot measurement value. More... | |
FluxSlotDefinition::ErrKey | getApFluxErrKey () const |
Return the key used for the ApFlux slot uncertainty. More... | |
Key< Flag > | getApFluxFlagKey () const |
Return the key used for the ApFlux slot failure flag. More... | |
FluxSlotDefinition const & | getInstFluxSlot () const |
void | defineInstFlux (std::string const &name) |
Set the measurement used for the InstFlux slot. More... | |
std::string | getInstFluxDefinition () const |
Return the name of the field used for the InstFlux slot. More... | |
bool | hasInstFluxSlot () const |
Return true if the InstFlux slot corresponds to a valid field. More... | |
FluxSlotDefinition::MeasKey | getInstFluxKey () const |
Return the key used for the InstFlux slot measurement value. More... | |
FluxSlotDefinition::ErrKey | getInstFluxErrKey () const |
Return the key used for the InstFlux slot uncertainty. More... | |
Key< Flag > | getInstFluxFlagKey () const |
Return the key used for the InstFlux slot failure flag. More... | |
FluxSlotDefinition const & | getCalibFluxSlot () const |
void | defineCalibFlux (std::string const &name) |
Set the measurement used for the CalibFlux slot. More... | |
std::string | getCalibFluxDefinition () const |
Return the name of the field used for the CalibFlux slot. More... | |
bool | hasCalibFluxSlot () const |
Return true if the CalibFlux slot corresponds to a valid field. More... | |
FluxSlotDefinition::MeasKey | getCalibFluxKey () const |
Return the key used for the CalibFlux slot measurement value. More... | |
FluxSlotDefinition::ErrKey | getCalibFluxErrKey () const |
Return the key used for the CalibFlux slot uncertainty. More... | |
Key< Flag > | getCalibFluxFlagKey () const |
Return the key used for the CalibFlux slot failure flag. More... | |
CentroidSlotDefinition const & | getCentroidSlot () const |
void | defineCentroid (std::string const &name) |
Set the measurement used for the Centroid slot. More... | |
std::string | getCentroidDefinition () const |
Return the name of the field used for the Centroid slot. More... | |
bool | hasCentroidSlot () const |
Return true if the Centroid slot corresponds to a valid field. More... | |
CentroidSlotDefinition::MeasKey | getCentroidKey () const |
Return the key used for the Centroid slot measurement value. More... | |
CentroidSlotDefinition::ErrKey | getCentroidErrKey () const |
Return the key used for the Centroid slot uncertainty. More... | |
Key< Flag > | getCentroidFlagKey () const |
Return the key used for the Centroid slot failure flag. More... | |
ShapeSlotDefinition const & | getShapeSlot () const |
void | defineShape (std::string const &name) |
Set the measurement used for the Shape slot. More... | |
std::string | getShapeDefinition () const |
Return the name of the field used for the Shape slot. More... | |
bool | hasShapeSlot () const |
Return true if the Shape slot corresponds to a valid field. More... | |
ShapeSlotDefinition::MeasKey | getShapeKey () const |
Return the key used for the Shape slot measurement value. More... | |
ShapeSlotDefinition::ErrKey | getShapeErrKey () const |
Return the key used for the Shape slot uncertainty. More... | |
Key< Flag > | getShapeFlagKey () const |
Return the key used for the Shape slot failure flag. More... | |
Public Member Functions inherited from lsst.afw.table::SimpleTable | |
boost::shared_ptr< IdFactory > | getIdFactory () |
Return the object that generates IDs for the table (may be null). More... | |
boost::shared_ptr< IdFactory const > | getIdFactory () const |
Return the object that generates IDs for the table (may be null). More... | |
void | setIdFactory (boost::shared_ptr< IdFactory > f) |
Switch to a new IdFactory – object that generates IDs for the table (may be null). More... | |
boost::shared_ptr< SimpleTable > | clone () const |
Return a polymorphic deep copy of the table. More... | |
boost::shared_ptr< SimpleRecord > | makeRecord () |
Default-construct an associated record. More... | |
boost::shared_ptr< SimpleRecord > | copyRecord (BaseRecord const &other) |
Deep-copy a record, requiring that it have the same schema as this table. More... | |
boost::shared_ptr< SimpleRecord > | copyRecord (BaseRecord const &other, SchemaMapper const &mapper) |
Deep-copy a record, requiring that it have the same schema as this table. More... | |
Public Member Functions inherited from lsst.afw.table::BaseTable | |
boost::shared_ptr < daf::base::PropertyList > | getMetadata () const |
Return the flexible metadata associated with the table. May be null. More... | |
void | setMetadata (boost::shared_ptr< daf::base::PropertyList > const &metadata) |
Set the flexible metadata associated with the table. May be null. More... | |
boost::shared_ptr < daf::base::PropertyList > | popMetadata () |
Return the metadata and set the internal metadata to a null pointer. More... | |
boost::shared_ptr< BaseTable > | clone () const |
Return a polymorphic deep copy of the table. More... | |
boost::shared_ptr< BaseRecord > | makeRecord () |
Default-construct an associated record. More... | |
boost::shared_ptr< BaseRecord > | copyRecord (BaseRecord const &input) |
Deep-copy a record, requiring that it have the same schema as this table. More... | |
boost::shared_ptr< BaseRecord > | copyRecord (BaseRecord const &input, SchemaMapper const &mapper) |
Deep-copy a record, using a mapper to relate two schemas. More... | |
Schema | getSchema () const |
Return the table's schema. More... | |
void | preallocate (std::size_t nRecords) |
Allocate contiguous space for new records in advance. More... | |
std::size_t | getBufferSize () const |
Return the number of additional records space has been already been allocated for. More... | |
virtual | ~BaseTable () |
Public Member Functions inherited from lsst::daf::base::Citizen | |
Citizen (const std::type_info &) | |
Citizen (Citizen const &) | |
~Citizen () | |
Citizen & | operator= (Citizen const &) |
std::string | repr () const |
Return a string representation of a Citizen. More... | |
void | markPersistent (void) |
Mark a Citizen as persistent and not destroyed until process end. More... | |
memId | getId () const |
Return the Citizen's ID. More... | |
Static Public Member Functions | |
static boost::shared_ptr < SourceTable > | make (Schema const &schema, boost::shared_ptr< IdFactory > const &idFactory) |
Construct a new table. More... | |
static boost::shared_ptr < SourceTable > | make (Schema const &schema) |
Construct a new table. More... | |
static Schema | makeMinimalSchema () |
Return a minimal schema for Source tables and records. More... | |
static bool | checkSchema (Schema const &other) |
Return true if the given schema is a valid SourceTable schema. More... | |
static Key< RecordId > | getParentKey () |
Key for the parent ID. More... | |
Static Public Member Functions inherited from lsst.afw.table::SimpleTable | |
static boost::shared_ptr < SimpleTable > | make (Schema const &schema, boost::shared_ptr< IdFactory > const &idFactory) |
Construct a new table. More... | |
static boost::shared_ptr < SimpleTable > | make (Schema const &schema) |
Construct a new table. More... | |
static Schema | makeMinimalSchema () |
Return a minimal schema for Simple tables and records. More... | |
static bool | checkSchema (Schema const &other) |
Return true if the given schema is a valid SimpleTable schema. More... | |
static Key< RecordId > | getIdKey () |
Key for the unique ID. More... | |
static CoordKey | getCoordKey () |
Key for the celestial coordinates. More... | |
Static Public Member Functions inherited from lsst.afw.table::BaseTable | |
static boost::shared_ptr < BaseTable > | make (Schema const &schema) |
Construct a new table. More... | |
Static Public Member Functions inherited from lsst::daf::base::Citizen | |
static bool | hasBeenCorrupted () |
Check all allocated blocks for corruption. More... | |
static memId | getNextMemId () |
Return the memId of the next object to be allocated. More... | |
static int | init () |
Called once when the memory system is being initialised. More... | |
static int | census (int, memId startingMemId=0) |
How many active Citizens are there? More... | |
static void | census (std::ostream &stream, memId startingMemId=0) |
Print a list of all active Citizens to stream, sorted by ID. More... | |
static const std::vector < const Citizen * > * | census () |
Return a (newly allocated) std::vector of active Citizens sorted by ID. More... | |
static memId | setNewCallbackId (memId id) |
Call the NewCallback when block is allocated. More... | |
static memId | setDeleteCallbackId (memId id) |
Call the current DeleteCallback when block is deleted. More... | |
static memNewCallback | setNewCallback (memNewCallback func) |
Set the NewCallback function. More... | |
static memCallback | setDeleteCallback (memCallback func) |
Set the DeleteCallback function. More... | |
static memCallback | setCorruptionCallback (memCallback func) |
Set the CorruptionCallback function. More... | |
Protected Member Functions | |
SourceTable (Schema const &schema, boost::shared_ptr< IdFactory > const &idFactory) | |
SourceTable (SourceTable const &other) | |
virtual void | handleAliasChange (std::string const &alias) |
Protected Member Functions inherited from lsst.afw.table::SimpleTable | |
SimpleTable (Schema const &schema, boost::shared_ptr< IdFactory > const &idFactory) | |
SimpleTable (SimpleTable const &other) | |
Protected Member Functions inherited from lsst.afw.table::BaseTable | |
template<typename Derived > | |
boost::shared_ptr< Derived > | getSelf () |
Convenience function for static-casting shared_from_this for use by derived classes. More... | |
template<typename Derived > | |
boost::shared_ptr< Derived const > | getSelf () const |
Convenience function for static-casting shared_from_this for use by derived classes. More... | |
virtual boost::shared_ptr < BaseTable > | _clone () const =0 |
Clone implementation with noncovariant return types. More... | |
virtual boost::shared_ptr < BaseRecord > | _makeRecord ()=0 |
Default-construct an associated record (protected implementation). More... | |
BaseTable (Schema const &schema) | |
Construct from a schema. More... | |
BaseTable (BaseTable const &other) | |
Copy construct. More... | |
Private Member Functions | |
virtual boost::shared_ptr < io::FitsWriter > | makeFitsWriter (fits::Fits *fitsfile, int flags) const |
Static Private Member Functions | |
static MinimalSchema & | getMinimalSchema () |
Private Attributes | |
SlotSuite | _slots |
Friends | |
class | io::FitsWriter |
class | SourceRecord |
Additional Inherited Members | |
Static Public Attributes inherited from lsst.afw.table::BaseTable | |
static int | nRecordsPerBlock |
Number of records in each memory block. More... | |
Table class that contains measurements made on a single exposure.
typedef SortedCatalogT<Record const> lsst.afw.table::SourceTable::ConstCatalog |
|
protected |
|
protected |
|
inlinestatic |
|
inline |
Return a polymorphic deep copy of the table.
Derived classes should reimplement by static-casting the output of _clone to a pointer-to-derived to simulate covariant return types.
Cloning a table does not clone its associated records; the new table produced by clone() does not have any associated records.
Definition at line 262 of file Source.h.
|
inline |
Deep-copy a record, requiring that it have the same schema as this table.
Regardless of the type or associated table of the input record, the type of the output record will be the type associated with this table and the record instance will be associated with this table.
Allowing derived-class records to be constructed from base-class records could be considered a form of type-slicing, but because we already demand that all records be constructable from nothing but a table, this isn't anything new.
Derived classes should reimplement by static-casting the output of BaseTable::copyRecord to the appropriate BaseRecord subclass.
This is implemented using makeRecord and calling record.assign on the results; override those to change the behavior.
Definition at line 268 of file Source.h.
|
inline |
Deep-copy a record, requiring that it have the same schema as this table.
Regardless of the type or associated table of the input record, the type of the output record will be the type associated with this table and the record instance will be associated with this table.
Allowing derived-class records to be constructed from base-class records could be considered a form of type-slicing, but because we already demand that all records be constructable from nothing but a table, this isn't anything new.
Derived classes should reimplement by static-casting the output of BaseTable::copyRecord to the appropriate BaseRecord subclass.
This is implemented using makeRecord and calling record.assign on the results; override those to change the behavior.
Definition at line 273 of file Source.h.
|
inline |
Set the measurement used for the ApFlux slot.
The definitions for slots are actually managed by the Schema object, and its associated AliasMap, so this simply sets the "slot_ApFlux" alias to point to the given field name prefix. See FluxSlotDefinition for more information.
Definition at line 415 of file Source.h.
|
inline |
Set the measurement used for the CalibFlux slot.
The definitions for slots are actually managed by the Schema object, and its associated AliasMap, so this simply sets the "slot_CalibFlux" alias to point to the given field name prefix. See FluxSlotDefinition for more information.
Definition at line 543 of file Source.h.
|
inline |
Set the measurement used for the Centroid slot.
The definitions for slots are actually managed by the Schema object, and its associated AliasMap, so this simply sets the "slot_Centroid" alias to point to the given field name prefix. See CentroidSlotDefinition for more information.
Definition at line 607 of file Source.h.
|
inline |
Set the measurement used for the InstFlux slot.
The definitions for slots are actually managed by the Schema object, and its associated AliasMap, so this simply sets the "slot_InstFlux" alias to point to the given field name prefix. See FluxSlotDefinition for more information.
Definition at line 479 of file Source.h.
|
inline |
Set the measurement used for the ModelFlux slot.
The definitions for slots are actually managed by the Schema object, and its associated AliasMap, so this simply sets the "slot_ModelFlux" alias to point to the given field name prefix. See FluxSlotDefinition for more information.
Definition at line 351 of file Source.h.
|
inline |
Set the measurement used for the PsfFlux slot.
The definitions for slots are actually managed by the Schema object, and its associated AliasMap, so this simply sets the "slot_PsfFlux" alias to point to the given field name prefix. See FluxSlotDefinition for more information.
Definition at line 287 of file Source.h.
|
inline |
Set the measurement used for the Shape slot.
The definitions for slots are actually managed by the Schema object, and its associated AliasMap, so this simply sets the "slot_Shape" alias to point to the given field name prefix. See ShapeSlotDefinition for more information.
Definition at line 671 of file Source.h.
|
inline |
Return the name of the field used for the ApFlux slot.
NotFoundError | if the slot is not defined. |
Definition at line 429 of file Source.h.
|
inline |
Return the key used for the ApFlux slot uncertainty.
Definition at line 456 of file Source.h.
|
inline |
Return the key used for the ApFlux slot failure flag.
Definition at line 465 of file Source.h.
|
inline |
Return the key used for the ApFlux slot measurement value.
Definition at line 447 of file Source.h.
|
inline |
|
inline |
Return the name of the field used for the CalibFlux slot.
NotFoundError | if the slot is not defined. |
Definition at line 557 of file Source.h.
|
inline |
Return the key used for the CalibFlux slot uncertainty.
Definition at line 584 of file Source.h.
|
inline |
Return the key used for the CalibFlux slot failure flag.
Definition at line 593 of file Source.h.
|
inline |
Return the key used for the CalibFlux slot measurement value.
Definition at line 575 of file Source.h.
|
inline |
|
inline |
Return the name of the field used for the Centroid slot.
NotFoundError | if the slot is not defined. |
Definition at line 621 of file Source.h.
|
inline |
Return the key used for the Centroid slot uncertainty.
Definition at line 648 of file Source.h.
|
inline |
Return the key used for the Centroid slot failure flag.
Definition at line 657 of file Source.h.
|
inline |
Return the key used for the Centroid slot measurement value.
Definition at line 639 of file Source.h.
|
inline |
|
inline |
Return the name of the field used for the InstFlux slot.
NotFoundError | if the slot is not defined. |
Definition at line 493 of file Source.h.
|
inline |
Return the key used for the InstFlux slot uncertainty.
Definition at line 520 of file Source.h.
|
inline |
Return the key used for the InstFlux slot failure flag.
Definition at line 529 of file Source.h.
|
inline |
Return the key used for the InstFlux slot measurement value.
Definition at line 511 of file Source.h.
|
inline |
|
staticprivate |
|
inline |
Return the name of the field used for the ModelFlux slot.
NotFoundError | if the slot is not defined. |
Definition at line 365 of file Source.h.
|
inline |
Return the key used for the ModelFlux slot uncertainty.
Definition at line 392 of file Source.h.
|
inline |
Return the key used for the ModelFlux slot failure flag.
Definition at line 401 of file Source.h.
|
inline |
Return the key used for the ModelFlux slot measurement value.
Definition at line 383 of file Source.h.
|
inline |
|
inline |
Return the name of the field used for the PsfFlux slot.
NotFoundError | if the slot is not defined. |
Definition at line 301 of file Source.h.
|
inline |
Return the key used for the PsfFlux slot uncertainty.
Definition at line 328 of file Source.h.
|
inline |
Return the key used for the PsfFlux slot failure flag.
Definition at line 337 of file Source.h.
|
inline |
Return the key used for the PsfFlux slot measurement value.
Definition at line 319 of file Source.h.
|
inline |
|
inline |
Return the name of the field used for the Shape slot.
NotFoundError | if the slot is not defined. |
Definition at line 685 of file Source.h.
|
inline |
Return the key used for the Shape slot uncertainty.
Definition at line 712 of file Source.h.
|
inline |
Return the key used for the Shape slot failure flag.
Definition at line 721 of file Source.h.
|
inline |
Return the key used for the Shape slot measurement value.
Definition at line 703 of file Source.h.
|
inline |
|
protectedvirtual |
Reimplemented from lsst.afw.table::BaseTable.
|
inline |
Return true if the ApFlux slot corresponds to a valid field.
Definition at line 438 of file Source.h.
|
inline |
Return true if the CalibFlux slot corresponds to a valid field.
Definition at line 566 of file Source.h.
|
inline |
Return true if the Centroid slot corresponds to a valid field.
Definition at line 630 of file Source.h.
|
inline |
Return true if the InstFlux slot corresponds to a valid field.
Definition at line 502 of file Source.h.
|
inline |
Return true if the ModelFlux slot corresponds to a valid field.
Definition at line 374 of file Source.h.
|
inline |
Return true if the PsfFlux slot corresponds to a valid field.
Definition at line 310 of file Source.h.
|
inline |
Return true if the Shape slot corresponds to a valid field.
Definition at line 694 of file Source.h.
|
static |
Construct a new table.
[in] | schema | Schema that defines the fields, offsets, and record size for the table. |
[in] | idFactory | Factory class to generate record IDs when they are not explicitly given. If null, record IDs will default to zero. |
Note that not passing an IdFactory at all will call the other override of make(), which will set the ID factory to IdFactory::makeSimple().
|
inlinestatic |
Construct a new table.
[in] | schema | Schema that defines the fields, offsets, and record size for the table. |
This overload sets the ID factory to IdFactory::makeSimple().
Definition at line 230 of file Source.h.
|
privatevirtual |
Reimplemented from lsst.afw.table::SimpleTable.
|
inlinestatic |
Return a minimal schema for Source tables and records.
The returned schema can and generally should be modified further, but many operations on sources will assume that at least the fields provided by this routine are present.
Keys for the standard fields added by this routine can be obtained from other static member functions of the SourceTable class.
Definition at line 242 of file Source.h.
|
inline |
Default-construct an associated record.
Derived classes should reimplement by static-casting the output of _makeRecord to the appropriate BaseRecord subclass to simulate covariant return types.
Definition at line 265 of file Source.h.
|
friend |
|
friend |