SURF - SCUBA User Reduction Facility
Up: SCUBA software
SURF is the SCUBA off-line data reduction package, developed at the Joint
Astronomy Centre, and is used to convert SCUBA raw (demodulated) data to the
final form. Supported observing modes are MAP (SCAN and JIGGLE), PHOTOM,
SKYDIP, NOISE and the JIGGLE/MAP versions of POINTING, FOCUS and ALIGN.
 SURF version 1.6-7 is now available.
In this page:
Three documents have been written to aid in the use of SURF. These documents
are available in postscript and html. The SURF Users' Guide (postscript;
compressed)
is the main source with the SCUBA
Photometry Cookbook (postscript;
compressed)
providing additional information on the reduction of photometry data and the
SCUBA mapping cookbook (postscript;
compressed)
providing information on the reduction of JIGGLE/MAP and SCAN/MAP data. There
is also a SURF programming guide available (SSN/72). Note that although these
manuals have been released as Starlink
documents any comments should be directed to the Joint Astronomy Centre.
SURF is a stand-alone package but is designed to run in a Starlink software environment. The main
implication of this is that SURF expects the presence of the Starlink KAPPA
package for general data manipulation and display. SURF can be run entirely
stand-alone, but it would not then be possible to examine data during the data
reduction stages (this is not recommended). Starlink software is readily
available (link to Starlink), and it is recommended that the Starlink packages
KAPPA and CONVERT are also installed on
any system using SURF. Kappa is a set of general routines for manipulating and
displaying NDF files (useful for examining data before generating a final
image) and Convert can be used to convert the NDF data (either photometry or
image data) to another format (such as FITS, IRAF or ASCII). In addition it
would also be useful to install hdstrace in case it is necessary to
examine the contents of the NDF file (data and extensions).
All this software can be obtained as standalone modules from the Starlink software
store or by obtaining a CD-ROM of
the complete Starlink software distribution (the Starlink environment will run
directly from the CD).
The SURF software can be obtained as source
code and binary distributions. Binary distributions are available for Sun
Solaris 8 (Sparc), Alpha
Digital Unix and Linux
(Intel)(RedHat 6(glibc)).
These links will pick up the latest version available from JAC (currently v1.6-7).
The
latest Starlink release is version 1.6-3 and can be obtained from the
Starlink software store. This software
follows the standard Starlink
installation procedure and installation instructions are provided
here.
To extract the full potential from the SURF software it is also necessary to
download and install the perl NDF module. This
module will only build on sites with the Starlink software system
installed. Binary distributions are available from the
Starlink software store. Without
NDFPERL the system can not provide observation summaries (sculog), automated
data reduction (scuquick) or scan map reduction (remdbm).
All released versions of SURF can be obtained from the
JCMT software ftp area.
The current release of SURF is v1.6-7 (released April 2001).
This software is actively supported at
the JCMT and upgrades will be released as they become available. Requests
for new features are welcome and they can be submitted by using the
SCUBA software wish-list.
Up: SCUBA software
Tim Jenness
Last modified: Tue May 15 15:21:36 HST 2001
|
