!Adjust LUT

             Adjust LUT
             ----------

    VDS data are displayed as a 2-d image.  The lookup
    table employed as default is a special which can be
    loaded with the routine tp_coltable.

    If you wish to change this, click on the 'Adjust
    LUT' button and the standard routine XLOADCT will
    be loaded.

    Note that the original LUT can be reloaded via an
    option in the 'Reset' menu.


!Check database

               Checking a database
               -------------------

    Not implemented yet.

    Eventually this function will allow the user to 
    check whether a database entry already exists
    that matches the current details in the mk_raster
    windows.



!Compression

               Compression
               -----------

    To reduce the amount of CDS data that has to be
    telemetered down, several data compression
    schemes have been provided in the on-board
    software.

    The menu allows the user to specify which
    compression scheme is to be used, together with, in
    some cases, a selection of the particular mode of
    operation for that scheme.

    The actual compression factors achievable by each
    of the schemes are TBD on real CDS data.

    In the meantime for the purposes of calculating the
    telemetry requirements, the following assumptions
    are made:

           Scheme                Compression factor
      1 (straight copy)                 1
      2 (truncate 12 bits)              1.33
      3 (VBWL - all options)            2.0
      4 (Sum over lines)            defined by window size
      5 (Sum over window)           defined by window size


!Display data

             Display data
             ------------

    The data displayed in the technical planning
    program can be representative of a number of
    sources as observed with different setups.

    At present only dummy data are available (via the
    programs vds_dummy and gis_dummy).  When
    calculating these data the exposure time and slit
    width are taken into account.  Dummy data are
    stored in the users own directory.



!Display GIS band

             Display GIS band
             ----------------

    In order to interact with GIS data, only one band
    of data may be displayed (a warning message is
    given otherwise).  Set the band to be displayed
    using these buttons.  

    For purely display purposes, all four bands can be
    displayed by selecting 'All'.




!Display mode

                      Display mode
                      ------------

    These buttons allow the user to change the mode of
    display of the data.

    ALL - means that the full wavelength range of data
    will be displayed and line windows will be
    superimposed upon that display.


    WINDOWS - means that only data within the defined
    line windows will be displayed.  For the VDS they
    are still displayed in their 'correct' location
    within the overall maximum possible image area. 
    For the GIS, separate plots are given for each
    window - these can quickly become illegible when
    the number > 4

    FLAGS - signifies that only the data from 
    windows designated as flag windows are to be
    displayed.  See FLAG mode under 'Window 
    interaction mode'.


!Exit

                  Exit
                  ----

    When MK_RASTER is finished you may either chose a quiet
    exit, in which case no further action is taken
    before leaving the program, or you may opt to store
    the internal structure which defines the current
    MK_RASTER setup in an IDL save file for later use.


  

!Exposure time

           Exposure time
           -------------

    Use the slider to set the exposure time (in
    seconds) required.  The range of values selectable
    on the slider is controlled by the "Exposure range"
    menu.

    Note that the maximum exposure for the VDS is 1023
    seconds.

    If you don't like sliders, the required value may
    also be typed in the exposure time display box.


!GIS default extraction

                  GIS default extraction
                  ----------------------
    Use the buttons provided to select ALL the data 
    from the selected detector.  This is done 
    independently of whether any spectral lines are
    selected in that region and this setting
    overrides the existence of any spectral lines.

    For instance if you switch on selection of all
    GIS1 data, you will get all GIS1 data (see the
    plot of data extraction windows) even if 
    some particular spectral lines are also defined
    within the range of GIS1.


!Instrument

              Instrument
              ----------

    The CDS has two instruments, the Normal Incidence
    and Grazing Incidence Spectrographs (NIS or GIS).  

    The NIS covers the wavelength regions (310-380)A
    and (517-633)A in two  separate spectra.

    The GIS has four detectors covering the ranges 
    155 - 224
    261 - 346 
    395 - 496 
    662 - 787 A respectively.

    Use the Instrument select buttons to switch between
    defining rasters and data extraction windows for
    the two instruments.

    Various other selectable items are only relevant to
    one instrument or the other. The appropriate
    windows to allow their selection are made available
    when the instrument is chosen.



