Table class used to store exposure metadata. More...

#include <Exposure.h>

Inheritance diagram for lsst::afw::table::ExposureTable:

Public Types
using	Record = ExposureRecord

using	ColumnView = ColumnViewT<ExposureRecord>

using	Catalog = ExposureCatalogT<Record>

using	ConstCatalog = ExposureCatalogT<const Record>

Public Member Functions
std::shared_ptr< ExposureTable >	clone () const
	Return a polymorphic deep copy of the table.

std::shared_ptr< ExposureRecord >	makeRecord ()
	Default-construct an associated record.

std::shared_ptr< ExposureRecord >	copyRecord (BaseRecord const &other)
	Deep-copy a record, requiring that it have the same schema as this table.

std::shared_ptr< ExposureRecord >	copyRecord (BaseRecord const &other, SchemaMapper const &mapper)
	Deep-copy a record, requiring that it have the same schema as this table.

ExposureTable &	operator= (ExposureTable const &)=delete

ExposureTable &	operator= (ExposureTable &&)=delete

	~ExposureTable () override

std::shared_ptr< daf::base::PropertyList >	getMetadata () const
	Return the flexible metadata associated with the table. May be null.

void	setMetadata (std::shared_ptr< daf::base::PropertyList > const &metadata)
	Set the flexible metadata associated with the table. May be null.

std::shared_ptr< daf::base::PropertyList >	popMetadata ()
	Return the metadata and set the internal metadata to a null pointer.

Schema	getSchema () const
	Return the table's schema.

void	preallocate (std::size_t nRecords)
	Allocate contiguous space for new records in advance.

std::size_t	getBufferSize () const
	Return the number of additional records space has been already been allocated for.

T	shared_from_this (T... args)

Static Public Member Functions
static std::shared_ptr< ExposureTable >	make (Schema const &schema)
	Construct a new table.

static Schema	makeMinimalSchema ()
	Return a minimal schema for Exposure tables and records.

static bool	checkSchema (Schema const &other)
	Return true if the given schema is a valid ExposureTable schema.

static Key< RecordId >	getIdKey ()
	Get keys for standard fields shared by all references.

static PointKey< int >	getBBoxMinKey ()
	Key for the minimum point of the bbox.

static PointKey< int >	getBBoxMaxKey ()
	Key for the maximum point of the bbox.

static Box2IKey	getBBoxKey ()
	Key for the full bbox.

Static Public Attributes
static int	nRecordsPerBlock = 100
	Number of records in each memory block.

Protected Member Functions
	ExposureTable (Schema const &schema)

	ExposureTable (ExposureTable const &other)

std::shared_ptr< BaseTable >	_clone () const override
	Clone implementation with noncovariant return types.

std::shared_ptr< BaseRecord >	_makeRecord () override
	Default-construct an associated record (protected implementation).

template<typename RecordT , typename... Args>
std::shared_ptr< RecordT >	constructRecord (Args &&... args)
	Helper function that must be used by all _makeRecord overrides to actually construct records.

virtual void	handleAliasChange (std::string const &alias)

Private Member Functions
std::shared_ptr< io::FitsWriter >	makeFitsWriter (fits::Fits *fitsfile, int flags) const override

Friends
class	io::FitsWriter

template<typename RecordT >
class	ExposureCatalogT

Detailed Description

Table class used to store exposure metadata.

Definition at line 195 of file Exposure.h.

Member Typedef Documentation

◆ Catalog

using lsst::afw::table::ExposureTable::Catalog = ExposureCatalogT<Record>

Definition at line 199 of file Exposure.h.

◆ ColumnView

using lsst::afw::table::ExposureTable::ColumnView = ColumnViewT<ExposureRecord>

Definition at line 198 of file Exposure.h.

◆ ConstCatalog

using lsst::afw::table::ExposureTable::ConstCatalog = ExposureCatalogT<const Record>

Definition at line 200 of file Exposure.h.

◆ Record

