Here are instructions on how to install and use the BoA reduction package
for ArTeMiS data.

First, move the file boa_artemis.tgz to your $BOA_HOME directory.
Then, uncompress it there:

> tar xzvf boa_artemis.tgz

This will create a sub-directory artemis, which contains the reduction
routines and some helper files; and this will add ArTeMiS RCP files to
the $BOA_HOME/rcp directory.

Then, you can start a BoA session from anywhere. You then have to execute
the file $BOA_HOME/artemis/artemis.boa:

boa> boadir = os.getenv('BOA_HOME')
boa> execfile(boadir+'/artemis/artemis.boa')

Now you should point the BoA input directory to where your raw data are
located:
boa> indir('<some dir that contains the raw data in MB-FITS format>')

Then you can call the ArTeMiS reduction function, e.g.:
boa> redcal(<scan num>)            # to reduce a calibration scan at 350 micron
boa> redcal(<scan num>, band=450)  # to reduce the same scan at 450 micron
boa> redsky(<scan num>)            # to reduce a skydip scan at 350 micron

To reduce your science data, you have to do for each scan:
boa> process(data,<scan num>)
or:
boa> process(data,<scan num>,band=450)
then compute a map with fixed limits for each scan, and finally co-add
all maps together. The full reduction procedure could like for example
like this:

boa> # Initialisations:
boa> scanlist = range(scan1,scanN + 1)
boa> maplist = []
boa> x1,x2,y1,y2 = ...  # limits in EQ of your final map
boa> # Now start the loop:
boa> for snum in scanlist:
....     process(data,snum,weak=1)
....     data.doMap(system='eq',oversamp=3,sizeX=[x1,x2],sizeY=[y1,y2])
....     maplist.append(copy.deepcopy(data.Map))

boa> finalmap = mapsumfast(maplist)
boa> finalmap.writeFits('result.fits')


Notes:
 - these procedures have been developed for the data taken in 2016, but
 should also work (to some extent...) with older data;
 - you need a working version of the Gildas software in order to reduce
 calibration scans on planets;
 - you need an internet connection in order to derive the opacity from
 the PWV values contained in the data files (that is the default,
 otherwise you need to provide a value of tau to correct for opacity).

IMPORTANT NOTE:
You can get more details on all input parameters for every procedure
by doing:
boa> print <procedure name>.__doc__

If you still need more help, you can contact Frederic Schuller at:
fschulle@apex-telescope.org

########################################################################