;---------------------------------------------------------------------------
; Document name: ST_SUMER.HLP
; Created by:    Liyun Wang, NASA/GSFC, October 9, 1996
;
; Last Modified: Sun Nov 10 17:10:42 1996 (LWANG@sumop1.nascom.nasa.gov)
;---------------------------------------------------------------------------
;

!Overview

		   SUMER Simulation Tool

This  SUMER  Simulation  Tool  is  designed  as  the  widget
interface to the SUMER technical and  photometric  simulator
and  to  SUMER command generator. It can be used to simulate
SUMER user defined programs (UDP) written in  SUMER  control
language (SCL). Simulated UDPs can be imported  or  exported
for   later  use.  When  running  on  the  designated  SUMER
operations  machine  (currently  SUMOP1), this tool can also
build  UDPs  and  studies into the Oracle database system on
which the whole SUMER  commanding  and  planning  tools  are
built.

To  do  any operation, you need to load in an UDP (in either
SCL code or in MMD format).

If you are running ST_SUMER on a non-operations machine, you
cannot register a simulated UDP with the SUMER database  nor
can  you  make  a study from the simulated UDP; you can only
simulate UDPs written in SCL. A simulated UDP is saved to  a
file in a special MMD format.  An UDP saved  in  MMD  format
can  be  later  imported  in  ST_SUMER  running  on  a SUMER
operations machine (SUMOP1) and registered  with  the  SUMER
database system and/or used to build new studies.

When you move the mouse cursor over an active widget  field,
you will get  an  interactive  instruction  in  "Interactive
Instruction" window on what that widget field does.

!Open SCL File

		       Open SCL File

UDPs written in SCL can be  loaded  into  ST_SUMER  via  the
"Open   SCL  File"  option  of  the  pull-down  menu  button
"File".  A widget program will appear allowing one to select
a SCL file from the disk.

!Import New UDP

		       Import New UDP

A simulated UDP is usually saved in a special format  called
MMD which can be imported to ST_SUMER.  Select  "Import  New
UDP" under the pull-down menu button "File" will bring up  a
widget program that allows you to select the desired UDP MMD
file from the disk.  If there is already an  UDP  loaded  in
ST_SUMER, it will be replaced by the newly loaded  one.  You
will be warned to avoid making any mistakes.

!Purge UDP Files

		      Purge UDP Files

This  operation  purges current-UDP related files (i.e., the
.SCL,  .OBJ,  and  .MMD files) and delete intermediate files
(.LST,  .MAP, .TOK, and .TRC files all TKI_SIM_OUTPUT files)
created in SCL compilation and simulation processes.

!Display SCL Code

		      Display SCL Code

Once  an UDP is loaded into ST_SUMER (in form of SCL file or
in MMD format), the SCL code of the UDP can be displayed  by
selecting   the   "Display   SCL   Code"  button  under  the
"Operations" menu button.

!Display Simulation Log

		   Display Simulation Log

Once an UDP is simulated, one can examine the simulation log
by  openning  the  simulation  log  file  via  the  "Display
Simulation  Log"  button under the "Operations" menu button.
Notice that for an imported UDP, the log file may not exist,
and choosing this operation is useless.

!Display UDP Structure

		   Display UDP Structure

Once  an  UDP  written  in  SCL  has been properly simulated
without  any  error, all information about the UDP itself is
saved  into  an  IDL  structure  which  can  be displayed by
selecting "Display UDP Structure" under the  pull-down  menu
button "Operations"; this will bring  up  a  widget  program
that  display  the  contents  of  the  UDP  structure  in  a
pull-down menu format.

!Display Spectral Range

		   Display Spectral Range

This operation displays the  photometrical  results  of  the
simulation.   This  display  contains  two windows, the left
window  shows  the  the  spectral range for SUMER in the 1st
order (quiet sun).   The  part  of  the  spectrum  which  is
currently visible for the choosen detector is  marked.   The
right  window  shows  the  marked  part  of  the spectrum in
detail.  Diffrent colors in this window  mark  the  diffrent
sensitive regions of the SUMER detector.

!Simulate UDP

		       Simulate UDP

If  you  only  intend to simulate the UDP you loaded in, you
can  select  the  "Simulate  UDP" option under the pull-down
menu button "Operations".  This will  start  the  simulation
process.   If  the  simulation  is successful, a special IDL
structure  will  be  created  which  can be used to save the
simulated UDP in  MMD  format  for  future  use.   This  UDP
structure can also be displayed via the option "Display  UDP
Structure" under the pull-down menu button "Operations".

Note: This simulation process is done automatically  if  you
choose the operation of "Register UDP" or "Make Study".

!Register UDP

			Register UDP

ST_SUMER  makes the process of creating a registered UDP for
use  in  SUMER  studies  extremely  easy.   You  just choose
"Register  UDP" from the pull-down menu button "Operations";
ST_SUMER  will  change  its  appearance  to  provide you UDP
associated fields (name, category, title, and purpose of the
UDP) to be filled.  Once those fields are filled, you simply
press  the  "GO!"   button  to  fire  off  the  UDP creation
process.  This will compile the SCL code of the UDP (if it's
not  compiled),  run  simulation  (if the simulation has not
been done), and register the UDP with  the  SUMER  database.
If there is no error during this process, the registered UDP
can be used directly in any SUMER  study.  

Notice that UDP associated information such as name,  title,
etc., is recorded/updated in a standard documentation header
in  SCL code.  If your UDP SCL code already has the standard
documentation  header,  those  UDP  related  fields  will be
filled in automatically.

This  "Register UDP" option is useful especially if you want
to create UDPs that will be used to build so-called compound
studies (studies that consist of multiple  UDPs  or  an  UDP
with other telemetry commands).  If you intend to  create  a
simplified study that uses only the UDP  you  are  about  to
make,  you  would be better off if you choose directly "Make
Study" instead.

Note:  This  option is available only when you run this tool
on SUMER operations machine  (SUMOP1),  home  of  the  SUMER
database system.

!Make Study 

			 Make Study

ST_SUMER   is   a   tool  designed  specially  for  creating
simplified studies from the scratch. A simplified  study  is
one  that consists of one (and only one!) UDP and optionally
a pointing sequence associated with the study.

Creating a simplified study with ST_SUMER is easy.  You just
choose  "Make  Study"  from  the   pull-down   menu   button
"Operations"; ST_SUMER will change its appearance to provide
you study-associated  fields  (name,  category,  title,  and
purpose  of  the  UDP)  to be filled. You will also have the
choice of whether to include a  pointing  sequence  in  your
study. Once those fields are filled, you  simply  press  the
"GO!"   button to fire off the study creation process.  This
will compile the SCL code of the associated UDP (if it's not
compiled), run simulation (if the simulation  has  not  been
done),  and register the associated UDP and the study itself
with the SUMER database. If there is no  error  during  this
process, the registered study will be ready to be  scheduled
to run with the SUMER Planning Tool.

Note:  This  option is available only when you run this tool
on  SUMER  operations  machine  (SUMOP1),  home of the SUMER
database system.

