source: trunk/src/Scantable.cpp@ 1475

Last change on this file since 1475 was 1430, checked in by Malte Marquarding, 16 years ago

merged in unflag option from alma branch

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 34.0 KB
Line 
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//
12#include <map>
13
14#include <casa/aips.h>
15#include <casa/iostream.h>
16#include <casa/iomanip.h>
17#include <casa/OS/Path.h>
18#include <casa/OS/File.h>
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>
24#include <casa/Arrays/Vector.h>
25#include <casa/Arrays/VectorSTLIterator.h>
26#include <casa/BasicMath/Math.h>
27#include <casa/BasicSL/Constants.h>
28#include <casa/Quanta/MVAngle.h>
29#include <casa/Containers/RecordField.h>
30#include <casa/Utilities/GenSort.h>
31
32#include <tables/Tables/TableParse.h>
33#include <tables/Tables/TableDesc.h>
34#include <tables/Tables/TableCopy.h>
35#include <tables/Tables/SetupNewTab.h>
36#include <tables/Tables/ScaColDesc.h>
37#include <tables/Tables/ArrColDesc.h>
38#include <tables/Tables/TableRow.h>
39#include <tables/Tables/TableVector.h>
40#include <tables/Tables/TableIter.h>
41
42#include <tables/Tables/ExprNode.h>
43#include <tables/Tables/TableRecord.h>
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>
52#include <measures/Measures/MFrequency.h>
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>
58#include <coordinates/Coordinates/CoordinateUtil.h>
59
60#include "Scantable.h"
61#include "STPolLinear.h"
62#include "STPolCircular.h"
63#include "STPolStokes.h"
64#include "STAttr.h"
65#include "MathUtils.h"
66
67using namespace casa;
68
69namespace asap {
70
71std::map<std::string, STPol::STPolFactory *> Scantable::factories_;
72
73void Scantable::initFactories() {
74 if ( factories_.empty() ) {
75 Scantable::factories_["linear"] = &STPolLinear::myFactory;
76 Scantable::factories_["circular"] = &STPolCircular::myFactory;
77 Scantable::factories_["stokes"] = &STPolStokes::myFactory;
78 }
79}
80
81Scantable::Scantable(Table::TableType ttype) :
82 type_(ttype)
83{
84 initFactories();
85 setupMainTable();
86 freqTable_ = STFrequencies(*this);
87 table_.rwKeywordSet().defineTable("FREQUENCIES", freqTable_.table());
88 weatherTable_ = STWeather(*this);
89 table_.rwKeywordSet().defineTable("WEATHER", weatherTable_.table());
90 focusTable_ = STFocus(*this);
91 table_.rwKeywordSet().defineTable("FOCUS", focusTable_.table());
92 tcalTable_ = STTcal(*this);
93 table_.rwKeywordSet().defineTable("TCAL", tcalTable_.table());
94 moleculeTable_ = STMolecules(*this);
95 table_.rwKeywordSet().defineTable("MOLECULES", moleculeTable_.table());
96 historyTable_ = STHistory(*this);
97 table_.rwKeywordSet().defineTable("HISTORY", historyTable_.table());
98 fitTable_ = STFit(*this);
99 table_.rwKeywordSet().defineTable("FIT", fitTable_.table());
100 originalTable_ = table_;
101 attach();
102}
103
104Scantable::Scantable(const std::string& name, Table::TableType ttype) :
105 type_(ttype)
106{
107 initFactories();
108 Table tab(name, Table::Update);
109 uInt version = tab.keywordSet().asuInt("VERSION");
110 if (version != version_) {
111 throw(AipsError("Unsupported version of ASAP file."));
112 }
113 if ( type_ == Table::Memory ) {
114 table_ = tab.copyToMemoryTable(generateName());
115 } else {
116 table_ = tab;
117 }
118
119 attachSubtables();
120 originalTable_ = table_;
121 attach();
122}
123
124Scantable::Scantable( const Scantable& other, bool clear )
125{
126 // with or without data
127 String newname = String(generateName());
128 type_ = other.table_.tableType();
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);
135 } else {
136 other.table_.deepCopy(newname, Table::New, False,
137 other.table_.endianFormat(),
138 Bool(clear));
139 table_ = Table(newname, Table::Update);
140 table_.markForDelete();
141 }
142 /// @todo reindex SCANNO, recompute nbeam, nif, npol
143 if ( clear ) copySubtables(other);
144 attachSubtables();
145 originalTable_ = table_;
146 attach();
147}
148
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());
162 t = table_.rwKeywordSet().asTable("FIT");
163 TableCopy::copyRows(t, other.fitTable_.table());
164}
165
166void Scantable::attachSubtables()
167{
168 freqTable_ = STFrequencies(table_);
169 focusTable_ = STFocus(table_);
170 weatherTable_ = STWeather(table_);
171 tcalTable_ = STTcal(table_);
172 moleculeTable_ = STMolecules(table_);
173 historyTable_ = STHistory(table_);
174 fitTable_ = STFit(table_);
175}
176
177Scantable::~Scantable()
178{
179 //cout << "~Scantable() " << this << endl;
180}
181
182void Scantable::setupMainTable()
183{
184 TableDesc td("", "1", TableDesc::Scratch);
185 td.comment() = "An ASAP Scantable";
186 td.rwKeywordSet().define("VERSION", uInt(version_));
187
188 // n Cycles
189 td.addColumn(ScalarColumnDesc<uInt>("SCANNO"));
190 // new index every nBeam x nIF x nPol
191 td.addColumn(ScalarColumnDesc<uInt>("CYCLENO"));
192
193 td.addColumn(ScalarColumnDesc<uInt>("BEAMNO"));
194 td.addColumn(ScalarColumnDesc<uInt>("IFNO"));
195 // linear, circular, stokes
196 td.rwKeywordSet().define("POLTYPE", String("linear"));
197 td.addColumn(ScalarColumnDesc<uInt>("POLNO"));
198
199 td.addColumn(ScalarColumnDesc<uInt>("FREQ_ID"));
200 td.addColumn(ScalarColumnDesc<uInt>("MOLECULE_ID"));
201 td.addColumn(ScalarColumnDesc<Int>("REFBEAMNO"));
202
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);
208
209 td.addColumn(ScalarColumnDesc<Double>("INTERVAL"));
210
211 td.addColumn(ScalarColumnDesc<String>("SRCNAME"));
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
217 td.addColumn(ArrayColumnDesc<Float>("SPECTRA"));
218 td.addColumn(ArrayColumnDesc<uChar>("FLAGTRA"));
219 td.addColumn(ArrayColumnDesc<Float>("TSYS"));
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);
228 // a uder set table type e.g. GALCTIC, B1950 ...
229 td.rwKeywordSet().define("DIRECTIONREF", String("J2000"));
230 // writing create the measure column
231 mdirCol.write(td);
232 td.addColumn(ScalarColumnDesc<Float>("AZIMUTH"));
233 td.addColumn(ScalarColumnDesc<Float>("ELEVATION"));
234 td.addColumn(ScalarColumnDesc<Float>("PARANGLE"));
235 td.addColumn(ScalarColumnDesc<Float>("OPACITY"));
236
237 td.addColumn(ScalarColumnDesc<uInt>("TCAL_ID"));
238 ScalarColumnDesc<Int> fitColumn("FIT_ID");
239 fitColumn.setDefault(Int(-1));
240 td.addColumn(fitColumn);
241
242 td.addColumn(ScalarColumnDesc<uInt>("FOCUS_ID"));
243 td.addColumn(ScalarColumnDesc<uInt>("WEATHER_ID"));
244
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
251 td.rwKeywordSet().define("OBSMODE", String(""));
252
253 // Now create Table SetUp from the description.
254 SetupNewTable aNewTab(generateName(), td, Table::Scratch);
255 table_ = Table(aNewTab, type_, 0);
256 originalTable_ = table_;
257}
258
259
260void Scantable::attach()
261{
262 timeCol_.attach(table_, "TIME");
263 srcnCol_.attach(table_, "SRCNAME");
264 srctCol_.attach(table_, "SRCTYPE");
265 specCol_.attach(table_, "SPECTRA");
266 flagsCol_.attach(table_, "FLAGTRA");
267 tsysCol_.attach(table_, "TSYS");
268 cycleCol_.attach(table_,"CYCLENO");
269 scanCol_.attach(table_, "SCANNO");
270 beamCol_.attach(table_, "BEAMNO");
271 ifCol_.attach(table_, "IFNO");
272 polCol_.attach(table_, "POLNO");
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");
280
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");
286}
287
288void Scantable::setHeader(const STHeader& sdh)
289{
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);
304 table_.rwKeywordSet().define("FluxUnit", sdh.fluxunit);
305 table_.rwKeywordSet().define("Epoch", sdh.epoch);
306 table_.rwKeywordSet().define("POLTYPE", sdh.poltype);
307}
308
309STHeader Scantable::getHeader() const
310{
311 STHeader sdh;
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);
326 table_.keywordSet().get("FluxUnit", sdh.fluxunit);
327 table_.keywordSet().get("Epoch", sdh.epoch);
328 table_.keywordSet().get("POLTYPE", sdh.poltype);
329 return sdh;
330}
331
332void Scantable::setSourceType( int stype )
333{
334 if ( stype < 0 || stype > 1 )
335 throw(AipsError("Illegal sourcetype."));
336 TableVector<Int> tabvec(table_, "SRCTYPE");
337 tabvec = Int(stype);
338}
339
340bool Scantable::conformant( const Scantable& other )
341{
342 return this->getHeader().conformant(other.getHeader());
343}
344
345
346
347std::string Scantable::formatSec(Double x) const
348{
349 Double xcop = x;
350 MVTime mvt(xcop/24./3600.); // make days
351
352 if (x < 59.95)
353 return String(" ") + mvt.string(MVTime::TIME_CLEAN_NO_HM, 7)+"s";
354 else if (x < 3599.95)
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);
361 }
362};
363
364std::string Scantable::formatDirection(const MDirection& md) const
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);
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 }
376 MVAngle mvLat(t[1]);
377 String sLat = mvLat.string(MVAngle::ANGLE+MVAngle::DIG2,prec);
378 return sLon + String(" ") + sLat;
379}
380
381
382std::string Scantable::getFluxUnit() const
383{
384 return table_.keywordSet().asString("FluxUnit");
385}
386
387void Scantable::setFluxUnit(const std::string& unit)
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
398void Scantable::setInstrument(const std::string& name)
399{
400 bool throwIt = true;
401 // create an Instrument to see if this is valid
402 STAttr::convertInstrument(name, throwIt);
403 String nameU(name);
404 nameU.upcase();
405 table_.rwKeywordSet().define(String("AntennaName"), nameU);
406}
407
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
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}
424
425void Scantable::makePersistent(const std::string& filename)
426{
427 String inname(filename);
428 Path path(inname);
429 /// @todo reindex SCANNO, recompute nbeam, nif, npol
430 inname = path.expandedName();
431 table_.deepCopy(inname, Table::New);
432}
433
434int Scantable::nbeam( int scanno ) const
435{
436 if ( scanno < 0 ) {
437 Int n;
438 table_.keywordSet().get("nBeam",n);
439 return int(n);
440 } else {
441 // take the first POLNO,IFNO,CYCLENO as nbeam shouldn't vary with these
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");
449 return int(v.nelements());
450 }
451 return 0;
452}
453
454int Scantable::nif( int scanno ) const
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
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");
470 return int(v.nelements());
471 }
472 return 0;
473}
474
475int Scantable::npol( int scanno ) const
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
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");
491 return int(v.nelements());
492 }
493 return 0;
494}
495
496int Scantable::ncycle( int scanno ) const
497{
498 if ( scanno < 0 ) {
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;
506 ++it;
507 }
508 return n;
509 } else {
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());
518 }
519 return 0;
520}
521
522
523int Scantable::nrow( int scanno ) const
524{
525 return int(table_.nrow());
526}
527
528int Scantable::nchan( int ifno ) const
529{
530 if ( ifno < 0 ) {
531 Int n;
532 table_.keywordSet().get("nChan",n);
533 return int(n);
534 } else {
535 // take the first SCANNO,POLNO,BEAMNO,CYCLENO as nbeam shouldn't
536 // vary with these
537 Table t = table_(table_.col("IFNO") == ifno);
538 if ( t.nrow() == 0 ) return 0;
539 ROArrayColumn<Float> v(t, "SPECTRA");
540 return v.shape(0)(0);
541 }
542 return 0;
543}
544
545int Scantable::nscan() const {
546 Vector<uInt> scannos(scanCol_.getColumn());
547 uInt nout = genSort( scannos, Sort::Ascending,
548 Sort::QuickSort|Sort::NoDuplicates );
549 return int(nout);
550}
551
552int Scantable::getChannels(int whichrow) const
553{
554 return specCol_.shape(whichrow)(0);
555}
556
557int Scantable::getBeam(int whichrow) const
558{
559 return beamCol_(whichrow);
560}
561
562std::vector<uint> Scantable::getNumbers(ScalarColumn<uInt>& col)
563{
564 Vector<uInt> nos(col.getColumn());
565 uInt n = genSort( nos, Sort::Ascending, Sort::QuickSort|Sort::NoDuplicates );
566 nos.resize(n, True);
567 std::vector<uint> stlout;
568 nos.tovector(stlout);
569 return stlout;
570}
571
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
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}
593
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;
601 for (Int i=0; i<nrow(); ++i) {
602 MEpoch me = timeCol(i);
603 MDirection md = getDirection(i);
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();
611 azCol_.put(i,Float(azel[0]));
612 elCol_.put(i,Float(azel[1]));
613 oss << "azel: " << azel[0]/C::pi*180.0 << " "
614 << azel[1]/C::pi*180.0 << " (deg)" << endl;
615 }
616 pushLog(String(oss));
617}
618
619void Scantable::flag(const std::vector<bool>& msk, bool unflag)
620{
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) )
629 throw(AipsError("Trying to flag whole scantable."));
630 if ( msk.size() == 0 ) {
631 uChar userflag = 1 << 7;
632 if ( unflag ) {
633 userflag = 0 << 7;
634 }
635 for ( uInt i=0; i<table_.nrow(); ++i) {
636 Vector<uChar> flgs = flagsCol_(i);
637 flgs = userflag;
638 flagsCol_.put(i, flgs);
639 }
640 return;
641 }
642 if ( int(msk.size()) != nchan() ) {
643 throw(AipsError("Mask has incorrect number of channels."));
644 }
645 for ( uInt i=0; i<table_.nrow(); ++i) {
646 Vector<uChar> flgs = flagsCol_(i);
647 if ( flgs.nelements() != msk.size() ) {
648 throw(AipsError("Mask has incorrect number of channels."
649 " Probably varying with IF. Please flag per IF"));
650 }
651 std::vector<bool>::const_iterator it;
652 uInt j = 0;
653 uChar userflag = 1 << 7;
654 if ( unflag ) {
655 userflag = 0 << 7;
656 }
657 for (it = msk.begin(); it != msk.end(); ++it) {
658 if ( *it ) {
659 flgs(j) = userflag;
660 }
661 ++j;
662 }
663 flagsCol_.put(i, flgs);
664 }
665}
666
667std::vector<bool> Scantable::getMask(int whichrow) const
668{
669 Vector<uChar> flags;
670 flagsCol_.get(uInt(whichrow), flags);
671 Vector<Bool> bflag(flags.shape());
672 convertArray(bflag, flags);
673 bflag = !bflag;
674 std::vector<bool> mask;
675 bflag.tovector(mask);
676 return mask;
677}
678
679std::vector<float> Scantable::getSpectrum( int whichrow,
680 const std::string& poltype ) const
681{
682 String ptype = poltype;
683 if (poltype == "" ) ptype = getPolType();
684 if ( whichrow < 0 || whichrow >= nrow() )
685 throw(AipsError("Illegal row number."));
686 std::vector<float> out;
687 Vector<Float> arr;
688 uInt requestedpol = polCol_(whichrow);
689 String basetype = getPolType();
690 if ( ptype == basetype ) {
691 specCol_.get(whichrow, arr);
692 } else {
693 CountedPtr<STPol> stpol(STPol::getPolClass(Scantable::factories_, basetype));
694 uInt row = uInt(whichrow);
695 stpol->setSpectra(getPolMatrix(row));
696 Float fang,fhand,parang;
697 fang = focusTable_.getTotalFeedAngle(mfocusidCol_(row));
698 fhand = focusTable_.getFeedHand(mfocusidCol_(row));
699 parang = paraCol_(row);
700 /// @todo re-enable this
701 // disable total feed angle to support paralactifying Caswell style
702 stpol->setPhaseCorrections(parang, -parang, fhand);
703 arr = stpol->getSpectrum(requestedpol, ptype);
704 }
705 if ( arr.nelements() == 0 )
706 pushLog("Not enough polarisations present to do the conversion.");
707 arr.tovector(out);
708 return out;
709}
710
711void Scantable::setSpectrum( const std::vector<float>& spec,
712 int whichrow )
713{
714 Vector<Float> spectrum(spec);
715 Vector<Float> arr;
716 specCol_.get(whichrow, arr);
717 if ( spectrum.nelements() != arr.nelements() )
718 throw AipsError("The spectrum has incorrect number of channels.");
719 specCol_.put(whichrow, spectrum);
720}
721
722
723String Scantable::generateName()
724{
725 return (File::newUniqueName("./","temp")).baseName();
726}
727
728const casa::Table& Scantable::table( ) const
729{
730 return table_;
731}
732
733casa::Table& Scantable::table( )
734{
735 return table_;
736}
737
738std::string Scantable::getPolType() const
739{
740 return table_.keywordSet().asString("POLTYPE");
741}
742
743void Scantable::unsetSelection()
744{
745 table_ = originalTable_;
746 attach();
747 selector_.reset();
748}
749
750void Scantable::setSelection( const STSelector& selection )
751{
752 Table tab = const_cast<STSelector&>(selection).apply(originalTable_);
753 if ( tab.nrow() == 0 ) {
754 throw(AipsError("Selection contains no data. Not applying it."));
755 }
756 table_ = tab;
757 attach();
758 selector_ = selection;
759}
760
761std::string Scantable::summary( bool verbose )
762{
763 // Format header info
764 ostringstream oss;
765 oss << endl;
766 oss << asap::SEPERATOR << endl;
767 oss << " Scan Table Summary" << endl;
768 oss << asap::SEPERATOR << endl;
769 oss.flags(std::ios_base::left);
770 oss << setw(15) << "Beams:" << setw(4) << nbeam() << endl
771 << setw(15) << "IFs:" << setw(4) << nif() << endl
772 << setw(15) << "Polarisations:" << setw(4) << npol()
773 << "(" << getPolType() << ")" << endl
774 << setw(15) << "Channels:" << setw(4) << nchan() << endl;
775 oss << endl;
776 String tmp;
777 oss << setw(15) << "Observer:"
778 << table_.keywordSet().asString("Observer") << endl;
779 oss << setw(15) << "Obs Date:" << getTime(-1,true) << endl;
780 table_.keywordSet().get("Project", tmp);
781 oss << setw(15) << "Project:" << tmp << endl;
782 table_.keywordSet().get("Obstype", tmp);
783 oss << setw(15) << "Obs. Type:" << tmp << endl;
784 table_.keywordSet().get("AntennaName", tmp);
785 oss << setw(15) << "Antenna Name:" << tmp << endl;
786 table_.keywordSet().get("FluxUnit", tmp);
787 oss << setw(15) << "Flux Unit:" << tmp << endl;
788 Vector<Double> vec(moleculeTable_.getRestFrequencies());
789 oss << setw(15) << "Rest Freqs:";
790 if (vec.nelements() > 0) {
791 oss << setprecision(10) << vec << " [Hz]" << endl;
792 } else {
793 oss << "none" << endl;
794 }
795
796 oss << setw(15) << "Abcissa:" << getAbcissaLabel(0) << endl;
797 oss << selector_.print() << endl;
798 oss << endl;
799 // main table
800 String dirtype = "Position ("
801 + getDirectionRefString()
802 + ")";
803 oss << setw(5) << "Scan" << setw(15) << "Source"
804 << setw(10) << "Time" << setw(18) << "Integration" << endl;
805 oss << setw(5) << "" << setw(5) << "Beam" << setw(3) << "" << dirtype << endl;
806 oss << setw(10) << "" << setw(3) << "IF" << setw(6) << ""
807 << setw(8) << "Frame" << setw(16)
808 << "RefVal" << setw(10) << "RefPix" << setw(12) << "Increment" <<endl;
809 oss << asap::SEPERATOR << endl;
810 TableIterator iter(table_, "SCANNO");
811 while (!iter.pastEnd()) {
812 Table subt = iter.table();
813 ROTableRow row(subt);
814 MEpoch::ROScalarColumn timeCol(subt,"TIME");
815 const TableRecord& rec = row.get(0);
816 oss << setw(4) << std::right << rec.asuInt("SCANNO")
817 << std::left << setw(1) << ""
818 << setw(15) << rec.asString("SRCNAME")
819 << setw(10) << formatTime(timeCol(0), false);
820 // count the cycles in the scan
821 TableIterator cyciter(subt, "CYCLENO");
822 int nint = 0;
823 while (!cyciter.pastEnd()) {
824 ++nint;
825 ++cyciter;
826 }
827 oss << setw(3) << std::right << nint << setw(3) << " x " << std::left
828 << setw(6) << formatSec(rec.asFloat("INTERVAL")) << endl;
829
830 TableIterator biter(subt, "BEAMNO");
831 while (!biter.pastEnd()) {
832 Table bsubt = biter.table();
833 ROTableRow brow(bsubt);
834 const TableRecord& brec = brow.get(0);
835 uInt row0 = bsubt.rowNumbers(table_)[0];
836 oss << setw(5) << "" << setw(4) << std::right << brec.asuInt("BEAMNO")<< std::left;
837 oss << setw(4) << "" << formatDirection(getDirection(row0)) << endl;
838 TableIterator iiter(bsubt, "IFNO");
839 while (!iiter.pastEnd()) {
840 Table isubt = iiter.table();
841 ROTableRow irow(isubt);
842 const TableRecord& irec = irow.get(0);
843 oss << setw(10) << "";
844 oss << setw(3) << std::right << irec.asuInt("IFNO") << std::left
845 << setw(2) << "" << frequencies().print(irec.asuInt("FREQ_ID"))
846 << endl;
847
848 ++iiter;
849 }
850 ++biter;
851 }
852 ++iter;
853 }
854 /// @todo implement verbose mode
855 return String(oss);
856}
857
858std::string Scantable::getTime(int whichrow, bool showdate) const
859{
860 MEpoch::ROScalarColumn timeCol(table_, "TIME");
861 MEpoch me;
862 if (whichrow > -1) {
863 me = timeCol(uInt(whichrow));
864 } else {
865 Double tm;
866 table_.keywordSet().get("UTC",tm);
867 me = MEpoch(MVEpoch(tm));
868 }
869 return formatTime(me, showdate);
870}
871
872MEpoch Scantable::getEpoch(int whichrow) const
873{
874 if (whichrow > -1) {
875 return timeCol_(uInt(whichrow));
876 } else {
877 Double tm;
878 table_.keywordSet().get("UTC",tm);
879 return MEpoch(MVEpoch(tm));
880 }
881}
882
883std::string Scantable::getDirectionString(int whichrow) const
884{
885 return formatDirection(getDirection(uInt(whichrow)));
886}
887
888std::vector< double > Scantable::getAbcissa( int whichrow ) const
889{
890 if ( whichrow > int(table_.nrow()) ) throw(AipsError("Illegal ro number"));
891 std::vector<double> stlout;
892 int nchan = specCol_(whichrow).nelements();
893 String us = freqTable_.getUnitString();
894 if ( us == "" || us == "pixel" || us == "channel" ) {
895 for (int i=0; i<nchan; ++i) {
896 stlout.push_back(double(i));
897 }
898 return stlout;
899 }
900
901 const MPosition& mp = getAntennaPosition();
902 const MDirection& md = getDirection(whichrow);
903 const MEpoch& me = timeCol_(whichrow);
904 Double rf = moleculeTable_.getRestFrequency(mmolidCol_(whichrow));
905 SpectralCoordinate spc =
906 freqTable_.getSpectralCoordinate(md, mp, me, rf, mfreqidCol_(whichrow));
907 Vector<Double> pixel(nchan);
908 Vector<Double> world;
909 indgen(pixel);
910 if ( Unit(us) == Unit("Hz") ) {
911 for ( int i=0; i < nchan; ++i) {
912 Double world;
913 spc.toWorld(world, pixel[i]);
914 stlout.push_back(double(world));
915 }
916 } else if ( Unit(us) == Unit("km/s") ) {
917 Vector<Double> world;
918 spc.pixelToVelocity(world, pixel);
919 world.tovector(stlout);
920 }
921 return stlout;
922}
923void Scantable::setDirectionRefString( const std::string & refstr )
924{
925 MDirection::Types mdt;
926 if (refstr != "" && !MDirection::getType(mdt, refstr)) {
927 throw(AipsError("Illegal Direction frame."));
928 }
929 if ( refstr == "" ) {
930 String defaultstr = MDirection::showType(dirCol_.getMeasRef().getType());
931 table_.rwKeywordSet().define("DIRECTIONREF", defaultstr);
932 } else {
933 table_.rwKeywordSet().define("DIRECTIONREF", String(refstr));
934 }
935}
936
937std::string Scantable::getDirectionRefString( ) const
938{
939 return table_.keywordSet().asString("DIRECTIONREF");
940}
941
942MDirection Scantable::getDirection(int whichrow ) const
943{
944 String usertype = table_.keywordSet().asString("DIRECTIONREF");
945 String type = MDirection::showType(dirCol_.getMeasRef().getType());
946 if ( usertype != type ) {
947 MDirection::Types mdt;
948 if (!MDirection::getType(mdt, usertype)) {
949 throw(AipsError("Illegal Direction frame."));
950 }
951 return dirCol_.convert(uInt(whichrow), mdt);
952 } else {
953 return dirCol_(uInt(whichrow));
954 }
955}
956
957std::string Scantable::getAbcissaLabel( int whichrow ) const
958{
959 if ( whichrow > int(table_.nrow()) ) throw(AipsError("Illegal ro number"));
960 const MPosition& mp = getAntennaPosition();
961 const MDirection& md = getDirection(whichrow);
962 const MEpoch& me = timeCol_(whichrow);
963 const Double& rf = mmolidCol_(whichrow);
964 SpectralCoordinate spc =
965 freqTable_.getSpectralCoordinate(md, mp, me, rf, mfreqidCol_(whichrow));
966
967 String s = "Channel";
968 Unit u = Unit(freqTable_.getUnitString());
969 if (u == Unit("km/s")) {
970 s = CoordinateUtil::axisLabel(spc, 0, True,True, True);
971 } else if (u == Unit("Hz")) {
972 Vector<String> wau(1);wau = u.getName();
973 spc.setWorldAxisUnits(wau);
974 s = CoordinateUtil::axisLabel(spc, 0, True, True, False);
975 }
976 return s;
977
978}
979
980void Scantable::setRestFrequencies( double rf, const std::string& name,
981 const std::string& unit )
982{
983 ///@todo lookup in line table to fill in name and formattedname
984 Unit u(unit);
985 Quantum<Double> urf(rf, u);
986 uInt id = moleculeTable_.addEntry(urf.getValue("Hz"), name, "");
987 TableVector<uInt> tabvec(table_, "MOLECULE_ID");
988 tabvec = id;
989}
990
991void Scantable::setRestFrequencies( const std::string& name )
992{
993 throw(AipsError("setRestFrequencies( const std::string& name ) NYI"));
994 ///@todo implement
995}
996
997std::vector< unsigned int > Scantable::rownumbers( ) const
998{
999 std::vector<unsigned int> stlout;
1000 Vector<uInt> vec = table_.rowNumbers();
1001 vec.tovector(stlout);
1002 return stlout;
1003}
1004
1005
1006Matrix<Float> Scantable::getPolMatrix( uInt whichrow ) const
1007{
1008 ROTableRow row(table_);
1009 const TableRecord& rec = row.get(whichrow);
1010 Table t =
1011 originalTable_( originalTable_.col("SCANNO") == Int(rec.asuInt("SCANNO"))
1012 && originalTable_.col("BEAMNO") == Int(rec.asuInt("BEAMNO"))
1013 && originalTable_.col("IFNO") == Int(rec.asuInt("IFNO"))
1014 && originalTable_.col("CYCLENO") == Int(rec.asuInt("CYCLENO")) );
1015 ROArrayColumn<Float> speccol(t, "SPECTRA");
1016 return speccol.getColumn();
1017}
1018
1019std::vector< std::string > Scantable::columnNames( ) const
1020{
1021 Vector<String> vec = table_.tableDesc().columnNames();
1022 return mathutil::tovectorstring(vec);
1023}
1024
1025MEpoch::Types Scantable::getTimeReference( ) const
1026{
1027 return MEpoch::castType(timeCol_.getMeasRef().getType());
1028}
1029
1030void Scantable::addFit( const STFitEntry& fit, int row )
1031{
1032 cout << mfitidCol_(uInt(row)) << endl;
1033 uInt id = fitTable_.addEntry(fit, mfitidCol_(uInt(row)));
1034 mfitidCol_.put(uInt(row), id);
1035}
1036
1037void Scantable::shift(int npix)
1038{
1039 Vector<uInt> fids(mfreqidCol_.getColumn());
1040 genSort( fids, Sort::Ascending,
1041 Sort::QuickSort|Sort::NoDuplicates );
1042 for (uInt i=0; i<fids.nelements(); ++i) {
1043 frequencies().shiftRefPix(npix, i);
1044 }
1045}
1046
1047std::string asap::Scantable::getAntennaName() const
1048{
1049 String out;
1050 table_.keywordSet().get("AntennaName", out);
1051 return out;
1052}
1053
1054int asap::Scantable::checkScanInfo(const std::vector<int>& scanlist) const
1055{
1056 String tbpath;
1057 int ret = 0;
1058 if ( table_.keywordSet().isDefined("GBT_GO") ) {
1059 table_.keywordSet().get("GBT_GO", tbpath);
1060 Table t(tbpath,Table::Old);
1061 // check each scan if other scan of the pair exist
1062 int nscan = scanlist.size();
1063 for (int i = 0; i < nscan; i++) {
1064 Table subt = t( t.col("SCAN") == scanlist[i]+1 );
1065 if (subt.nrow()==0) {
1066 cerr <<"Scan "<<scanlist[i]<<" cannot be found in the scantable."<<endl;
1067 ret = 1;
1068 break;
1069 }
1070 ROTableRow row(subt);
1071 const TableRecord& rec = row.get(0);
1072 int scan1seqn = rec.asuInt("PROCSEQN");
1073 int laston1 = rec.asuInt("LASTON");
1074 if ( rec.asuInt("PROCSIZE")==2 ) {
1075 if ( i < nscan-1 ) {
1076 Table subt2 = t( t.col("SCAN") == scanlist[i+1]+1 );
1077 if ( subt2.nrow() == 0) {
1078 cerr<<"Scan "<<scanlist[i+1]<<" cannot be found in the scantable."<<endl;
1079 ret = 1;
1080 break;
1081 }
1082 ROTableRow row2(subt2);
1083 const TableRecord& rec2 = row2.get(0);
1084 int scan2seqn = rec2.asuInt("PROCSEQN");
1085 int laston2 = rec2.asuInt("LASTON");
1086 if (scan1seqn == 1 && scan2seqn == 2) {
1087 if (laston1 == laston2) {
1088 cerr<<"A valid scan pair ["<<scanlist[i]<<","<<scanlist[i+1]<<"]"<<endl;
1089 i +=1;
1090 }
1091 else {
1092 cerr<<"Incorrect scan pair ["<<scanlist[i]<<","<<scanlist[i+1]<<"]"<<endl;
1093 }
1094 }
1095 else if (scan1seqn==2 && scan2seqn == 1) {
1096 if (laston1 == laston2) {
1097 cerr<<"["<<scanlist[i]<<","<<scanlist[i+1]<<"] is a valid scan pair but in incorrect order."<<endl;
1098 ret = 1;
1099 break;
1100 }
1101 }
1102 else {
1103 cerr<<"The other scan for "<<scanlist[i]<<" appears to be missing. Check the input scan numbers."<<endl;
1104 ret = 1;
1105 break;
1106 }
1107 }
1108 }
1109 else {
1110 cerr<<"The scan does not appear to be standard obsevation."<<endl;
1111 }
1112 //if ( i >= nscan ) break;
1113 }
1114 }
1115 else {
1116 cerr<<"No reference to GBT_GO table."<<endl;
1117 ret = 1;
1118 }
1119 return ret;
1120}
1121
1122std::vector<double> asap::Scantable::getDirectionVector(int whichrow) const
1123{
1124 Vector<Double> Dir = dirCol_(whichrow).getAngle("rad").getValue();
1125 std::vector<double> dir;
1126 Dir.tovector(dir);
1127 return dir;
1128}
1129
1130}
1131 //namespace asap
Note: See TracBrowser for help on using the repository browser.