!Line lists

           Line lists
           ----------

    The concept of line lists is required because of
    the limited telemetry available to CDS.  It will
    very rarely be appropriate to telemeter the whole
    of a VDS image to ground.  The GIS is less affected
    since the volume of possible data is so much less.

    Because of this limitation it is anticipated that
    particular wavelengths of interest will be
    specified and only a few pixels surrounding those
    wavelengths will be transmitted (cf window width).

    The group of wavelengths (lines) expected to be
    useful for a particular study is known as the line
    list for that study.  

    Note that because each line in a line list is
    associated with a data extraction window, the
    number of lines possible in a line list is limited
    by the telemetry format to  a maximum of 48 for GIS
    and 24 for NIS.  The maximum number allowed for NIS
    is further reduced to 20 if the background windows
    are enabled.  The only way to include more wavelengths
    is to widen the extraction windows so that each window
    has the potential of covering more than on spectral
    line.

    Using MK_RASTER it is possible to modify these lists or
    to create lists from scratch.  It will be possible
    to access these 'user-made' lists by retrieving
    them from the line list database (cf 'Select from
    databases').



!Mirror/Slit step sizes and number

              Mirror/Slit step sizes and number
              ---------------------------------

    Enter in the boxes provided the sizes of steps to
    be made by the Mirror and Slit during a raster. 
    The values are in arcseconds.  One slit step
    corresponds to approximately 1 arcsec and a mirror
    step to approximately 2 arcsecs.  The number of
    sample points in the raster should also be entered
    as required.  

    NB.  The step size and number of locations are NOT
    applicable to rasters which use the NIS - these
    boxes are therefore not editable when that 
    instrument is selected.

    Remember to enter the NUMBER of sample points for
    each mechanism NOT the number of steps to be made
    with each mechanism. A degenerate raster (ie a
    single sample position) will, therefore, have (1,1)
    mirror and slit positions and the step size will be
    irrelevant.  A raster with (3,3) positions and a
    step size of (10,10) arcseconds will sample data
    over only a (20,20) arcsecond area (neglecting the
    actual slit size).


  

!Reset

            Reset
            -----

    A reset menu is provided to allow various parts (or
    all) of the MK_RASTER parameters to be reset to default
    values.  The reset only affects the internal
    storage within MK_RASTER and is not communicated to
    other programs in any way - until MK_RASTER is exited
    that is.



!Selection from databases

          Selection from databases
          ------------------------

    All of the information required for and created by
    the technical planning will be kept in small
    databases accessible from within IDL.  

    The IDL database software described in CDS Software
    note #10 is used  to create and access these
    databases.  

    As an example, there will be one database which
    will store the details of rasters already defined
    by the technical planning software.  To save the
    work of defining a new raster from scratch it may
    be desirable to load the parameters of a
    previously-defined raster and then to modify them
    using MK_RASTER.

    The "Select from databases" menu will allow the
    user to select an entry from a particular database
    and to have it loaded into MK_RASTER for use as is or
    for modifying.

    At the moment the interface to the databases is not
    available.



!Slits 
                        
             Slits 
             -----

    The choice of which slit to use is made by a
    pull-down-menu selection.  CDS has 6 slits
    available, and each detector can use any of the
    six.

    The numerical values quoted in parentheses are the
    slit sizes in arcseconds.

    It is anticipated that the NIS will normally be
    used with the long (240 arcsec) slits and the GIS
    with the smaller 2 or 4 arcsec long slits.

    The large (90x240) slit is intended for
    overlappagram type images.



!Store Definition

            Store Definition
            ----------------

    When the details of a raster, raster variation or
    line list (and its dependant data extraction
    windows) have been defined to the user's
    satisfaction, they may be transferred to the
    databases (assuming the user has the correct key
    code) by selecting from this menu.




!Technical planning overview

                 Technical planning overview
                 ---------------------------

    The procedure MK_RASTER is the CDS technical planning
    tool.  It is designed to allow the user to define
    all of the parameters needed to describe the
    technical aspects of a CDS observation with either
    instrument.

    It can take one argument which maybe either an
    input or output variable.  If, on input, the
    parameter is a structure of the correct type, the
    details contained in it will be loaded onto the
    screen at startup.  The observation setup as
    defined at the time of exit from MK_RASTER will be
    returned in the parameter (even if it was not of
    the correct type originally).  The definition of
    the structure is given in the file tplan_com.pro.

    The form of the structure is such that it
    corresponds closely to the structures contained in
    the various IDL databases to be used with the
    planning software.  There are, in addition, some
    tags which are for MK_RASTER internal use only viz.
    vds_win, line_w, flaf_w.

    MK_RASTER also communicates directly with the IDL 
    databases in order to load new definitions and 
    to restore previous ones.  

    This version of the software has been run on a DEC
    workstation (Ultrix) and a DEC Alpha (OSF) with
    both version 3.0 and 3.5 of IDL.  For the 
    IDL3.5/Alpha combination a code size of at least
    42000 is needed ie. enter .size 42000 5000 before
    trying to run MK_RASTER.


!User/CDS databases
 
              USER/CDS Databases
              ------------------

    This button toggles between allowing usage of
    'official' CDS databases or private user ones.
    No security pass is needed for use of private
    databases.

    To use this facility, two environment variables
    must be set up.  The variable ZDBASE_CDS is set
    in the /cs/login file and points to the project
    databases.  The environment variable ZDBASE_USER
    must be set in the user's own .login file to 
    point to the directory where the private databases
    are kept.  MK_RASTER switches the definition of ZDBASE
    to be either of those as requested by the user.
    On exit, MK_RASTER returns the definition of ZDBASE to
    it value on entry to MK_RASTER.



!VDS background windows

           VDS background windows
           ----------------------

    Use these buttons to determine whether VDS
    background windows will be used in the data
    extraction scheme or not.

    In normal operation the VDS CCD is read out in 4
    quadrants using separate electronics for each
    quadrant.  This leads to a different bias level in
    the digitised data in each quadrant which must be
    subtracted from the data before any flat-fielding
    or linearity corrections can be made.  The
    determination of these bias values requires that
    some unilluminated part of each quadrant of the CCD
    be read out.

    To allow this, the option is given to request 4
    readout windows in addition to any windows defined
    in the spectra.

    These windows are square and only one is permitted in
    each quadrant.  The location and initial size of these
    additional windows are defined in the file 
    $CDS_PLAN_TECH/vds_background.def.  The format is the
    same as for the definition of the windows within the IDL
    observation structure ie (xst,yst,xlen,ylen).  It is
    possible to change the size of these background boxes by
    clicking on the 'resize' button in the 'VDS background'
    widget.

    Note that the selected data extraction windows and
    corresponding VDS hardware windows can be seen by
    selecting "VDS Parameters/Plot extraction windows". If
    this display is active when the windows are being
    resized, the new size will be plotted when the mouse
    button is released from the slider.

!VDS default extraction

             VDS default extraction
             ----------------------

    It is possible to specify that you want wholesale
    extraction of the VDS data (either all spectral
    band 1 or all band 2 or all the CCD) by setting
    these buttons.  They will override any spectral
    line selections within that band.  See the plot of
    data extraction windows to see what you have done.



!VDS parameters

             VDS parameters
             --------------

    The VDS has a number of parameters which are
    selectable but which are expected to remain the
    same for considerable lengths of time eg until some
    hardware consideration (fault) dictates that things
    should change.


    The VDS ORIENTATION determines whether the data are
    extracted from the CCD by rows or columns.  This
    has certain advantages for some of the compression
    techniques.


    The CDHS MAP option allows VDS data to be read from
    the CCD into memory and then telemetered down
    (normal) or for the data to stay in memory and be
    accumulated with the next exposure's data. (I
    think???)


    The VDS READOUT mode under normal operations is
    expected to be 'quadrant' - see help on VDS
    background.  It is anticipated that only a hardware
    anomaly will force a change from this.


    The MCP VOLTAGE affects the gain of the detector
    and certain calibrations (eg linearity) are
    voltage-dependant.


    Owing to optical misalignments the two VDS spectra
    will not lie exactly parallel to the CCD rows and
    will not abut at the CCD centre.  The VDS OFFSETS
    are provided to allow the data extraction windows
    to find the spectra when they are not at the
    nominal position.

    Note that the offset in the 300A range is
    considered negative ie it moves the location of the
    actual spectrum away from the CCD centre row.

    It is possible to see the current setup of these
    parameters by selecting "See current values". 
    These values are updated whenever there is a change
    of any of the items.


    PLOT EXTRACTION WINDOWS allows the user to see the
    extraction windows and VDS hardware windows that
    result from the current setup.


