
!Overview
		 CDS Science Planning Tool

The CDS Science Planning Tool  is designed for
scheduling and editing CDS studies for any given
operational day. The plot window typically shows two
timelines. The upper timeline is the reference
line and typically shows the CDS science plan.
This line is NOT editable. The lower timeline is
editable, and can show the CDS 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 New Study" button and
choosing from the resulting menu of available
studies. Once selected, the parameters of the
study will be loaded into the corresponding text
widgets (STUDY_ID, STUDYVAR, 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 dotted
line, and it's corresponding value will be
printed in the text widget labelled CUR_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 (CUR_TIME).

(5) Finally, press the "ADD" button to write the
study to the database. A pulldown menu will give
you the choice of either inserting the study at
the current cursor position, or appending it to
the last entry before the cursor position. 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. 

!Safety tips

* If the END TIME of a new study extends over
into another study that is TIME-TAGGED, then the
new study will be terminated prematurely before
the start of the subsequent study. If the
subsequent study is NOT TIME-TAGGED, then it's
start time will be delayed until the new study is
completed. Note that SCIENCE and FLAG studies are
always treated as TIME-TAGGED.

* If you try to insert a study between two
TIME-TAGGED studies then you may get an error: 

"Cannot Cannot ADD/INSERT entry. Insufficient space"

In this case, you should either make room by
manually shifting the start time of the second
study, or untime-tagging the second study.

!Operations

!! CLONE A Set of Plans

Clone a set of plan entries in units of days

!! COPY A Set Of Plans

Copy a set of plan entries by setting start and stop cursors

!! CUSTOMIZE Display Window

Customize plot window with additional information (e.g. DSN, other expt plans)

!! DELETE A Set Of Plans

Delete a set of plan entries by setting start and stop cursors

!! HARDCOPY IMAGE_TOOL Window

Hardcopy currently displayed IMAGE_TOOL window

!! HARDCOPY Timeline Window

Hardcopy display window

!! IMPORT plan
 
Import plans from an exported file

!! LIST Plans Displayed In Editing Row

List parameters of plan entries in editing timeline

!! MK_STUDY - Create New Study

Call MK_STUDY tool to create new studies

!! MOVE A Set Of Plans

Move a set of plan entries by setting start and stop cursors

!! PRINT Highlighted Plan Entry To File

Print defining parameters of currently highlighted plan entry

!! PRINT Plan Summary For XCAT

Print summary listing of detailed plan entries
      
!! PRODUCE Study Briefing

Print defining parameters of current study

!! REFRESH Display

Replot display window

!! RESET Fields & REREAD Databases

Reset all edited fields and reread databases (Full Reset)

!! UPDATE Resources From Latest KAP

Update latest DSN and commanding times from ECS KAP files

!! UPDATE SCIENCE Plan With DETAILS Plan

Update SCIENCE plan start/stop times, objectives, cmp_no, etc with
corresponding DETAILED plan entries

!! XCAMP - View And Update Campaigns

View and update latest campaign database listing from SOC

!! XCAT  - View FITS Catalog/Data

View FITS catalog listing and run Quicklook software

!! XCPT  - Run Command Preparation Tool

Run CPT to produce Table Load files for uplinking plans

!! XIAP  - Write Instrument Activity Plan

Write and submit Instrument Activity Plan (IAP) to ECS planning tool

!! XPORT - Export Plans

Export SCIENCE and DETAILED plans

!Load New Study

Load a new study from the CDS databases


!Image Tool

Examine latest SOHO and Synoptic images
and specify pointing for a study

!Add
		    Insert/Append Button

Append/Insert: Add a new plan to DB. The plan can
be added such that its start time is the current
cursor time, or appended to the last plan before
the current cursor time.


!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.

!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).


!Remove
		       Remove Button

Remove a highlighted plan from the DB.


!Replace
		       Replace Button

Replace a highlighted plan with the current
edited plan.

!Save                  
                       Save Button


Press this button to save the currently edited plan to memory.
Saving will occur automatically whenever :

(1) the display start/end times or duration are changed

(2) the database is switched to a new type (e.g. SCIENCE)

!Swap 

                       Swap Button

Swap two plan entries. After pressing this button, you will
be prompted to select a plan entry that will be swapped with
the current selected (highlighted) plan.


!Undo

                       Undo Button

Undo the most recent editing operation.


!Colors

                        Meaning of Colors


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.

!SOLAR ROTATE

Deferred pointings can be solar rotated. Three options are available:

(1) for studies with multiple pointings, successive pointings after the first
pointing will be computed by rotating with respect to the first pointing.

(2) successive pointings in a study will be computed by rotating with respect
to the last pointing in the previous study.
    
(3) successive pointings in a study will be computed by rotating with respect
to the corresponding pointing index in the previous study.
    
!SHIFT

Shift display start time in selected units.

!STEP

Step thru sucessive plan entries.


