;---------------------------------------------------------------------------
; Document name: MK_SOHO.HLP
; Created by:    Liyun Wang, GSFC/ARC, April 21, 1995
;
; Last Modified: Thu Jul 20 17:13:14 1995 (lwang@achilles.nascom.nasa.gov)
;---------------------------------------------------------------------------
;

!Overview
		 SOHO Science Planning Tool

The SOHO Science Planning Tool is designed  for  displaying,
scheduling, and editing Science plans  for  several  related
SOHO instruments for any given  operational  day.   It  also
displays  other  information  such  as  DSN  contact   time,
commanding time, ground observatory support time,  etc,  all
saved in the database.  Science plans are displayed in color
coded way for easy recognition. The choice of  timelines  to
be displayed is selectable via the "Customize  Plot"  option
under the "OPTIONS" button.

To edit or modify any plan entry, you must  switch  to  Edit
Mode by  selecting  the  "Edit"  button  below  the  display
window.

The following is a typical sequence of operations to  create
a plan entry:

(1) Select the instrument for which plan entried are edited.

(2) If you are starting from scratch, and/or no  plan  entry
is currently displayed in the timeline, then you must fill
necessary fields on the left of the display. Among those
fields, you have to determine start/stop time of the plan to
be executed. 

(3) If you want to use a plan entry that already appears in
the editing timeline, then you can automatically load it's
parameters by positioning the cursor on the entry. The
corresponding entry will be highlighted in YELLOW.

(4) Use the MIDDLE mouse cursor to specify the time at which
the plan starts. The cursor position will appear as a yellow
vertical dotted-dash line, and it's corresponding value will
be printed in the text widget labelled START_TIME.  You  can
also manually type the start time of the  planned  study  in
this field.

You must also specify a stop time by using the  RIGHT  mouse
cursor. The cursor position will appear as a yellow vertical
dashed line, and it's corresponding value will be printed in
the text widget labelled STOP_TIME.  You can  also  manually
type the stop time of the planned study in this field.

(5) You must enter  a  SCIENCE  objective  for  the  planned
entry. You can do this manually by  pressing  the  "SCI_OBJ"
button and choosing from the available list. If  this  field
is left blank, then the  program  will  search  the  SCIENCE
database for a science objective at the current cursor  time
(CUR_TIME).

(6) Finally, press the "ADD" button to write  the  entry  to
the database. A pulldown menu will give you  the  choice  of
either inserting the entry at the current  cursor  position,
or  appending  it  to  the  last  entry  before  the  cursor
position.

Some important safety tips:
---------------------------

* If the STOP_TIME of a new entry extends over into the next
entry, then the new entry  will  be  terminated  before  the
start of the subsequent plan entry. 

!FILE 

Through this pull-down menu button,  you  can  1)  save  the
current plan form in  different  formats,  or  2)  quit  the
program.

!OPTIONS

Under the Options button, you can 1) make new  plan  entries
by cloning from existed one on a given  day;  2)  run  IMAGE
TOOL to take a look at the most recent solar images from the
SOHO synoptic solar  image  database;  3)  display  or  hide
current UT line, local  time,  or  day  boundary  lines;  4)
customize the display; 5) Refresh the display.

!Display Mode
		       Display Mode

In display mode, you can reveal the content of a plan  entry
by moving the cursor over the plan and  clicking  the  mouse
button. Notice that the time line can be shifted forward  or
backward by month, week, day, or hour by clicking those time
buttons below the display. Time span of  the  diaply  window
can be changed through the "TIME SPAN" button.

!Edit Mode
			 Edit Mode

In edit mode, one can display and edit the  content  of  any
plan entry shown on the display window. Notice that the time
line can be shifted forward or backward by month, week, day,
or  hour  by  clicking  those   time   buttons   below   the
display. The time span of the diaply window can  be  changed
through the "TIME SPAN" button.

To edit a plan entry, one needs to select it by  moving  the
cursor over the plan and clicking the mouse cursor.  Once  a
plan is selected, it will be highlighted on the display; its
contents are shown in fields on  the  left  of  the  display
window.

The start time of a plan entry can be  changed  by  clicking
the middle mouse button at the  desired  time  line,  or  by
manually entering desired values to the START_TIME widget (a
carriage  return  is  required  for  the  editing  to   take
effect). A dot-dashed yellow line will appear at the desired
timeline. One can also change interactively  the  start
time of a plan through the "Shift" button.

The stop time of a plan entry can be changed by clicking the
right mouse button at the desired time line, or by  manually
entering desired values to the STOP_TIME widget (a  carriage
return is required for  the  editing  to  take  effect).   A
dashed yellow line will appear at the desired timeline.  The
"Shift" feature can  also  be  used  to  change  stop  time.
Notice that the stop time  of  a  plan  entry  can  also  be
changed when one changes the duration of the  plan  (through
the "PLAN DUR." widget).

The duration of the plan can be changed directly by manually
entering desired values to the "PLAN DUR." widget.  Whenever
the use changes start or stop time of  the  plan,  the  plan
duration is also changed accordingly. The plan duration  can
be displayed (by pressing and choosing the unit  button)  in
units of seconds, minutes, or hours.

Fields such as SCI_OBJ, SCI_SPEC, DISTURB, and NOTES can  be
edited directly or by pressing the corresponding  button  to
select from a predefined list.

The following editing operation can be performed: Append  or
Insert, Remove, Move, Shift, Replace, Copy, Clear and Reset.
See related help topics for details.

!Add
		    Append/Insert Button

Add a new entry into the DB. The plan  entry  can  be  added
such that its start time is  the  current  cursor  time,  or
appended to the current entry block or to last  plan  before
the current cursor time.

!Remove
		       Remove Button

Remove the highlighted plan entry from DB.


!Replace
		       Replace Button

Replace a highlighted plan with the current edited plan.

!Copy
			Copy Button

Copy a highlighted plan. Once this button is pressed, a  box
cursor will  appear  at  the  location  of  the  highlighted
plan. The user can drag the box by moving  the  mouse  while
pressing the left mouse button. Once the box cursor is moved
to the desired time, the user clicks the right mouse  button
to write the copied plan to the DB. Notice that a plan entry
for one instrument can be copied to another instrument.

!Move
			Move Button

Manually move  a  highlighted  plan  to  a  new  start  time
indicated by CUR_TIME, or  graphically  by  dragging  a  box
cursor. (N.B. the original plan will  be  deleted  from  the
DB). Note that you can only move a plan entry  in  the  same
instrument timeline. 

The current cursor  time  CURSOR  TIME  can  be  changed  by
clicking the left mouse button at the desired time  line  or
by editing the time value directly (don't forget  to  hit  a
return when edit is done) in the "CUR. TIME" widget.



!Shift
			Shift Button

Shift a highlighted  plan  in  time.  Once  this  button  is
pressed, the button name changes to "COMMIT". The  user  can
shift the highlighted plan forward or backward  by  pressing
and dragging the middle mouse button. The  user  can  change
the start/stop time of the plan by pressing and dragging the
left  mouse  button  nearest  the  start/stop  time  of  the
plan. Press "COMMIT" to implement the shift.

This  button  is  similar  to  "MOVE",  but  has  the  extra
capability for changing the duration of the plan entry.

!Clear
			Clear Button

Clear all plan entries that are loaded into the  memory,  or
that are shown in the display window, from the DB. Use  with
caution.

!Reset
			Reset Button

Clean out the contents of  plan  field  widgets  and  reload
entries from the DB.

;---------------------------------------------------------------------------
; End of 'MK_SOHO.HLP'.
;---------------------------------------------------------------------------
