LSSTApplications  20.0.0
LSSTDataManagementBasePackage
FitsTable.h
Go to the documentation of this file.
1 /*
2  * LSST Data Management System
3  * Copyright 2017 AURA/LSST.
4  *
5  * This product includes software developed by the
6  * LSST Project (http://www.lsst.org/).
7  *
8  * This program is free software: you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation, either version 3 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the LSST License Statement and
19  * the GNU General Public License along with this program. If not,
20  * see <https://www.lsstcorp.org/LegalNotices/>.
21  */
22 #ifndef ASTSHIM_FITSTABLE_H
23 #define ASTSHIM_FITSTABLE_H
24 
25 #include <complex>
26 #include <string>
27 #include <vector>
28 
29 #include "ndarray.h"
30 
31 #include "astshim/base.h"
32 #include "astshim/Object.h"
33 #include "astshim/Table.h"
34 #include "astshim/FitsChan.h"
35 
36 namespace ast {
37 
38 class FitsTable : public Table {
39  friend class Object;
40 
41 public:
42  explicit FitsTable(FitsChan const &header, std::string const &options = "")
43  : Table(reinterpret_cast<AstTable *>(astFitsTable(const_cast<AstObject *>(header.getRawPtr()),
44  "%s", options.c_str()))) {
45  assertOK();;
46  }
47  explicit FitsTable(std::string const &options = "")
48  : Table(reinterpret_cast<AstTable *>(astFitsTable(NULL,
49  "%s", options.c_str()))) {
50  assertOK();;
51  }
52 
53 
54  virtual ~FitsTable(){};
55 
56  FitsTable(FitsTable const &) = default;
57  FitsTable(FitsTable &&) = default;
58  FitsTable &operator=(FitsTable const &) = delete;
59  FitsTable &operator=(FitsTable &&) = default;
60 
62  auto *rawFitsChan = reinterpret_cast<AstObject *>(astGetTableHeader(getRawPtr()));
63  assertOK(rawFitsChan);
64  if (!rawFitsChan) {
65  throw std::runtime_error("getTableHeader failed (returned a null fitschan)");
66  }
67  return Object::fromAstObject<FitsChan>(rawFitsChan, false);
68  }
69 
71  size_t retVal = astColumnSize(getRawPtr(), column.c_str());
72  assertOK();
73  return retVal;
74  }
75 
76  // We do not know the shape of the column so in C++ we can only return
77  // the elements as a 1-D double array. It is up to the caller to extract
78  // the relevant information.
79  ndarray::Array<double, 1, 1> getColumnData1D(std::string const &column) {
80  auto dtype = columnType(column);
81  if (dtype != DataType::DoubleType) {
82  throw std::runtime_error("Data type not supported by getColumnData");
83  }
84  // We can ask AST for the number of bytes required but for now
85  // calculate the number of elements from the shape and rows
86  auto totnel = getNRow();
87  auto shape = columnShape(column);
88  for (auto &val : shape) {
89  totnel *= val;
90  }
91  ndarray::Array<double, 1, 1> coldata = ndarray::allocate(ndarray::makeVector(totnel));
92  int nelem;
93  astGetColumnData(getRawPtr(), column.c_str(), AST__NANF, AST__NAN, totnel*sizeof(double),
94  coldata.getData(), &nelem);
95  return coldata;
96  }
97 
98  protected:
99 
103  explicit FitsTable(AstFitsTable *rawFitsTable) : Table(reinterpret_cast<AstTable *>(rawFitsTable)) {
104  if (!astIsAFitsTable(getRawPtr())) {
106  os << "this is a " << getClassName() << ", which is not a FitsTable";
107  throw std::invalid_argument(os.str());
108  }
109  assertOK();
110  }
111 
112 
113 };
114 
115 } // namespace ast
116 
117 #endif
ast::FitsTable::FitsTable
FitsTable(FitsTable const &)=default
Table.h
std::string
STL class.
std::shared_ptr
STL class.
ast::DataType::DoubleType
@ DoubleType
ast::FitsTable::getColumnData1D
ndarray::Array< double, 1, 1 > getColumnData1D(std::string const &column)
Definition: FitsTable.h:79
ast::FitsTable::~FitsTable
virtual ~FitsTable()
Definition: FitsTable.h:54
ast::assertOK
void assertOK(AstObject *rawPtr1=nullptr, AstObject *rawPtr2=nullptr)
Throw std::runtime_error if AST's state is bad.
Definition: base.cc:49
ast::FitsTable::operator=
FitsTable & operator=(FitsTable &&)=default
ast::FitsTable::FitsTable
FitsTable(std::string const &options="")
Definition: FitsTable.h:47
ast::FitsChan
A specialized form of Channel which reads and writes FITS header cards.
Definition: FitsChan.h:202
base.h
ast::Table::columnShape
std::vector< int > columnShape(std::string const &column)
Definition: Table.h:87
ast::Object
Abstract base class for all AST objects.
Definition: Object.h:51
val
ImageT val
Definition: CR.cc:146
ast::FitsTable::FitsTable
FitsTable(AstFitsTable *rawFitsTable)
Construct a FitsTable from a raw AstFitsTable.
Definition: FitsTable.h:103
ast::FitsTable::FitsTable
FitsTable(FitsTable &&)=default
ast::FitsTable::FitsTable
FitsTable(FitsChan const &header, std::string const &options="")
Definition: FitsTable.h:42
ast::Table::getNRow
int getNRow() const
Get NRow: The number of rows currently in the Table.
Definition: Table.h:106
ast::Object::getClassName
std::string getClassName() const
Get Class: the name of the class (e.g.
Definition: Object.h:139
FitsChan.h
std::string::c_str
T c_str(T... args)
ast::Table
Definition: Table.h:35
std::runtime_error
STL class.
std::invalid_argument
STL class.
ast::FitsTable::operator=
FitsTable & operator=(FitsTable const &)=delete
ast::FitsTable
Definition: FitsTable.h:38
std::ostringstream
STL class.
ast::FitsTable::getTableHeader
std::shared_ptr< FitsChan > getTableHeader() const
Definition: FitsTable.h:61
ast
AST wrapper classes and functions.
Definition: attributes_channel.dox:1
os
std::ostream * os
Definition: Schema.cc:746
ast::FitsTable::columnSize
std::size_t columnSize(std::string const &column)
Definition: FitsTable.h:70
ast::Object::getRawPtr
AstObject const * getRawPtr() const
Get the raw AST pointer.
Definition: Object.h:292
std::size_t
Object.h
ast::Table::columnType
DataType columnType(std::string const &column) const
Definition: Table.h:57