BoA Template Documentation

STANDARD COMMANDS

You have to execute the file "laboca.boa" in order to define the following functions:

redsky, redfoc, redmfoc, redpnt, redweak, redcal, redmap, redscans, redMultiScans, redbeam, do00, skyquality

---

• redsky(ScanNr)

SKYDIP. Reduces a bolotip (hot+skydip) measurement with LABOCA. ScanNr is mandatory. As a output result you will receive the tau_z (optical detph). If tau_z is not specified, it will make a calculation taking as a reference the Precipitable Water Vapor (PWV) from the radiometer.

boa> redsky (23979)

After the command processes some calculations. You will receive the following information: boa< I: ---- skydip results ---- boa< I: Signal corrected using blind bolos boa< I: Coupling = 68.56 % boa< I: tau_z = 0.252 23979 2013-04-23T10:57:38 56405.4566995602 0.328

---

• redfoc(ScanNr)

FOCUS. Reduces a focus measurement with LABOCA, ScanNr is mandatory.

boa> redfoc (38808)
(focus on Saturn, i.e. Z axis). Necessary when wfz (wobbler focus) or fz was executed. For the other axis will be: wfy or fy and wfx or fx.

After the command processes some calculations. You will receive the following information: boa< I: plotting signal boa< I: Offset : 0.03 +- 0.00 boa< L: Parabola: a + b x + c x^2, a = 1630.1260 b = 73.2230 c = -1089.4720 boa< I: plotting signal boa< I: Offset : 0.03 +- 0.00 boa< L: Parabola: a + b x + c x^2, a = 1622.6423 b = 71.7645 c = -1094.2611 ###################### # fcorr 0.03, 'Z' ######################

---

• redmfoc(ScanNr,tau)

FOCUS (mapping mode). Reduces a focus observed in spiral-mapping mode with LABOCA. ScanNr is mandatory. Optional parameters: zenith opacity, list of subscans(5).

boa> redmfoc (19099,0.3)
(mapfocus on CW-Leo, i.e. Z axis). Reduces five subscans and then it shows the result of the parabolic fit giving the focus correction. Command executed: mfz

After the command processes some calculations. You will receive the following information: boa< L: Building a map with dimensions (x,y) = 51,51 boa< I: Peak Flux = 2.68959260967 boa< I: Delta Az ["] = 11.4150479371 boa< I: Delta El ["] = 1.58871752512 boa< I: FWHM_1 ["] = 35.4476296125 boa< I: FWHM_2 ["] = 28.8686971322 boa< I: Tilt [deg] = -37.2578085008 boa< I: map r.m.s. = 0.128217 boa< I: Offset : -0.02 +/- 0.02 (based on peak flux) boa< I: Offset : 0.02 +/- 0.01 (based on FWHM) ###################### # fcorr 0.01, 'Z' ######################

---

• redpnt(ScanNr,tau)

POINTING. Reduces a LABOCA map on a pointing source. ScanNr is mandatory. Optional parameters: Zenith opacity.

boa> redpnt (21355)
(pointing on Carina), pspiral, pspirall observing commands.

---

• redweak(ScanNr,tau,sm)

POINTING on a weak source. Reduces a LABOCA map on a pointing source. ScanNr is mandatory. Optional parameters: Zenith opacity, smoothing kernel (in arcsec).

boa> redweak (54259)
(pointing on J2202+421), spiralras, spirallras observing commands.

After the command processes some calculations. You will receive the following information: ##################### Sensivity: 56.5 mJy sqrt(s) ##################### boa< L: Building a map with dimensions (x,y) = 67,67 boa< I: Smoothing with 6.0 arcsec kernel. boa< I: Peak flux = 4.86201387205 boa< I: Delta Az ["]= -0.228862117625 boa< I: Delta El ["]= 0.721317131701 boa< I: FWHM_1 ["]= 23.7307764341 boa< I: FWHM_2 ["]= 20.6500872117 boa< I: Tilt [deg]= 38.6484914869 boa< I: map r.m.s. = 0.134647 #################### # pcorr -0.2, 0.7 #################### Row inserted in database No opacity value passed, using ATM model: tau_z = 0.240

