Description

COLDEN can be run over the WWW using a browser, such as Netscape, or run locally using the command-line interface (CLI). The CLI version will accept a text file with a list of positions as input.

COLDEN is part of the Proposal toolkit. The toolkit is distributed with CIAO.

SUPPORTED DATASETS

There are two datasets supported: Bell and NRAO.

Bell is the Stark, et al, velocity-resolved Bell Labs survey. An early version of the spectra from 1984 is used. Please note that these have not been checked in detail against the published FITS data (ApJ Suppl. 79, p77, 1992). There are two data files, one integrated over velocity and one with the velocity-resolved spectra. Note that the Stark et al data only covers Dec > -40 degrees.

NRAO is the Dickey and Lockman 1990 (ARA&A, 28, p.215) all-sky interpolation of Stark, et al, and several other surveys. This dataset is not velocity-resolved.

AVAILABLE COORDINATE SYSTEMS

The available coordinate systems are: Equatorial or Ecliptic with Besselian Epoch (default is J2000, or specify as 'BXXXX'), Equatorial or Ecliptic with Julian Epoch (default is J2000, or specify as 'JXXXX'), or Galactic. For a detailed description of the available coordinate systems, see the ahelp file for prop-coords.

RUNNING COLDEN OVER THE WWW

COLDEN can be accessed via the URL

http://cxc.harvard.edu/toolkit/colden.jsp

General help information is available by clicking the 'HELP' button.

RUNNING COLDEN FROM THE COMMAND-LINE

The syntax for processing a file of coordinates is:

prop_colden commands:infile:outfile

The syntax for evaluating a single position is:

prop_colden data dataset eval position

See the EXAMPLES section for more information.

To run COLDEN in the interactive CLI mode, type 'prop_colden' at the Unix prompt. This enters an interactive command mode for setting program parameters. The command level prompt is Colden[Setup]>:. Within the command level, type '?' or 'help' to see a list of the available commands, and type 'list' or 'l' to display the current program settings.

INPUT COMMANDS

The most usual command sequence is 'data', 'from', and 'convert', which can be abbreviated as 'd', 'f', and 'c', respectively. The 'data' command selects the survey source, either 'Bell' or 'NRAO'. When using the Bell survey, you can select the velocity range using the command 'vlims [vlmin] [vlmax]'. The command 'vlims *' returns the velocity slice to its default (maximum) range of -550 km/s to +550 km/s. The from command defines the Input coordinate system (J2000 is the default).

The 'convert' command enters the processing level. Within the processing level, enter the Input coordinates in the appropriate format, either both coordinates on the same line separated by spaces or a comma, or the x-coordinate on one line and the y-coordinate on the next. The default format for RA and DEC is hh mm ss.ss and dd mm ss.ss. The default format for the other coordinate systems is decimal degrees.

OTHER COMMANDS

The 'p' command sets the output display mode: use 'p0' for terse, 'p1' for normal, or 'p2' for verbose display. The default output display mode is p1.

To leave the processing level and return to the command level, type 'q' or 'quit'. Type 'q' or 'quit' at the command level to exit the program.

COLDEN RESULTS

COLDEN computes three values: Galactic L2 (in decimal degrees), B2 (in decimal degrees), and NH (in units of 1e+20 per cm**2). COLDEN also provides a comment that describes the computation. The possible comments are:

• Interpolated - Value interpolated from four nearest measurement directions.
• At target - Measurement in exactly the specified column direction.
• At closest point - Measurement in observed direction closest to the specified column direction; the specified direction does not have four nearest measurement directions suitable for interpolation.
• Gain uncertain - Specified column direction is less than 0.2 deg from the equator (B1950); measurements near the equator in the Stark, et al Bell survey (ApJ Suppl. 79, p77, 1992) may suffer from large gain fluctuations.
• Too far south - No value computed -- Specified column direction is at least 40.0 deg south of the equator (B1950); the Stark, et al Bell survey (ApJ Suppl. 79, p77, 1992) used a Northern Hemisphere telescope.