MAPSUM - Produce one-line summary of SCUBA map observations

Description:

Mapsum goes through all the sdf files in the current directory and, optionally, DATADIR (defined in an environment variable) and summarizes files containing map observations.

In the absence of the $-$all flag, a numeric range is requested. This range only has an effect on raw data or reduced files which have the run number embedded into the file name. Filenames with no numbers are treated as scan 0.

Usage:

mapsum [-h] [-demod] [-reduced] [-all$\vert$[-begin nn -end nn]]

Parameters:

$-$h[elp]

Return a help message only. More help can be obtained by using `showme sun216' or `scuhelp mapsum'.

$-$all

List all map files in the current directory and $DATADIR

$-$demod

Only list demodulated data files (signified by _dem_ file name)

$-$reduced

Only list reduced data files (signified by _red_ file name)

$-$begin nn

First scan number to be considered (same as $--$begin==nn)

$-$end nn

Final scan number to be considered (same as $--$end=nn)

Examples:

mapsum

Ask for a range of scan numbers and then give a summary of every MAP file matching this criterion in DATADIR and the current directory.

mapsum $-$all

Generate a summary of all map files in the current and DATADIR directory.

mapsum $--$begin=5 $--$end=100

Generate a summary of all map data from scans 5 to 100 inclusive.

mapsum $-$all $-$reduced

Produce a one line summary of all reduced (_red_) map files.

mapsum $-$all $-$reduced $>$ log.txt

Produce a one line summary of all the reduced map files and store the output in the text file log.txt (note this example is shell specific).

mapsum $-$all $-$reduced $-$demod

Produce a summary of all reduced (_red_) and demodulated (_dem_) map data files (ie not files produced during off-line data reduction).

Notes:

• mapsum only displays map data.

• Files are drawn from the current working directory and the directory indicated by the $DATADIR environment variable.

• Data reduced by the off-line system will all be treated as run 0 for the purposes of listing unless numbers are present in the filename.

• The output can be stored in a file by using unix redirection as long as the search range is fully specified (either as `$-$all' or with `$-$begin' and `$-$end').

• Command line options can be abbreviated.

• Options that take values can be used either as `$-$flag option' or as `$--$flag=option'

Related Applications

SURF: sculog, photsum, pointsum, obssum, skysum