Atacama Pathfinder EXperiment APEX
MPIfR Bonn   ESO   Onsala Space Observatory

Home > Instrumentation

BoA Template Documentation


Kindly provided by Dr. Thomas Stanke (ESO)

As soon as you unpack the file template_boa.tar.gz, you will see the next configuration:

This, it will create two subdirectories: raw and boa. Within boa, it will create two more subdirectories: reduced and calib. Then copy your raw data to the 'raw' directory.

Important: The first thing you have to do is to change the names of the raw data files back to their original names containing the scan numbers. There's a little script to do that called:, and then you can run BoA.

account:> cd boa
account boa:> boa

There are a bunch of macros and calibration files, some of which you will have to modify to your local stuff. Most of the things you will have to change are in the YOURSOURCE_parameters.boa macro. Mainly, you'll have to update the 'PROJDIR' variable, the scan list and few more parameters neccesaries for adjusting to your project. Edit YOURSOURCE_parameters.boa and change them according to your needs.

Other macro routines:

It has provided macros for the first 2 iterations; from those it should be easy to create the macros for the next iterations (usually is like 10-35, depending on the source properties). It is not necessaary to mask the region around bright source emission in any of the iterations; you can either check the outcome of the first iteration to see if the despiking did cut off some of the brightest source emission and then repeat the first iteration with more careful settings for the despiking, or flag the area around bright sources as you did before; this should only be necessary in the first iteration, as later the source emission will be subtracted with the model.

* Things to be updated for the next iteration:

in red_scan_n.boa:

- base(order=2, subscan=0) (degree of baseline can be set higher; if you set subscan=1 it will subtract the baseline subscan by subscan rather than on the entire scan; don't set the baseline order too high if you use subscan=1)
- nbloop=2 can be set higher (in medianNoiseRemoval, correlbox, correlgroup) - more brutal despiking - you may also want to try out the other skynoise removal algorithms, but there is not much experience with those...

in comb_n.boa:

- SMOOTHBY = 12./3600. (you should somewhat reduce the smoothing applied in higher iterations to get point sources modeled better; e.g., reduce the Size by 1 arcsec in each iteration)

* Concerning flux calbration:

You need a Laboca_opacities.dat file which contains tau values from skydips; you can either download one here, calibration web page or make one yourself. You also need a LabocaCalibratorsForBoA.dat file which contains corrective factors to the flux calibration obtained from observations of flux calibrator sources (which you can also downloaded from here, (same webpage), or make one yourself - but make sure that you either use BOTH from the webpage or BOTH made yourself, to make sure you did things consistently).