source: trunk/src/Scantable.cpp @ 1430

Last change on this file since 1430 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.