source: branches/alma/src/Scantable.cpp@ 1395

Last change on this file since 1395 was 1387, checked in by TakTsutsumi, 17 years ago

merged from NRAO version of ASAP 2.1 with ALMA specific modifications

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 33.7 KB
RevLine 
[805]1//
2// C++ Implementation: Scantable
3//
4// Description:
5//
6//
7// Author: Malte Marquarding <asap@atnf.csiro.au>, (C) 2005
8//
9// Copyright: See COPYING file that comes with this distribution
10//
11//
[206]12#include <map>
13
[125]14#include <casa/aips.h>
[80]15#include <casa/iostream.h>
16#include <casa/iomanip.h>
[805]17#include <casa/OS/Path.h>
18#include <casa/OS/File.h>
[80]19#include <casa/Arrays/Array.h>
20#include <casa/Arrays/ArrayMath.h>
21#include <casa/Arrays/MaskArrMath.h>
22#include <casa/Arrays/ArrayLogical.h>
23#include <casa/Arrays/ArrayAccessor.h>
[1325]24#include <casa/Arrays/Vector.h>
[455]25#include <casa/Arrays/VectorSTLIterator.h>
[418]26#include <casa/BasicMath/Math.h>
[504]27#include <casa/BasicSL/Constants.h>
[286]28#include <casa/Quanta/MVAngle.h>
[805]29#include <casa/Containers/RecordField.h>
[902]30#include <casa/Utilities/GenSort.h>
[2]31
[80]32#include <tables/Tables/TableParse.h>
33#include <tables/Tables/TableDesc.h>
[488]34#include <tables/Tables/TableCopy.h>
[80]35#include <tables/Tables/SetupNewTab.h>
36#include <tables/Tables/ScaColDesc.h>
37#include <tables/Tables/ArrColDesc.h>
[805]38#include <tables/Tables/TableRow.h>
39#include <tables/Tables/TableVector.h>
40#include <tables/Tables/TableIter.h>
[2]41
[80]42#include <tables/Tables/ExprNode.h>
43#include <tables/Tables/TableRecord.h>
[1325]44#include <casa/Quanta/MVTime.h>
45#include <casa/Quanta/MVAngle.h>
46#include <measures/Measures/MeasRef.h>
47#include <measures/Measures/MeasTable.h>
48// needed to avoid error in .tcc
49#include <measures/Measures/MCDirection.h>
50//
51#include <measures/Measures/MDirection.h>
[80]52#include <measures/Measures/MFrequency.h>
[805]53#include <measures/Measures/MEpoch.h>
54#include <measures/TableMeasures/TableMeasRefDesc.h>
55#include <measures/TableMeasures/TableMeasValueDesc.h>
56#include <measures/TableMeasures/TableMeasDesc.h>
57#include <measures/TableMeasures/ScalarMeasColumn.h>
[105]58#include <coordinates/Coordinates/CoordinateUtil.h>
[2]59
[805]60#include "Scantable.h"
[896]61#include "STPolLinear.h"
[1189]62#include "STPolCircular.h"
[913]63#include "STPolStokes.h"
[878]64#include "STAttr.h"
[902]65#include "MathUtils.h"
[2]66
[125]67using namespace casa;
[2]68
[805]69namespace asap {
70
[896]71std::map<std::string, STPol::STPolFactory *> Scantable::factories_;
72
73void Scantable::initFactories() {
74 if ( factories_.empty() ) {
75 Scantable::factories_["linear"] = &STPolLinear::myFactory;
[1323]76 Scantable::factories_["circular"] = &STPolCircular::myFactory;
[913]77 Scantable::factories_["stokes"] = &STPolStokes::myFactory;
[896]78 }
79}
80
[805]81Scantable::Scantable(Table::TableType ttype) :
[852]82 type_(ttype)
[206]83{
[896]84 initFactories();
[805]85 setupMainTable();
[852]86 freqTable_ = STFrequencies(*this);
[805]87 table_.rwKeywordSet().defineTable("FREQUENCIES", freqTable_.table());
[852]88 weatherTable_ = STWeather(*this);
[805]89 table_.rwKeywordSet().defineTable("WEATHER", weatherTable_.table());
[852]90 focusTable_ = STFocus(*this);
[805]91 table_.rwKeywordSet().defineTable("FOCUS", focusTable_.table());
[852]92 tcalTable_ = STTcal(*this);
[805]93 table_.rwKeywordSet().defineTable("TCAL", tcalTable_.table());
[852]94 moleculeTable_ = STMolecules(*this);
[805]95 table_.rwKeywordSet().defineTable("MOLECULES", moleculeTable_.table());
[860]96 historyTable_ = STHistory(*this);
97 table_.rwKeywordSet().defineTable("HISTORY", historyTable_.table());
[959]98 fitTable_ = STFit(*this);
99 table_.rwKeywordSet().defineTable("FIT", fitTable_.table());
[805]100 originalTable_ = table_;
[322]101 attach();
[18]102}
[206]103
[805]104Scantable::Scantable(const std::string& name, Table::TableType ttype) :
[852]105 type_(ttype)
[206]106{
[896]107 initFactories();
[865]108 Table tab(name, Table::Update);
[1009]109 uInt version = tab.keywordSet().asuInt("VERSION");
[483]110 if (version != version_) {
111 throw(AipsError("Unsupported version of ASAP file."));
112 }
[1009]113 if ( type_ == Table::Memory ) {
[852]114 table_ = tab.copyToMemoryTable(generateName());
[1009]115 } else {
[805]116 table_ = tab;
[1009]117 }
118
[859]119 attachSubtables();
[805]120 originalTable_ = table_;
[329]121 attach();
[2]122}
123
[805]124Scantable::Scantable( const Scantable& other, bool clear )
[206]125{
[805]126 // with or without data
[859]127 String newname = String(generateName());
[865]128 type_ = other.table_.tableType();
[859]129 if ( other.table_.tableType() == Table::Memory ) {
130 if ( clear ) {
131 table_ = TableCopy::makeEmptyMemoryTable(newname,
132 other.table_, True);
133 } else
134 table_ = other.table_.copyToMemoryTable(newname);
[16]135 } else {
[915]136 other.table_.deepCopy(newname, Table::New, False,
137 other.table_.endianFormat(),
[865]138 Bool(clear));
139 table_ = Table(newname, Table::Update);
140 table_.markForDelete();
141 }
[1111]142 /// @todo reindex SCANNO, recompute nbeam, nif, npol
[915]143 if ( clear ) copySubtables(other);
[859]144 attachSubtables();
[805]145 originalTable_ = table_;
[322]146 attach();
[2]147}
148
[865]149void Scantable::copySubtables(const Scantable& other) {
150 Table t = table_.rwKeywordSet().asTable("FREQUENCIES");
151 TableCopy::copyRows(t, other.freqTable_.table());
152 t = table_.rwKeywordSet().asTable("FOCUS");
153 TableCopy::copyRows(t, other.focusTable_.table());
154 t = table_.rwKeywordSet().asTable("WEATHER");
155 TableCopy::copyRows(t, other.weatherTable_.table());
156 t = table_.rwKeywordSet().asTable("TCAL");
157 TableCopy::copyRows(t, other.tcalTable_.table());
158 t = table_.rwKeywordSet().asTable("MOLECULES");
159 TableCopy::copyRows(t, other.moleculeTable_.table());
160 t = table_.rwKeywordSet().asTable("HISTORY");
161 TableCopy::copyRows(t, other.historyTable_.table());
[972]162 t = table_.rwKeywordSet().asTable("FIT");
163 TableCopy::copyRows(t, other.fitTable_.table());
[865]164}
165
[859]166void Scantable::attachSubtables()
167{
168 freqTable_ = STFrequencies(table_);
169 focusTable_ = STFocus(table_);
170 weatherTable_ = STWeather(table_);
171 tcalTable_ = STTcal(table_);
172 moleculeTable_ = STMolecules(table_);
[860]173 historyTable_ = STHistory(table_);
[972]174 fitTable_ = STFit(table_);
[859]175}
176
[805]177Scantable::~Scantable()
[206]178{
[941]179 //cout << "~Scantable() " << this << endl;
[2]180}
181
[805]182void Scantable::setupMainTable()
[206]183{
[805]184 TableDesc td("", "1", TableDesc::Scratch);
185 td.comment() = "An ASAP Scantable";
[1009]186 td.rwKeywordSet().define("VERSION", uInt(version_));
[2]187
[805]188 // n Cycles
189 td.addColumn(ScalarColumnDesc<uInt>("SCANNO"));
190 // new index every nBeam x nIF x nPol
191 td.addColumn(ScalarColumnDesc<uInt>("CYCLENO"));
[2]192
[805]193 td.addColumn(ScalarColumnDesc<uInt>("BEAMNO"));
194 td.addColumn(ScalarColumnDesc<uInt>("IFNO"));
[972]195 // linear, circular, stokes
[805]196 td.rwKeywordSet().define("POLTYPE", String("linear"));
197 td.addColumn(ScalarColumnDesc<uInt>("POLNO"));
[138]198
[805]199 td.addColumn(ScalarColumnDesc<uInt>("FREQ_ID"));
200 td.addColumn(ScalarColumnDesc<uInt>("MOLECULE_ID"));
201 td.addColumn(ScalarColumnDesc<Int>("REFBEAMNO"));
[80]202
[805]203 td.addColumn(ScalarColumnDesc<Double>("TIME"));
204 TableMeasRefDesc measRef(MEpoch::UTC); // UTC as default
205 TableMeasValueDesc measVal(td, "TIME");
206 TableMeasDesc<MEpoch> mepochCol(measVal, measRef);
207 mepochCol.write(td);
[483]208
[805]209 td.addColumn(ScalarColumnDesc<Double>("INTERVAL"));
210
[2]211 td.addColumn(ScalarColumnDesc<String>("SRCNAME"));
[805]212 // Type of source (on=0, off=1, other=-1)
213 td.addColumn(ScalarColumnDesc<Int>("SRCTYPE", Int(-1)));
214 td.addColumn(ScalarColumnDesc<String>("FIELDNAME"));
215
216 //The actual Data Vectors
[2]217 td.addColumn(ArrayColumnDesc<Float>("SPECTRA"));
218 td.addColumn(ArrayColumnDesc<uChar>("FLAGTRA"));
[89]219 td.addColumn(ArrayColumnDesc<Float>("TSYS"));
[805]220
221 td.addColumn(ArrayColumnDesc<Double>("DIRECTION",
222 IPosition(1,2),
223 ColumnDesc::Direct));
224 TableMeasRefDesc mdirRef(MDirection::J2000); // default
225 TableMeasValueDesc tmvdMDir(td, "DIRECTION");
226 // the TableMeasDesc gives the column a type
227 TableMeasDesc<MDirection> mdirCol(tmvdMDir, mdirRef);
[987]228 // a uder set table type e.g. GALCTIC, B1950 ...
229 td.rwKeywordSet().define("DIRECTIONREF", String("J2000"));
[805]230 // writing create the measure column
231 mdirCol.write(td);
[923]232 td.addColumn(ScalarColumnDesc<Float>("AZIMUTH"));
233 td.addColumn(ScalarColumnDesc<Float>("ELEVATION"));
[105]234 td.addColumn(ScalarColumnDesc<Float>("PARANGLE"));
[1047]235 td.addColumn(ScalarColumnDesc<Float>("OPACITY"));
[105]236
[805]237 td.addColumn(ScalarColumnDesc<uInt>("TCAL_ID"));
[972]238 ScalarColumnDesc<Int> fitColumn("FIT_ID");
[973]239 fitColumn.setDefault(Int(-1));
[972]240 td.addColumn(fitColumn);
[805]241
242 td.addColumn(ScalarColumnDesc<uInt>("FOCUS_ID"));
243 td.addColumn(ScalarColumnDesc<uInt>("WEATHER_ID"));
244
[999]245 // columns which just get dragged along, as they aren't used in asap
246 td.addColumn(ScalarColumnDesc<Double>("SRCVELOCITY"));
247 td.addColumn(ArrayColumnDesc<Double>("SRCPROPERMOTION"));
248 td.addColumn(ArrayColumnDesc<Double>("SRCDIRECTION"));
249 td.addColumn(ArrayColumnDesc<Double>("SCANRATE"));
250
[805]251 td.rwKeywordSet().define("OBSMODE", String(""));
252
[418]253 // Now create Table SetUp from the description.
[859]254 SetupNewTable aNewTab(generateName(), td, Table::Scratch);
[852]255 table_ = Table(aNewTab, type_, 0);
[805]256 originalTable_ = table_;
257}
[418]258
[455]259
[805]260void Scantable::attach()
[455]261{
[805]262 timeCol_.attach(table_, "TIME");
263 srcnCol_.attach(table_, "SRCNAME");
[1068]264 srctCol_.attach(table_, "SRCTYPE");
[805]265 specCol_.attach(table_, "SPECTRA");
266 flagsCol_.attach(table_, "FLAGTRA");
[865]267 tsysCol_.attach(table_, "TSYS");
[805]268 cycleCol_.attach(table_,"CYCLENO");
269 scanCol_.attach(table_, "SCANNO");
270 beamCol_.attach(table_, "BEAMNO");
[847]271 ifCol_.attach(table_, "IFNO");
272 polCol_.attach(table_, "POLNO");
[805]273 integrCol_.attach(table_, "INTERVAL");
274 azCol_.attach(table_, "AZIMUTH");
275 elCol_.attach(table_, "ELEVATION");
276 dirCol_.attach(table_, "DIRECTION");
277 paraCol_.attach(table_, "PARANGLE");
278 fldnCol_.attach(table_, "FIELDNAME");
279 rbeamCol_.attach(table_, "REFBEAMNO");
[455]280
[805]281 mfitidCol_.attach(table_,"FIT_ID");
282 mfreqidCol_.attach(table_, "FREQ_ID");
283 mtcalidCol_.attach(table_, "TCAL_ID");
284 mfocusidCol_.attach(table_, "FOCUS_ID");
285 mmolidCol_.attach(table_, "MOLECULE_ID");
[455]286}
287
[901]288void Scantable::setHeader(const STHeader& sdh)
[206]289{
[18]290 table_.rwKeywordSet().define("nIF", sdh.nif);
291 table_.rwKeywordSet().define("nBeam", sdh.nbeam);
292 table_.rwKeywordSet().define("nPol", sdh.npol);
293 table_.rwKeywordSet().define("nChan", sdh.nchan);
294 table_.rwKeywordSet().define("Observer", sdh.observer);
295 table_.rwKeywordSet().define("Project", sdh.project);
296 table_.rwKeywordSet().define("Obstype", sdh.obstype);
297 table_.rwKeywordSet().define("AntennaName", sdh.antennaname);
298 table_.rwKeywordSet().define("AntennaPosition", sdh.antennaposition);
299 table_.rwKeywordSet().define("Equinox", sdh.equinox);
300 table_.rwKeywordSet().define("FreqRefFrame", sdh.freqref);
301 table_.rwKeywordSet().define("FreqRefVal", sdh.reffreq);
302 table_.rwKeywordSet().define("Bandwidth", sdh.bandwidth);
303 table_.rwKeywordSet().define("UTC", sdh.utc);
[206]304 table_.rwKeywordSet().define("FluxUnit", sdh.fluxunit);
305 table_.rwKeywordSet().define("Epoch", sdh.epoch);
[905]306 table_.rwKeywordSet().define("POLTYPE", sdh.poltype);
[50]307}
[21]308
[901]309STHeader Scantable::getHeader() const
[206]310{
[901]311 STHeader sdh;
[21]312 table_.keywordSet().get("nBeam",sdh.nbeam);
313 table_.keywordSet().get("nIF",sdh.nif);
314 table_.keywordSet().get("nPol",sdh.npol);
315 table_.keywordSet().get("nChan",sdh.nchan);
316 table_.keywordSet().get("Observer", sdh.observer);
317 table_.keywordSet().get("Project", sdh.project);
318 table_.keywordSet().get("Obstype", sdh.obstype);
319 table_.keywordSet().get("AntennaName", sdh.antennaname);
320 table_.keywordSet().get("AntennaPosition", sdh.antennaposition);
321 table_.keywordSet().get("Equinox", sdh.equinox);
322 table_.keywordSet().get("FreqRefFrame", sdh.freqref);
323 table_.keywordSet().get("FreqRefVal", sdh.reffreq);
324 table_.keywordSet().get("Bandwidth", sdh.bandwidth);
325 table_.keywordSet().get("UTC", sdh.utc);
[206]326 table_.keywordSet().get("FluxUnit", sdh.fluxunit);
327 table_.keywordSet().get("Epoch", sdh.epoch);
[905]328 table_.keywordSet().get("POLTYPE", sdh.poltype);
[21]329 return sdh;
[18]330}
[805]331
[1360]332void Scantable::setSourceType( int stype )
[1068]333{
334 if ( stype < 0 || stype > 1 )
335 throw(AipsError("Illegal sourcetype."));
336 TableVector<Int> tabvec(table_, "SRCTYPE");
337 tabvec = Int(stype);
338}
339
[845]340bool Scantable::conformant( const Scantable& other )
341{
342 return this->getHeader().conformant(other.getHeader());
343}
344
345
[50]346
[805]347std::string Scantable::formatSec(Double x) const
[206]348{
[105]349 Double xcop = x;
350 MVTime mvt(xcop/24./3600.); // make days
[365]351
[105]352 if (x < 59.95)
[281]353 return String(" ") + mvt.string(MVTime::TIME_CLEAN_NO_HM, 7)+"s";
[745]354 else if (x < 3599.95)
[281]355 return String(" ") + mvt.string(MVTime::TIME_CLEAN_NO_H,7)+" ";
356 else {
357 ostringstream oss;
358 oss << setw(2) << std::right << setprecision(1) << mvt.hour();
359 oss << ":" << mvt.string(MVTime::TIME_CLEAN_NO_H,7) << " ";
360 return String(oss);
[745]361 }
[105]362};
363
[805]364std::string Scantable::formatDirection(const MDirection& md) const
[281]365{
366 Vector<Double> t = md.getAngle(Unit(String("rad"))).getValue();
367 Int prec = 7;
368
369 MVAngle mvLon(t[0]);
370 String sLon = mvLon.string(MVAngle::TIME,prec);
[987]371 uInt tp = md.getRef().getType();
372 if (tp == MDirection::GALACTIC ||
373 tp == MDirection::SUPERGAL ) {
374 sLon = mvLon(0.0).string(MVAngle::ANGLE_CLEAN,prec);
375 }
[281]376 MVAngle mvLat(t[1]);
377 String sLat = mvLat.string(MVAngle::ANGLE+MVAngle::DIG2,prec);
[380]378 return sLon + String(" ") + sLat;
[281]379}
380
381
[805]382std::string Scantable::getFluxUnit() const
[206]383{
[847]384 return table_.keywordSet().asString("FluxUnit");
[206]385}
386
[805]387void Scantable::setFluxUnit(const std::string& unit)
[218]388{
389 String tmp(unit);
390 Unit tU(tmp);
391 if (tU==Unit("K") || tU==Unit("Jy")) {
392 table_.rwKeywordSet().define(String("FluxUnit"), tmp);
393 } else {
394 throw AipsError("Illegal unit - must be compatible with Jy or K");
395 }
396}
397
[805]398void Scantable::setInstrument(const std::string& name)
[236]399{
[805]400 bool throwIt = true;
[996]401 // create an Instrument to see if this is valid
402 STAttr::convertInstrument(name, throwIt);
[236]403 String nameU(name);
404 nameU.upcase();
405 table_.rwKeywordSet().define(String("AntennaName"), nameU);
406}
407
[1189]408void Scantable::setFeedType(const std::string& feedtype)
409{
410 if ( Scantable::factories_.find(feedtype) == Scantable::factories_.end() ) {
411 std::string msg = "Illegal feed type "+ feedtype;
412 throw(casa::AipsError(msg));
413 }
414 table_.rwKeywordSet().define(String("POLTYPE"), feedtype);
415}
416
[805]417MPosition Scantable::getAntennaPosition () const
418{
419 Vector<Double> antpos;
420 table_.keywordSet().get("AntennaPosition", antpos);
421 MVPosition mvpos(antpos(0),antpos(1),antpos(2));
422 return MPosition(mvpos);
423}
[281]424
[805]425void Scantable::makePersistent(const std::string& filename)
426{
427 String inname(filename);
428 Path path(inname);
[1111]429 /// @todo reindex SCANNO, recompute nbeam, nif, npol
[805]430 inname = path.expandedName();
431 table_.deepCopy(inname, Table::New);
432}
433
[837]434int Scantable::nbeam( int scanno ) const
[805]435{
436 if ( scanno < 0 ) {
437 Int n;
438 table_.keywordSet().get("nBeam",n);
439 return int(n);
[105]440 } else {
[805]441 // take the first POLNO,IFNO,CYCLENO as nbeam shouldn't vary with these
[888]442 Table t = table_(table_.col("SCANNO") == scanno);
443 ROTableRow row(t);
444 const TableRecord& rec = row.get(0);
445 Table subt = t( t.col("IFNO") == Int(rec.asuInt("IFNO"))
446 && t.col("POLNO") == Int(rec.asuInt("POLNO"))
447 && t.col("CYCLENO") == Int(rec.asuInt("CYCLENO")) );
448 ROTableVector<uInt> v(subt, "BEAMNO");
[805]449 return int(v.nelements());
[105]450 }
[805]451 return 0;
452}
[455]453
[837]454int Scantable::nif( int scanno ) const
[805]455{
456 if ( scanno < 0 ) {
457 Int n;
458 table_.keywordSet().get("nIF",n);
459 return int(n);
460 } else {
461 // take the first POLNO,BEAMNO,CYCLENO as nbeam shouldn't vary with these
[888]462 Table t = table_(table_.col("SCANNO") == scanno);
463 ROTableRow row(t);
464 const TableRecord& rec = row.get(0);
465 Table subt = t( t.col("BEAMNO") == Int(rec.asuInt("BEAMNO"))
466 && t.col("POLNO") == Int(rec.asuInt("POLNO"))
467 && t.col("CYCLENO") == Int(rec.asuInt("CYCLENO")) );
468 if ( subt.nrow() == 0 ) return 0;
469 ROTableVector<uInt> v(subt, "IFNO");
[805]470 return int(v.nelements());
[2]471 }
[805]472 return 0;
473}
[321]474
[837]475int Scantable::npol( int scanno ) const
[805]476{
477 if ( scanno < 0 ) {
478 Int n;
479 table_.keywordSet().get("nPol",n);
480 return n;
481 } else {
482 // take the first POLNO,IFNO,CYCLENO as nbeam shouldn't vary with these
[888]483 Table t = table_(table_.col("SCANNO") == scanno);
484 ROTableRow row(t);
485 const TableRecord& rec = row.get(0);
486 Table subt = t( t.col("BEAMNO") == Int(rec.asuInt("BEAMNO"))
487 && t.col("IFNO") == Int(rec.asuInt("IFNO"))
488 && t.col("CYCLENO") == Int(rec.asuInt("CYCLENO")) );
489 if ( subt.nrow() == 0 ) return 0;
490 ROTableVector<uInt> v(subt, "POLNO");
[805]491 return int(v.nelements());
[321]492 }
[805]493 return 0;
[2]494}
[805]495
[845]496int Scantable::ncycle( int scanno ) const
[206]497{
[805]498 if ( scanno < 0 ) {
[837]499 Block<String> cols(2);
500 cols[0] = "SCANNO";
501 cols[1] = "CYCLENO";
502 TableIterator it(table_, cols);
503 int n = 0;
504 while ( !it.pastEnd() ) {
505 ++n;
[902]506 ++it;
[837]507 }
508 return n;
[805]509 } else {
[888]510 Table t = table_(table_.col("SCANNO") == scanno);
511 ROTableRow row(t);
512 const TableRecord& rec = row.get(0);
513 Table subt = t( t.col("BEAMNO") == Int(rec.asuInt("BEAMNO"))
514 && t.col("POLNO") == Int(rec.asuInt("POLNO"))
515 && t.col("IFNO") == Int(rec.asuInt("IFNO")) );
516 if ( subt.nrow() == 0 ) return 0;
517 return int(subt.nrow());
[805]518 }
519 return 0;
[18]520}
[455]521
522
[845]523int Scantable::nrow( int scanno ) const
[805]524{
[845]525 return int(table_.nrow());
526}
527
528int Scantable::nchan( int ifno ) const
529{
530 if ( ifno < 0 ) {
[805]531 Int n;
532 table_.keywordSet().get("nChan",n);
533 return int(n);
534 } else {
[1360]535 // take the first SCANNO,POLNO,BEAMNO,CYCLENO as nbeam shouldn't
536 // vary with these
[888]537 Table t = table_(table_.col("IFNO") == ifno);
538 if ( t.nrow() == 0 ) return 0;
539 ROArrayColumn<Float> v(t, "SPECTRA");
[923]540 return v.shape(0)(0);
[805]541 }
542 return 0;
[18]543}
[455]544
[1111]545int Scantable::nscan() const {
546 Vector<uInt> scannos(scanCol_.getColumn());
[1148]547 uInt nout = genSort( scannos, Sort::Ascending,
[1111]548 Sort::QuickSort|Sort::NoDuplicates );
549 return int(nout);
550}
551
[923]552int Scantable::getChannels(int whichrow) const
553{
554 return specCol_.shape(whichrow)(0);
555}
[847]556
557int Scantable::getBeam(int whichrow) const
558{
559 return beamCol_(whichrow);
560}
561
[1111]562std::vector<uint> Scantable::getNumbers(ScalarColumn<uInt>& col)
563{
564 Vector<uInt> nos(col.getColumn());
[1148]565 uInt n = genSort( nos, Sort::Ascending, Sort::QuickSort|Sort::NoDuplicates );
566 nos.resize(n, True);
[1111]567 std::vector<uint> stlout;
568 nos.tovector(stlout);
569 return stlout;
570}
571
[847]572int Scantable::getIF(int whichrow) const
573{
574 return ifCol_(whichrow);
575}
576
577int Scantable::getPol(int whichrow) const
578{
579 return polCol_(whichrow);
580}
581
[805]582std::string Scantable::formatTime(const MEpoch& me, bool showdate) const
583{
584 MVTime mvt(me.getValue());
585 if (showdate)
586 mvt.setFormat(MVTime::YMD);
587 else
588 mvt.setFormat(MVTime::TIME);
589 ostringstream oss;
590 oss << mvt;
591 return String(oss);
592}
[488]593
[805]594void Scantable::calculateAZEL()
595{
596 MPosition mp = getAntennaPosition();
597 MEpoch::ROScalarColumn timeCol(table_, "TIME");
598 ostringstream oss;
599 oss << "Computed azimuth/elevation using " << endl
600 << mp << endl;
[996]601 for (Int i=0; i<nrow(); ++i) {
[805]602 MEpoch me = timeCol(i);
[987]603 MDirection md = getDirection(i);
[805]604 oss << " Time: " << formatTime(me,False) << " Direction: " << formatDirection(md)
605 << endl << " => ";
606 MeasFrame frame(mp, me);
607 Vector<Double> azel =
608 MDirection::Convert(md, MDirection::Ref(MDirection::AZEL,
609 frame)
610 )().getAngle("rad").getValue();
[923]611 azCol_.put(i,Float(azel[0]));
612 elCol_.put(i,Float(azel[1]));
[805]613 oss << "azel: " << azel[0]/C::pi*180.0 << " "
614 << azel[1]/C::pi*180.0 << " (deg)" << endl;
[16]615 }
[805]616 pushLog(String(oss));
617}
[89]618
[1000]619void Scantable::flag(const std::vector<bool>& msk)
[865]620{
[1333]621 std::vector<bool>::const_iterator it;
622 uInt ntrue = 0;
623 for (it = msk.begin(); it != msk.end(); ++it) {
624 if ( *it ) {
625 ntrue++;
626 }
627 }
628 if ( selector_.empty() && (msk.size() == 0 || msk.size() == ntrue) )
[1000]629 throw(AipsError("Trying to flag whole scantable."));
630 if ( msk.size() == 0 ) {
631 uChar userflag = 1 << 7;
632 for ( uInt i=0; i<table_.nrow(); ++i) {
633 Vector<uChar> flgs = flagsCol_(i);
634 flgs = userflag;
635 flagsCol_.put(i, flgs);
636 }
637 return;
638 }
639 if ( int(msk.size()) != nchan() ) {
640 throw(AipsError("Mask has incorrect number of channels."));
641 }
642 for ( uInt i=0; i<table_.nrow(); ++i) {
643 Vector<uChar> flgs = flagsCol_(i);
644 if ( flgs.nelements() != msk.size() ) {
645 throw(AipsError("Mask has incorrect number of channels."
646 " Probably varying with IF. Please flag per IF"));
647 }
648 std::vector<bool>::const_iterator it;
649 uInt j = 0;
650 uChar userflag = 1 << 7;
651 for (it = msk.begin(); it != msk.end(); ++it) {
652 if ( *it ) {
653 flgs(j) = userflag;
654 }
655 ++j;
656 }
657 flagsCol_.put(i, flgs);
658 }
[865]659}
660
[805]661std::vector<bool> Scantable::getMask(int whichrow) const
662{
663 Vector<uChar> flags;
664 flagsCol_.get(uInt(whichrow), flags);
665 Vector<Bool> bflag(flags.shape());
666 convertArray(bflag, flags);
667 bflag = !bflag;
668 std::vector<bool> mask;
669 bflag.tovector(mask);
670 return mask;
671}
[89]672
[896]673std::vector<float> Scantable::getSpectrum( int whichrow,
[902]674 const std::string& poltype ) const
[805]675{
[905]676 String ptype = poltype;
677 if (poltype == "" ) ptype = getPolType();
[902]678 if ( whichrow < 0 || whichrow >= nrow() )
679 throw(AipsError("Illegal row number."));
[896]680 std::vector<float> out;
[805]681 Vector<Float> arr;
[896]682 uInt requestedpol = polCol_(whichrow);
683 String basetype = getPolType();
[905]684 if ( ptype == basetype ) {
[896]685 specCol_.get(whichrow, arr);
686 } else {
[1334]687 CountedPtr<STPol> stpol(STPol::getPolClass(Scantable::factories_, basetype));
688 uInt row = uInt(whichrow);
689 stpol->setSpectra(getPolMatrix(row));
690 Float fang,fhand,parang;
691 fang = focusTable_.getTotalFeedAngle(mfocusidCol_(row));
692 fhand = focusTable_.getFeedHand(mfocusidCol_(row));
693 parang = paraCol_(row);
694 /// @todo re-enable this
695 // disable total feed angle to support paralactifying Caswell style
696 stpol->setPhaseCorrections(parang, -parang, fhand);
697 arr = stpol->getSpectrum(requestedpol, ptype);
[896]698 }
[902]699 if ( arr.nelements() == 0 )
700 pushLog("Not enough polarisations present to do the conversion.");
[805]701 arr.tovector(out);
702 return out;
[89]703}
[212]704
[1360]705void Scantable::setSpectrum( const std::vector<float>& spec,
[884]706 int whichrow )
707{
708 Vector<Float> spectrum(spec);
709 Vector<Float> arr;
710 specCol_.get(whichrow, arr);
711 if ( spectrum.nelements() != arr.nelements() )
[896]712 throw AipsError("The spectrum has incorrect number of channels.");
[884]713 specCol_.put(whichrow, spectrum);
714}
715
716
[805]717String Scantable::generateName()
[745]718{
[805]719 return (File::newUniqueName("./","temp")).baseName();
[212]720}
721
[805]722const casa::Table& Scantable::table( ) const
[212]723{
[805]724 return table_;
[212]725}
726
[805]727casa::Table& Scantable::table( )
[386]728{
[805]729 return table_;
[386]730}
731
[896]732std::string Scantable::getPolType() const
733{
734 return table_.keywordSet().asString("POLTYPE");
735}
736
[805]737void Scantable::unsetSelection()
[380]738{
[805]739 table_ = originalTable_;
[847]740 attach();
[805]741 selector_.reset();
[380]742}
[386]743
[805]744void Scantable::setSelection( const STSelector& selection )
[430]745{
[805]746 Table tab = const_cast<STSelector&>(selection).apply(originalTable_);
747 if ( tab.nrow() == 0 ) {
748 throw(AipsError("Selection contains no data. Not applying it."));
749 }
750 table_ = tab;
[847]751 attach();
[805]752 selector_ = selection;
[430]753}
754
[837]755std::string Scantable::summary( bool verbose )
[447]756{
[805]757 // Format header info
758 ostringstream oss;
759 oss << endl;
760 oss << asap::SEPERATOR << endl;
761 oss << " Scan Table Summary" << endl;
762 oss << asap::SEPERATOR << endl;
763 oss.flags(std::ios_base::left);
764 oss << setw(15) << "Beams:" << setw(4) << nbeam() << endl
765 << setw(15) << "IFs:" << setw(4) << nif() << endl
[896]766 << setw(15) << "Polarisations:" << setw(4) << npol()
767 << "(" << getPolType() << ")" << endl
[805]768 << setw(15) << "Channels:" << setw(4) << nchan() << endl;
769 oss << endl;
770 String tmp;
[860]771 oss << setw(15) << "Observer:"
772 << table_.keywordSet().asString("Observer") << endl;
[805]773 oss << setw(15) << "Obs Date:" << getTime(-1,true) << endl;
774 table_.keywordSet().get("Project", tmp);
775 oss << setw(15) << "Project:" << tmp << endl;
776 table_.keywordSet().get("Obstype", tmp);
777 oss << setw(15) << "Obs. Type:" << tmp << endl;
778 table_.keywordSet().get("AntennaName", tmp);
779 oss << setw(15) << "Antenna Name:" << tmp << endl;
780 table_.keywordSet().get("FluxUnit", tmp);
781 oss << setw(15) << "Flux Unit:" << tmp << endl;
[941]782 Vector<Double> vec(moleculeTable_.getRestFrequencies());
[805]783 oss << setw(15) << "Rest Freqs:";
784 if (vec.nelements() > 0) {
785 oss << setprecision(10) << vec << " [Hz]" << endl;
786 } else {
787 oss << "none" << endl;
788 }
[941]789
790 oss << setw(15) << "Abcissa:" << getAbcissaLabel(0) << endl;
[805]791 oss << selector_.print() << endl;
792 oss << endl;
793 // main table
794 String dirtype = "Position ("
[987]795 + getDirectionRefString()
[805]796 + ")";
[941]797 oss << setw(5) << "Scan" << setw(15) << "Source"
798 << setw(10) << "Time" << setw(18) << "Integration" << endl;
799 oss << setw(5) << "" << setw(5) << "Beam" << setw(3) << "" << dirtype << endl;
800 oss << setw(10) << "" << setw(3) << "IF" << setw(6) << ""
[805]801 << setw(8) << "Frame" << setw(16)
802 << "RefVal" << setw(10) << "RefPix" << setw(12) << "Increment" <<endl;
803 oss << asap::SEPERATOR << endl;
804 TableIterator iter(table_, "SCANNO");
805 while (!iter.pastEnd()) {
806 Table subt = iter.table();
807 ROTableRow row(subt);
808 MEpoch::ROScalarColumn timeCol(subt,"TIME");
809 const TableRecord& rec = row.get(0);
810 oss << setw(4) << std::right << rec.asuInt("SCANNO")
811 << std::left << setw(1) << ""
812 << setw(15) << rec.asString("SRCNAME")
813 << setw(10) << formatTime(timeCol(0), false);
814 // count the cycles in the scan
815 TableIterator cyciter(subt, "CYCLENO");
816 int nint = 0;
817 while (!cyciter.pastEnd()) {
818 ++nint;
819 ++cyciter;
820 }
821 oss << setw(3) << std::right << nint << setw(3) << " x " << std::left
822 << setw(6) << formatSec(rec.asFloat("INTERVAL")) << endl;
[447]823
[805]824 TableIterator biter(subt, "BEAMNO");
825 while (!biter.pastEnd()) {
826 Table bsubt = biter.table();
827 ROTableRow brow(bsubt);
828 const TableRecord& brec = brow.get(0);
[1000]829 uInt row0 = bsubt.rowNumbers(table_)[0];
[941]830 oss << setw(5) << "" << setw(4) << std::right << brec.asuInt("BEAMNO")<< std::left;
[987]831 oss << setw(4) << "" << formatDirection(getDirection(row0)) << endl;
[805]832 TableIterator iiter(bsubt, "IFNO");
833 while (!iiter.pastEnd()) {
834 Table isubt = iiter.table();
835 ROTableRow irow(isubt);
836 const TableRecord& irec = irow.get(0);
[941]837 oss << setw(10) << "";
838 oss << setw(3) << std::right << irec.asuInt("IFNO") << std::left
[1375]839 << setw(2) << "" << frequencies().print(irec.asuInt("FREQ_ID"))
840 << endl;
[447]841
[805]842 ++iiter;
843 }
844 ++biter;
845 }
846 ++iter;
[447]847 }
[805]848 /// @todo implement verbose mode
849 return String(oss);
[447]850}
851
[805]852std::string Scantable::getTime(int whichrow, bool showdate) const
[777]853{
[805]854 MEpoch::ROScalarColumn timeCol(table_, "TIME");
855 MEpoch me;
856 if (whichrow > -1) {
857 me = timeCol(uInt(whichrow));
858 } else {
859 Double tm;
860 table_.keywordSet().get("UTC",tm);
861 me = MEpoch(MVEpoch(tm));
[777]862 }
[805]863 return formatTime(me, showdate);
[777]864}
[805]865
[1068]866std::string Scantable::getDirectionString(int whichrow) const
867{
868 return formatDirection(getDirection(uInt(whichrow)));
869}
870
[1360]871std::vector< double > Scantable::getAbcissa( int whichrow ) const
[865]872{
[996]873 if ( whichrow > int(table_.nrow()) ) throw(AipsError("Illegal ro number"));
[865]874 std::vector<double> stlout;
875 int nchan = specCol_(whichrow).nelements();
876 String us = freqTable_.getUnitString();
877 if ( us == "" || us == "pixel" || us == "channel" ) {
878 for (int i=0; i<nchan; ++i) {
879 stlout.push_back(double(i));
880 }
881 return stlout;
882 }
883
884 const MPosition& mp = getAntennaPosition();
[987]885 const MDirection& md = getDirection(whichrow);
[865]886 const MEpoch& me = timeCol_(whichrow);
887 Double rf = moleculeTable_.getRestFrequency(mmolidCol_(whichrow));
888 SpectralCoordinate spc =
889 freqTable_.getSpectralCoordinate(md, mp, me, rf, mfreqidCol_(whichrow));
890 Vector<Double> pixel(nchan);
891 Vector<Double> world;
892 indgen(pixel);
893 if ( Unit(us) == Unit("Hz") ) {
894 for ( int i=0; i < nchan; ++i) {
895 Double world;
896 spc.toWorld(world, pixel[i]);
897 stlout.push_back(double(world));
898 }
899 } else if ( Unit(us) == Unit("km/s") ) {
900 Vector<Double> world;
901 spc.pixelToVelocity(world, pixel);
902 world.tovector(stlout);
903 }
904 return stlout;
905}
[1360]906void Scantable::setDirectionRefString( const std::string & refstr )
[987]907{
908 MDirection::Types mdt;
909 if (refstr != "" && !MDirection::getType(mdt, refstr)) {
910 throw(AipsError("Illegal Direction frame."));
911 }
912 if ( refstr == "" ) {
913 String defaultstr = MDirection::showType(dirCol_.getMeasRef().getType());
914 table_.rwKeywordSet().define("DIRECTIONREF", defaultstr);
915 } else {
916 table_.rwKeywordSet().define("DIRECTIONREF", String(refstr));
917 }
918}
[865]919
[1360]920std::string Scantable::getDirectionRefString( ) const
[987]921{
922 return table_.keywordSet().asString("DIRECTIONREF");
923}
924
925MDirection Scantable::getDirection(int whichrow ) const
926{
927 String usertype = table_.keywordSet().asString("DIRECTIONREF");
928 String type = MDirection::showType(dirCol_.getMeasRef().getType());
929 if ( usertype != type ) {
930 MDirection::Types mdt;
931 if (!MDirection::getType(mdt, usertype)) {
932 throw(AipsError("Illegal Direction frame."));
933 }
934 return dirCol_.convert(uInt(whichrow), mdt);
935 } else {
936 return dirCol_(uInt(whichrow));
937 }
938}
939
[847]940std::string Scantable::getAbcissaLabel( int whichrow ) const
941{
[996]942 if ( whichrow > int(table_.nrow()) ) throw(AipsError("Illegal ro number"));
[847]943 const MPosition& mp = getAntennaPosition();
[987]944 const MDirection& md = getDirection(whichrow);
[847]945 const MEpoch& me = timeCol_(whichrow);
946 const Double& rf = mmolidCol_(whichrow);
947 SpectralCoordinate spc =
948 freqTable_.getSpectralCoordinate(md, mp, me, rf, mfreqidCol_(whichrow));
949
950 String s = "Channel";
951 Unit u = Unit(freqTable_.getUnitString());
952 if (u == Unit("km/s")) {
[1170]953 s = CoordinateUtil::axisLabel(spc, 0, True,True, True);
[847]954 } else if (u == Unit("Hz")) {
955 Vector<String> wau(1);wau = u.getName();
956 spc.setWorldAxisUnits(wau);
[1170]957 s = CoordinateUtil::axisLabel(spc, 0, True, True, False);
[847]958 }
959 return s;
960
961}
962
[1360]963void Scantable::setRestFrequencies( double rf, const std::string& name,
[1170]964 const std::string& unit )
[847]965{
[923]966 ///@todo lookup in line table to fill in name and formattedname
[847]967 Unit u(unit);
968 Quantum<Double> urf(rf, u);
[1170]969 uInt id = moleculeTable_.addEntry(urf.getValue("Hz"), name, "");
[847]970 TableVector<uInt> tabvec(table_, "MOLECULE_ID");
971 tabvec = id;
972}
973
[1360]974void Scantable::setRestFrequencies( const std::string& name )
[847]975{
976 throw(AipsError("setRestFrequencies( const std::string& name ) NYI"));
977 ///@todo implement
978}
979
[1360]980std::vector< unsigned int > Scantable::rownumbers( ) const
[852]981{
982 std::vector<unsigned int> stlout;
983 Vector<uInt> vec = table_.rowNumbers();
984 vec.tovector(stlout);
985 return stlout;
986}
987
[865]988
[1360]989Matrix<Float> Scantable::getPolMatrix( uInt whichrow ) const
[896]990{
991 ROTableRow row(table_);
992 const TableRecord& rec = row.get(whichrow);
993 Table t =
994 originalTable_( originalTable_.col("SCANNO") == Int(rec.asuInt("SCANNO"))
995 && originalTable_.col("BEAMNO") == Int(rec.asuInt("BEAMNO"))
996 && originalTable_.col("IFNO") == Int(rec.asuInt("IFNO"))
997 && originalTable_.col("CYCLENO") == Int(rec.asuInt("CYCLENO")) );
998 ROArrayColumn<Float> speccol(t, "SPECTRA");
999 return speccol.getColumn();
1000}
[865]1001
[1360]1002std::vector< std::string > Scantable::columnNames( ) const
[902]1003{
1004 Vector<String> vec = table_.tableDesc().columnNames();
1005 return mathutil::tovectorstring(vec);
1006}
[896]1007
[1360]1008MEpoch::Types Scantable::getTimeReference( ) const
[915]1009{
1010 return MEpoch::castType(timeCol_.getMeasRef().getType());
[972]1011}
[915]1012
[1360]1013void Scantable::addFit( const STFitEntry& fit, int row )
[972]1014{
1015 cout << mfitidCol_(uInt(row)) << endl;
1016 uInt id = fitTable_.addEntry(fit, mfitidCol_(uInt(row)));
1017 mfitidCol_.put(uInt(row), id);
1018}
[915]1019
[1360]1020void Scantable::shift(int npix)
1021{
1022 Vector<uInt> fids(mfreqidCol_.getColumn());
1023 genSort( fids, Sort::Ascending,
1024 Sort::QuickSort|Sort::NoDuplicates );
1025 for (uInt i=0; i<fids.nelements(); ++i) {
1026 frequencies().shiftRefPix(npix, i);
1027 }
1028}
[987]1029
[1387]1030std::string asap::Scantable::getAntennaName() const
1031{
1032 String out;
1033 table_.keywordSet().get("AntennaName", out);
1034 return out;
[987]1035}
[1387]1036
1037int asap::Scantable::checkScanInfo(const std::vector<int>& scanlist) const
1038{
1039 String tbpath;
1040 int ret = 0;
1041 if ( table_.keywordSet().isDefined("GBT_GO") ) {
1042 table_.keywordSet().get("GBT_GO", tbpath);
1043 Table t(tbpath,Table::Old);
1044 // check each scan if other scan of the pair exist
1045 int nscan = scanlist.size();
1046 for (int i = 0; i < nscan; i++) {
1047 Table subt = t( t.col("SCAN") == scanlist[i]+1 );
1048 if (subt.nrow()==0) {
1049 cerr <<"Scan "<<scanlist[i]<<" cannot be found in the scantable."<<endl;
1050 ret = 1;
1051 break;
1052 }
1053 ROTableRow row(subt);
1054 const TableRecord& rec = row.get(0);
1055 int scan1seqn = rec.asuInt("PROCSEQN");
1056 int laston1 = rec.asuInt("LASTON");
1057 if ( rec.asuInt("PROCSIZE")==2 ) {
1058 if ( i < nscan-1 ) {
1059 Table subt2 = t( t.col("SCAN") == scanlist[i+1]+1 );
1060 if ( subt2.nrow() == 0) {
1061 cerr<<"Scan "<<scanlist[i+1]<<" cannot be found in the scantable."<<endl;
1062 ret = 1;
1063 break;
1064 }
1065 ROTableRow row2(subt2);
1066 const TableRecord& rec2 = row2.get(0);
1067 int scan2seqn = rec2.asuInt("PROCSEQN");
1068 int laston2 = rec2.asuInt("LASTON");
1069 if (scan1seqn == 1 && scan2seqn == 2) {
1070 if (laston1 == laston2) {
1071 cerr<<"A valid scan pair ["<<scanlist[i]<<","<<scanlist[i+1]<<"]"<<endl;
1072 i +=1;
1073 }
1074 else {
1075 cerr<<"Incorrect scan pair ["<<scanlist[i]<<","<<scanlist[i+1]<<"]"<<endl;
1076 }
1077 }
1078 else if (scan1seqn==2 && scan2seqn == 1) {
1079 if (laston1 == laston2) {
1080 cerr<<"["<<scanlist[i]<<","<<scanlist[i+1]<<"] is a valid scan pair but in incorrect order."<<endl;
1081 ret = 1;
1082 break;
1083 }
1084 }
1085 else {
1086 cerr<<"The other scan for "<<scanlist[i]<<" appears to be missing. Check the input scan numbers."<<endl;
1087 ret = 1;
1088 break;
1089 }
1090 }
1091 }
1092 else {
1093 cerr<<"The scan does not appear to be standard obsevation."<<endl;
1094 }
1095 //if ( i >= nscan ) break;
1096 }
1097 }
1098 else {
1099 cerr<<"No reference to GBT_GO table."<<endl;
1100 ret = 1;
1101 }
1102 return ret;
1103}
1104
1105std::vector<double> asap::Scantable::getDirectionVector(int whichrow) const
1106{
1107 Vector<Double> Dir = dirCol_(whichrow).getAngle("rad").getValue();
1108 std::vector<double> dir;
1109 Dir.tovector(dir);
1110 return dir;
1111}
1112
1113}
[987]1114 //namespace asap
Note: See TracBrowser for help on using the repository browser.