using lsst::afw::table::ExposureTable::Record = ExposureRecord

Definition at line 197 of file Exposure.h.

Constructor & Destructor Documentation

◆ ~ExposureTable()

lsst::afw::table::ExposureTable::~ExposureTable ( )

overridedefault

◆ ExposureTable() [1/2]

lsst::afw::table::ExposureTable::ExposureTable ( Schema const & schema )

explicitprotected

Definition at line 405 of file Exposure.cc.

405: BaseTable(schema) {}

lsst::afw::table::BaseTable::BaseTable

BaseTable(Schema const &schema, std::shared_ptr< daf::base::PropertyList > metadata=nullptr)

Construct from a schema.

Definition BaseTable.cc:152

◆ ExposureTable() [2/2]

lsst::afw::table::ExposureTable::ExposureTable ( ExposureTable const & other )

protecteddefault

Member Function Documentation

◆ _clone()

std::shared_ptr< BaseTable > lsst::afw::table::ExposureTable::_clone ( ) const

overrideprotectedvirtual

Clone implementation with noncovariant return types.

Reimplemented from lsst::afw::table::BaseTable.

Definition at line 431 of file Exposure.cc.

                                                     {
    std::shared_ptr<ExposureTable> table(new ExposureTable(*this));
    table->getSchema().getAliasMap()->setTable(table);
    return table;
}

◆ _makeRecord()

std::shared_ptr< BaseRecord > lsst::afw::table::ExposureTable::_makeRecord ( )

overrideprotectedvirtual

Default-construct an associated record (protected implementation).

Reimplemented from lsst::afw::table::BaseTable.

Definition at line 437 of file Exposure.cc.

                                                     {
    return constructRecord<ExposureRecord>();
}

◆ checkSchema()

static bool lsst::afw::table::ExposureTable::checkSchema ( Schema const & other )

inlinestatic

Return true if the given schema is a valid ExposureTable schema.

This will always be true if the given schema was originally constructed using makeMinimalSchema(), and will rarely be true otherwise.

Definition at line 228 of file Exposure.h.

228{ return other.contains(getMinimalSchema().schema); }

◆ clone()

std::shared_ptr< ExposureTable > lsst::afw::table::ExposureTable::clone ( ) const

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 247 of file Exposure.h.

247{ return std::static_pointer_cast<ExposureTable>(_clone()); }

lsst::afw::table::ExposureTable::_clone

std::shared_ptr< BaseTable > _clone() const override

Clone implementation with noncovariant return types.

Definition Exposure.cc:431

◆ constructRecord()

template<typename RecordT , typename ... Args>

std::shared_ptr< RecordT > lsst::afw::table::BaseTable::constructRecord ( Args &&... args )

protectedinherited

Helper function that must be used by all _makeRecord overrides to actually construct records.

Use of this function is enforced by the fact that Record::ConstructionToken can only be created by BaseTable, and is only ever constructed inside this method.

This function expects Record subclasses to have a constructor signature of the form

Record(ConstructionToken const &, detail::RecordData &&, Args && ...);

Definition at line 227 of file BaseRecord.h.

                                                                 {
    return std::make_shared<RecordT>(BaseRecord::ConstructionToken(0), _makeNewRecordData(),
                                     std::forward<Args>(args)...);
}

◆ copyRecord() [1/2]

std::shared_ptr< ExposureRecord > lsst::afw::table::ExposureTable::copyRecord ( BaseRecord const & other )

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 255 of file Exposure.h.

                                                                      {
        return std::static_pointer_cast<ExposureRecord>(BaseTable::copyRecord(other));
    }

◆ copyRecord() [2/2]

std::shared_ptr< ExposureRecord > lsst::afw::table::ExposureTable::copyRecord	(	BaseRecord const &	other,
		SchemaMapper const &	mapper )

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 260 of file Exposure.h.

                                                                                                  {
        return std::static_pointer_cast<ExposureRecord>(BaseTable::copyRecord(other, mapper));
    }

