Working with data files

SMURF does not itself enforce a naming scheme on files. However, raw data from ACSIS and SCUBA-2 obey a well-defined naming scheme. The convention is as follows: the name is composed of an instrument prefix, the UT date in the form YYYYMMDD, a zero-padded five-digit observation number, followed by a two-digit sub-system number (ACSIS only) and a zero-padded four-digit subscan number, all separated by underscore characters. The file has an extension of .sdf. The instrument prefix for ACSIS is simply a. For SCUBA-2 it is a three-character string dependent on the particular subarray from which the data were recorded. The SCUBA-2 subarrays are labelled a-d at each wavelength, which are coded by a single digit (either 4 or 8 for 450 and 850$\mu$m data respectively); thus the SCUBA-2 prefix is s[4|8][a-d].

Example ACSIS filename: a20090620_00023_01_0002.sdf
Example SCUBA-2 filename: s8a20090620_00075_0001.sdf

Files can be processed either singly or in batches. It is more efficient to process multiple files at the same time. To work with multiple files you can specify them in a text file using group file indirection syntax (the `^' caret before the filename), using shell wildcards (escaped from the shell itself) or by listing them explicitly separated by commas. For more information on specifying groups of objects for input and output see the section Specifying Groups of Objects in SUN/95. Examples of valid inputs are:

IN=s8a20090620_00075_0001.sdf
IN=s8a20090620_00075_*
IN=s8a20090620_00075_00??
IN=file1,file2
IN=^myfile.lis
OUT=*_out

Note that if you are providing a text file containing output filenames, those should be listed in the same order as the input filenames, otherwise the processed data will be written under the wrong filenames. Take care to supply a different output file name from the input as the contents are overwritten!