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
Classes | Public Types | Public Member Functions | Static Public Member Functions | Protected Types | Protected Member Functions | List of all members
lsst::afw::cameraGeom::Camera Class Reference

An immutable representation of a camera. More...

#include <Camera.h>

Inheritance diagram for lsst::afw::cameraGeom::Camera:
lsst::afw::cameraGeom::DetectorCollection lsst::afw::table::io::PersistableFacade< Camera > lsst::afw::cameraGeom::DetectorCollectionBase< Detector const > lsst::afw::table::io::PersistableFacade< DetectorCollection > lsst::afw::table::io::Persistable

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< Detector const > >
 
using IdMap = std::map< int, std::shared_ptr< Detector const > >
 
using List = std::vector< std::shared_ptr< Detector const > >
 

Public Member Functions

 Camera (Camera const &)=delete
 
 Camera (Camera &&)=delete
 
Cameraoperator= (Camera const &)=delete
 
Cameraoperator= (Camera &&)=delete
 
virtual ~Camera () noexcept
 
Camera::Builder rebuild () const
 Create a Camera::Builder object initialized with this camera's state. More...
 
std::string getName () const
 Return the name of the camera. More...
 
std::string getPupilFactoryName () const
 Return the fully-qualified name of the Python class that provides this Camera's PupilFactory. More...
 
DetectorList findDetectors (lsst::geom::Point2D const &point, CameraSys const &cameraSys) const
 Find the detectors that cover a point in any camera system. More...
 
std::vector< DetectorListfindDetectorsList (std::vector< lsst::geom::Point2D > const &pointList, CameraSys const &cameraSys) const
 Find the detectors that cover a list of points in any camera system. More...
 
std::shared_ptr< afw::geom::TransformPoint2ToPoint2getTransform (CameraSys const &fromSys, CameraSys const &toSys) const
 Get a transform from one CameraSys to another. More...
 
std::shared_ptr< TransformMap const > getTransformMap () const noexcept
 Obtain the transform registry. More...
 
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. More...
 