◆ getBBoxKey()

static Box2IKey lsst::afw::table::ExposureTable::getBBoxKey ( )

inlinestatic

Key for the full bbox.

Definition at line 243 of file Exposure.h.

243{ return getMinimalSchema().bbox; }

◆ getBBoxMaxKey()

static PointKey< int > lsst::afw::table::ExposureTable::getBBoxMaxKey ( )

inlinestatic

Key for the maximum point of the bbox.

Definition at line 241 of file Exposure.h.

241{ return getMinimalSchema().bbox.getMax(); }

◆ getBBoxMinKey()

static PointKey< int > lsst::afw::table::ExposureTable::getBBoxMinKey ( )

inlinestatic

Key for the minimum point of the bbox.

Definition at line 239 of file Exposure.h.

239{ return getMinimalSchema().bbox.getMin(); }

◆ getBufferSize()

std::size_t lsst::afw::table::BaseTable::getBufferSize ( ) const

inherited

Return the number of additional records space has been already been allocated for.

Unlike std::vector::capacity, this does not factor in existing records in any way.

Definition at line 112 of file BaseTable.cc.

                                         {
    if (_manager) {
        return Block::getBufferSize(_schema.getRecordSize(), _manager);
    } else {
        return 0;
    }
}

◆ getIdKey()

static Key< RecordId > lsst::afw::table::ExposureTable::getIdKey ( )

inlinestatic

Get keys for standard fields shared by all references.

These keys are used to implement getters and setters on ExposureRecord. Key for the unique ID.

Definition at line 237 of file Exposure.h.

237{ return getMinimalSchema().id; }

◆ getMetadata()

std::shared_ptr< daf::base::PropertyList > lsst::afw::table::BaseTable::getMetadata ( ) const

inlineinherited

Return the flexible metadata associated with the table. May be null.

Definition at line 79 of file BaseTable.h.

79{ return _metadata; }

◆ getSchema()

Schema lsst::afw::table::BaseTable::getSchema ( ) const

inlineinherited

Return the table's schema.

Definition at line 137 of file BaseTable.h.

137{ return _schema; }

◆ handleAliasChange()

virtual void lsst::afw::table::BaseTable::handleAliasChange ( std::string const & alias )

inlineprotectedvirtualinherited

Reimplemented in lsst::afw::table::SourceTable.

Definition at line 207 of file BaseTable.h.

207{}

◆ make()

std::shared_ptr< ExposureTable > lsst::afw::table::ExposureTable::make ( Schema const & schema )

static

Construct a new table.

Parameters

[in] schema Schema that defines the fields, offsets, and record size for the table.

Definition at line 394 of file Exposure.cc.

                                                                     {
    if (!checkSchema(schema)) {
        throw LSST_EXCEPT(
                lsst::pex::exceptions::InvalidParameterError,
                "Schema for Exposure must contain at least the keys defined by makeMinimalSchema().");
    }
    std::shared_ptr<ExposureTable> table(new ExposureTable(schema));
    table->getSchema().getAliasMap()->setTable(table);
    return table;
}

◆ makeFitsWriter()

std::shared_ptr< io::FitsWriter > lsst::afw::table::ExposureTable::makeFitsWriter	(	fits::Fits *	fitsfile,
		int	flags ) const

overrideprivatevirtual

Reimplemented from lsst::afw::table::BaseTable.

Definition at line 421 of file Exposure.cc.

                                                                                             {
    return std::make_shared<ExposureFitsWriter>(fitsfile, std::shared_ptr<io::OutputArchive>(), flags);
}

◆ makeMinimalSchema()

static Schema lsst::afw::table::ExposureTable::makeMinimalSchema ( )

inlinestatic

Return a minimal schema for Exposure tables and records.

The returned schema can and generally should be modified further, but many operations on ExposureRecords will assume that at least the fields provided by this routine are present.