!Window Height

             Window Height
             -------------

    For the VDS spectra it is possible to limit the
    extent of the spatial information retrieved from
    the long slit images.  The 'normal' (2x240) VDS
    slit will give spectral information from a region
    along the slit covering 240 arcseconds.  If for
    some reason a smaller spatial coverage is required,
    use the window height parameter to change the
    extent of the spatial data returned.  A single
    value will apply to all windows.

!Window Interaction Mode

                 Window interaction mode
                 -----------------------

    In order for the user to be able to interact via
    the cursor with the display window in a variety of
    ways, the mode of interaction must be explicitly
    set.   Set one of these mutually exclusive buttons
    to select that mode.  Note that for GIS no
    interaction is allowed until the display is in
    single-band mode - see "Display GIS band".

    ADD - will add a line to the current line list
    (this can be used to start a line list as well). 
    The line window will have the characteristics as
    defined by the current MK_RASTER settings.  The line
    will be centred on the clicked cursor position.  A
    maximum of 20 lines is currently accepted.

    DEL - will delete a line from an existing list.  In
    this mode just click on any pixel within the line
    window to have the line deleted.

    MOV - allows the user to move line windows around. 
    Click on any pixel within the line window to 'pick
    up' the line.  The line will be moved to a position
    centred on the cursor when the cursor button is
    released. It will not simply be moved by a distance
    corresponding to the cursor movement from button
    press to release. Note that windows cannot move
    from one spectrum to another, in other words only
    the horizontal value of the cursor is read.

    ID - gives details of the spectral line contained
    within the window or just details of the cursor
    position and the data value at that point if the
    cursor is not within a defined window.

    FLAG - will nominate as a flag window any window
    identified (up to a maximum of 3). To clear the
    flag window definitions, use the RESET option.

    PROF - will enter the profile display mode. 
    Currently only uses crudest profiling routine.
    Will be upgraded when Stein Vidar rejoins the fray.
    Exit by pressing the right hand mouse button.

