EXTRACT_DATA - Write bolometer positions and values to text file

Description:

This routine writes the value, variance and position of each data point to a ASCII file. The interface is the same as that used in the rebin task. The data and variance are in volts. The positions are in radians. The data are written out as columns: RA DEC DATA VAR

Parameters:

FILE = FILENAME (Write)

The name of the ASCII file used for storing the data.

IN = CHAR (Read)

The name of the input file to be rebinned. This parameter is requested repeatedly until a NULL value (!) is supplied. LOOP must be TRUE. IN can include a SCUBA section. Like the REF parameter this parameter accepts a text file.

LAT_OUT = CHAR (Read)

The latitude of the output map centre. The supplied default value is that of the map centre of the first map.

LONG_OUT = CHAR (Read)

The longitude of the output map centre. The supplied default value is that of the map centre of the first map.

LOOP = LOGICAL (Read)

Task will ask for multiple input files if true. Only REF is read if noloop.

MSG_FILTER = CHAR (Read)

Message filter level. Allowed values are QUIET, NORM and VERB. Default is NORM. There are no verbose messages.

OUT_COORDS = CHAR (Read)

The coordinate system of the output map. Available coordinate systems are:

• AZ: Azimuth/elevation offsets

• NA: Nasmyth offsets

• PL: RA/Dec Offsets from moving centre (e.g. Planets)

• RB: RA/Dec (B1950)

• RJ: RA/Dec (J2000)

• RD: RA/Dec (epoch of observation)

• GA: Galactic coordinates (J2000)

REF = CHAR (Read)

The name of the first NDF to be rebinned. The name may also be the name of an ASCII text file containing NDF and parameter values. See the notes. REF can include a SCUBA section.

SHIFT_DX = REAL (Read)

The pointing shift (in X) to be applied that would bring the maps in line. This is a shift in the output coordinate frame.

SHIFT_DY = REAL (Read)

The pointing shift (in Y) to be applied that would bring the maps in line. This is a shift in the output coordinate frame.

WEIGHT = REAL (Read)

The relative weight that should be assigned to each dataset.

Notes:

For each file name that is entered, values for the parameters SELECT_INTS, WEIGHT, SHIFT_DX and SHIFT_DY are requested.

• The application can read in up to 256 separate input datasets.

• No data is returned if the DATA or positions are bad. Data is still returned if Variance is bad.

ASCII input files

The REF and IN parameters accept ASCII text files as input. These text files may contain comments (signified by a #), NDF names, values for the parameters WEIGHT, SHIFT_DX and SHIFT_DY, and names of other ASCII files. There is one data file per line. An example file is:

file1{b5}	1.0	0.5	0.0	# Read bolometer 5 from file1.sdf
file2				# Read file 2 but you will still be
				# prompted for WEIGHT, and shifts.
file3{i3}-	1.0	0.0	0.0	# Use everything except int 3
test.bat				# Read in another text file

Note that the parameters are position dependent and are not necessary. Missing parameters are requested. This means it is not possible to specify SHIFT_DX (position 3) without specifying the WEIGHT. Also note that SCUBA sections can be specified with any input NDF.

Related Applications

SURF: rebin, bolrebin, intrebin, change_quality