source: trunk/src/STMath.cpp@ 1423

Last change on this file since 1423 was 1416, checked in by Malte Marquarding, 17 years ago

Provide a more useful warning then 'oh oh'

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 65.0 KB
RevLine 
[805]1//
2// C++ Implementation: STMath
3//
4// Description:
5//
6//
7// Author: Malte Marquarding <asap@atnf.csiro.au>, (C) 2006
8//
9// Copyright: See COPYING file that comes with this distribution
10//
11//
[38]12
[330]13#include <casa/iomanip.h>
[805]14#include <casa/Exceptions/Error.h>
15#include <casa/Containers/Block.h>
[81]16#include <casa/BasicSL/String.h>
[805]17#include <casa/Arrays/MaskArrLogi.h>
18#include <casa/Arrays/MaskArrMath.h>
19#include <casa/Arrays/ArrayLogical.h>
[81]20#include <casa/Arrays/ArrayMath.h>
[1066]21#include <casa/Arrays/Slice.h>
22#include <casa/Arrays/Slicer.h>
[805]23#include <casa/Containers/RecordField.h>
24#include <tables/Tables/TableRow.h>
25#include <tables/Tables/TableVector.h>
[917]26#include <tables/Tables/TabVecMath.h>
[805]27#include <tables/Tables/ExprNode.h>
28#include <tables/Tables/TableRecord.h>
[1140]29#include <tables/Tables/TableParse.h>
[805]30#include <tables/Tables/ReadAsciiTable.h>
[1140]31#include <tables/Tables/TableIter.h>
32#include <tables/Tables/TableCopy.h>
[1192]33#include <scimath/Mathematics/FFTServer.h>
[2]34
[262]35#include <lattices/Lattices/LatticeUtilities.h>
36
[917]37#include <coordinates/Coordinates/SpectralCoordinate.h>
38#include <coordinates/Coordinates/CoordinateSystem.h>
39#include <coordinates/Coordinates/CoordinateUtil.h>
40#include <coordinates/Coordinates/FrequencyAligner.h>
41
[177]42#include <scimath/Mathematics/VectorKernel.h>
43#include <scimath/Mathematics/Convolver.h>
[234]44#include <scimath/Functionals/Polynomial.h>
[177]45
[38]46#include "MathUtils.h"
[805]47#include "RowAccumulator.h"
[878]48#include "STAttr.h"
[805]49#include "STMath.h"
[1391]50#include "STSelector.h"
[2]51
[805]52using namespace casa;
[2]53
[83]54using namespace asap;
[2]55
[805]56STMath::STMath(bool insitu) :
57 insitu_(insitu)
[716]58{
59}
[170]60
61
[805]62STMath::~STMath()
[170]63{
64}
65
[805]66CountedPtr<Scantable>
[977]67STMath::average( const std::vector<CountedPtr<Scantable> >& in,
[858]68 const std::vector<bool>& mask,
[805]69 const std::string& weight,
[977]70 const std::string& avmode)
[262]71{
[977]72 if ( avmode == "SCAN" && in.size() != 1 )
[1066]73 throw(AipsError("Can't perform 'SCAN' averaging on multiple tables.\n"
74 "Use merge first."));
[805]75 WeightType wtype = stringToWeight(weight);
[926]76
[805]77 // output
78 // clone as this is non insitu
79 bool insitu = insitu_;
80 setInsitu(false);
[977]81 CountedPtr< Scantable > out = getScantable(in[0], true);
[805]82 setInsitu(insitu);
[977]83 std::vector<CountedPtr<Scantable> >::const_iterator stit = in.begin();
[862]84 ++stit;
[977]85 while ( stit != in.end() ) {
[862]86 out->appendToHistoryTable((*stit)->history());
87 ++stit;
88 }
[294]89
[805]90 Table& tout = out->table();
[701]91
[805]92 /// @todo check if all scantables are conformant
[294]93
[805]94 ArrayColumn<Float> specColOut(tout,"SPECTRA");
95 ArrayColumn<uChar> flagColOut(tout,"FLAGTRA");
96 ArrayColumn<Float> tsysColOut(tout,"TSYS");
97 ScalarColumn<Double> mjdColOut(tout,"TIME");
98 ScalarColumn<Double> intColOut(tout,"INTERVAL");
[1008]99 ScalarColumn<uInt> cycColOut(tout,"CYCLENO");
[1145]100 ScalarColumn<uInt> scanColOut(tout,"SCANNO");
[262]101
[805]102 // set up the output table rows. These are based on the structure of the
[862]103 // FIRST scantable in the vector
[977]104 const Table& baset = in[0]->table();
[262]105
[805]106 Block<String> cols(3);
107 cols[0] = String("BEAMNO");
108 cols[1] = String("IFNO");
109 cols[2] = String("POLNO");
110 if ( avmode == "SOURCE" ) {
111 cols.resize(4);
112 cols[3] = String("SRCNAME");
[488]113 }
[977]114 if ( avmode == "SCAN" && in.size() == 1) {
[805]115 cols.resize(4);
116 cols[3] = String("SCANNO");
[2]117 }
[805]118 uInt outrowCount = 0;
119 TableIterator iter(baset, cols);
120 while (!iter.pastEnd()) {
121 Table subt = iter.table();
122 // copy the first row of this selection into the new table
123 tout.addRow();
124 TableCopy::copyRows(tout, subt, outrowCount, 0, 1);
[1145]125 // re-index to 0
126 if ( avmode != "SCAN" && avmode != "SOURCE" ) {
127 scanColOut.put(outrowCount, uInt(0));
128 }
[805]129 ++outrowCount;
130 ++iter;
[144]131 }
[805]132 RowAccumulator acc(wtype);
[858]133 Vector<Bool> cmask(mask);
134 acc.setUserMask(cmask);
[805]135 ROTableRow row(tout);
136 ROArrayColumn<Float> specCol, tsysCol;
137 ROArrayColumn<uChar> flagCol;
138 ROScalarColumn<Double> mjdCol, intCol;
139 ROScalarColumn<Int> scanIDCol;
[144]140
[1333]141 Vector<uInt> rowstodelete;
142
[805]143 for (uInt i=0; i < tout.nrow(); ++i) {
[996]144 for ( int j=0; j < int(in.size()); ++j ) {
[977]145 const Table& tin = in[j]->table();
[805]146 const TableRecord& rec = row.get(i);
147 ROScalarColumn<Double> tmp(tin, "TIME");
148 Double td;tmp.get(0,td);
149 Table basesubt = tin(tin.col("BEAMNO") == Int(rec.asuInt("BEAMNO"))
150 && tin.col("IFNO") == Int(rec.asuInt("IFNO"))
151 && tin.col("POLNO") == Int(rec.asuInt("POLNO")) );
152 Table subt;
153 if ( avmode == "SOURCE") {
154 subt = basesubt( basesubt.col("SRCNAME") == rec.asString("SRCNAME") );
155 } else if (avmode == "SCAN") {
156 subt = basesubt( basesubt.col("SCANNO") == Int(rec.asuInt("SCANNO")) );
157 } else {
158 subt = basesubt;
159 }
160 specCol.attach(subt,"SPECTRA");
161 flagCol.attach(subt,"FLAGTRA");
162 tsysCol.attach(subt,"TSYS");
163 intCol.attach(subt,"INTERVAL");
164 mjdCol.attach(subt,"TIME");
165 Vector<Float> spec,tsys;
166 Vector<uChar> flag;
167 Double inter,time;
168 for (uInt k = 0; k < subt.nrow(); ++k ) {
169 flagCol.get(k, flag);
170 Vector<Bool> bflag(flag.shape());
171 convertArray(bflag, flag);
[1314]172 /*
[805]173 if ( allEQ(bflag, True) ) {
[1314]174 continue;//don't accumulate
[144]175 }
[1314]176 */
[805]177 specCol.get(k, spec);
178 tsysCol.get(k, tsys);
179 intCol.get(k, inter);
180 mjdCol.get(k, time);
181 // spectrum has to be added last to enable weighting by the other values
182 acc.add(spec, !bflag, tsys, inter, time);
183 }
184 }
[1333]185 const Vector<Bool>& msk = acc.getMask();
186 if ( allEQ(msk, False) ) {
187 uint n = rowstodelete.nelements();
188 rowstodelete.resize(n+1, True);
189 rowstodelete[n] = i;
190 continue;
191 }
[805]192 //write out
193 Vector<uChar> flg(msk.shape());
194 convertArray(flg, !msk);
195 flagColOut.put(i, flg);
[1333]196 specColOut.put(i, acc.getSpectrum());
[805]197 tsysColOut.put(i, acc.getTsys());
198 intColOut.put(i, acc.getInterval());
199 mjdColOut.put(i, acc.getTime());
[1008]200 // we should only have one cycle now -> reset it to be 0
201 // frequency switched data has different CYCLENO for different IFNO
202 // which requires resetting this value
203 cycColOut.put(i, uInt(0));
[805]204 acc.reset();
[144]205 }
[1333]206 if (rowstodelete.nelements() > 0) {
207 tout.removeRow(rowstodelete);
208 if (tout.nrow() == 0) {
209 throw(AipsError("Can't average fully flagged data."));
210 }
211 }
[805]212 return out;
[2]213}
[9]214
[1069]215CountedPtr< Scantable >
216 STMath::averageChannel( const CountedPtr < Scantable > & in,
[1078]217 const std::string & mode,
218 const std::string& avmode )
[1069]219{
220 // clone as this is non insitu
221 bool insitu = insitu_;
222 setInsitu(false);
223 CountedPtr< Scantable > out = getScantable(in, true);
224 setInsitu(insitu);
225 Table& tout = out->table();
226 ArrayColumn<Float> specColOut(tout,"SPECTRA");
227 ArrayColumn<uChar> flagColOut(tout,"FLAGTRA");
228 ArrayColumn<Float> tsysColOut(tout,"TSYS");
[1140]229 ScalarColumn<uInt> scanColOut(tout,"SCANNO");
[1232]230 ScalarColumn<Double> intColOut(tout, "INTERVAL");
[1140]231 Table tmp = in->table().sort("BEAMNO");
[1069]232 Block<String> cols(3);
233 cols[0] = String("BEAMNO");
234 cols[1] = String("IFNO");
235 cols[2] = String("POLNO");
[1078]236 if ( avmode == "SCAN") {
237 cols.resize(4);
238 cols[3] = String("SCANNO");
239 }
[1069]240 uInt outrowCount = 0;
241 uChar userflag = 1 << 7;
[1140]242 TableIterator iter(tmp, cols);
[1069]243 while (!iter.pastEnd()) {
244 Table subt = iter.table();
245 ROArrayColumn<Float> specCol, tsysCol;
246 ROArrayColumn<uChar> flagCol;
[1232]247 ROScalarColumn<Double> intCol(subt, "INTERVAL");
[1069]248 specCol.attach(subt,"SPECTRA");
249 flagCol.attach(subt,"FLAGTRA");
250 tsysCol.attach(subt,"TSYS");
251 tout.addRow();
252 TableCopy::copyRows(tout, subt, outrowCount, 0, 1);
[1140]253 if ( avmode != "SCAN") {
254 scanColOut.put(outrowCount, uInt(0));
255 }
[1069]256 Vector<Float> tmp;
257 specCol.get(0, tmp);
258 uInt nchan = tmp.nelements();
[1078]259 // have to do channel by channel here as MaskedArrMath
260 // doesn't have partialMedians
[1069]261 Vector<uChar> flags = flagCol.getColumn(Slicer(Slice(0)));
262 Vector<Float> outspec(nchan);
263 Vector<uChar> outflag(nchan,0);
264 Vector<Float> outtsys(1);/// @fixme when tsys is channel based
265 for (uInt i=0; i<nchan; ++i) {
266 Vector<Float> specs = specCol.getColumn(Slicer(Slice(i)));
267 MaskedArray<Float> ma = maskedArray(specs,flags);
268 outspec[i] = median(ma);
269 if ( allEQ(ma.getMask(), False) )
270 outflag[i] = userflag;// flag data
271 }
272 outtsys[0] = median(tsysCol.getColumn());
273 specColOut.put(outrowCount, outspec);
274 flagColOut.put(outrowCount, outflag);
275 tsysColOut.put(outrowCount, outtsys);
[1232]276 Double intsum = sum(intCol.getColumn());
277 intColOut.put(outrowCount, intsum);
[1069]278 ++outrowCount;
279 ++iter;
280 }
281 return out;
282}
283
[805]284CountedPtr< Scantable > STMath::getScantable(const CountedPtr< Scantable >& in,
285 bool droprows)
[185]286{
[805]287 if (insitu_) return in;
288 else {
289 // clone
290 Scantable* tabp = new Scantable(*in, Bool(droprows));
291 return CountedPtr<Scantable>(tabp);
[234]292 }
[805]293}
[234]294
[805]295CountedPtr< Scantable > STMath::unaryOperate( const CountedPtr< Scantable >& in,
296 float val,
297 const std::string& mode,
298 bool tsys )
299{
300 CountedPtr< Scantable > out = getScantable(in, false);
301 Table& tab = out->table();
302 ArrayColumn<Float> specCol(tab,"SPECTRA");
303 ArrayColumn<Float> tsysCol(tab,"TSYS");
304 for (uInt i=0; i<tab.nrow(); ++i) {
305 Vector<Float> spec;
306 Vector<Float> ts;
307 specCol.get(i, spec);
308 tsysCol.get(i, ts);
[1308]309 if (mode == "MUL" || mode == "DIV") {
310 if (mode == "DIV") val = 1.0/val;
[805]311 spec *= val;
312 specCol.put(i, spec);
313 if ( tsys ) {
314 ts *= val;
315 tsysCol.put(i, ts);
316 }
[1308]317 } else if ( mode == "ADD" || mode == "SUB") {
318 if (mode == "SUB") val *= -1.0;
[805]319 spec += val;
320 specCol.put(i, spec);
321 if ( tsys ) {
322 ts += val;
323 tsysCol.put(i, ts);
324 }
325 }
[234]326 }
[805]327 return out;
328}
[234]329
[1308]330CountedPtr<Scantable> STMath::binaryOperate(const CountedPtr<Scantable>& left,
331 const CountedPtr<Scantable>& right,
332 const std::string& mode)
333{
334 bool insitu = insitu_;
335 if ( ! left->conformant(*right) ) {
336 throw(AipsError("'left' and 'right' scantables are not conformant."));
337 }
338 setInsitu(false);
339 CountedPtr< Scantable > out = getScantable(left, false);
340 setInsitu(insitu);
341 Table& tout = out->table();
342 Block<String> coln(5);
343 coln[0] = "SCANNO"; coln[1] = "CYCLENO"; coln[2] = "BEAMNO";
344 coln[3] = "IFNO"; coln[4] = "POLNO";
345 Table tmpl = tout.sort(coln);
346 Table tmpr = right->table().sort(coln);
347 ArrayColumn<Float> lspecCol(tmpl,"SPECTRA");
348 ROArrayColumn<Float> rspecCol(tmpr,"SPECTRA");
349 ArrayColumn<uChar> lflagCol(tmpl,"FLAGTRA");
350 ROArrayColumn<uChar> rflagCol(tmpr,"FLAGTRA");
351
352 for (uInt i=0; i<tout.nrow(); ++i) {
353 Vector<Float> lspecvec, rspecvec;
354 Vector<uChar> lflagvec, rflagvec;
355 lspecvec = lspecCol(i); rspecvec = rspecCol(i);
356 lflagvec = lflagCol(i); rflagvec = rflagCol(i);
357 MaskedArray<Float> mleft = maskedArray(lspecvec, lflagvec);
358 MaskedArray<Float> mright = maskedArray(rspecvec, rflagvec);
359 if (mode == "ADD") {
360 mleft += mright;
361 } else if ( mode == "SUB") {
362 mleft -= mright;
363 } else if ( mode == "MUL") {
364 mleft *= mright;
365 } else if ( mode == "DIV") {
366 mleft /= mright;
367 } else {
368 throw(AipsError("Illegal binary operator"));
369 }
370 lspecCol.put(i, mleft.getArray());
371 }
372 return out;
373}
374
375
376
[805]377MaskedArray<Float> STMath::maskedArray( const Vector<Float>& s,
378 const Vector<uChar>& f)
379{
380 Vector<Bool> mask;
381 mask.resize(f.shape());
382 convertArray(mask, f);
383 return MaskedArray<Float>(s,!mask);
384}
[248]385
[805]386Vector<uChar> STMath::flagsFromMA(const MaskedArray<Float>& ma)
387{
388 const Vector<Bool>& m = ma.getMask();
389 Vector<uChar> flags(m.shape());
390 convertArray(flags, !m);
391 return flags;
392}
[234]393
[1066]394CountedPtr< Scantable > STMath::autoQuotient( const CountedPtr< Scantable >& in,
395 const std::string & mode,
396 bool preserve )
[805]397{
398 /// @todo make other modes available
399 /// modes should be "nearest", "pair"
400 // make this operation non insitu
401 const Table& tin = in->table();
402 Table ons = tin(tin.col("SRCTYPE") == Int(0));
403 Table offs = tin(tin.col("SRCTYPE") == Int(1));
404 if ( offs.nrow() == 0 )
405 throw(AipsError("No 'off' scans present."));
406 // put all "on" scans into output table
[701]407
[805]408 bool insitu = insitu_;
409 setInsitu(false);
410 CountedPtr< Scantable > out = getScantable(in, true);
411 setInsitu(insitu);
412 Table& tout = out->table();
[248]413
[805]414 TableCopy::copyRows(tout, ons);
415 TableRow row(tout);
416 ROScalarColumn<Double> offtimeCol(offs, "TIME");
417 ArrayColumn<Float> outspecCol(tout, "SPECTRA");
418 ROArrayColumn<Float> outtsysCol(tout, "TSYS");
419 ArrayColumn<uChar> outflagCol(tout, "FLAGTRA");
420 for (uInt i=0; i < tout.nrow(); ++i) {
421 const TableRecord& rec = row.get(i);
422 Double ontime = rec.asDouble("TIME");
[1321]423 Table presel = offs(offs.col("BEAMNO") == Int(rec.asuInt("BEAMNO"))
424 && offs.col("IFNO") == Int(rec.asuInt("IFNO"))
425 && offs.col("POLNO") == Int(rec.asuInt("POLNO")) );
426 ROScalarColumn<Double> offtimeCol(presel, "TIME");
427
[805]428 Double mindeltat = min(abs(offtimeCol.getColumn() - ontime));
[1259]429 // Timestamp may vary within a cycle ???!!!
[1321]430 // increase this by 0.01 sec in case of rounding errors...
[1259]431 // There might be a better way to do this.
[1321]432 // fix to this fix. TIME is MJD, so 1.0d not 1.0s
433 mindeltat += 0.01/24./60./60.;
434 Table sel = presel( abs(presel.col("TIME")-ontime) <= mindeltat);
[780]435
[1259]436 if ( sel.nrow() < 1 ) {
437 throw(AipsError("No closest in time found... This could be a rounding "
438 "issue. Try quotient instead."));
439 }
[805]440 TableRow offrow(sel);
441 const TableRecord& offrec = offrow.get(0);//should only be one row
442 RORecordFieldPtr< Array<Float> > specoff(offrec, "SPECTRA");
443 RORecordFieldPtr< Array<Float> > tsysoff(offrec, "TSYS");
444 RORecordFieldPtr< Array<uChar> > flagoff(offrec, "FLAGTRA");
445 /// @fixme this assumes tsys is a scalar not vector
446 Float tsysoffscalar = (*tsysoff)(IPosition(1,0));
447 Vector<Float> specon, tsyson;
448 outtsysCol.get(i, tsyson);
449 outspecCol.get(i, specon);
450 Vector<uChar> flagon;
451 outflagCol.get(i, flagon);
452 MaskedArray<Float> mon = maskedArray(specon, flagon);
453 MaskedArray<Float> moff = maskedArray(*specoff, *flagoff);
454 MaskedArray<Float> quot = (tsysoffscalar * mon / moff);
455 if (preserve) {
456 quot -= tsysoffscalar;
457 } else {
458 quot -= tsyson[0];
[701]459 }
[805]460 outspecCol.put(i, quot.getArray());
461 outflagCol.put(i, flagsFromMA(quot));
462 }
[926]463 // renumber scanno
464 TableIterator it(tout, "SCANNO");
465 uInt i = 0;
466 while ( !it.pastEnd() ) {
467 Table t = it.table();
468 TableVector<uInt> vec(t, "SCANNO");
469 vec = i;
470 ++i;
471 ++it;
472 }
[805]473 return out;
474}
[234]475
[1066]476
477CountedPtr< Scantable > STMath::quotient( const CountedPtr< Scantable > & on,
478 const CountedPtr< Scantable > & off,
479 bool preserve )
480{
481 bool insitu = insitu_;
[1069]482 if ( ! on->conformant(*off) ) {
483 throw(AipsError("'on' and 'off' scantables are not conformant."));
484 }
[1066]485 setInsitu(false);
486 CountedPtr< Scantable > out = getScantable(on, false);
487 setInsitu(insitu);
488 Table& tout = out->table();
489 const Table& toff = off->table();
490 TableIterator sit(tout, "SCANNO");
491 TableIterator s2it(toff, "SCANNO");
492 while ( !sit.pastEnd() ) {
493 Table ton = sit.table();
494 TableRow row(ton);
495 Table t = s2it.table();
496 ArrayColumn<Float> outspecCol(ton, "SPECTRA");
497 ROArrayColumn<Float> outtsysCol(ton, "TSYS");
498 ArrayColumn<uChar> outflagCol(ton, "FLAGTRA");
499 for (uInt i=0; i < ton.nrow(); ++i) {
500 const TableRecord& rec = row.get(i);
501 Table offsel = t( t.col("BEAMNO") == Int(rec.asuInt("BEAMNO"))
502 && t.col("IFNO") == Int(rec.asuInt("IFNO"))
503 && t.col("POLNO") == Int(rec.asuInt("POLNO")) );
[1145]504 if ( offsel.nrow() == 0 )
505 throw AipsError("STMath::quotient: no matching off");
[1066]506 TableRow offrow(offsel);
507 const TableRecord& offrec = offrow.get(0);//should be ncycles - take first
508 RORecordFieldPtr< Array<Float> > specoff(offrec, "SPECTRA");
509 RORecordFieldPtr< Array<Float> > tsysoff(offrec, "TSYS");
510 RORecordFieldPtr< Array<uChar> > flagoff(offrec, "FLAGTRA");
511 Float tsysoffscalar = (*tsysoff)(IPosition(1,0));
512 Vector<Float> specon, tsyson;
513 outtsysCol.get(i, tsyson);
514 outspecCol.get(i, specon);
515 Vector<uChar> flagon;
516 outflagCol.get(i, flagon);
517 MaskedArray<Float> mon = maskedArray(specon, flagon);
518 MaskedArray<Float> moff = maskedArray(*specoff, *flagoff);
519 MaskedArray<Float> quot = (tsysoffscalar * mon / moff);
520 if (preserve) {
521 quot -= tsysoffscalar;
522 } else {
523 quot -= tsyson[0];
524 }
525 outspecCol.put(i, quot.getArray());
526 outflagCol.put(i, flagsFromMA(quot));
527 }
528 ++sit;
529 ++s2it;
530 // take the first off for each on scan which doesn't have a
531 // matching off scan
532 // non <= noff: matching pairs, non > noff matching pairs then first off
533 if ( s2it.pastEnd() ) s2it.reset();
534 }
535 return out;
536}
537
[1391]538// dototalpower (migration of GBTIDL procedure dototalpower.pro)
539// calibrate the CAL on-off pair. It calculate Tsys and average CAL on-off subintegrations
540// do it for each cycles in a specific scan.
541CountedPtr< Scantable > STMath::dototalpower( const CountedPtr< Scantable >& calon,
542 const CountedPtr< Scantable >& caloff, Float tcal )
543{
544if ( ! calon->conformant(*caloff) ) {
545 throw(AipsError("'CAL on' and 'CAL off' scantables are not conformant."));
546 }
547 setInsitu(false);
548 CountedPtr< Scantable > out = getScantable(caloff, false);
549 Table& tout = out->table();
550 const Table& tcon = calon->table();
551 Vector<Float> tcalout;
552 Vector<Float> tcalout2; //debug
[1066]553
[1391]554 if ( tout.nrow() != tcon.nrow() ) {
555 throw(AipsError("Mismatch in number of rows to form cal on - off pair."));
556 }
557 // iteration by scanno or cycle no.
558 TableIterator sit(tout, "SCANNO");
559 TableIterator s2it(tcon, "SCANNO");
560 while ( !sit.pastEnd() ) {
561 Table toff = sit.table();
562 TableRow row(toff);
563 Table t = s2it.table();
564 ScalarColumn<Double> outintCol(toff, "INTERVAL");
565 ArrayColumn<Float> outspecCol(toff, "SPECTRA");
566 ArrayColumn<Float> outtsysCol(toff, "TSYS");
567 ArrayColumn<uChar> outflagCol(toff, "FLAGTRA");
568 ROScalarColumn<uInt> outtcalIdCol(toff, "TCAL_ID");
569 ROScalarColumn<uInt> outpolCol(toff, "POLNO");
570 ROScalarColumn<Double> onintCol(t, "INTERVAL");
571 ROArrayColumn<Float> onspecCol(t, "SPECTRA");
572 ROArrayColumn<Float> ontsysCol(t, "TSYS");
573 ROArrayColumn<uChar> onflagCol(t, "FLAGTRA");
574 //ROScalarColumn<uInt> ontcalIdCol(t, "TCAL_ID");
575
576 for (uInt i=0; i < toff.nrow(); ++i) {
577 //skip these checks -> assumes the data order are the same between the cal on off pairs
578 //
579 Vector<Float> specCalon, specCaloff;
580 // to store scalar (mean) tsys
581 Vector<Float> tsysout(1);
582 uInt tcalId, polno;
583 Double offint, onint;
584 outpolCol.get(i, polno);
585 outspecCol.get(i, specCaloff);
586 onspecCol.get(i, specCalon);
587 Vector<uChar> flagCaloff, flagCalon;
588 outflagCol.get(i, flagCaloff);
589 onflagCol.get(i, flagCalon);
590 outtcalIdCol.get(i, tcalId);
591 outintCol.get(i, offint);
592 onintCol.get(i, onint);
593 // caluculate mean Tsys
594 uInt nchan = specCaloff.nelements();
595 // percentage of edge cut off
596 uInt pc = 10;
597 uInt bchan = nchan/pc;
598 uInt echan = nchan-bchan;
599
600 Slicer chansl(IPosition(1,bchan-1), IPosition(1,echan-1), IPosition(1,1),Slicer::endIsLast);
601 Vector<Float> testsubsp = specCaloff(chansl);
602 MaskedArray<Float> spoff = maskedArray( specCaloff(chansl),flagCaloff(chansl) );
603 MaskedArray<Float> spon = maskedArray( specCalon(chansl),flagCalon(chansl) );
604 MaskedArray<Float> spdiff = spon-spoff;
605 uInt noff = spoff.nelementsValid();
606 //uInt non = spon.nelementsValid();
607 uInt ndiff = spdiff.nelementsValid();
608 Float meantsys;
609
610/**
611 Double subspec, subdiff;
612 uInt usednchan;
613 subspec = 0;
614 subdiff = 0;
615 usednchan = 0;
616 for(uInt k=(bchan-1); k<echan; k++) {
617 subspec += specCaloff[k];
618 subdiff += static_cast<Double>(specCalon[k]-specCaloff[k]);
619 ++usednchan;
620 }
621**/
622 // get tcal if input tcal <= 0
623 String tcalt;
624 Float tcalUsed;
625 tcalUsed = tcal;
626 if ( tcal <= 0.0 ) {
627 caloff->tcal().getEntry(tcalt, tcalout, tcalId);
628 if (polno<=3) {
629 tcalUsed = tcalout[polno];
630 }
631 else {
632 tcalUsed = tcalout[0];
633 }
634 }
635
636 Float meanoff;
637 Float meandiff;
638 if (noff && ndiff) {
639 //Debug
640 //if(noff!=ndiff) cerr<<"noff and ndiff is not equal"<<endl;
641 meanoff = sum(spoff)/noff;
642 meandiff = sum(spdiff)/ndiff;
643 meantsys= (meanoff/meandiff )*tcalUsed + tcalUsed/2;
644 }
645 else {
646 meantsys=1;
647 }
648
649 tsysout[0] = Float(meantsys);
650 MaskedArray<Float> mcaloff = maskedArray(specCaloff, flagCaloff);
651 MaskedArray<Float> mcalon = maskedArray(specCalon, flagCalon);
652 MaskedArray<Float> sig = Float(0.5) * (mcaloff + mcalon);
653 //uInt ncaloff = mcaloff.nelementsValid();
654 //uInt ncalon = mcalon.nelementsValid();
655
656 outintCol.put(i, offint+onint);
657 outspecCol.put(i, sig.getArray());
658 outflagCol.put(i, flagsFromMA(sig));
659 outtsysCol.put(i, tsysout);
660 }
661 ++sit;
662 ++s2it;
663 }
664 return out;
665}
666
667//dosigref - migrated from GBT IDL's dosigref.pro, do calibration of position switch
668// observatiions.
669// input: sig and ref scantables, and an optional boxcar smoothing width(default width=0,
670// no smoothing).
671// output: resultant scantable [= (sig-ref/ref)*tsys]
672CountedPtr< Scantable > STMath::dosigref( const CountedPtr < Scantable >& sig,
673 const CountedPtr < Scantable >& ref,
674 int smoothref,
675 casa::Float tsysv,
676 casa::Float tau )
677{
678if ( ! ref->conformant(*sig) ) {
679 throw(AipsError("'sig' and 'ref' scantables are not conformant."));
680 }
681 setInsitu(false);
682 CountedPtr< Scantable > out = getScantable(sig, false);
683 CountedPtr< Scantable > smref;
684 if ( smoothref > 1 ) {
685 float fsmoothref = static_cast<float>(smoothref);
686 std::string inkernel = "boxcar";
687 smref = smooth(ref, inkernel, fsmoothref );
688 ostringstream oss;
689 oss<<"Applied smoothing of "<<fsmoothref<<" on the reference."<<endl;
690 pushLog(String(oss));
691 }
692 else {
693 smref = ref;
694 }
695 Table& tout = out->table();
696 const Table& tref = smref->table();
697 if ( tout.nrow() != tref.nrow() ) {
698 throw(AipsError("Mismatch in number of rows to form on-source and reference pair."));
699 }
700 // iteration by scanno? or cycle no.
701 TableIterator sit(tout, "SCANNO");
702 TableIterator s2it(tref, "SCANNO");
703 while ( !sit.pastEnd() ) {
704 Table ton = sit.table();
705 Table t = s2it.table();
706 ScalarColumn<Double> outintCol(ton, "INTERVAL");
707 ArrayColumn<Float> outspecCol(ton, "SPECTRA");
708 ArrayColumn<Float> outtsysCol(ton, "TSYS");
709 ArrayColumn<uChar> outflagCol(ton, "FLAGTRA");
710 ArrayColumn<Float> refspecCol(t, "SPECTRA");
711 ROScalarColumn<Double> refintCol(t, "INTERVAL");
712 ROArrayColumn<Float> reftsysCol(t, "TSYS");
713 ArrayColumn<uChar> refflagCol(t, "FLAGTRA");
714 ROScalarColumn<Float> refelevCol(t, "ELEVATION");
715 for (uInt i=0; i < ton.nrow(); ++i) {
716
717 Double onint, refint;
718 Vector<Float> specon, specref;
719 // to store scalar (mean) tsys
720 Vector<Float> tsysref;
721 outintCol.get(i, onint);
722 refintCol.get(i, refint);
723 outspecCol.get(i, specon);
724 refspecCol.get(i, specref);
725 Vector<uChar> flagref, flagon;
726 outflagCol.get(i, flagon);
727 refflagCol.get(i, flagref);
728 reftsysCol.get(i, tsysref);
729
730 Float tsysrefscalar;
731 if ( tsysv > 0.0 ) {
732 ostringstream oss;
733 Float elev;
734 refelevCol.get(i, elev);
735 oss << "user specified Tsys = " << tsysv;
736 // do recalc elevation if EL = 0
737 if ( elev == 0 ) {
738 throw(AipsError("EL=0, elevation data is missing."));
739 } else {
740 if ( tau <= 0.0 ) {
741 throw(AipsError("Valid tau is not supplied."));
742 } else {
743 tsysrefscalar = tsysv * exp(tau/elev);
744 }
745 }
746 oss << ", corrected (for El) tsys= "<<tsysrefscalar;
747 pushLog(String(oss));
748 }
749 else {
750 tsysrefscalar = tsysref[0];
751 }
752 //get quotient spectrum
753 MaskedArray<Float> mref = maskedArray(specref, flagref);
754 MaskedArray<Float> mon = maskedArray(specon, flagon);
755 MaskedArray<Float> specres = tsysrefscalar*((mon - mref)/mref);
756 Double resint = onint*refint*smoothref/(onint+refint*smoothref);
757
758 //Debug
759 //cerr<<"Tsys used="<<tsysrefscalar<<endl;
760 // fill the result, replay signal tsys by reference tsys
761 outintCol.put(i, resint);
762 outspecCol.put(i, specres.getArray());
763 outflagCol.put(i, flagsFromMA(specres));
764 outtsysCol.put(i, tsysref);
765 }
766 ++sit;
767 ++s2it;
768 }
769 return out;
770}
771
772CountedPtr< Scantable > STMath::donod(const casa::CountedPtr<Scantable>& s,
773 const std::vector<int>& scans,
774 int smoothref,
775 casa::Float tsysv,
776 casa::Float tau,
777 casa::Float tcal )
778
779{
780 setInsitu(false);
781 STSelector sel;
782 std::vector<int> scan1, scan2, beams;
783 std::vector< vector<int> > scanpair;
784 std::vector<string> calstate;
785 String msg;
786
787 CountedPtr< Scantable > s1b1on, s1b1off, s1b2on, s1b2off;
788 CountedPtr< Scantable > s2b1on, s2b1off, s2b2on, s2b2off;
789
790 std::vector< CountedPtr< Scantable > > sctables;
791 sctables.push_back(s1b1on);
792 sctables.push_back(s1b1off);
793 sctables.push_back(s1b2on);
794 sctables.push_back(s1b2off);
795 sctables.push_back(s2b1on);
796 sctables.push_back(s2b1off);
797 sctables.push_back(s2b2on);
798 sctables.push_back(s2b2off);
799
800 //check scanlist
801 int n=s->checkScanInfo(scans);
802 if (n==1) {
803 throw(AipsError("Incorrect scan pairs. "));
804 }
805
806 // Assume scans contain only a pair of consecutive scan numbers.
807 // It is assumed that first beam, b1, is on target.
808 // There is no check if the first beam is on or not.
809 if ( scans.size()==1 ) {
810 scan1.push_back(scans[0]);
811 scan2.push_back(scans[0]+1);
812 } else if ( scans.size()==2 ) {
813 scan1.push_back(scans[0]);
814 scan2.push_back(scans[1]);
815 } else {
816 if ( scans.size()%2 == 0 ) {
817 for (uInt i=0; i<scans.size(); i++) {
818 if (i%2 == 0) {
819 scan1.push_back(scans[i]);
820 }
821 else {
822 scan2.push_back(scans[i]);
823 }
824 }
825 } else {
826 throw(AipsError("Odd numbers of scans, cannot form pairs."));
827 }
828 }
829 scanpair.push_back(scan1);
830 scanpair.push_back(scan2);
831 calstate.push_back("*calon");
832 calstate.push_back("*[^calon]");
833 CountedPtr< Scantable > ws = getScantable(s, false);
834 uInt l=0;
835 while ( l < sctables.size() ) {
836 for (uInt i=0; i < 2; i++) {
837 for (uInt j=0; j < 2; j++) {
838 for (uInt k=0; k < 2; k++) {
839 sel.reset();
840 sel.setScans(scanpair[i]);
841 sel.setName(calstate[k]);
842 beams.clear();
843 beams.push_back(j);
844 sel.setBeams(beams);
845 ws->setSelection(sel);
846 sctables[l]= getScantable(ws, false);
847 l++;
848 }
849 }
850 }
851 }
852
853 // replace here by splitData or getData functionality
854 CountedPtr< Scantable > sig1;
855 CountedPtr< Scantable > ref1;
856 CountedPtr< Scantable > sig2;
857 CountedPtr< Scantable > ref2;
858 CountedPtr< Scantable > calb1;
859 CountedPtr< Scantable > calb2;
860
861 msg=String("Processing dototalpower for subset of the data");
862 ostringstream oss1;
863 oss1 << msg << endl;
864 pushLog(String(oss1));
865 // Debug for IRC CS data
866 //float tcal1=7.0;
867 //float tcal2=4.0;
868 sig1 = dototalpower(sctables[0], sctables[1], tcal=tcal);
869 ref1 = dototalpower(sctables[2], sctables[3], tcal=tcal);
870 ref2 = dototalpower(sctables[4], sctables[5], tcal=tcal);
871 sig2 = dototalpower(sctables[6], sctables[7], tcal=tcal);
872
873 // correction of user-specified tsys for elevation here
874
875 // dosigref calibration
876 msg=String("Processing dosigref for subset of the data");
877 ostringstream oss2;
878 oss2 << msg << endl;
879 pushLog(String(oss2));
880 calb1=dosigref(sig1,ref2,smoothref,tsysv,tau);
881 calb2=dosigref(sig2,ref1,smoothref,tsysv,tau);
882
883 // iteration by scanno or cycle no.
884 Table& tcalb1 = calb1->table();
885 Table& tcalb2 = calb2->table();
886 TableIterator sit(tcalb1, "SCANNO");
887 TableIterator s2it(tcalb2, "SCANNO");
888 while ( !sit.pastEnd() ) {
889 Table t1 = sit.table();
890 Table t2= s2it.table();
891 ArrayColumn<Float> outspecCol(t1, "SPECTRA");
892 ArrayColumn<Float> outtsysCol(t1, "TSYS");
893 ArrayColumn<uChar> outflagCol(t1, "FLAGTRA");
894 ScalarColumn<Double> outintCol(t1, "INTERVAL");
895 ArrayColumn<Float> t2specCol(t2, "SPECTRA");
896 ROArrayColumn<Float> t2tsysCol(t2, "TSYS");
897 ArrayColumn<uChar> t2flagCol(t2, "FLAGTRA");
898 ROScalarColumn<Double> t2intCol(t2, "INTERVAL");
899 for (uInt i=0; i < t1.nrow(); ++i) {
900 Vector<Float> spec1, spec2;
901 // to store scalar (mean) tsys
902 Vector<Float> tsys1, tsys2;
903 Vector<uChar> flag1, flag2;
904 Double tint1, tint2;
905 outspecCol.get(i, spec1);
906 t2specCol.get(i, spec2);
907 outflagCol.get(i, flag1);
908 t2flagCol.get(i, flag2);
909 outtsysCol.get(i, tsys1);
910 t2tsysCol.get(i, tsys2);
911 outintCol.get(i, tint1);
912 t2intCol.get(i, tint2);
913 // average
914 // assume scalar tsys for weights
915 Float wt1, wt2, tsyssq1, tsyssq2;
916 tsyssq1 = tsys1[0]*tsys1[0];
917 tsyssq2 = tsys2[0]*tsys2[0];
918 wt1 = Float(tint1)/tsyssq1;
919 wt2 = Float(tint2)/tsyssq2;
920 Float invsumwt=1/(wt1+wt2);
921 MaskedArray<Float> mspec1 = maskedArray(spec1, flag1);
922 MaskedArray<Float> mspec2 = maskedArray(spec2, flag2);
923 MaskedArray<Float> avspec = invsumwt * (wt1*mspec1 + wt2*mspec2);
924 //Array<Float> avtsys = Float(0.5) * (tsys1 + tsys2);
925 // cerr<< "Tsys1="<<tsys1<<" Tsys2="<<tsys2<<endl;
926 tsys1[0] = sqrt(tsyssq1 + tsyssq2);
927 Array<Float> avtsys = tsys1;
928
929 outspecCol.put(i, avspec.getArray());
930 outflagCol.put(i, flagsFromMA(avspec));
931 outtsysCol.put(i, avtsys);
932 }
933 ++sit;
934 ++s2it;
935 }
936 return calb1;
937}
938
939//GBTIDL version of frequency switched data calibration
940CountedPtr< Scantable > STMath::dofs( const CountedPtr< Scantable >& s,
941 const std::vector<int>& scans,
942 int smoothref,
943 casa::Float tsysv,
944 casa::Float tau,
945 casa::Float tcal )
946{
947
948
949 STSelector sel;
950 CountedPtr< Scantable > ws = getScantable(s, false);
951 CountedPtr< Scantable > sig, sigwcal, ref, refwcal;
952 CountedPtr< Scantable > calsig, calref, out;
953
954 //split the data
955 sel.setName("*_fs");
956 ws->setSelection(sel);
957 sig = getScantable(ws,false);
958 sel.reset();
959 sel.setName("*_fs_calon");
960 ws->setSelection(sel);
961 sigwcal = getScantable(ws,false);
962 sel.reset();
963 sel.setName("*_fsr");
964 ws->setSelection(sel);
965 ref = getScantable(ws,false);
966 sel.reset();
967 sel.setName("*_fsr_calon");
968 ws->setSelection(sel);
969 refwcal = getScantable(ws,false);
970
971 calsig = dototalpower(sigwcal, sig, tcal=tcal);
972 calref = dototalpower(refwcal, ref, tcal=tcal);
973
974 out=dosigref(calsig,calref,smoothref,tsysv,tau);
975
976 return out;
977}
978
979
[805]980CountedPtr< Scantable > STMath::freqSwitch( const CountedPtr< Scantable >& in )
981{
982 // make copy or reference
983 CountedPtr< Scantable > out = getScantable(in, false);
984 Table& tout = out->table();
[1008]985 Block<String> cols(4);
[805]986 cols[0] = String("SCANNO");
[1008]987 cols[1] = String("CYCLENO");
988 cols[2] = String("BEAMNO");
989 cols[3] = String("POLNO");
[805]990 TableIterator iter(tout, cols);
991 while (!iter.pastEnd()) {
992 Table subt = iter.table();
993 // this should leave us with two rows for the two IFs....if not ignore
994 if (subt.nrow() != 2 ) {
995 continue;
[701]996 }
[1008]997 ArrayColumn<Float> specCol(subt, "SPECTRA");
998 ArrayColumn<Float> tsysCol(subt, "TSYS");
999 ArrayColumn<uChar> flagCol(subt, "FLAGTRA");
[805]1000 Vector<Float> onspec,offspec, ontsys, offtsys;
1001 Vector<uChar> onflag, offflag;
1002 tsysCol.get(0, ontsys); tsysCol.get(1, offtsys);
1003 specCol.get(0, onspec); specCol.get(1, offspec);
1004 flagCol.get(0, onflag); flagCol.get(1, offflag);
1005 MaskedArray<Float> on = maskedArray(onspec, onflag);
1006 MaskedArray<Float> off = maskedArray(offspec, offflag);
1007 MaskedArray<Float> oncopy = on.copy();
[248]1008
[805]1009 on /= off; on -= 1.0f;
1010 on *= ontsys[0];
1011 off /= oncopy; off -= 1.0f;
1012 off *= offtsys[0];
1013 specCol.put(0, on.getArray());
1014 const Vector<Bool>& m0 = on.getMask();
1015 Vector<uChar> flags0(m0.shape());
1016 convertArray(flags0, !m0);
1017 flagCol.put(0, flags0);
[234]1018
[805]1019 specCol.put(1, off.getArray());
1020 const Vector<Bool>& m1 = off.getMask();
1021 Vector<uChar> flags1(m1.shape());
1022 convertArray(flags1, !m1);
1023 flagCol.put(1, flags1);
[867]1024 ++iter;
[130]1025 }
[780]1026
[805]1027 return out;
[9]1028}
[48]1029
[805]1030std::vector< float > STMath::statistic( const CountedPtr< Scantable > & in,
1031 const std::vector< bool > & mask,
1032 const std::string& which )
[130]1033{
1034
[805]1035 Vector<Bool> m(mask);
1036 const Table& tab = in->table();
1037 ROArrayColumn<Float> specCol(tab, "SPECTRA");
1038 ROArrayColumn<uChar> flagCol(tab, "FLAGTRA");
1039 std::vector<float> out;
1040 for (uInt i=0; i < tab.nrow(); ++i ) {
1041 Vector<Float> spec; specCol.get(i, spec);
[867]1042 Vector<uChar> flag; flagCol.get(i, flag);
1043 MaskedArray<Float> ma = maskedArray(spec, flag);
1044 float outstat = 0.0;
[805]1045 if ( spec.nelements() == m.nelements() ) {
1046 outstat = mathutil::statistics(which, ma(m));
1047 } else {
1048 outstat = mathutil::statistics(which, ma);
1049 }
1050 out.push_back(outstat);
[234]1051 }
[805]1052 return out;
[130]1053}
1054
[805]1055CountedPtr< Scantable > STMath::bin( const CountedPtr< Scantable > & in,
1056 int width )
[144]1057{
[841]1058 if ( !in->getSelection().empty() ) throw(AipsError("Can't bin subset of the data."));
[805]1059 CountedPtr< Scantable > out = getScantable(in, false);
1060 Table& tout = out->table();
1061 out->frequencies().rescale(width, "BIN");
1062 ArrayColumn<Float> specCol(tout, "SPECTRA");
1063 ArrayColumn<uChar> flagCol(tout, "FLAGTRA");
1064 for (uInt i=0; i < tout.nrow(); ++i ) {
1065 MaskedArray<Float> main = maskedArray(specCol(i), flagCol(i));
1066 MaskedArray<Float> maout;
1067 LatticeUtilities::bin(maout, main, 0, Int(width));
1068 /// @todo implement channel based tsys binning
1069 specCol.put(i, maout.getArray());
1070 flagCol.put(i, flagsFromMA(maout));
1071 // take only the first binned spectrum's length for the deprecated
1072 // global header item nChan
1073 if (i==0) tout.rwKeywordSet().define(String("nChan"),
1074 Int(maout.getArray().nelements()));
[169]1075 }
[805]1076 return out;
[146]1077}
1078
[805]1079CountedPtr< Scantable > STMath::resample( const CountedPtr< Scantable >& in,
1080 const std::string& method,
1081 float width )
[299]1082//
1083// Should add the possibility of width being specified in km/s. This means
[780]1084// that for each freqID (SpectralCoordinate) we will need to convert to an
1085// average channel width (say at the reference pixel). Then we would need
1086// to be careful to make sure each spectrum (of different freqID)
[299]1087// is the same length.
1088//
1089{
[996]1090 //InterpolateArray1D<Double,Float>::InterpolationMethod interp;
[805]1091 Int interpMethod(stringToIMethod(method));
[299]1092
[805]1093 CountedPtr< Scantable > out = getScantable(in, false);
1094 Table& tout = out->table();
[299]1095
1096// Resample SpectralCoordinates (one per freqID)
[805]1097 out->frequencies().rescale(width, "RESAMPLE");
1098 TableIterator iter(tout, "IFNO");
1099 TableRow row(tout);
1100 while ( !iter.pastEnd() ) {
1101 Table tab = iter.table();
1102 ArrayColumn<Float> specCol(tab, "SPECTRA");
1103 //ArrayColumn<Float> tsysCol(tout, "TSYS");
1104 ArrayColumn<uChar> flagCol(tab, "FLAGTRA");
1105 Vector<Float> spec;
1106 Vector<uChar> flag;
1107 specCol.get(0,spec); // the number of channels should be constant per IF
1108 uInt nChanIn = spec.nelements();
1109 Vector<Float> xIn(nChanIn); indgen(xIn);
1110 Int fac = Int(nChanIn/width);
1111 Vector<Float> xOut(fac+10); // 10 to be safe - resize later
1112 uInt k = 0;
1113 Float x = 0.0;
1114 while (x < Float(nChanIn) ) {
1115 xOut(k) = x;
1116 k++;
1117 x += width;
1118 }
1119 uInt nChanOut = k;
1120 xOut.resize(nChanOut, True);
1121 // process all rows for this IFNO
1122 Vector<Float> specOut;
1123 Vector<Bool> maskOut;
1124 Vector<uChar> flagOut;
1125 for (uInt i=0; i < tab.nrow(); ++i) {
1126 specCol.get(i, spec);
1127 flagCol.get(i, flag);
1128 Vector<Bool> mask(flag.nelements());
1129 convertArray(mask, flag);
[299]1130
[805]1131 IPosition shapeIn(spec.shape());
1132 //sh.nchan = nChanOut;
1133 InterpolateArray1D<Float,Float>::interpolate(specOut, maskOut, xOut,
1134 xIn, spec, mask,
1135 interpMethod, True, True);
1136 /// @todo do the same for channel based Tsys
1137 flagOut.resize(maskOut.nelements());
1138 convertArray(flagOut, maskOut);
1139 specCol.put(i, specOut);
1140 flagCol.put(i, flagOut);
1141 }
1142 ++iter;
[299]1143 }
1144
[805]1145 return out;
1146}
[299]1147
[805]1148STMath::imethod STMath::stringToIMethod(const std::string& in)
1149{
1150 static STMath::imap lookup;
[299]1151
[805]1152 // initialize the lookup table if necessary
1153 if ( lookup.empty() ) {
[926]1154 lookup["nearest"] = InterpolateArray1D<Double,Float>::nearestNeighbour;
1155 lookup["linear"] = InterpolateArray1D<Double,Float>::linear;
1156 lookup["cubic"] = InterpolateArray1D<Double,Float>::cubic;
1157 lookup["spline"] = InterpolateArray1D<Double,Float>::spline;
[299]1158 }
1159
[805]1160 STMath::imap::const_iterator iter = lookup.find(in);
[299]1161
[805]1162 if ( lookup.end() == iter ) {
1163 std::string message = in;
1164 message += " is not a valid interpolation mode";
1165 throw(AipsError(message));
[299]1166 }
[805]1167 return iter->second;
[299]1168}
1169
[805]1170WeightType STMath::stringToWeight(const std::string& in)
[146]1171{
[805]1172 static std::map<std::string, WeightType> lookup;
[434]1173
[805]1174 // initialize the lookup table if necessary
1175 if ( lookup.empty() ) {
1176 lookup["NONE"] = asap::NONE;
1177 lookup["TINT"] = asap::TINT;
1178 lookup["TINTSYS"] = asap::TINTSYS;
1179 lookup["TSYS"] = asap::TSYS;
1180 lookup["VAR"] = asap::VAR;
1181 }
[434]1182
[805]1183 std::map<std::string, WeightType>::const_iterator iter = lookup.find(in);
[294]1184
[805]1185 if ( lookup.end() == iter ) {
1186 std::string message = in;
1187 message += " is not a valid weighting mode";
1188 throw(AipsError(message));
1189 }
1190 return iter->second;
[146]1191}
1192
[805]1193CountedPtr< Scantable > STMath::gainElevation( const CountedPtr< Scantable >& in,
[867]1194 const vector< float > & coeff,
[805]1195 const std::string & filename,
1196 const std::string& method)
[165]1197{
[805]1198 // Get elevation data from Scantable and convert to degrees
1199 CountedPtr< Scantable > out = getScantable(in, false);
[926]1200 Table& tab = out->table();
[805]1201 ROScalarColumn<Float> elev(tab, "ELEVATION");
1202 Vector<Float> x = elev.getColumn();
1203 x *= Float(180 / C::pi); // Degrees
[165]1204
[867]1205 Vector<Float> coeffs(coeff);
[805]1206 const uInt nc = coeffs.nelements();
1207 if ( filename.length() > 0 && nc > 0 ) {
1208 throw(AipsError("You must choose either polynomial coefficients or an ascii file, not both"));
[315]1209 }
[165]1210
[805]1211 // Correct
1212 if ( nc > 0 || filename.length() == 0 ) {
1213 // Find instrument
1214 Bool throwit = True;
1215 Instrument inst =
[878]1216 STAttr::convertInstrument(tab.keywordSet().asString("AntennaName"),
[805]1217 throwit);
[165]1218
[805]1219 // Set polynomial
1220 Polynomial<Float>* ppoly = 0;
1221 Vector<Float> coeff;
1222 String msg;
1223 if ( nc > 0 ) {
1224 ppoly = new Polynomial<Float>(nc);
1225 coeff = coeffs;
1226 msg = String("user");
1227 } else {
[878]1228 STAttr sdAttr;
[805]1229 coeff = sdAttr.gainElevationPoly(inst);
1230 ppoly = new Polynomial<Float>(3);
1231 msg = String("built in");
1232 }
[532]1233
[805]1234 if ( coeff.nelements() > 0 ) {
1235 ppoly->setCoefficients(coeff);
1236 } else {
1237 delete ppoly;
1238 throw(AipsError("There is no known gain-elevation polynomial known for this instrument"));
1239 }
1240 ostringstream oss;
1241 oss << "Making polynomial correction with " << msg << " coefficients:" << endl;
1242 oss << " " << coeff;
1243 pushLog(String(oss));
1244 const uInt nrow = tab.nrow();
1245 Vector<Float> factor(nrow);
1246 for ( uInt i=0; i < nrow; ++i ) {
1247 factor[i] = 1.0 / (*ppoly)(x[i]);
1248 }
1249 delete ppoly;
1250 scaleByVector(tab, factor, true);
[532]1251
[805]1252 } else {
1253 // Read and correct
1254 pushLog("Making correction from ascii Table");
1255 scaleFromAsciiTable(tab, filename, method, x, true);
[532]1256 }
[805]1257 return out;
1258}
[165]1259
[805]1260void STMath::scaleFromAsciiTable(Table& in, const std::string& filename,
1261 const std::string& method,
1262 const Vector<Float>& xout, bool dotsys)
1263{
[165]1264
[805]1265// Read gain-elevation ascii file data into a Table.
[165]1266
[805]1267 String formatString;
1268 Table tbl = readAsciiTable(formatString, Table::Memory, filename, "", "", False);
1269 scaleFromTable(in, tbl, method, xout, dotsys);
1270}
[165]1271
[805]1272void STMath::scaleFromTable(Table& in,
1273 const Table& table,
1274 const std::string& method,
1275 const Vector<Float>& xout, bool dotsys)
1276{
[780]1277
[805]1278 ROScalarColumn<Float> geElCol(table, "ELEVATION");
1279 ROScalarColumn<Float> geFacCol(table, "FACTOR");
1280 Vector<Float> xin = geElCol.getColumn();
1281 Vector<Float> yin = geFacCol.getColumn();
1282 Vector<Bool> maskin(xin.nelements(),True);
[165]1283
[805]1284 // Interpolate (and extrapolate) with desired method
[532]1285
[996]1286 InterpolateArray1D<Double,Float>::InterpolationMethod interp = stringToIMethod(method);
[165]1287
[805]1288 Vector<Float> yout;
1289 Vector<Bool> maskout;
1290 InterpolateArray1D<Float,Float>::interpolate(yout, maskout, xout,
[996]1291 xin, yin, maskin, interp,
[805]1292 True, True);
[165]1293
[805]1294 scaleByVector(in, Float(1.0)/yout, dotsys);
[165]1295}
[167]1296
[805]1297void STMath::scaleByVector( Table& in,
1298 const Vector< Float >& factor,
1299 bool dotsys )
[177]1300{
[805]1301 uInt nrow = in.nrow();
1302 if ( factor.nelements() != nrow ) {
1303 throw(AipsError("factors.nelements() != table.nelements()"));
1304 }
1305 ArrayColumn<Float> specCol(in, "SPECTRA");
1306 ArrayColumn<uChar> flagCol(in, "FLAGTRA");
1307 ArrayColumn<Float> tsysCol(in, "TSYS");
1308 for (uInt i=0; i < nrow; ++i) {
1309 MaskedArray<Float> ma = maskedArray(specCol(i), flagCol(i));
1310 ma *= factor[i];
1311 specCol.put(i, ma.getArray());
1312 flagCol.put(i, flagsFromMA(ma));
1313 if ( dotsys ) {
[926]1314 Vector<Float> tsys = tsysCol(i);
[805]1315 tsys *= factor[i];
[926]1316 tsysCol.put(i,tsys);
[805]1317 }
1318 }
[177]1319}
1320
[805]1321CountedPtr< Scantable > STMath::convertFlux( const CountedPtr< Scantable >& in,
1322 float d, float etaap,
1323 float jyperk )
[221]1324{
[805]1325 CountedPtr< Scantable > out = getScantable(in, false);
1326 Table& tab = in->table();
1327 Unit fluxUnit(tab.keywordSet().asString("FluxUnit"));
[221]1328 Unit K(String("K"));
1329 Unit JY(String("Jy"));
[701]1330
[805]1331 bool tokelvin = true;
1332 Double cfac = 1.0;
[716]1333
[805]1334 if ( fluxUnit == JY ) {
[716]1335 pushLog("Converting to K");
[701]1336 Quantum<Double> t(1.0,fluxUnit);
1337 Quantum<Double> t2 = t.get(JY);
[805]1338 cfac = (t2 / t).getValue(); // value to Jy
[780]1339
[805]1340 tokelvin = true;
1341 out->setFluxUnit("K");
1342 } else if ( fluxUnit == K ) {
[716]1343 pushLog("Converting to Jy");
[701]1344 Quantum<Double> t(1.0,fluxUnit);
1345 Quantum<Double> t2 = t.get(K);
[805]1346 cfac = (t2 / t).getValue(); // value to K
[780]1347
[805]1348 tokelvin = false;
1349 out->setFluxUnit("Jy");
[221]1350 } else {
[701]1351 throw(AipsError("Unrecognized brightness units in Table - must be consistent with Jy or K"));
[221]1352 }
[701]1353 // Make sure input values are converted to either Jy or K first...
[805]1354 Float factor = cfac;
[221]1355
[701]1356 // Select method
[805]1357 if (jyperk > 0.0) {
1358 factor *= jyperk;
1359 if ( tokelvin ) factor = 1.0 / jyperk;
[716]1360 ostringstream oss;
[805]1361 oss << "Jy/K = " << jyperk;
[716]1362 pushLog(String(oss));
[805]1363 Vector<Float> factors(tab.nrow(), factor);
1364 scaleByVector(tab,factors, false);
1365 } else if ( etaap > 0.0) {
[1319]1366 if (d < 0) {
1367 Instrument inst =
1368 STAttr::convertInstrument(tab.keywordSet().asString("AntennaName"),
1369 True);
1370 STAttr sda;
1371 d = sda.diameter(inst);
1372 }
[996]1373 jyperk = STAttr::findJyPerK(etaap, d);
[716]1374 ostringstream oss;
[805]1375 oss << "Jy/K = " << jyperk;
[716]1376 pushLog(String(oss));
[805]1377 factor *= jyperk;
1378 if ( tokelvin ) {
[701]1379 factor = 1.0 / factor;
1380 }
[805]1381 Vector<Float> factors(tab.nrow(), factor);
1382 scaleByVector(tab, factors, False);
[354]1383 } else {
[780]1384
[701]1385 // OK now we must deal with automatic look up of values.
1386 // We must also deal with the fact that the factors need
1387 // to be computed per IF and may be different and may
1388 // change per integration.
[780]1389
[716]1390 pushLog("Looking up conversion factors");
[805]1391 convertBrightnessUnits(out, tokelvin, cfac);
[701]1392 }
[805]1393
1394 return out;
[221]1395}
1396
[805]1397void STMath::convertBrightnessUnits( CountedPtr<Scantable>& in,
1398 bool tokelvin, float cfac )
[227]1399{
[805]1400 Table& table = in->table();
1401 Instrument inst =
[878]1402 STAttr::convertInstrument(table.keywordSet().asString("AntennaName"), True);
[805]1403 TableIterator iter(table, "FREQ_ID");
1404 STFrequencies stfreqs = in->frequencies();
[878]1405 STAttr sdAtt;
[805]1406 while (!iter.pastEnd()) {
1407 Table tab = iter.table();
1408 ArrayColumn<Float> specCol(tab, "SPECTRA");
1409 ArrayColumn<uChar> flagCol(tab, "FLAGTRA");
1410 ROScalarColumn<uInt> freqidCol(tab, "FREQ_ID");
1411 MEpoch::ROScalarColumn timeCol(tab, "TIME");
[234]1412
[805]1413 uInt freqid; freqidCol.get(0, freqid);
1414 Vector<Float> tmpspec; specCol.get(0, tmpspec);
[878]1415 // STAttr.JyPerK has a Vector interface... change sometime.
[805]1416 Vector<Float> freqs(1,stfreqs.getRefFreq(freqid, tmpspec.nelements()));
1417 for ( uInt i=0; i<tab.nrow(); ++i) {
1418 Float jyperk = (sdAtt.JyPerK(inst, timeCol(i), freqs))[0];
1419 Float factor = cfac * jyperk;
1420 if ( tokelvin ) factor = Float(1.0) / factor;
1421 MaskedArray<Float> ma = maskedArray(specCol(i), flagCol(i));
1422 ma *= factor;
1423 specCol.put(i, ma.getArray());
1424 flagCol.put(i, flagsFromMA(ma));
1425 }
[867]1426 ++iter;
[234]1427 }
[230]1428}
[227]1429
[805]1430CountedPtr< Scantable > STMath::opacity( const CountedPtr< Scantable > & in,
1431 float tau )
[234]1432{
[805]1433 CountedPtr< Scantable > out = getScantable(in, false);
[926]1434
1435 Table tab = out->table();
[234]1436 ROScalarColumn<Float> elev(tab, "ELEVATION");
[805]1437 ArrayColumn<Float> specCol(tab, "SPECTRA");
1438 ArrayColumn<uChar> flagCol(tab, "FLAGTRA");
1439 for ( uInt i=0; i<tab.nrow(); ++i) {
1440 Float zdist = Float(C::pi_2) - elev(i);
[1318]1441 Float factor = exp(tau/cos(zdist));
[926]1442 MaskedArray<Float> ma = maskedArray(specCol(i), flagCol(i));
[805]1443 ma *= factor;
1444 specCol.put(i, ma.getArray());
1445 flagCol.put(i, flagsFromMA(ma));
[234]1446 }
[805]1447 return out;
[234]1448}
1449
[1373]1450CountedPtr< Scantable > STMath::smoothOther( const CountedPtr< Scantable >& in,
1451 const std::string& kernel,
1452 float width )
1453{
1454 CountedPtr< Scantable > out = getScantable(in, false);
1455 Table& table = out->table();
1456 ArrayColumn<Float> specCol(table, "SPECTRA");
1457 ArrayColumn<uChar> flagCol(table, "FLAGTRA");
1458 Vector<Float> spec;
1459 Vector<uChar> flag;
1460 for ( uInt i=0; i<table.nrow(); ++i) {
1461 specCol.get(i, spec);
1462 flagCol.get(i, flag);
1463 Vector<Bool> mask(flag.nelements());
1464 convertArray(mask, flag);
1465 Vector<Float> specout;
1466 Vector<Bool> maskout;
1467 if ( kernel == "hanning" ) {
1468 mathutil::hanning(specout, maskout, spec , !mask);
1469 convertArray(flag, !maskout);
1470 } else if ( kernel == "rmedian" ) {
1471 mathutil::runningMedian(specout, maskout, spec , mask, width);
1472 convertArray(flag, maskout);
1473 }
1474 flagCol.put(i, flag);
1475 specCol.put(i, specout);
1476 }
1477 return out;
1478}
1479
[805]1480CountedPtr< Scantable > STMath::smooth( const CountedPtr< Scantable >& in,
1481 const std::string& kernel, float width )
[457]1482{
[1373]1483 if (kernel == "rmedian" || kernel == "hanning") {
1484 return smoothOther(in, kernel, width);
1485 }
[805]1486 CountedPtr< Scantable > out = getScantable(in, false);
[1033]1487 Table& table = out->table();
[805]1488 VectorKernel::KernelTypes type = VectorKernel::toKernelType(kernel);
1489 // same IFNO should have same no of channels
1490 // this saves overhead
1491 TableIterator iter(table, "IFNO");
1492 while (!iter.pastEnd()) {
1493 Table tab = iter.table();
1494 ArrayColumn<Float> specCol(tab, "SPECTRA");
1495 ArrayColumn<uChar> flagCol(tab, "FLAGTRA");
1496 Vector<Float> tmpspec; specCol.get(0, tmpspec);
1497 uInt nchan = tmpspec.nelements();
1498 Vector<Float> kvec = VectorKernel::make(type, width, nchan, True, False);
1499 Convolver<Float> conv(kvec, IPosition(1,nchan));
1500 Vector<Float> spec;
1501 Vector<uChar> flag;
1502 for ( uInt i=0; i<tab.nrow(); ++i) {
1503 specCol.get(i, spec);
1504 flagCol.get(i, flag);
1505 Vector<Bool> mask(flag.nelements());
1506 convertArray(mask, flag);
1507 Vector<Float> specout;
[1373]1508 mathutil::replaceMaskByZero(specout, mask);
1509 conv.linearConv(specout, spec);
1510 specCol.put(i, specout);
[805]1511 }
[867]1512 ++iter;
[701]1513 }
[805]1514 return out;
[701]1515}
[841]1516
1517CountedPtr< Scantable >
1518 STMath::merge( const std::vector< CountedPtr < Scantable > >& in )
1519{
1520 if ( in.size() < 2 ) {
[862]1521 throw(AipsError("Need at least two scantables to perform a merge."));
[841]1522 }
1523 std::vector<CountedPtr < Scantable > >::const_iterator it = in.begin();
1524 bool insitu = insitu_;
1525 setInsitu(false);
[862]1526 CountedPtr< Scantable > out = getScantable(*it, false);
[841]1527 setInsitu(insitu);
1528 Table& tout = out->table();
1529 ScalarColumn<uInt> freqidcol(tout,"FREQ_ID"), molidcol(tout, "MOLECULE_ID");
[917]1530 ScalarColumn<uInt> scannocol(tout,"SCANNO"), focusidcol(tout,"FOCUS_ID");
1531 // Renumber SCANNO to be 0-based
[926]1532 Vector<uInt> scannos = scannocol.getColumn();
1533 uInt offset = min(scannos);
[917]1534 scannos -= offset;
[926]1535 scannocol.putColumn(scannos);
1536 uInt newscanno = max(scannos)+1;
[862]1537 ++it;
[841]1538 while ( it != in.end() ){
1539 if ( ! (*it)->conformant(*out) ) {
1540 // log message: "ignoring scantable i, as it isn't
1541 // conformant with the other(s)"
[1416]1542 pushLog(String("Warning: Can't merge scantables as header info differs."));
[841]1543 ++it;
1544 continue;
1545 }
[862]1546 out->appendToHistoryTable((*it)->history());
[841]1547 const Table& tab = (*it)->table();
1548 TableIterator scanit(tab, "SCANNO");
1549 while (!scanit.pastEnd()) {
1550 TableIterator freqit(scanit.table(), "FREQ_ID");
1551 while ( !freqit.pastEnd() ) {
1552 Table thetab = freqit.table();
1553 uInt nrow = tout.nrow();
1554 //tout.addRow(thetab.nrow());
1555 TableCopy::copyRows(tout, thetab, nrow, 0, thetab.nrow());
1556 ROTableRow row(thetab);
1557 for ( uInt i=0; i<thetab.nrow(); ++i) {
1558 uInt k = nrow+i;
1559 scannocol.put(k, newscanno);
1560 const TableRecord& rec = row.get(i);
1561 Double rv,rp,inc;
1562 (*it)->frequencies().getEntry(rp, rv, inc, rec.asuInt("FREQ_ID"));
1563 uInt id;
1564 id = out->frequencies().addEntry(rp, rv, inc);
1565 freqidcol.put(k,id);
1566 String name,fname;Double rf;
1567 (*it)->molecules().getEntry(rf, name, fname, rec.asuInt("MOLECULE_ID"));
1568 id = out->molecules().addEntry(rf, name, fname);
1569 molidcol.put(k, id);
[961]1570 Float frot,fax,ftan,fhand,fmount,fuser, fxy, fxyp;
1571 (*it)->focus().getEntry(fax, ftan, frot, fhand,
1572 fmount,fuser, fxy, fxyp,
1573 rec.asuInt("FOCUS_ID"));
1574 id = out->focus().addEntry(fax, ftan, frot, fhand,
1575 fmount,fuser, fxy, fxyp);
[841]1576 focusidcol.put(k, id);
1577 }
1578 ++freqit;
1579 }
1580 ++newscanno;
1581 ++scanit;
1582 }
1583 ++it;
1584 }
1585 return out;
1586}
[896]1587
1588CountedPtr< Scantable >
1589 STMath::invertPhase( const CountedPtr < Scantable >& in )
1590{
[996]1591 return applyToPol(in, &STPol::invertPhase, Float(0.0));
[896]1592}
1593
1594CountedPtr< Scantable >
1595 STMath::rotateXYPhase( const CountedPtr < Scantable >& in, float phase )
1596{
1597 return applyToPol(in, &STPol::rotatePhase, Float(phase));
1598}
1599
1600CountedPtr< Scantable >
1601 STMath::rotateLinPolPhase( const CountedPtr < Scantable >& in, float phase )
1602{
1603 return applyToPol(in, &STPol::rotateLinPolPhase, Float(phase));
1604}
1605
1606CountedPtr< Scantable > STMath::applyToPol( const CountedPtr<Scantable>& in,
1607 STPol::polOperation fptr,
1608 Float phase )
1609{
1610 CountedPtr< Scantable > out = getScantable(in, false);
1611 Table& tout = out->table();
1612 Block<String> cols(4);
1613 cols[0] = String("SCANNO");
1614 cols[1] = String("BEAMNO");
1615 cols[2] = String("IFNO");
1616 cols[3] = String("CYCLENO");
1617 TableIterator iter(tout, cols);
[1384]1618 CountedPtr<STPol> stpol = STPol::getPolClass(out->factories_,
1619 out->getPolType() );
[896]1620 while (!iter.pastEnd()) {
1621 Table t = iter.table();
1622 ArrayColumn<Float> speccol(t, "SPECTRA");
[1015]1623 ScalarColumn<uInt> focidcol(t, "FOCUS_ID");
1624 ScalarColumn<Float> parancol(t, "PARANGLE");
[1384]1625 Matrix<Float> pols(speccol.getColumn());
[896]1626 try {
1627 stpol->setSpectra(pols);
[1015]1628 Float fang,fhand,parang;
1629 fang = in->focusTable_.getTotalFeedAngle(focidcol(0));
1630 fhand = in->focusTable_.getFeedHand(focidcol(0));
1631 parang = parancol(0);
1632 /// @todo re-enable this
1633 // disable total feed angle to support paralactifying Caswell style
1634 stpol->setPhaseCorrections(parang, -parang, fhand);
[1384]1635 // use a member function pointer in STPol. This only works on
1636 // the STPol pointer itself, not the Counted Pointer so
1637 // derefernce it.
1638 (&(*(stpol))->*fptr)(phase);
[896]1639 speccol.putColumn(stpol->getSpectra());
1640 } catch (AipsError& e) {
[1384]1641 //delete stpol;stpol=0;
[896]1642 throw(e);
1643 }
1644 ++iter;
1645 }
[1384]1646 //delete stpol;stpol=0;
[896]1647 return out;
1648}
1649
1650CountedPtr< Scantable >
1651 STMath::swapPolarisations( const CountedPtr< Scantable > & in )
1652{
1653 CountedPtr< Scantable > out = getScantable(in, false);
1654 Table& tout = out->table();
1655 Table t0 = tout(tout.col("POLNO") == 0);
1656 Table t1 = tout(tout.col("POLNO") == 1);
1657 if ( t0.nrow() != t1.nrow() )
1658 throw(AipsError("Inconsistent number of polarisations"));
1659 ArrayColumn<Float> speccol0(t0, "SPECTRA");
1660 ArrayColumn<uChar> flagcol0(t0, "FLAGTRA");
1661 ArrayColumn<Float> speccol1(t1, "SPECTRA");
1662 ArrayColumn<uChar> flagcol1(t1, "FLAGTRA");
1663 Matrix<Float> s0 = speccol0.getColumn();
1664 Matrix<uChar> f0 = flagcol0.getColumn();
1665 speccol0.putColumn(speccol1.getColumn());
1666 flagcol0.putColumn(flagcol1.getColumn());
1667 speccol1.putColumn(s0);
1668 flagcol1.putColumn(f0);
1669 return out;
1670}
[917]1671
1672CountedPtr< Scantable >
[940]1673 STMath::averagePolarisations( const CountedPtr< Scantable > & in,
1674 const std::vector<bool>& mask,
1675 const std::string& weight )
1676{
[1232]1677 if (in->npol() < 2 )
1678 throw(AipsError("averagePolarisations can only be applied to two or more"
1679 "polarisations"));
[1010]1680 bool insitu = insitu_;
1681 setInsitu(false);
[1232]1682 CountedPtr< Scantable > pols = getScantable(in, true);
[1010]1683 setInsitu(insitu);
1684 Table& tout = pols->table();
[1232]1685 std::string taql = "SELECT FROM $1 WHERE POLNO IN [0,1]";
1686 Table tab = tableCommand(taql, in->table());
1687 if (tab.nrow() == 0 )
1688 throw(AipsError("Could not find any rows with POLNO==0 and POLNO==1"));
1689 TableCopy::copyRows(tout, tab);
[1145]1690 TableVector<uInt> vec(tout, "POLNO");
[940]1691 vec = 0;
[1145]1692 pols->table_.rwKeywordSet().define("nPol", Int(1));
[1391]1693 //pols->table_.rwKeywordSet().define("POLTYPE", String("stokes"));
1694 pols->table_.rwKeywordSet().define("POLTYPE", in->getPolType());
[1010]1695 std::vector<CountedPtr<Scantable> > vpols;
1696 vpols.push_back(pols);
[1232]1697 CountedPtr< Scantable > out = average(vpols, mask, weight, "SCAN");
[940]1698 return out;
1699}
1700
[1145]1701CountedPtr< Scantable >
1702 STMath::averageBeams( const CountedPtr< Scantable > & in,
1703 const std::vector<bool>& mask,
1704 const std::string& weight )
1705{
1706 bool insitu = insitu_;
1707 setInsitu(false);
1708 CountedPtr< Scantable > beams = getScantable(in, false);
1709 setInsitu(insitu);
1710 Table& tout = beams->table();
1711 // give all rows the same BEAMNO
1712 TableVector<uInt> vec(tout, "BEAMNO");
1713 vec = 0;
1714 beams->table_.rwKeywordSet().define("nBeam", Int(1));
1715 std::vector<CountedPtr<Scantable> > vbeams;
1716 vbeams.push_back(beams);
[1232]1717 CountedPtr< Scantable > out = average(vbeams, mask, weight, "SCAN");
[1145]1718 return out;
1719}
[940]1720
[1145]1721
[940]1722CountedPtr< Scantable >
[917]1723 asap::STMath::frequencyAlign( const CountedPtr< Scantable > & in,
1724 const std::string & refTime,
[926]1725 const std::string & method)
[917]1726{
[940]1727 // clone as this is not working insitu
1728 bool insitu = insitu_;
1729 setInsitu(false);
[917]1730 CountedPtr< Scantable > out = getScantable(in, false);
[940]1731 setInsitu(insitu);
[917]1732 Table& tout = out->table();
1733 // Get reference Epoch to time of first row or given String
1734 Unit DAY(String("d"));
1735 MEpoch::Ref epochRef(in->getTimeReference());
1736 MEpoch refEpoch;
1737 if (refTime.length()>0) {
1738 Quantum<Double> qt;
1739 if (MVTime::read(qt,refTime)) {
1740 MVEpoch mv(qt);
1741 refEpoch = MEpoch(mv, epochRef);
1742 } else {
1743 throw(AipsError("Invalid format for Epoch string"));
1744 }
1745 } else {
1746 refEpoch = in->timeCol_(0);
1747 }
1748 MPosition refPos = in->getAntennaPosition();
[940]1749
[996]1750 InterpolateArray1D<Double,Float>::InterpolationMethod interp = stringToIMethod(method);
[917]1751 // test if user frame is different to base frame
1752 if ( in->frequencies().getFrameString(true)
1753 == in->frequencies().getFrameString(false) ) {
[985]1754 throw(AipsError("Can't convert as no output frame has been set"
1755 " (use set_freqframe) or it is aligned already."));
[917]1756 }
1757 MFrequency::Types system = in->frequencies().getFrame();
[940]1758 MVTime mvt(refEpoch.getValue());
1759 String epochout = mvt.string(MVTime::YMD) + String(" (") + refEpoch.getRefString() + String(")");
1760 ostringstream oss;
1761 oss << "Aligned at reference Epoch " << epochout
1762 << " in frame " << MFrequency::showType(system);
1763 pushLog(String(oss));
[917]1764 // set up the iterator
[926]1765 Block<String> cols(4);
1766 // select by constant direction
[917]1767 cols[0] = String("SRCNAME");
1768 cols[1] = String("BEAMNO");
1769 // select by IF ( no of channels varies over this )
1770 cols[2] = String("IFNO");
[926]1771 // select by restfrequency
1772 cols[3] = String("MOLECULE_ID");
[917]1773 TableIterator iter(tout, cols);
[926]1774 while ( !iter.pastEnd() ) {
[917]1775 Table t = iter.table();
1776 MDirection::ROScalarColumn dirCol(t, "DIRECTION");
[926]1777 TableIterator fiter(t, "FREQ_ID");
[917]1778 // determine nchan from the first row. This should work as
[926]1779 // we are iterating over BEAMNO and IFNO // we should have constant direction
1780
[917]1781 ROArrayColumn<Float> sCol(t, "SPECTRA");
[926]1782 MDirection direction = dirCol(0);
[917]1783 uInt nchan = sCol(0).nelements();
[926]1784 while ( !fiter.pastEnd() ) {
1785 Table ftab = fiter.table();
1786 ScalarColumn<uInt> freqidCol(ftab, "FREQ_ID");
1787 // get the SpectralCoordinate for the freqid, which we are iterating over
1788 SpectralCoordinate sC = in->frequencies().getSpectralCoordinate(freqidCol(0));
1789 FrequencyAligner<Float> fa( sC, nchan, refEpoch,
1790 direction, refPos, system );
1791 // realign the SpectralCoordinate and put into the output Scantable
1792 Vector<String> units(1);
1793 units = String("Hz");
1794 Bool linear=True;
1795 SpectralCoordinate sc2 = fa.alignedSpectralCoordinate(linear);
1796 sc2.setWorldAxisUnits(units);
[934]1797 uInt id = out->frequencies().addEntry(sc2.referencePixel()[0],
1798 sc2.referenceValue()[0],
1799 sc2.increment()[0]);
1800 TableVector<uInt> tvec(ftab, "FREQ_ID");
1801 tvec = id;
[926]1802 // create the "global" abcissa for alignment with same FREQ_ID
1803 Vector<Double> abc(nchan);
[917]1804 Double w;
1805 for (uInt i=0; i<nchan; i++) {
1806 sC.toWorld(w,Double(i));
1807 abc[i] = w;
1808 }
[926]1809 // cache abcissa for same time stamps, so iterate over those
1810 TableIterator timeiter(ftab, "TIME");
1811 while ( !timeiter.pastEnd() ) {
1812 Table tab = timeiter.table();
1813 ArrayColumn<Float> specCol(tab, "SPECTRA");
1814 ArrayColumn<uChar> flagCol(tab, "FLAGTRA");
1815 MEpoch::ROScalarColumn timeCol(tab, "TIME");
1816 // use align abcissa cache after the first row
1817 bool first = true;
1818 // these rows should be just be POLNO
[996]1819 for (int i=0; i<int(tab.nrow()); ++i) {
[926]1820 // input values
1821 Vector<uChar> flag = flagCol(i);
1822 Vector<Bool> mask(flag.shape());
1823 Vector<Float> specOut, spec;
1824 spec = specCol(i);
1825 Vector<Bool> maskOut;Vector<uChar> flagOut;
1826 convertArray(mask, flag);
1827 // alignment
1828 Bool ok = fa.align(specOut, maskOut, abc, spec,
1829 mask, timeCol(i), !first,
1830 interp, False);
1831 // back into scantable
1832 flagOut.resize(maskOut.nelements());
1833 convertArray(flagOut, maskOut);
1834 flagCol.put(i, flagOut);
1835 specCol.put(i, specOut);
1836 // start abcissa caching
1837 first = false;
[917]1838 }
[926]1839 // next timestamp
1840 ++timeiter;
[917]1841 }
[940]1842 // next FREQ_ID
[926]1843 ++fiter;
[917]1844 }
1845 // next aligner
1846 ++iter;
1847 }
[940]1848 // set this afterwards to ensure we are doing insitu correctly.
1849 out->frequencies().setFrame(system, true);
[917]1850 return out;
1851}
[992]1852
1853CountedPtr<Scantable>
1854 asap::STMath::convertPolarisation( const CountedPtr<Scantable>& in,
1855 const std::string & newtype )
1856{
1857 if (in->npol() != 2 && in->npol() != 4)
1858 throw(AipsError("Can only convert two or four polarisations."));
1859 if ( in->getPolType() == newtype )
1860 throw(AipsError("No need to convert."));
[1000]1861 if ( ! in->selector_.empty() )
1862 throw(AipsError("Can only convert whole scantable. Unset the selection."));
[992]1863 bool insitu = insitu_;
1864 setInsitu(false);
1865 CountedPtr< Scantable > out = getScantable(in, true);
1866 setInsitu(insitu);
1867 Table& tout = out->table();
1868 tout.rwKeywordSet().define("POLTYPE", String(newtype));
1869
1870 Block<String> cols(4);
1871 cols[0] = "SCANNO";
1872 cols[1] = "CYCLENO";
1873 cols[2] = "BEAMNO";
1874 cols[3] = "IFNO";
1875 TableIterator it(in->originalTable_, cols);
1876 String basetype = in->getPolType();
1877 STPol* stpol = STPol::getPolClass(in->factories_, basetype);
1878 try {
1879 while ( !it.pastEnd() ) {
1880 Table tab = it.table();
1881 uInt row = tab.rowNumbers()[0];
1882 stpol->setSpectra(in->getPolMatrix(row));
1883 Float fang,fhand,parang;
1884 fang = in->focusTable_.getTotalFeedAngle(in->mfocusidCol_(row));
1885 fhand = in->focusTable_.getFeedHand(in->mfocusidCol_(row));
1886 parang = in->paraCol_(row);
1887 /// @todo re-enable this
1888 // disable total feed angle to support paralactifying Caswell style
1889 stpol->setPhaseCorrections(parang, -parang, fhand);
1890 Int npolout = 0;
1891 for (uInt i=0; i<tab.nrow(); ++i) {
1892 Vector<Float> outvec = stpol->getSpectrum(i, newtype);
1893 if ( outvec.nelements() > 0 ) {
1894 tout.addRow();
1895 TableCopy::copyRows(tout, tab, tout.nrow()-1, 0, 1);
1896 ArrayColumn<Float> sCol(tout,"SPECTRA");
1897 ScalarColumn<uInt> pCol(tout,"POLNO");
1898 sCol.put(tout.nrow()-1 ,outvec);
1899 pCol.put(tout.nrow()-1 ,uInt(npolout));
1900 npolout++;
1901 }
1902 }
1903 tout.rwKeywordSet().define("nPol", npolout);
1904 ++it;
1905 }
1906 } catch (AipsError& e) {
1907 delete stpol;
1908 throw(e);
1909 }
1910 delete stpol;
1911 return out;
1912}
[1066]1913
[1143]1914CountedPtr< Scantable >
[1140]1915 asap::STMath::mxExtract( const CountedPtr< Scantable > & in,
1916 const std::string & scantype )
1917{
1918 bool insitu = insitu_;
1919 setInsitu(false);
1920 CountedPtr< Scantable > out = getScantable(in, true);
1921 setInsitu(insitu);
1922 Table& tout = out->table();
1923 std::string taql = "SELECT FROM $1 WHERE BEAMNO != REFBEAMNO";
1924 if (scantype == "on") {
1925 taql = "SELECT FROM $1 WHERE BEAMNO == REFBEAMNO";
1926 }
1927 Table tab = tableCommand(taql, in->table());
1928 TableCopy::copyRows(tout, tab);
1929 if (scantype == "on") {
[1143]1930 // re-index SCANNO to 0
[1140]1931 TableVector<uInt> vec(tout, "SCANNO");
1932 vec = 0;
1933 }
1934 return out;
1935}
[1192]1936
1937CountedPtr< Scantable >
1938 asap::STMath::lagFlag( const CountedPtr< Scantable > & in,
[1200]1939 double frequency, double width )
[1192]1940{
1941 CountedPtr< Scantable > out = getScantable(in, false);
1942 Table& tout = out->table();
1943 TableIterator iter(tout, "FREQ_ID");
1944 FFTServer<Float,Complex> ffts;
1945 while ( !iter.pastEnd() ) {
1946 Table tab = iter.table();
1947 Double rp,rv,inc;
1948 ROTableRow row(tab);
1949 const TableRecord& rec = row.get(0);
1950 uInt freqid = rec.asuInt("FREQ_ID");
1951 out->frequencies().getEntry(rp, rv, inc, freqid);
1952 ArrayColumn<Float> specCol(tab, "SPECTRA");
1953 ArrayColumn<uChar> flagCol(tab, "FLAGTRA");
1954 for (int i=0; i<int(tab.nrow()); ++i) {
1955 Vector<Float> spec = specCol(i);
1956 Vector<uChar> flag = flagCol(i);
[1200]1957 Int lag0 = Int(spec.nelements()*abs(inc)/(frequency+width)+0.5);
1958 Int lag1 = Int(spec.nelements()*abs(inc)/(frequency-width)+0.5);
[1192]1959 for (int k=0; k < flag.nelements(); ++k ) {
1960 if (flag[k] > 0) {
1961 spec[k] = 0.0;
1962 }
1963 }
1964 Vector<Complex> lags;
[1203]1965 ffts.fft0(lags, spec);
[1200]1966 Int start = max(0, lag0);
1967 Int end = min(Int(lags.nelements()-1), lag1);
[1192]1968 if (start == end) {
1969 lags[start] = Complex(0.0);
1970 } else {
1971 for (int j=start; j <=end ;++j) {
1972 lags[j] = Complex(0.0);
1973 }
1974 }
[1203]1975 ffts.fft0(spec, lags);
[1192]1976 specCol.put(i, spec);
1977 }
1978 ++iter;
1979 }
1980 return out;
1981}
Note: See TracBrowser for help on using the repository browser.