LSST Applications g1653933729+34a971ddd9,g1a997c3884+34a971ddd9,g2160c40384+da0d0eec6b,g28da252d5a+cb6ff358b6,g2bbee38e9b+e5a1bc5b38,g2bc492864f+e5a1bc5b38,g2ca4be77d2+2af33ed832,g2cdde0e794+704103fe75,g3156d2b45e+6e87dc994a,g347aa1857d+e5a1bc5b38,g35bb328faa+34a971ddd9,g3a166c0a6a+e5a1bc5b38,g3e281a1b8c+8ec26ec694,g4005a62e65+ba0306790b,g414038480c+9f5be647b3,g41af890bb2+f34483f65b,g5065538af8+53fd6e9482,g5a0bb5165c+1b31a0decc,g717e5f8c0f+19a1ad098c,g80478fca09+1acdc24a0d,g8204df1d8d+19a1ad098c,g82479be7b0+44a04e1d61,g858d7b2824+19a1ad098c,g9125e01d80+34a971ddd9,ga5288a1d22+ad6d5da1a4,gae0086650b+34a971ddd9,gb58c049af0+ace264a4f2,gbd397ab92a+d5fd0218dc,gc28159a63d+e5a1bc5b38,gcf0d15dbbd+618cb38075,gd6b7c0dfd1+3388d854ad,gda6a2b7d83+618cb38075,gdaeeff99f8+7774323b41,ge2409df99d+8082276ac0,ge33fd446bb+19a1ad098c,ge79ae78c31+e5a1bc5b38,gf0baf85859+890af219f9,gf5289d68f6+701f7b396a,w.2024.37
LSST Data Management Base Package
Loading...
Searching...
No Matches
Persistable.h
Go to the documentation of this file.
1// -*- lsst-c++ -*-
2#ifndef AFW_TABLE_IO_Persistable_h_INCLUDED
3#define AFW_TABLE_IO_Persistable_h_INCLUDED
4
5#include <climits>
6#include "lsst/base.h"
9
10namespace lsst {
11namespace afw {
12
13namespace fits {
14
15class Fits;
16class MemFileManager;
17
18} // namespace fits
19
20namespace table {
21namespace io {
22
23class InputArchive;
24class OutputArchive;
25class OutputArchiveHandle;
26class CatalogVector;
27
32
33
40
41
48#define LSST_ARCHIVE_ASSERT(EXPR) \
49 if (!(EXPR)) \
50 throw LSST_EXCEPT(lsst::afw::table::io::MalformedArchiveError, "Archive assertion failed: " #EXPR)
51
75public:
83 void writeFits(std::string const& fileName, std::string const& mode = "w") const;
84
92 void writeFits(fits::MemFileManager& manager, std::string const& mode = "w") const;
93
99 void writeFits(fits::Fits& fitsfile) const;
100
102 virtual bool isPersistable() const noexcept { return false; }
103
104 virtual ~Persistable() noexcept = default;
105
107 // convenient for derived classes not in afw::table::io
109
116
126
134 virtual void write(OutputArchiveHandle& handle) const;
135
137
139 Persistable(Persistable&& other) noexcept = default;
140
141 Persistable& operator=(Persistable const& other) noexcept = default;
142 Persistable& operator=(Persistable&& other) noexcept = default;
143
144private:
147
148 template <typename T>
150
151 static std::shared_ptr<Persistable> _readFits(std::string const& fileName, int hdu = fits::DEFAULT_HDU);
152
153 static std::shared_ptr<Persistable> _readFits(fits::MemFileManager& manager, int hdu = fits::DEFAULT_HDU);
154
155 static std::shared_ptr<Persistable> _readFits(fits::Fits& fitsfile);
156};
157
175template <typename T>
177public:
184 return dynamicCast(Persistable::_readFits(fitsfile));
185 }
186
195 return dynamicCast(Persistable::_readFits(fileName, hdu));
196 }
197
206 return dynamicCast(Persistable::_readFits(manager, hdu));
207 }
208
218 static std::shared_ptr<T> dynamicCast(std::shared_ptr<Persistable> const &ptr);
219};
220
229protected:
230 using InputArchive = io::InputArchive; // convenient for derived classes not in afw::table::io
232
233public:
245 explicit PersistableFactory(std::string const& name);
246
249 CatalogVector const& catalogs) const = 0;
250
258 static PersistableFactory const& lookup(std::string const& name, std::string const& module = "");
259
260 virtual ~PersistableFactory() noexcept = default;
261
262 // No copying
265
266 // No moving
269};
270} // namespace io
271} // namespace table
272} // namespace afw
273} // namespace lsst
274
275#endif // !AFW_TABLE_IO_Persistable_h_INCLUDED
#define LSST_EXCEPTION_TYPE(t, b, c)
Macro used to define new types of exceptions without additional data.
Definition Exception.h:69
std::uint64_t * ptr
Definition RangeSet.cc:95
Basic LSST definitions.
A simple struct that combines the two arguments that must be passed to most cfitsio routines and cont...
Definition fits.h:308
Lifetime-management for memory that goes into FITS memory files.
Definition fits.h:125
Tag types used to declare specialized field types.
Definition misc.h:31
A vector of catalogs used by Persistable.
A multi-catalog archive object used to load table::io::Persistable objects.
An exception thrown when an InputArchive's contents do not make sense.
Definition Persistable.h:39
An object passed to Persistable::write to allow it to persist itself.
A multi-catalog archive object used to save table::io::Persistable objects.
A CRTP facade class for subclasses of Persistable.
static std::shared_ptr< T > readFits(std::string const &fileName, int hdu=fits::DEFAULT_HDU)
Read an object from a regular FITS file.
static std::shared_ptr< T > readFits(fits::MemFileManager &manager, int hdu=fits::DEFAULT_HDU)
Read an object from a FITS file in memory.
static std::shared_ptr< T > readFits(fits::Fits &fitsfile)
Read an object from an already open FITS object.
A base class for factory classes used to reconstruct objects from records.
virtual std::shared_ptr< Persistable > read(InputArchive const &archive, CatalogVector const &catalogs) const =0
Construct a new object from the given InputArchive and vector of catalogs.
virtual ~PersistableFactory() noexcept=default
A base class for objects that can be persisted via afw::table::io Archive classes.
Definition Persistable.h:74
void writeFits(std::string const &fileName, std::string const &mode="w") const
Write the object to a regular FITS file.
virtual bool isPersistable() const noexcept
Return true if this particular object can be persisted using afw::table::io.
virtual std::string getPythonModule() const
Return the fully-qualified Python module that should be imported to guarantee that its factory is reg...
virtual ~Persistable() noexcept=default
virtual std::string getPersistenceName() const
Return the unique name used to persist this object and look up its factory.
An exception thrown when problems occur during persistence.
Definition Persistable.h:31
Reports errors in external input/output operations.
Definition Runtime.h:160
const int DEFAULT_HDU
Specify that the default HDU should be read.
STL namespace.