next up previous 623
Next: SURF_WRITE_MAP_INFO - Calculate FITS and WCS information for rebinned image
Up: Library APIs
Previous: SURF_SET_APP_NAME - Set application name for NDF history


SURF_WRITE_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. It is called as part of the EXTRACT_DATA task. 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) and subsets can be extracted by using SCUBA sections.

Invocation:
CALL SURF_WRITE_DATA( FD, NPTS, IN_DATA, IN_VARIANCE, BOL_RA, BOL_DEC, STATUS )

Arguments:

FD = INTEGER (Given)
Output file descriptor
NPTS = INTEGER (Given)
Number of points in input data
IN_DATA( NPTS ) = REAL (Given)
Data value
IN_VARIANCE( NPTS ) = REAL (Given)
Variance on data
BOL_RA( NPTS ) = DOUBLE (Given)
Bolometer position (radians offset from map centre)
BOL_DEC( NPTS ) = DOUBLE (Given)
Bolometer position (radians offset from map centre)
STATUS = INTEGER (Given and Returned)
The global status

Notes:
For each file name that is entered, values for the parameters SELECT_INTS, WEIGHT, SHIFT_DX and SHIFT_DY are requested.
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
Copyright
Copyright ©1995,1996,1997,1998,1999 Particle Physics and Astronomy Research Council. All Rights Reserved.


next up previous 623
Next: SURF_WRITE_MAP_INFO - Calculate FITS and WCS information for rebinned image
Up: Library APIs
Previous: SURF_SET_APP_NAME - Set application name for NDF history

SURF Programming Interface
Starlink System Note 72
Tim Jenness, John F. Lightfoot
Joint Astronomy Centre, Hilo, Hawaii
10 July 2000
E-mail:ussc@star.rl.ac.uk

Copyright © 2008 Science and Technology Facilities Council