std::vector< lsst::geom::Point2Dtransform (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. More...
 
bool isPersistable () const noexcept override
 Cameras are always persistable. More...
 
lsst::geom::Box2D const & getFpBBox () const noexcept
 Return a focal plane bounding box that encompasses all detectors. More...
 
NameMap const & getNameMap () const noexcept
 Get a map keyed and ordered by name. More...
 
IdMap const & getIdMap () const noexcept
 Get a map keyed and ordered by ID. More...
 
std::size_t size () const noexcept
 Get the number of detectors. More...
 
bool empty () const noexcept
 Determine if the collection contains any detectors. More...
 
std::shared_ptr< Detector const > operator[] (std::string const &name) const
 Implement the [name] operator. More...
 
std::shared_ptr< Detector const > operator[] (int id) const
 Implement the [id] operator. More...
 
std::shared_ptr< Detector const > get (std::string const &name, std::shared_ptr< Detector const > def=nullptr) const
 Retrieve a detector by name, or fall back to a default. More...
 
std::shared_ptr< Detector const > get (int id, std::shared_ptr< Detector const > def=nullptr) const
 Retrieve a detector by ID, or fall back to a default. More...
 
void writeFits (std::string const &fileName, std::string const &mode="w") const
 Write the object to a regular FITS file. More...
 
void writeFits (fits::MemFileManager &manager, std::string const &mode="w") const
 Write the object to a FITS image in memory. More...
 
void writeFits (fits::Fits &fitsfile) const
 Write the object to an already-open FITS object. More...
 

Static Public Member Functions

static std::shared_ptr< DetectorCollectionreadFits (fits::Fits &fitsfile)
 Read an object from an already open FITS object. More...
 
static std::shared_ptr< DetectorCollectionreadFits (std::string const &fileName, int hdu=fits::DEFAULT_HDU)
 Read an object from a regular FITS file. More...
 
static std::shared_ptr< DetectorCollectionreadFits (fits::MemFileManager &manager, int hdu=fits::DEFAULT_HDU)
 Read an object from a FITS file in memory. More...
 
static std::shared_ptr< DetectorCollectiondynamicCast (std::shared_ptr< Persistable > const &ptr)
 Dynamically cast a shared_ptr. More...
 
static std::shared_ptr< CamerareadFits (fits::Fits &fitsfile)
 Read an object from an already open FITS object. More...
 
static std::shared_ptr< CamerareadFits (std::string const &fileName, int hdu=fits::DEFAULT_HDU)
 Read an object from a regular FITS file. More...
 
static std::shared_ptr< CamerareadFits (fits::MemFileManager &manager, int hdu=fits::DEFAULT_HDU)
 Read an object from a FITS file in memory. More...
 
static std::shared_ptr< CameradynamicCast (std::shared_ptr< Persistable > const &ptr)
 Dynamically cast a shared_ptr. More...
 

Protected Types

using OutputArchiveHandle = io::OutputArchiveHandle
 

Protected Member Functions

void write (OutputArchiveHandle &handle) const override
 Write the object to one or more catalogs. More...
 
std::string getPythonModule () const override
 Return the fully-qualified Python module that should be imported to guarantee that its factory is registered. More...
 
void add (std::shared_ptr< Detector const > detector)
 Add a detector to the collection. More...
 
void remove (std::string const &name)
 
void remove (int id)
 

Detailed Description

An immutable representation of a camera.

Cameras are created (and modified, when necessary) via the Camera::Builder helper class.

Definition at line 43 of file Camera.h.

Member Typedef Documentation

◆ DetectorList

Definition at line 48 of file Camera.h.

◆ IdMap

Definition at line 53 of file DetectorCollection.h.

◆ List

Definition at line 54 of file DetectorCollection.h.

◆ NameMap

Definition at line 52 of file DetectorCollection.h.

◆ OutputArchiveHandle

using lsst::afw::table::io::Persistable::OutputArchiveHandle = io::OutputArchiveHandle
protectedinherited

Definition at line 108 of file Persistable.h.

Constructor & Destructor Documentation

◆ Camera() [1/2]

lsst::afw::cameraGeom::Camera::Camera ( Camera const &  )
delete

◆ Camera() [2/2]

lsst::afw::cameraGeom::Camera::Camera ( Camera &&  )
delete

◆ ~Camera()

lsst::afw::cameraGeom::Camera::~Camera ( )
virtualdefaultnoexcept

Member Function Documentation

◆ add()

void lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::add ( std::shared_ptr< Detector const >  detector)
protectedinherited

Add a detector to the collection.

Parameters
[in]detectorNew detector to add to the collection.
Exceptions
pex::exceptions::RuntimeErrorThrown if the ID and/or name conflict with those of detectors already in the collection.
Exception Safety
Strong for pex::exceptions::RuntimeError, weak (collection is made empty) otherwise.

Definition at line 135 of file DetectorCollection.cc.

89  {
90  auto idIter = _idDict.find(detector->getId());
91  auto nameIter = _nameDict.find(detector->getName());
92  if (idIter == _idDict.end()) {
93  if (nameIter == _nameDict.end()) {
94  try {
95  _idDict.emplace(detector->getId(), detector);
96  _nameDict.emplace(detector->getName(), detector);
97  } catch (...) {
98  _idDict.clear();
99  _nameDict.clear();
100  throw;
101  }
102  } else {
103  throw LSST_EXCEPT(
104  pex::exceptions::RuntimeError,
105  (boost::format("Detector name %s is not unique.") % detector->getName()).str()
106  );
107  }
108  } else {
109  if (nameIter == _nameDict.end()) {
110  throw LSST_EXCEPT(
111  pex::exceptions::RuntimeError,
112  (boost::format("Detector ID %s is not unique.") % detector->getId()).str()
113  );
114  } else {
115  if (nameIter->second != detector) {
116  assert(idIter->second != detector);
117  throw LSST_EXCEPT(
118  pex::exceptions::RuntimeError,
119  (boost::format("Detector name %s and ID %s are not unique.") % detector->getName()
120  % detector->getId()).str()
121  );
122  }
123  // detector is already present; do nothing
124  }
125  }
126 }
table::Key< int > detector
#define LSST_EXCEPT(type,...)
Create an exception with a given type.
Definition: Exception.h:48
T clear(T... args)
T emplace(T... args)
T end(T... args)
T find(T... args)
def format(config, name=None, writeSourceLine=True, prefix="", verbose=False)
Definition: history.py:174

◆ dynamicCast() [1/2]

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;

Exceptions
lsst::pex::exceptions::LogicErrorif the cast fails

param[in] ptr The pointer to be cast.

Returns
The cast pointer.
Exceptions
lsst::pex::exceptions::TypeErrorIf the dynamic cast fails.

Definition at line 218 of file Persistable.cc.

18  {
19  auto result = std::dynamic_pointer_cast<T>(ptr);
20  if (!result) {
21  throw LSST_EXCEPT(pex::exceptions::TypeError, "Dynamic pointer cast failed");
22  }
23  return result;
24 }
py::object result
Definition: _schema.cc:429
uint64_t * ptr
Definition: RangeSet.cc:88

◆ dynamicCast() [2/2]

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;

Exceptions
lsst::pex::exceptions::LogicErrorif the cast fails

param[in] ptr The pointer to be cast.

Returns
The cast pointer.
Exceptions
lsst::pex::exceptions::TypeErrorIf the dynamic cast fails.

Definition at line 218 of file Persistable.cc.

18  {
19  auto result = std::dynamic_pointer_cast<T>(ptr);
20  if (!result) {
21  throw LSST_EXCEPT(pex::exceptions::TypeError, "Dynamic pointer cast failed");
22  }
23  return result;
24 }

◆ empty()

bool lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::empty ( ) const
inlinenoexceptinherited

Determine if the collection contains any detectors.

Definition at line 72 of file DetectorCollection.h.

72 { return _idDict.empty(); }
T empty(T... args)

◆ findDetectors()

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.

Parameters
[in]pointposition to use in lookup (lsst::geom::Point2D)
[in]cameraSyscamera coordinate system of point
Returns
a list of zero or more Detectors that overlap the specified point

Definition at line 45 of file Camera.cc.

46  {
47  auto nativePoint = transform(point, cameraSys, getNativeCameraSys());
48 
49  DetectorList detectorList;
50  for (auto const &item : getIdMap()) {
51  auto detector = item.second;
52  auto pointPixels = detector->transform(nativePoint, getNativeCameraSys(), PIXELS);
53  if (lsst::geom::Box2D(detector->getBBox()).contains(pointPixels)) {
54  detectorList.push_back(std::move(detector));
55  }
56  }
57  return detectorList;
58 }
DetectorCollection::List DetectorList
Definition: Camera.h:48
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.
Definition: Camera.cc:83
IdMap const & getIdMap() const noexcept
Get a map keyed and ordered by ID.
A floating-point coordinate rectangle geometry.
Definition: Box.h:413
bool contains(Point2D const &point) const noexcept
Return true if the box contains the point.
Definition: Box.cc:322
T move(T... args)
CameraSysPrefix const PIXELS
Pixel coordinates: Nominal position on the entry surface of a given detector (x, y unbinned pixels).
Definition: CameraSys.cc:34

◆ findDetectorsList()

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.

Parameters
[in]pointLista list of points (lsst::geom::Point2D)
[in]cameraSysthe camera coordinate system of the points in pointList
Returns
a list of lists; each list contains the names of all detectors which contain the corresponding point

Definition at line 60 of file Camera.cc.

61  {
62  std::vector<DetectorList> detectorListList(pointList.size());
63  auto nativePointList = transform(pointList, cameraSys, getNativeCameraSys());
64 
65  for (auto const &item: getIdMap()) {
66  auto const &detector = item.second;
67  auto pointPixelsList = detector->transform(nativePointList, getNativeCameraSys(), PIXELS);
68  for (std::size_t i = 0; i < pointPixelsList.size(); ++i) {
69  auto const &pointPixels = pointPixelsList[i];
70  if (lsst::geom::Box2D(detector->getBBox()).contains(pointPixels)) {
71  detectorListList[i].push_back(detector);
72  }
73  }
74  }
75  return detectorListList;
76 }
T size(T... args)

◆ get() [1/2]

std::shared_ptr< Detector const > lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::get ( int  id,
std::shared_ptr< Detector const >  def = nullptr 
) const
inherited

Retrieve a detector by ID, or fall back to a default.

Parameters
[in]iddetector id
[in]defdefault detector to return. This defaults to nullptr.
Returns
pointer to detector entry if the entry exists, else return the default value

Definition at line 110 of file DetectorCollection.cc.

65  {
66  auto i = _idDict.find(id);
67  if (i == _idDict.end()) {
68  return def;
69  }
70  return i->second;
71 }

◆ get() [2/2]

std::shared_ptr< Detector const > lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::get ( std::string const &  name,
std::shared_ptr< Detector const >  def = nullptr 
) const
inherited

Retrieve a detector by name, or fall back to a default.

Parameters
[in]namedetector name
[in]defdefault detector to return. This defaults to nullptr.
Returns
pointer to detector entry if the entry exists, else return the default value

Definition at line 99 of file DetectorCollection.cc.

56  {
57  auto i = _nameDict.find(name);
58  if (i == _nameDict.end()) {
59  return def;
60  }
61  return i->second;
62 }
table::Key< std::string > name
Definition: Amplifier.cc:116

◆ getFpBBox()

lsst::geom::Box2D const& lsst::afw::cameraGeom::DetectorCollection::getFpBBox ( ) const
inlinenoexceptinherited

Return a focal plane bounding box that encompasses all detectors.

Definition at line 159 of file DetectorCollection.h.

159 { return _fpBBox; }

◆ getIdMap()

IdMap const& lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::getIdMap ( ) const
inlinenoexceptinherited

Get a map keyed and ordered by ID.

Definition at line 62 of file DetectorCollection.h.

62 { return _idDict; }

◆ getName()

std::string lsst::afw::cameraGeom::Camera::getName ( ) const
inline

Return the name of the camera.

Definition at line 71 of file Camera.h.

71 { return _name; }

◆ getNameMap()

NameMap const& lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::getNameMap ( ) const
inlinenoexceptinherited

Get a map keyed and ordered by name.

Definition at line 59 of file DetectorCollection.h.

59 { return _nameDict; }

◆ getPupilFactoryName()

std::string lsst::afw::cameraGeom::Camera::getPupilFactoryName ( ) const
inline

Return the fully-qualified name of the Python class that provides this Camera's PupilFactory.

Definition at line 76 of file Camera.h.

76 { return _pupilFactoryName; }

◆ getPythonModule()

std::string lsst::afw::cameraGeom::DetectorCollection::getPythonModule ( ) const
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.

246  {
247  return "lsst.afw.cameraGeom";
248 }

◆ getTransform()

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.

Parameters
[in]fromSysFrom CameraSys
[in]toSysTo CameraSys
Returns
an afw::geom::TransformPoint2ToPoint2 that transforms from fromSys to toSys in the forward direction
Exceptions
lsst::pex::exceptions::InvalidParameterErrorif no transform is available.
KeyErrorif an unknown detector is specified

Definition at line 78 of file Camera.cc.

79  {
80  return getTransformMap()->getTransform(fromSys, toSys);
81 }
std::shared_ptr< TransformMap const > getTransformMap() const noexcept
Obtain the transform registry.
Definition: Camera.h:120

◆ getTransformMap()

std::shared_ptr<TransformMap const> lsst::afw::cameraGeom::Camera::getTransformMap ( ) const
inlinenoexcept

Obtain the transform registry.

Returns
_transformMap a TransformMap
Note
_transformMap is immutable, so this should be safe.

Definition at line 120 of file Camera.h.

120 { return _transformMap; }

◆ isPersistable()

bool lsst::afw::cameraGeom::Camera::isPersistable ( ) const
inlineoverridevirtualnoexcept

Cameras are always persistable.

Reimplemented from lsst::afw::table::io::Persistable.

Definition at line 148 of file Camera.h.

148 { return true; }

◆ operator=() [1/2]

Camera& lsst::afw::cameraGeom::Camera::operator= ( Camera &&  )
delete

◆ operator=() [2/2]

Camera& lsst::afw::cameraGeom::Camera::operator= ( Camera const &  )
delete

◆ operator[]() [1/2]

std::shared_ptr< Detector const > lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::operator[] ( int  id) const
inherited

Implement the [id] operator.

Parameters
[in]iddetector name
Returns
pointer to detector entry

Definition at line 88 of file DetectorCollection.cc.

46  {
47  auto det = get(id);
48  if (det == nullptr) {
49  throw LSST_EXCEPT(pex::exceptions::NotFoundError,
50  (boost::format("Detector with ID %s not found") % id).str());
51  }
52  return det;
53 }
table::Key< int > id
Definition: Detector.cc:162

◆ operator[]() [2/2]

std::shared_ptr< Detector const > lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::operator[] ( std::string const &  name) const
inherited

Implement the [name] operator.

Parameters
[in]namedetector name
Returns
pointer to detector entry

Definition at line 80 of file DetectorCollection.cc.

36  {
37  auto det = get(name);
38  if (det == nullptr) {
39  throw LSST_EXCEPT(pex::exceptions::NotFoundError,
40  (boost::format("Detector with name %s not found") % name).str());
41  }
42  return det;
43 }

◆ readFits() [1/6]

static std::shared_ptr<Camera > lsst::afw::table::io::PersistableFacade< Camera >::readFits ( fits::Fits fitsfile)
inlinestaticinherited

Read an object from an already open FITS object.

Parameters
[in]fitsfileFITS object to read from, already positioned at the desired HDU.

Definition at line 183 of file Persistable.h.

183  {
184  return dynamicCast(Persistable::_readFits(fitsfile));
185  }
static std::shared_ptr< Camera > dynamicCast(std::shared_ptr< Persistable > const &ptr)
Dynamically cast a shared_ptr.
Definition: Persistable.cc:18

◆ readFits() [2/6]

Read an object from an already open FITS object.

Parameters
[in]fitsfileFITS object to read from, already positioned at the desired HDU.

Definition at line 183 of file Persistable.h.

183  {
184  return dynamicCast(Persistable::_readFits(fitsfile));
185  }

◆ readFits() [3/6]

static std::shared_ptr<Camera > lsst::afw::table::io::PersistableFacade< Camera >::readFits ( fits::MemFileManager manager,
int  hdu = fits::DEFAULT_HDU 
)
inlinestaticinherited

Read an object from a FITS file in memory.

Parameters
[in]managerManager for the memory to read from.
[in]hduHDU 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.

205  {
206  return dynamicCast(Persistable::_readFits(manager, hdu));
207  }

◆ readFits() [4/6]

static std::shared_ptr<DetectorCollection > lsst::afw::table::io::PersistableFacade< DetectorCollection >::readFits ( fits::MemFileManager manager,
int  hdu = fits::DEFAULT_HDU 
)
inlinestaticinherited

Read an object from a FITS file in memory.

Parameters
[in]managerManager for the memory to read from.
[in]hduHDU 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.

205  {
206  return dynamicCast(Persistable::_readFits(manager, hdu));
207  }

◆ readFits() [5/6]

static std::shared_ptr<Camera > lsst::afw::table::io::PersistableFacade< Camera >::readFits ( std::string const &  fileName,
int  hdu = fits::DEFAULT_HDU 
)
inlinestaticinherited

Read an object from a regular FITS file.

Parameters
[in]fileNameName of the file to read.
[in]hduHDU 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.

194  {
195  return dynamicCast(Persistable::_readFits(fileName, hdu));
196  }

◆ readFits() [6/6]

static std::shared_ptr<DetectorCollection > lsst::afw::table::io::PersistableFacade< DetectorCollection >::readFits ( std::string const &  fileName,
int  hdu = fits::DEFAULT_HDU 
)
inlinestaticinherited

Read an object from a regular FITS file.

Parameters
[in]fileNameName of the file to read.
[in]hduHDU 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.

194  {
195  return dynamicCast(Persistable::_readFits(fileName, hdu));
196  }

◆ rebuild()

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.

41  {
42  return Camera::Builder(*this);
43 }

◆ remove() [1/2]

void lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::remove ( int  id)
protectedinherited

Definition at line 138 of file DetectorCollection.cc.

144  {
145  auto idIter = _idDict.find(id);
146  if (idIter == _idDict.end()) {
147  throw LSST_EXCEPT(
148  pex::exceptions::NotFoundError,
149  (boost::format("Detector with ID %s not found.") % id).str()
150  );
151  }
152  auto nameIter = _nameDict.find(idIter->second->getName());
153  assert(nameIter != _nameDict.end());
154  _nameDict.erase(nameIter);
155  _idDict.erase(idIter);
156 }
T erase(T... args)

◆ remove() [2/2]

void lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::remove ( std::string const &  name)
protectedinherited

Definition at line 137 of file DetectorCollection.cc.

129  {
130  auto nameIter = _nameDict.find(name);
131  if (nameIter == _nameDict.end()) {
132  throw LSST_EXCEPT(
133  pex::exceptions::NotFoundError,
134  (boost::format("Detector with name %s not found.") % name).str()
135  );
136  }
137  auto idIter = _idDict.find(nameIter->second->getId());
138  assert(idIter != _idDict.end());
139  _nameDict.erase(nameIter);
140  _idDict.erase(idIter);
141 }

◆ size()

std::size_t lsst::afw::cameraGeom::DetectorCollectionBase< Detector const >::size ( ) const
inlinenoexceptinherited

Get the number of detectors.

Renamed to __len__ in Python.

Definition at line 67 of file DetectorCollection.h.

67 { return _idDict.size(); }

◆ transform() [1/2]

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.

Parameters
[in]pointan lsst::geom::Point2d
[in]fromSystransform from this CameraSys
[in]toSystransform to this CameraSys
Returns
point transformed to toSys (an lsst::geom::Point2D)

Definition at line 83 of file Camera.cc.

84  {
85  auto transform = getTransform(fromSys, toSys);
86  return transform->applyForward(point);
87 }
std::shared_ptr< afw::geom::TransformPoint2ToPoint2 > getTransform(CameraSys const &fromSys, CameraSys const &toSys) const
Get a transform from one CameraSys to another.
Definition: Camera.cc:78

◆ transform() [2/2]

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.

Parameters
[in]pointsan vector of lsst::geom::Point2d
[in]fromSystransform from this CameraSys
[in]toSystransform to this CameraSys
Returns
points transformed to toSys (a vector of lsst::geom::Point2D)

Definition at line 89 of file Camera.cc.

91  {
92  auto transform = getTransform(fromSys, toSys);
93  return transform->applyForward(points);
94 }

◆ write()

void lsst::afw::cameraGeom::Camera::write ( OutputArchiveHandle handle) const
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.

149  {
151  auto const & keys = PersistenceHelper::get();
152  auto cat = handle.makeCatalog(keys.schema);
153  auto record = cat.addNew();
154  record->set(keys.name, getName());
155  record->set(keys.pupilFactoryName, getPupilFactoryName());
156  record->set(keys.transformMap, handle.put(getTransformMap()));
157  handle.saveCatalog(cat);
158 }
std::string getPupilFactoryName() const
Return the fully-qualified name of the Python class that provides this Camera's PupilFactory.
Definition: Camera.h:76
std::string getName() const
Return the name of the camera.
Definition: Camera.h:71
void write(OutputArchiveHandle &handle) const override
Write the object to one or more catalogs.

◆ writeFits() [1/3]

void lsst::afw::table::io::Persistable::writeFits ( fits::Fits fitsfile) const
inherited

Write the object to an already-open FITS object.

Parameters
[in]fitsfileOpen FITS object to write to.

Definition at line 18 of file Persistable.cc.

18  {
19  OutputArchive archive;
20  archive.put(this);
21  archive.writeFits(fitsfile);
22 }

◆ writeFits() [2/3]

void lsst::afw::table::io::Persistable::writeFits ( fits::MemFileManager manager,
std::string const &  mode = "w" 
) const
inherited

Write the object to a FITS image in memory.

Parameters
[in]managerName of the file to write to.
[in]modeIf "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.

29  {
30  fits::Fits fitsfile(manager, mode, fits::Fits::AUTO_CLOSE | fits::Fits::AUTO_CHECK);
31  writeFits(fitsfile);
32 }
void writeFits(std::string const &fileName, std::string const &mode="w") const
Write the object to a regular FITS file.
Definition: Persistable.cc:24

◆ writeFits() [3/3]

void lsst::afw::table::io::Persistable::writeFits ( std::string const &  fileName,
std::string const &  mode = "w" 
) const
inherited

Write the object to a regular FITS file.

Parameters
[in]fileNameName of the file to write to.
[in]modeIf "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.

24  {
25  fits::Fits fitsfile(fileName, mode, fits::Fits::AUTO_CLOSE | fits::Fits::AUTO_CHECK);
26  writeFits(fitsfile);
27 }

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