!Overview
EIS Science Planning Tool

The EIS Science Planning Tool is designed for scheduling and
editing EIS studies for any given operational day. The plot
window typically shows two timelines. The upper timeline is
the reference line and typically shows the EIS science plan.
This line is NOT editable. The lower timeline is editable,
and can show the EIS DETAILS, FLAG, SCIENCE or ALT-DETAILS
plans. The choice of reference and editable plan is
selectable via the CUSTOMIZE button.

To create a plan entry, you must first decide what study to
load and when to load it. The following is a typical
sequence of operations:

(1) If you are starting from scratch, and/or no study is
currently displayed in the timeline, then you must select a
study from the database by pressing the "Load/Select Study"
entry in the "Study" menubar. Choose from the resulting menu
of available studies. Once selected, the parameters of the
study will be loaded into the corresponding text widgets
(Study ID, Acronym, Title, etc).

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

(3) Use the LEFT mouse cursor to specify the time at which
to start* the planned study. The cursor position will appear
as a yellow vertical line, and it's corresponding value will
be printed in the text widget labelled "Cursor Time". You
can also manually type the start time of the planned study
in this field.

* Note that you do not have to specify a stop time for a
DETAILS entry. This is because the study duration is a fixed
parameter (shown in the STUDY_DUR text field). For a SCIENCE
entry, 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.

(4) You must enter a SCIENCE objective for the planned
study. 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 ("Cursor Time").

(5) Finally, add the study to the timeline by acessing the
"Study" menubar  and selecting either the "Insert at cursor
position" or "Append to higlighted entry" options. In the
former case, the study entry is TIME-TAGGED at the cursor
position and will be locked at that time. In the latter
case, the study is UNTIME-TAGGED and will always follow the
study before it.


!Colours
Meaning of Colours

YELLOW -- denotes the current plan entry that is loaded into
memory and, by default, the plan entry that will be edited.
Clicking on a plotted entry will highlight it in this color.

ORANGE -- denotes reference plans and resources displayed in
the optional upper plot. These are not editable in this
window.

GREEN -- denotes UN-TIME-TAGGED plan entries. These apply
only to DETAILED plans.

RED -- denotes a Time-Tagged study

CYAN -- denotes a non Time-Tagged study

!Copying an Entry
Copying an Entry

Having selected an entry on the timeline, place the cursor
at the desired time. Select "Copy" from the "Study" menu
on the main-menu.

!Metadata Key
!!Blah
Metadata Key

OBSTITLE
Format        : String
Unit/Option   : Free Style (one sentence)
Data Source   : CO or Proposer of the observation
Description   : Tile of the observation

OBS_DEC
Format        : String
Unit/Option   : Free Style
Data Source   : CO or Proposer of the observation
Description   : Describe the properties of the observation

JOIN_SB
Format        : String
Unit/Option   : ESX, ES, SX, EX, E, S, X
Data Source   : CO or Proposer of the observation
Description   : Indicate the joint observation of the
                instruments on board Hinode

JOP_ID
Format        : Integer
Unit/Option   : -
Data Source   : Science Coordinator
Description   : Joint observations between Hinode and other
                instruments will be sequentially numbered

NOAA_NUM
Format        : Integer
Unit/Option   : -
Data Source   : CP
Description   : The NOAA Active Region number for AR
                observations

OBS_ID
Format        : Integer
Unit/Option   : -
Data Source   : CO or Proposer of the observation
Description   :

SCI_OBJ
Format        : String
Unit/Option   : List of acronyms
Data Source   : CO or Proposer of the observation
Description   : Scientific objective of the observation

!Credits
John Rainnie     - RAL
Khalid Al Janabi - MSSL
Matthew Whillock - MSSL
David Brooks     - NRL/ISAS
David Williams   - MSSL/ISAS
Peter Young      - RAL
