casacore
MSFeedColumns.h
Go to the documentation of this file.
1 //# MSFeedColumns.h: provides easy access to MSFeed columns
2 //# Copyright (C) 1996,1999,2000
3 //# Associated Universities, Inc. Washington DC, USA.
4 //#
5 //# This library is free software; you can redistribute it and/or modify it
6 //# under the terms of the GNU Library General Public License as published by
7 //# the Free Software Foundation; either version 2 of the License, or (at your
8 //# option) any later version.
9 //#
10 //# This library is distributed in the hope that it will be useful, but WITHOUT
11 //# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 //# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
13 //# License for more details.
14 //#
15 //# You should have received a copy of the GNU Library General Public License
16 //# along with this library; if not, write to the Free Software Foundation,
17 //# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
18 //#
19 //# Correspondence concerning AIPS++ should be addressed as follows:
20 //# Internet email: aips2-request@nrao.edu.
21 //# Postal address: AIPS++ Project Office
22 //# National Radio Astronomy Observatory
23 //# 520 Edgemont Road
24 //# Charlottesville, VA 22903-2475 USA
25 //#
26 //# $Id$
27 
28 #ifndef MS_MSFEEDCOLUMNS_H
29 #define MS_MSFEEDCOLUMNS_H
30 
31 #include <casacore/casa/aips.h>
32 #include <casacore/casa/BasicSL/Complex.h>
33 #include <casacore/measures/Measures/MDirection.h>
34 #include <casacore/measures/Measures/MEpoch.h>
35 #include <casacore/measures/Measures/MPosition.h>
36 #include <casacore/measures/Measures/MCDirection.h>
37 #include <casacore/measures/Measures/MCEpoch.h>
38 #include <casacore/measures/Measures/MCPosition.h>
39 #include <casacore/measures/TableMeasures/ArrayMeasColumn.h>
40 #include <casacore/measures/TableMeasures/ArrayQuantColumn.h>
41 #include <casacore/measures/TableMeasures/ScalarMeasColumn.h>
42 #include <casacore/measures/TableMeasures/ScalarQuantColumn.h>
43 #include <casacore/tables/Tables/ArrayColumn.h>
44 #include <casacore/tables/Tables/ScalarColumn.h>
45 #include <casacore/casa/BasicSL/String.h>
46 
47 namespace casacore { //# NAMESPACE CASACORE - BEGIN
48 
49 class MSFeed;
50 
51 // <summary>
52 // A class to provide easy access to MSFeed columns
53 // </summary>
54 
55 // <use visibility=export>
56 
57 // <reviewed reviewer="Bob Garwood" date="1997/02/01" tests="" demos="">
58 // </reviewed>
59 
60 // <prerequisite>
61 // <li> MSFeed
62 // <li> ArrayColumn
63 // <li> ScalarColumn
64 // </prerequisite>
65 //
66 // <etymology>
67 // MSFeedColumns stands for MeasurementSet Feed Table columns.
68 // </etymology>
69 //
70 // <synopsis>
71 // This class provides access to the columns in the MSFeed Table,
72 // it does the declaration of all the Scalar and ArrayColumns with the
73 // correct types, so the application programmer doesn't have to
74 // worry about getting those right. There is an access function
75 // for every predefined column. Access to non-predefined columns will still
76 // have to be done with explicit declarations.
77 // See <linkto class=MSColumns> MSColumns</linkto> for an example.
78 // </synopsis>
79 //
80 // <motivation>
81 // See <linkto class=MSColumns> MSColumns</linkto> for the motivation.
82 // </motivation>
83 
85 {
86 public:
87  // Create a columns object that accesses the data in the specified Table
88  MSFeedColumns(const MSFeed& msFeed);
89 
90  // The desctructor does nothing special
92 
93  // Access to required columns
94  // <group>
100  {return beamOffsetMeas_p;}
110  { return positionMeas_p;}
113  return receptorAngleQuant_p;}
118  // </group>
119 
120  // Const access to required columns
121  // <group>
122  const ScalarColumn<Int>& antennaId() const {return antennaId_p;}
123  const ScalarColumn<Int>& beamId() const {return beamId_p;}
124  const ArrayColumn<Double>& beamOffset() const {return beamOffset_p;}
127  {return beamOffsetMeas_p;}
128  const ScalarColumn<Int>& feedId() const {return feedId_p;}
129  const ScalarColumn<Double>& interval() const {return interval_p;}
134  const ArrayColumn<Double>& position() const {return position_p;}
137  { return positionMeas_p;}
140  return receptorAngleQuant_p;}
142  const ScalarColumn<Double>& time() const {return time_p;}
144  const ScalarMeasColumn<MEpoch>& timeMeas() const { return timeMeas_p;}
145  // </group>
146 
147  // Access to optional columns
148  // <group>
152  // </group>
153 
154  // Const access to optional columns
155  // <group>
159  // </group>
160 
161  // set the epoch type for the TIME column.
162  // <note role=tip>
163  // In principle this function can only be used if the table is empty,
164  // otherwise already written values may thereafter have an incorrect
165  // reference, offset, or unit. However, it is possible that part of the
166  // table gets written before these values are known. In that case the
167  // reference, offset, or units can be set by using a False
168  // <src>tableMustBeEmpty</src> argument.
169  // </note>
170  void setEpochRef(MEpoch::Types ref, Bool tableMustBeEmpty=True);
171 
172  // set the direction type for the BEAM_OFFSET column. This can only be done
173  // when the table has no rows. Trying to do so at other times will throw an
174  // exception.
176 
177  // set the position type for the POSITION column. This can only be done when
178  // the table has no rows. Trying to do so at other times will throw an
179  // exception.
181 
182  // Convenience function that returns the number of rows in any of the columns
183  uInt nrow() const {return antennaId_p.nrow();}
184 
185  // Returns the last row that contains a feed with the specified values.
186  // If no matching row can be found, but a match is possible if the validity
187  // time interval is widened, return that row and the suggestion for the
188  // new time information.
189  // If no change to time is necessary, newTimeQ and newIntervalQ are zero.
190  // Returns -1 if no match could be found.
191  // Ignore the Feed table rows contained in vector ignoreRows.
192  // focusLengthQ is only compared if this optional column is present and
193  // if the value of focusLengthQ is not dimensionless.
195  Quantum<Double>& newIntervalQ,
196  const Int& antId,
197  const Int& fId, // feedId
198  const Int& spwId,
199  const Quantum<Double>& timeQ,
200  const Quantum<Double>& intervalQ,
201  const Int& numRec,
202  const Array<Quantum<Double> >& beamOffsetQ,
203  const Array<String>& polType,
204  const Array<Complex>& polResp,
205  const Array<Quantum<Double> >& positionQ,
206  const Array<Quantum<Double> >& receptorAngleQ,
207  const Vector<uInt>& ignoreRows,
208  const Quantum<Double>& focusLengthQ=Quantum<Double>()
209  );
210 
211 protected:
212  //# default constructor creates a object that is not usable. Use the attach
213  //# function correct this.
215 
216  //# attach this object to the supplied table.
217  void attach(const MSFeed& msFeed);
218 
219 private:
220  //# Make the assignment operator and the copy constructor private to prevent
221  //# any compiler generated one from being used.
224 
225  //# Check if any optional columns exist and if so attach them.
226  void attachOptionalCols(const MSFeed& msFeed);
227 
228  //# required columns
241  //# optional columns
244 
245  //# Access to Measure columns
249 
250  //# Access to Quantum columns
256  //# optional Quantum columns
258 };
259 
260 //# Define the RO version for backward compatibility.
262 
263 } //# NAMESPACE CASACORE - END
264 
265 #endif
casacore::MSFeedColumns::receptorAngleQuant_p
ArrayQuantColumn< Double > receptorAngleQuant_p
Definition: MSFeedColumns.h:254
casacore::MSFeedColumns::positionQuant
ArrayQuantColumn< Double > & positionQuant()
Definition: MSFeedColumns.h:108
casacore::MSFeedColumns::phasedFeedId
ScalarColumn< Int > & phasedFeedId()
Definition: MSFeedColumns.h:151
casacore::MSFeedColumns::beamId
ScalarColumn< Int > & beamId()
Definition: MSFeedColumns.h:96
casacore::MSFeedColumns::receptorAngle
ArrayColumn< Double > & receptorAngle()
Definition: MSFeedColumns.h:111
casacore::MSFeedColumns::polResponse
const ArrayColumn< Complex > & polResponse() const
Definition: MSFeedColumns.h:132
casacore::MSFeedColumns::beamOffsetQuant
ArrayQuantColumn< Double > & beamOffsetQuant()
Definition: MSFeedColumns.h:98
casacore::MSFeedColumns::beamOffset
const ArrayColumn< Double > & beamOffset() const
Definition: MSFeedColumns.h:124
casacore::MSFeedColumns::polarizationType
const ArrayColumn< String > & polarizationType() const
Definition: MSFeedColumns.h:133
casacore::MSFeedColumns::focusLengthQuant
ScalarQuantColumn< Double > & focusLengthQuant()
Definition: MSFeedColumns.h:150
casacore::MSFeedColumns::position
const ArrayColumn< Double > & position() const
Definition: MSFeedColumns.h:134
casacore::MSFeedColumns::phasedFeedId
const ScalarColumn< Int > & phasedFeedId() const
Definition: MSFeedColumns.h:158
casacore::MSFeedColumns::positionMeas_p
ScalarMeasColumn< MPosition > positionMeas_p
Definition: MSFeedColumns.h:247
casacore::MSFeedColumns::beamOffsetQuant_p
ArrayQuantColumn< Double > beamOffsetQuant_p
Definition: MSFeedColumns.h:251
casacore::MSFeedColumns
A class to provide easy access to MSFeed columns.
Definition: MSFeedColumns.h:85
casacore::MSFeedColumns::feedId
ScalarColumn< Int > & feedId()
Definition: MSFeedColumns.h:101
casacore::MSFeedColumns::beamOffset_p
ArrayColumn< Double > beamOffset_p
Definition: MSFeedColumns.h:231
casacore::MSFeedColumns::timeQuant
ScalarQuantColumn< Double > & timeQuant()
Definition: MSFeedColumns.h:116
casacore::MSFeedColumns::nrow
uInt nrow() const
Convenience function that returns the number of rows in any of the columns.
Definition: MSFeedColumns.h:183
casacore::MSFeedColumns::focusLengthQuant
const ScalarQuantColumn< Double > & focusLengthQuant() const
Definition: MSFeedColumns.h:157
casacore::MSFeedColumns::focusLength
const ScalarColumn< Double > & focusLength() const
Const access to optional columns.
Definition: MSFeedColumns.h:156
casacore::MSFeedColumns::polarizationType_p
ArrayColumn< String > polarizationType_p
Definition: MSFeedColumns.h:236
casacore::MSFeedColumns::positionQuant
const ArrayQuantColumn< Double > & positionQuant() const
Definition: MSFeedColumns.h:135
casacore::ScalarColumn< Int >
casacore::MSFeedColumns::position_p
ArrayColumn< Double > position_p
Definition: MSFeedColumns.h:237
casacore::ArrayColumn< Double >
casacore::MSFeedColumns::beamOffsetQuant
const ArrayQuantColumn< Double > & beamOffsetQuant() const
Definition: MSFeedColumns.h:125
casacore::MSFeedColumns::timeMeas
const ScalarMeasColumn< MEpoch > & timeMeas() const
Definition: MSFeedColumns.h:144
casacore::MSFeedColumns::attachOptionalCols
void attachOptionalCols(const MSFeed &msFeed)
casacore::MSFeedColumns::polResponse_p
ArrayColumn< Complex > polResponse_p
Definition: MSFeedColumns.h:235
casacore::MSFeedColumns::timeQuant_p
ScalarQuantColumn< Double > timeQuant_p
Definition: MSFeedColumns.h:255
casacore::MSFeedColumns::receptorAngleQuant
ArrayQuantColumn< Double > & receptorAngleQuant()
Definition: MSFeedColumns.h:112
casacore::MSFeedColumns::feedId
const ScalarColumn< Int > & feedId() const
Definition: MSFeedColumns.h:128
casacore::MSFeedColumns::time
const ScalarColumn< Double > & time() const
Definition: MSFeedColumns.h:142
casacore::MSFeedColumns::beamOffsetMeas
ArrayMeasColumn< MDirection > & beamOffsetMeas()
Definition: MSFeedColumns.h:99
casacore::MSFeedColumns::setPositionRef
void setPositionRef(MPosition::Types ref)
set the position type for the POSITION column.
casacore::MSFeedColumns::polResponse
ArrayColumn< Complex > & polResponse()
Definition: MSFeedColumns.h:105
casacore::MEpoch::Types
Types
Types of known MEpochs Caution: The order defines the order in the translation matrix in the MCEpoch...
Definition: MEpoch.h:117
casacore::MSFeedColumns::attach
void attach(const MSFeed &msFeed)
casacore::MSFeed
A Table intended to hold a MeasurementSet FEED table.
Definition: MSFeed.h:80
casacore::MSFeedColumns::antennaId
const ScalarColumn< Int > & antennaId() const
Const access to required columns.
Definition: MSFeedColumns.h:122
casacore::MSFeedColumns::~MSFeedColumns
~MSFeedColumns()
The desctructor does nothing special.
casacore::MSFeedColumns::operator=
MSFeedColumns & operator=(const MSFeedColumns &)
casacore::ArrayMeasColumn< MDirection >
casacore::uInt
unsigned int uInt
Definition: aipstype.h:51
casacore::MSFeedColumns::position
ArrayColumn< Double > & position()
Definition: MSFeedColumns.h:107
casacore::MSFeedColumns::phasedFeedId_p
ScalarColumn< Int > phasedFeedId_p
Definition: MSFeedColumns.h:243
casacore::MSFeedColumns::intervalQuant
ScalarQuantColumn< Double > & intervalQuant()
Definition: MSFeedColumns.h:103
casacore::MSFeedColumns::focusLengthQuant_p
ScalarQuantColumn< Double > focusLengthQuant_p
Definition: MSFeedColumns.h:257
casacore::MSFeedColumns::spectralWindowId
const ScalarColumn< Int > & spectralWindowId() const
Definition: MSFeedColumns.h:141
casacore::MSFeedColumns::focusLength
ScalarColumn< Double > & focusLength()
Access to optional columns.
Definition: MSFeedColumns.h:149
casacore::MSFeedColumns::receptorAngle_p
ArrayColumn< Double > receptorAngle_p
Definition: MSFeedColumns.h:238
casacore::MSFeedColumns::interval_p
ScalarColumn< Double > interval_p
Definition: MSFeedColumns.h:233
casacore::MSFeedColumns::time
ScalarColumn< Double > & time()
Definition: MSFeedColumns.h:115
casacore::MSFeedColumns::numReceptors_p
ScalarColumn< Int > numReceptors_p
Definition: MSFeedColumns.h:234
casacore::Int
int Int
Definition: aipstype.h:50
casacore
this file contains all the compiler specific defines
Definition: mainpage.dox:28
casacore::MSFeedColumns::interval
const ScalarColumn< Double > & interval() const
Definition: MSFeedColumns.h:129
casacore::MSFeedColumns::positionMeas
const ScalarMeasColumn< MPosition > & positionMeas() const
Definition: MSFeedColumns.h:136
casacore::MSFeedColumns::MSFeedColumns
MSFeedColumns(const MSFeed &msFeed)
Create a columns object that accesses the data in the specified Table.
casacore::MSFeedColumns::intervalQuant
const ScalarQuantColumn< Double > & intervalQuant() const
Definition: MSFeedColumns.h:130
casacore::True
const Bool True
Definition: aipstype.h:43
casacore::MSFeedColumns::polarizationType
ArrayColumn< String > & polarizationType()
Definition: MSFeedColumns.h:106
casacore::MSFeedColumns::MSFeedColumns
MSFeedColumns(const MSFeedColumns &)
casacore::MSFeedColumns::time_p
ScalarColumn< Double > time_p
Definition: MSFeedColumns.h:240
casacore::MSFeedColumns::beamId_p
ScalarColumn< Int > beamId_p
Definition: MSFeedColumns.h:230
casacore::MSFeedColumns::focusLength_p
ScalarColumn< Double > focusLength_p
Definition: MSFeedColumns.h:242
casacore::MSFeedColumns::numReceptors
ScalarColumn< Int > & numReceptors()
Definition: MSFeedColumns.h:104
casacore::MSFeedColumns::matchFeed
Int matchFeed(Quantum< Double > &newTimeQ, Quantum< Double > &newIntervalQ, const Int &antId, const Int &fId, const Int &spwId, const Quantum< Double > &timeQ, const Quantum< Double > &intervalQ, const Int &numRec, const Array< Quantum< Double > > &beamOffsetQ, const Array< String > &polType, const Array< Complex > &polResp, const Array< Quantum< Double > > &positionQ, const Array< Quantum< Double > > &receptorAngleQ, const Vector< uInt > &ignoreRows, const Quantum< Double > &focusLengthQ=Quantum< Double >())
Returns the last row that contains a feed with the specified values.
casacore::ArrayQuantColumn< Double >
casacore::MSFeedColumns::feedId_p
ScalarColumn< Int > feedId_p
Definition: MSFeedColumns.h:232
casacore::MSFeedColumns::beamOffsetMeas_p
ArrayMeasColumn< MDirection > beamOffsetMeas_p
Definition: MSFeedColumns.h:246
casacore::MSFeedColumns::timeQuant
const ScalarQuantColumn< Double > & timeQuant() const
Definition: MSFeedColumns.h:143
casacore::ROMSFeedColumns
MSFeedColumns ROMSFeedColumns
Definition: MSFeedColumns.h:261
casacore::ScalarQuantColumn< Double >
casacore::MSFeedColumns::antennaId_p
ScalarColumn< Int > antennaId_p
Definition: MSFeedColumns.h:229
casacore::Array
template <class T, class U> class vector;
Definition: Array.h:167
casacore::MSFeedColumns::positionMeas
ScalarMeasColumn< MPosition > & positionMeas()
Definition: MSFeedColumns.h:109
casacore::MSFeedColumns::beamOffset
ArrayColumn< Double > & beamOffset()
Definition: MSFeedColumns.h:97
casacore::ScalarMeasColumn< MPosition >
casacore::Bool
bool Bool
Define the standard types used by Casacore.
Definition: aipstype.h:42
casacore::MDirection::Types
Types
Types of known MDirections Warning: The order defines the order in the translation matrix FromTo in ...
Definition: MDirection.h:188
casacore::MSFeedColumns::MSFeedColumns
MSFeedColumns()
casacore::MSFeedColumns::receptorAngle
const ArrayColumn< Double > & receptorAngle() const
Definition: MSFeedColumns.h:138
casacore::Vector< uInt >
casacore::MSFeedColumns::beamOffsetMeas
const ArrayMeasColumn< MDirection > & beamOffsetMeas() const
Definition: MSFeedColumns.h:126
casacore::MSFeedColumns::positionQuant_p
ArrayQuantColumn< Double > positionQuant_p
Definition: MSFeedColumns.h:253
casacore::MSFeedColumns::timeMeas_p
ScalarMeasColumn< MEpoch > timeMeas_p
Definition: MSFeedColumns.h:248
casacore::MSFeedColumns::timeMeas
ScalarMeasColumn< MEpoch > & timeMeas()
Definition: MSFeedColumns.h:117
casacore::MSFeedColumns::intervalQuant_p
ScalarQuantColumn< Double > intervalQuant_p
Definition: MSFeedColumns.h:252
casacore::MSFeedColumns::numReceptors
const ScalarColumn< Int > & numReceptors() const
Definition: MSFeedColumns.h:131
casacore::MSFeedColumns::spectralWindowId
ScalarColumn< Int > & spectralWindowId()
Definition: MSFeedColumns.h:114
casacore::MSFeedColumns::setDirectionRef
void setDirectionRef(MDirection::Types ref)
set the direction type for the BEAM_OFFSET column.
casacore::Quantum< Double >
casacore::MSFeedColumns::spectralWindowId_p
ScalarColumn< Int > spectralWindowId_p
Definition: MSFeedColumns.h:239
casacore::MSFeedColumns::receptorAngleQuant
const ArrayQuantColumn< Double > & receptorAngleQuant() const
Definition: MSFeedColumns.h:139
casacore::MSFeedColumns::antennaId
ScalarColumn< Int > & antennaId()
Access to required columns.
Definition: MSFeedColumns.h:95
casacore::MSFeedColumns::beamId
const ScalarColumn< Int > & beamId() const
Definition: MSFeedColumns.h:123
casacore::MSFeedColumns::interval
ScalarColumn< Double > & interval()
Definition: MSFeedColumns.h:102
casacore::MSFeedColumns::setEpochRef
void setEpochRef(MEpoch::Types ref, Bool tableMustBeEmpty=True)
set the epoch type for the TIME column.
casacore::MPosition::Types
Types
Types of known MPositions Warning: The order defines the order in the translation matrix FromTo in t...
Definition: MPosition.h:94