SCUBA_SUFFIX

Most SURF tasks automatically constructs a default output filename based on the input filename (rebin bases the output filename on the object name). In this way it is possible for the filename to reflect the data reduction history.⁵The SCUBA_SUFFIX environment variable can be used to select the preferred method to use for constructing the output name.

Table: Output file suffices for each task.

Task	Suffix
	SHORT	LONG/VERBOSE
reduce_switch	onn1	onn
flatfield	f	_flat
restore	r	_res
extinction	_???_x2	_???_ext
remip	i	_ip
remsky	s	_sky
despike	d	_dsp
despike2	d	_des
scuclip	c	_clip
scan_rlb	b	_rlb
scuphot	p	_pht
change_data	a	_cdata
add_dbm	2_thr_pa3	_dbm_thr_pa

¹ nn = observation number

² ??? = first three letters of the selected sub-instrument (e.g. lon, sho, p20, p11, p13)

³ These include the throw and position angle of the chop to be added to the data.

Three modes are available:

SHORT

In this mode, the output filename is constructed by appending the short suffix related to the current task to the input filename.

LONG

In this mode, the output filename is constructed as follows:

1. Remove everything from the last underscore to the end of the input string.
2. Append the long task suffix

For example, for scuclip an input string of o15_lon_ext would become an output string of o15_lon_clip (i.e. the trailing _ext has been replaced with _clip. This method ensures that the length of the filename does not grow out of control during the data reduction. Additionally, if the suggested output filename would be the same as the input (e.g. by running scuclip successively), a `-' is appended to the string so that the two can be distinguished.

This is the default method (and is used by scuquick).

VERBOSE

In this mode, the output filename is constructed by appending the long suffix related to the current task to the input filename. This means that the filename becomes longer and longer as the reduction proceeds.

The method of choice can be selected by setting SCUBA_SUFFIX to one of the above values (case independent) e.g.:

% setenv SCUBA_SUFFIX verbose

The suffix strings related to each task and mode are detailed in table and typical examples from a data reduction are shown in table . Currently modes LONG and VERBOSE share the same suffices but use them in different ways.

Table: Filenames generated from a typical data reduction. Each row demonstrates how the filename is constructed from the previous row. An observation number of 15 is used in this example.

Task	Short	Long	Verbose
reduce_switch	o15	o15	o15
flatfield	o15f	o15_flat	o15_flat
extinction	o15f_lon_x	o15_lon_ext	o15_flat_lon_ext
scuclip	o15f_lon_xc	o15_lon_clip	o15_flat_lon_ext_clip
remsky	o15f_lon_xcs	o15_lon_sky	o15_flat_lon_ext_clip_sky
despike	o15f_lon_xcsd	o15_lon_dsp	o15_flat_lon_ext_clip_sky_dsp
despike	o15f_lon_xcsdd	o15_lon_dsp-	o15_flat_lon_ext_clip_sky_dsp_dsp
rebin	3c279	3c279	3c279