Technical planning
                      ------------------

The routines in this directory are for the technical planning of CDS
observations.  They allow the user to set up the details of a raster including
the definition of line lists and spectral windows.  

The procedure MK_RASTER [,structure] runs the complete set of programs.

An example of an ascii spectral lines file (which can be read in from within
mk_raster) is given in the file eg_ll_ascii.nis

See CDS software note #24 for further details

===========================================================================

As of 21-Apr-95 the files are:

 
 
 
Directory:  /sohos1/cds/soft/ops/plan/tech/
 
CHECK_WINDOWS     - Check the line_window structure to ensure completeness.
DASH_LINE()       - Turn a line image into a dashed line.
DEL_WINDOW        - Delete window definitions, ie. set contents to zero/blank.
DISPLAY_GIS_WIN   - Display GIS line-windows on the technical planning plot.
DISPLAY_NIS_WIN   - Display NIS line-windows on the technical planning plot.
ERASE_NIS_WIN     - Erase the NIS line-windows on the technical planning plot.
GET_VDS_WIN()     - Calculate VDS windows from data windows
GIS_DUMMY         - Creates dummy data array for CDS GIS spectrograph
GIS_IN_WINDOW()   - Decide which GIS line_window cursor is in, if any.
IN_WINDOW()       - Decide which line_window cursor is in, if any.
LOAD_TP_STRUCT    - Load the raster planning structure onto the screen widgets.
MK_RASTER         - Widget selection and definition of a CDS raster observation.
NIS_IN_WINDOW()   - Decide which NIS line_window cursor is in, if any.
RD_LINE_LIST      - Read a CDS line list into the line editor.
SEL_LINE_EVENT    - Processes events from the SEL_LINE_MENU.
SEL_LINE_MENU     - Defines the mk_raster line selection window.
SORT_WINDOWS      - Sort the technical planning line_window structure.
TP_BSCALE()       - Scales VDS data for display with TP_COLTABLE color table.
TP_CALC_COMP      - To calculate effect of compression on VDS data array
TP_CALL_HELP      - Put up a help window for widget event generated.
TP_CHK_RAST()     - Check feasibility of fundamental raster parameters.
TP_CLEAR_LINES    - Clears LINES/WINDOWS branches of tp_obs structure.
TP_CLEAR_RASTER   - Clears raster branch of structure used in the tech planning.
TP_CLEAR_STATE    - Clears STATE branch of structure used in the tech planning.
TP_COLBAR         - Displays colour bar on TPLAN screen.
TP_COLTABLE       - Loads a special color table for technical planning.
TP_DB2INT         - Transfer database line list structure to TPLAN internal.
TP_DISP_LLIST     - Defines display of database line lists.
TP_DISP_RAST      - Defines display of raster parameters.
TP_DISPLAY_DEW    - Defines the window to display Data Extraction Windows.
TP_DISPLAY_GP     - Defines the window to display VDS parameters.
TP_DISPLAY_VP     - Defines the window to display VDS parameters.
TP_DRAW_MESSAGE   - To put message in technical planning image area
TP_DUMP_SETUP     - Produce hardcopy of TPLAN setup structure.
TP_EDIT_LINES     - Widget to edit the technical planning lines list.
TP_EDIT_TABLE()   - 2-D array screen editor for technical planning.
TP_GET_DESC()     - Composes raster, variation and window descriptions.
TP_GET_DUMDATA    - Package to get dummy data for technical planning.
TP_GWIN_LOGIC     - Produce Data Extraction Windows for GIS
TP_KEY_EVENT      - Processes events from the TP_KEY_MENU.
TP_KEY_MENU       - Defines the security key window.
TP_LOAD_VDSBACK() - Loads default VDS background windows into structure.
TP_PLOT_DEW       - Plot the data extraction windows in a raster.
TP_PLOT_GIS       - Plots the spectral data from the CDS GIS detector.
TP_READ_HELP()    - Read a text help file.
TP_READ_TEXTW     - Reads TPLAN editable text widgets.
TP_RECALC_DEW     - Recalculate the data extraction (and VDS) windows.
TP_REDISPLAY      - To redisplay current image/plot.
TP_TP2INT         - Transfer line list structure within TPLAN structure.
TP_UPDATE_LINES   - Update the line_list2 structure in tp_obs.
TP_UPDATE_PIX     - Updates pixel values from wavelengths
TP_VDS_AXES       - Label VDS image with wavelength scales.
TP_VWIN_LOGIC     - Produce Data Extraction and VDS Extraction Windows
TP_WRT_DWIN()     - Store the data extraction definition into the database.
TP_WRT_FRAST()    - Store the fundamental raster definition into the database.
TP_WRT_LLIST()    - Store the line list definition into the database.
TP_WRT_VRAST()    - Store the raster variation definition into the database.
TPLAN_COM         - The common blocks include file for TP_PAGE1
TPLAN_STRUCT      - Define the structures used in the technical planning.
VDS_DUMMY         - Produce dummy VDS data in the form of a (1024,256) array.
WHICH_GIS_BAND()  - Determine which GIS band contains given wavelength.
WHICH_NIS_BAND()  - Determine which NIS band contains given wavelength.
ZONE_DEF_ID()     - Associates zone ID's with widget event values.
ZONE_DEF_LABEL    - Associates zone labels with ID numbers.