Definition at line 216 of file Exposure.h.

                                      {
        Schema r = getMinimalSchema().schema;
        r.disconnectAliases();
        return r;
    }

◆ makeRecord()

std::shared_ptr< ExposureRecord > lsst::afw::table::ExposureTable::makeRecord ( )

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 250 of file Exposure.h.

                                               {
        return std::static_pointer_cast<ExposureRecord>(_makeRecord());
    }

◆ operator=() [1/2]

ExposureTable & lsst::afw::table::ExposureTable::operator= ( ExposureTable && )

delete

◆ operator=() [2/2]

ExposureTable & lsst::afw::table::ExposureTable::operator= ( ExposureTable const & )

delete

◆ popMetadata()

std::shared_ptr< daf::base::PropertyList > lsst::afw::table::BaseTable::popMetadata ( )

inlineinherited

Return the metadata and set the internal metadata to a null pointer.

Definition at line 85 of file BaseTable.h.

                                                     {
        std::shared_ptr<daf::base::PropertyList> tmp;
        _metadata.swap(tmp);
        return tmp;
    }

◆ preallocate()

void lsst::afw::table::BaseTable::preallocate ( std::size_t nRecords )

inherited

Allocate contiguous space for new records in advance.

If a contiguous memory block for at least n additional records has already been allocated, this is a no-op. If not, a new block will be allocated, and any remaining space on the old block will go to waste; this ensures the new records will be allocated contiguously. Note that "wasted" memory is not leaked; it will be deallocated along with any records created from that block when those records go out of scope.

Note that unlike std::vector::reserve, this does not factor in existing records in any way; nRecords refers to a number of new records to reserve space for.

Definition at line 110 of file BaseTable.cc.

110{ Block::preallocate(_schema.getRecordSize(), n, _manager); }

◆ setMetadata()

void lsst::afw::table::BaseTable::setMetadata ( std::shared_ptr< daf::base::PropertyList > const & metadata )

inlineinherited

Set the flexible metadata associated with the table. May be null.

Definition at line 82 of file BaseTable.h.

82{ _metadata = metadata; }

Friends And Related Symbol Documentation

◆ ExposureCatalogT

template<typename RecordT >

friend class ExposureCatalogT

friend

Definition at line 293 of file Exposure.h.

◆ io::FitsWriter

friend class io::FitsWriter

friend

Definition at line 290 of file Exposure.h.

Member Data Documentation

◆ nRecordsPerBlock

int lsst::afw::table::BaseTable::nRecordsPerBlock = 100

staticinherited

Number of records in each memory block.

Definition at line 76 of file BaseTable.h.

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

/j/snowflake/release/lsstsw/stack/lsst-scipipe-9.0.0/Linux64/afw/g9726552aa6+10f999ec6a/include/lsst/afw/table/Exposure.h
/j/snowflake/release/lsstsw/stack/lsst-scipipe-9.0.0/Linux64/afw/g9726552aa6+10f999ec6a/src/table/Exposure.cc

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Private Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ Catalog

◆ ColumnView

◆ ConstCatalog

◆ Record

Constructor & Destructor Documentation

◆ ~ExposureTable()

◆ ExposureTable() [1/2]

◆ ExposureTable() [2/2]

Member Function Documentation

◆ _clone()

◆ _makeRecord()

◆ checkSchema()

◆ clone()

◆ constructRecord()

◆ copyRecord() [1/2]

◆ copyRecord() [2/2]

◆ getBBoxKey()

◆ getBBoxMaxKey()

◆ getBBoxMinKey()

◆ getBufferSize()

◆ getIdKey()

◆ getMetadata()

◆ getSchema()

◆ handleAliasChange()

◆ make()

◆ makeFitsWriter()

◆ makeMinimalSchema()

◆ makeRecord()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ popMetadata()

◆ preallocate()

◆ setMetadata()

Friends And Related Symbol Documentation

◆ ExposureCatalogT

◆ io::FitsWriter

Member Data Documentation

◆ nRecordsPerBlock