This directory contains the spectrograph description and script wrapper.

PARAMETERS:

    The following spectrograph parameters may be used.

          title - Title used for labeling of output.
    description - Multiple lines of text used for documentation of output.
     tablescale - Factor by which to multiply the table values.
      apmagdisp - Aperture magnification in dispersion direction. [1]
     apmagxdisp - Aperture magnification in cross dispersion direction. [1]

    [1] The aperture magnifications are normally absent.  Any grating
    magnification along the dispersion is determined by the program.  These
    parameters are intended to be used in cases where the aperture
    mechanism (such as the slit plate) is tilted for viewing and the user
    input is the unprojected slit size.  For instance if the slit is tilted
    about the long axis the "apmagdisp" would be the cosine of the tilt to
    convert input sizes to projected size.  These parameters could be used
    for other purposes and other optical magnification effects.

    The following parameters are default values for program parameters given
    as INDEF (for inoutangle and xinoutangle) or "" for the table parameters.
    This provides a convenient way to fix certain parameters so they do not
    have to be specified in the program parameters.  However, specifying in
    the program parameters overrides the values in this file.

     inoutangle - Incident to diffration angle for primary grating. [1]
    xinoutangle - Incident to diffration angle for cross disperser grating. [1]
            sky - Sky brightness table/spectrum.
     extinction - Extinction table.
      telescope - Telescope table.
            adc - ADC table.
         filter - Primary filter table.
        filter2 - Secondary filter table.
       aperture - Aperture table.
          fiber - Fiber table.
     collimator - Collimator table.
      disperser - Disperser table.
     xdisperser - Cross-disperser table.
      corrector - Corrector table.
         camera - Camera table.
       detector - Detector table.

    [1] The incident to diffraction angle for a single grating is the camera
    to collimator angle.  However, with cross dispersion gratings the angles
    may be different.

TABLE:

    The spectrograph table has two columns, the wavelength in Angstroms and the
    fractional transmission at that wavelength.  For values in percent use
    a "tablescale" parameter of 0.01.  If no table is given then 100%
    transmission at all wavelengths is assumed.

    In most cases all the transmission components are given in other
    tables; telescope, collimator, camera, detector, etc.  The table in the
    spectrograph file provides a place for 1) any components not taken into
    account in the other tables, 2) a place to put final fudge corrections,
    and 3) if desired this could be the only table used apart from the
    filter, grating, and detector tables.

EXAMPLE

    # title = "4-m R-C Spectrograph"
    # telescope = KPNO/Telescopes/mayall4m
    # collimator = KPNO/Collimators/rcspec
    # camera = KPNO/Cameras/uvfast
    # detector = KPNO/Detectors/t2kb
    # extinction = KPNO/kpextinct
    # sky = KPNO/kpsky
    # aperture = slit
    # inoutangle = 46 deg

SYNTAX:

    Comment lines begin with '#' and can contain any text and can occur
    anywhere in the file, though normally found at the beginning.

    Parameters are comment lines with the form

	# <parameter> = <value>

    where whitespace is required between each field, <parameter> is a single
    word parameter name, and <value> is a single word value.  A quoted string
    is a single word so if the value contains whitespace it must be quoted.
    Any text following the value is ignored.

    The optional table is a multicolumn list of numeric values.  The list
    must be in increasing order in the independent columns.  Only 1D (two
    columns) and 2D (three columns) tables are currently supported.  2D
    tables must form a regular grid.  The table will be interpolated.
    Extrapolation outside of the table consists of the taking the nearest
    value; thus, a single line defines a constant value for all values of
    the independent variable.  If a "tablescale" parameter is specified
    then the table values are multiplied by this value.