---

• redcal(ScanNr,tau)

MAP for calibration/pointing. Reduces a LABOCA map on a secondary calibrator. ScanNr is mandatory. Optional parameters: Zenith opacity.

boa> redcal (38820) Secondary Calibrator
(pointing on G5.89), spiralras, spirallras commands.

After the command processes some calculations. You will receive the following information: Solving for pointing on map... boa< I: Peak flux = 30.7083795459 boa< I: Delta Az ["]= 0.545900520491 boa< I: Delta El ["]= 3.49988528025 boa< I: FWHM_1 ["]= 23.8951778225 boa< I: FWHM_2 ["]= 22.989820119 boa< I: Tilt [deg]= 33.77425287673 boa< I: map r.m.s. = 0.920395 ------------------------------------------------------------------------ FLUX G5.89: 30.71 [expected: 27.60, 111.26 percent] ------------------------------------------------------------------------ pcorr 0.5,3.5 No opacity value passed, using ATM model: tau_z = 0.235

boa> redcal (54255) Primary Calibrator (planet)
(pointing on Uranus), pspiral, pspirall commands.

After the command processes some calculations. You will receive the following information: --------------------------------------------------------------------------- FLUX URANUS: 73.64 [expected: 65.88, 111.77 percent] --------------------------------------------------------------------------- pcorr -1.0, -0.6 No opacity value passed, using ATM model: tau_z = 0.241

---

• redmap(ScanNr,tau,ra1,ra2,dec1,dec2)

MAP. Reduces a LABOCA map on target source. ScanNr is mandatory. Optional parameters: Zenith opacity, ra1,ra2,dec1,dec2 = abs. Map limits in degree.

e.g. boa> redmap (1234,tau=0.3,ra1=190.4,ra2=190.2,dec1=-63.1,dec2=-62.9)
e.g. boa> redmap (1234)

---

• redscans([Scan1,Scan2...],[tau1,tau2..])

MAP. Reduces multiple scans (LABOCA map) on a target source and coadds the data. Optional parameters: Scan numbers (list), zenith opacity single value or list. Map size is determined by the first scan in the list.

---

• redMultiscans([ [Scan1,Scan2],[ ]...],[tau1,tau2..])

Reduces multiple LABOCA map on a target source and coadds the data.
1 --> [scan1,scan1N] first group tau
2 --> [scan2,scan2N] second group tau
N --> [scanN,scanNN] N group

The format to execute the macro:
redMultiScans(ScanList=[ [scan1,scan1N],[scan2,scan2N] ], update=1, smooth=18.0, calfile='', taufile='', modelfile='', weak=1, covclip=0.25, writeScans=0, update=1, ra1=0, ra2=0, dec1=0, dec2=0), update=1
Read a codded map file, when this option is used the ra1,ra2,dec1,dec2 should be define too.
ra1,ra2,dec1,dec2: the values are defined from the first scan reduced and saved in the log file.
Modelfile: Remove data model from the data, it can use after the first primary reduction.

---

• redbeam(ScanNr,tau)

BEAM-MAP. Reduces a LABOCA beam-map, i.e. a fully sampled OTF map on planet. ScanNr is mandatory. Optional parameters: Zenith opacity.

---

• ([do00(ScanNr1,ScanNr2],tau),weak,filename,update

ON-OFF Reduction.
NAME: doOO (function), it processes a list of ON-OFF scans.
For this specific command, please refer to another page clicking here

---

• skyquality(ScanNr,refCh)

Print measure of sky noise in sec. and min. scale. This macro gives an estimate of the quality of the sky. It prints two numbers: sky emission rms on scales of 1 sec and 1 min.

INPUT: scanNr is mandatory, refCh (optional, default = 71), time2: time (in sec.) for 2nd time scale (default = 30), doplot: if true, it generates plots showing signals, sliding mean, and the difference (default: doplot=1)

OUTPUT: returns scanNr, meanPWV, result1, sdev1, result2, sdev2.

---