LSST Applications g0f08755f38+9c285cab97,g1635faa6d4+13f3999e92,g1653933729+a8ce1bb630,g1a0ca8cf93+bf6eb00ceb,g28da252d5a+0829b12dee,g29321ee8c0+5700dc9eac,g2bbee38e9b+9634bc57db,g2bc492864f+9634bc57db,g2cdde0e794+c2c89b37c4,g3156d2b45e+41e33cbcdc,g347aa1857d+9634bc57db,g35bb328faa+a8ce1bb630,g3a166c0a6a+9634bc57db,g3e281a1b8c+9f2c4e2fc3,g414038480c+077ccc18e7,g41af890bb2+fde0dd39b6,g5fbc88fb19+17cd334064,g781aacb6e4+a8ce1bb630,g80478fca09+55a9465950,g82479be7b0+d730eedb7d,g858d7b2824+9c285cab97,g9125e01d80+a8ce1bb630,g9726552aa6+10f999ec6a,ga5288a1d22+2a84bb7594,gacf8899fa4+c69c5206e8,gae0086650b+a8ce1bb630,gb58c049af0+d64f4d3760,gc28159a63d+9634bc57db,gcf0d15dbbd+4b7d09cae4,gda3e153d99+9c285cab97,gda6a2b7d83+4b7d09cae4,gdaeeff99f8+1711a396fd,ge2409df99d+5e831397f4,ge79ae78c31+9634bc57db,gf0baf85859+147a0692ba,gf3967379c6+41c94011de,gf3fb38a9a8+8f07a9901b,gfb92a5be7c+9c285cab97,w.2024.46
LSST Data Management Base Package
|
An immutable representation of a camera. More...
#include <Camera.h>
Classes | |
class | Builder |
A helper class for creating and modifying cameras. More... | |
class | Factory |
Public Types | |
using | DetectorList = DetectorCollection::List |
using | NameMap = std::unordered_map<std::string, std::shared_ptr<T>> |
using | IdMap = std::map<int, std::shared_ptr<T>> |
using | List = std::vector<std::shared_ptr<T>> |
Public Member Functions | |
Camera (Camera const &)=delete | |
Camera (Camera &&)=delete | |
Camera & | operator= (Camera const &)=delete |
Camera & | operator= (Camera &&)=delete |
virtual | ~Camera () noexcept |
Camera::Builder | rebuild () const |
Create a Camera::Builder object initialized with this camera's state. | |
std::string | getName () const |
Return the name of the camera. | |
std::string | getPupilFactoryName () const |
Return the fully-qualified name of the Python class that provides this Camera's PupilFactory. | |
DetectorList | findDetectors (lsst::geom::Point2D const &point, CameraSys const &cameraSys) const |
Find the detectors that cover a point in any camera system. | |
std::vector< DetectorList > | findDetectorsList (std::vector< lsst::geom::Point2D > const &pointList, CameraSys const &cameraSys) const |
Find the detectors that cover a list of points in any camera system. | |
std::shared_ptr< afw::geom::TransformPoint2ToPoint2 > | getTransform (CameraSys const &fromSys, CameraSys const &toSys) const |
Get a transform from one CameraSys to another. | |
std::shared_ptr< TransformMap const > | getTransformMap () const noexcept |
Obtain the transform registry. | |
lsst::geom::Point2D | transform (lsst::geom::Point2D const &point, CameraSys const &fromSys, CameraSys const &toSys) const |
Transform a point from one camera coordinate system to another. | |
std::vector< lsst::geom::Point2D > | transform (std::vector< lsst::geom::Point2D > const &points, CameraSys const &fromSys, CameraSys const &toSys) const |
Transform a vector of points from one camera coordinate system to another. | |
bool | isPersistable () const noexcept override |
Cameras are always persistable. | |
lsst::geom::Box2D const & | getFpBBox () const noexcept |
Return a focal plane bounding box that encompasses all detectors. | |
NameMap const & | getNameMap () const noexcept |
Get a map keyed and ordered by name. | |
IdMap const & | getIdMap () const noexcept |
Get a map keyed and ordered by ID. | |
std::size_t | size () const noexcept |
Get the number of detectors. | |
bool | empty () const noexcept |
Determine if the collection contains any detectors. | |
std::shared_ptr< T > | operator[] (std::string const &name) const |
Implement the [name] operator. | |
std::shared_ptr< T > | operator[] (int id) const |
Implement the [id] operator. | |
std::shared_ptr< T > | get (std::string const &name, std::shared_ptr< T > def=nullptr) const |
Retrieve a detector by name, or fall back to a default. | |
std::shared_ptr< T > | get (int id, std::shared_ptr< T > def=nullptr) const |
Retrieve a detector by ID, or fall back to a default. | |
void | writeFits (std::string const &fileName, std::string const &mode="w") const |
Write the object to a regular FITS file. | |
void | writeFits (fits::MemFileManager &manager, std::string const &mode="w") const |
Write the object to a FITS image in memory. | |
void | writeFits (fits::Fits &fitsfile) const |
Write the object to an already-open FITS object. | |
Static Public Member Functions | |
static std::shared_ptr< DetectorCollection > | readFits (fits::Fits &fitsfile) |
Read an object from an already open FITS object. | |
static std::shared_ptr< DetectorCollection > | readFits (std::string const &fileName, int hdu=fits::DEFAULT_HDU) |
Read an object from a regular FITS file. | |
static std::shared_ptr< DetectorCollection > | readFits (fits::MemFileManager &manager, int hdu=fits::DEFAULT_HDU) |
Read an object from a FITS file in memory. | |
static std::shared_ptr< DetectorCollection > | dynamicCast (std::shared_ptr< Persistable > const &ptr) |
Dynamically cast a shared_ptr. | |
static std::shared_ptr< Camera > | readFits (fits::Fits &fitsfile) |
Read an object from an already open FITS object. | |
static std::shared_ptr< Camera > | readFits (std::string const &fileName, int hdu=fits::DEFAULT_HDU) |
Read an object from a regular FITS file. | |
static std::shared_ptr< Camera > | readFits (fits::MemFileManager &manager, int hdu=fits::DEFAULT_HDU) |
Read an object from a FITS file in memory. | |
static std::shared_ptr< Camera > | dynamicCast (std::shared_ptr< Persistable > const &ptr) |
Dynamically cast a shared_ptr. | |
Protected Types | |
using | OutputArchiveHandle = io::OutputArchiveHandle |
Protected Member Functions | |
void | write (OutputArchiveHandle &handle) const override |
Write the object to one or more catalogs. | |
std::string | getPythonModule () const override |
Return the fully-qualified Python module that should be imported to guarantee that its factory is registered. | |
void | add (std::shared_ptr< T > detector) |
Add a detector to the collection. | |
void | remove (std::string const &name) |
void | remove (int id) |
Private Member Functions | |
std::string | getPersistenceName () const override |
Return the unique name used to persist this object and look up its factory. | |
An immutable representation of a camera.
Cameras are created (and modified, when necessary) via the Camera::Builder helper class.
|
inherited |
Definition at line 53 of file DetectorCollection.h.
|
inherited |
Definition at line 54 of file DetectorCollection.h.
|
inherited |
Definition at line 52 of file DetectorCollection.h.
|
protectedinherited |
Definition at line 108 of file Persistable.h.
|
delete |
|
delete |
|
virtualdefaultnoexcept |
|
protectedinherited |
Add a detector to the collection.
[in] | detector | New detector to add to the collection. |
pex::exceptions::RuntimeError | Thrown if the ID and/or name conflict with those of detectors already in the collection. |
Definition at line 89 of file DetectorCollection.cc.
|
staticinherited |
Dynamically cast a shared_ptr.
Dynamically cast a shared pointer and raise on failure.
You must provide an explicit template instantiation in the .cc file for each class that inherits from PersistableFacade. Designed to work around RTTI issues on macOS with hidden symbols;
lsst::pex::exceptions::LogicError | if the cast fails |
param[in] ptr The pointer to be cast.
lsst::pex::exceptions::TypeError | If the dynamic cast fails. |
Definition at line 218 of file Persistable.cc.
|
staticinherited |
Dynamically cast a shared_ptr.
Dynamically cast a shared pointer and raise on failure.
You must provide an explicit template instantiation in the .cc file for each class that inherits from PersistableFacade. Designed to work around RTTI issues on macOS with hidden symbols;
lsst::pex::exceptions::LogicError | if the cast fails |
param[in] ptr The pointer to be cast.
lsst::pex::exceptions::TypeError | If the dynamic cast fails. |
Definition at line 218 of file Persistable.cc.
|
inlinenoexceptinherited |
Determine if the collection contains any detectors.
Definition at line 72 of file DetectorCollection.h.
Camera::DetectorList lsst::afw::cameraGeom::Camera::findDetectors | ( | lsst::geom::Point2D const & | point, |
CameraSys const & | cameraSys ) const |
Find the detectors that cover a point in any camera system.
[in] | point | position to use in lookup (lsst::geom::Point2D) |
[in] | cameraSys | camera coordinate system of point |
Definition at line 45 of file Camera.cc.
std::vector< Camera::DetectorList > lsst::afw::cameraGeom::Camera::findDetectorsList | ( | std::vector< lsst::geom::Point2D > const & | pointList, |
CameraSys const & | cameraSys ) const |
Find the detectors that cover a list of points in any camera system.
[in] | pointList | a list of points (lsst::geom::Point2D) |
[in] | cameraSys | the camera coordinate system of the points in pointList |
Definition at line 60 of file Camera.cc.
|
inherited |
Retrieve a detector by ID, or fall back to a default.
[in] | id | detector id |
[in] | def | default detector to return. This defaults to nullptr . |
Definition at line 65 of file DetectorCollection.cc.
|
inherited |
Retrieve a detector by name, or fall back to a default.
[in] | name | detector name |
[in] | def | default detector to return. This defaults to nullptr . |
Definition at line 56 of file DetectorCollection.cc.
|
inlinenoexceptinherited |
Return a focal plane bounding box that encompasses all detectors.
Definition at line 159 of file DetectorCollection.h.
|
inlinenoexceptinherited |
Get a map keyed and ordered by ID.
Definition at line 62 of file DetectorCollection.h.
|
inline |
|
inlinenoexceptinherited |
Get a map keyed and ordered by name.
Definition at line 59 of file DetectorCollection.h.
|
overrideprivatevirtual |
Return the unique name used to persist this object and look up its factory.
Must be less than ArchiveIndexSchema::MAX_NAME_LENGTH characters.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 201 of file Camera.cc.
|
inline |
|
overrideprotectedvirtualinherited |
Return the fully-qualified Python module that should be imported to guarantee that its factory is registered.
Must be less than ArchiveIndexSchema::MAX_MODULE_LENGTH characters.
Will be ignored if empty.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 246 of file DetectorCollection.cc.
std::shared_ptr< afw::geom::TransformPoint2ToPoint2 > lsst::afw::cameraGeom::Camera::getTransform | ( | CameraSys const & | fromSys, |
CameraSys const & | toSys ) const |
Get a transform from one CameraSys to another.
fromSys
to toSys
in the forward directionlsst::pex::exceptions::InvalidParameterError | if no transform is available. |
KeyError | if an unknown detector is specified |
Definition at line 78 of file Camera.cc.
|
inlinenoexcept |
Obtain the transform registry.
Definition at line 120 of file Camera.h.
|
inlineoverridevirtualnoexcept |
Cameras are always persistable.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 148 of file Camera.h.
|
inherited |
Implement the [id] operator.
[in] | id | detector name |
Definition at line 46 of file DetectorCollection.cc.
|
inherited |
Implement the [name] operator.
[in] | name | detector name |
Definition at line 36 of file DetectorCollection.cc.
|
inlinestaticinherited |
Read an object from an already open FITS object.
[in] | fitsfile | FITS object to read from, already positioned at the desired HDU. |
Definition at line 183 of file Persistable.h.
|
inlinestaticinherited |
Read an object from an already open FITS object.
[in] | fitsfile | FITS object to read from, already positioned at the desired HDU. |
Definition at line 183 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a FITS file in memory.
[in] | manager | Manager for the memory to read from. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 205 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a FITS file in memory.
[in] | manager | Manager for the memory to read from. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 205 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a regular FITS file.
[in] | fileName | Name of the file to read. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 194 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a regular FITS file.
[in] | fileName | Name of the file to read. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 194 of file Persistable.h.
Camera::Builder lsst::afw::cameraGeom::Camera::rebuild | ( | ) | const |
Create a Camera::Builder object initialized with this camera's state.
This is simply a shortcut for Camera::Builder(*this)
.
Definition at line 41 of file Camera.cc.
|
protectedinherited |
Definition at line 144 of file DetectorCollection.cc.
|
protectedinherited |
Definition at line 129 of file DetectorCollection.cc.
|
inlinenoexceptinherited |
Get the number of detectors.
Renamed to __len__
in Python.
Definition at line 67 of file DetectorCollection.h.
lsst::geom::Point2D lsst::afw::cameraGeom::Camera::transform | ( | lsst::geom::Point2D const & | point, |
CameraSys const & | fromSys, | ||
CameraSys const & | toSys ) const |
Transform a point from one camera coordinate system to another.
[in] | point | an lsst::geom::Point2d |
[in] | fromSys | transform from this CameraSys |
[in] | toSys | transform to this CameraSys |
toSys
(an lsst::geom::Point2D) Definition at line 83 of file Camera.cc.
std::vector< lsst::geom::Point2D > lsst::afw::cameraGeom::Camera::transform | ( | std::vector< lsst::geom::Point2D > const & | points, |
CameraSys const & | fromSys, | ||
CameraSys const & | toSys ) const |
Transform a vector of points from one camera coordinate system to another.
[in] | points | an vector of lsst::geom::Point2d |
[in] | fromSys | transform from this CameraSys |
[in] | toSys | transform to this CameraSys |
toSys
(a vector of lsst::geom::Point2D) Definition at line 89 of file Camera.cc.
|
overrideprotectedvirtual |
Write the object to one or more catalogs.
The handle object passed to this function provides an interface for adding new catalogs and adding nested objects to the same archive (while checking for duplicates). See OutputArchiveHandle for more information.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 149 of file Camera.cc.
|
inherited |
Write the object to an already-open FITS object.
[in] | fitsfile | Open FITS object to write to. |
Definition at line 18 of file Persistable.cc.
|
inherited |
Write the object to a FITS image in memory.
[in] | manager | Name of the file to write to. |
[in] | mode | If "w", any existing file with the given name will be overwritten. If "a", new HDUs will be appended to an existing file. |
Definition at line 29 of file Persistable.cc.
|
inherited |
Write the object to a regular FITS file.
[in] | fileName | Name of the file to write to. |
[in] | mode | If "w", any existing file with the given name will be overwritten. If "a", new HDUs will be appended to an existing file. |
Definition at line 24 of file Persistable.cc.