APT Visit Planner Review

Chris O’DeaChris O’Dea

The Gallant Crew

Chris O’Dea - Project Scientist Chris O’Dea - Project Scientist Jesse Doggett - Software Engineer/Coordinator Jesse Doggett - Software Engineer/Coordinator Tricia Royle - HST OperationsTricia Royle - HST Operations Rusty Whitman - System Engineer Rusty Whitman - System Engineer Karla Peterson - Testing Karla Peterson - Testing Leslie Zimmerman Foor - Testing Leslie Zimmerman Foor - Testing Tony Krueger - Spike Engineering Tony Krueger - Spike Engineering Ron Downes – Science Ron Downes – Science Steve Lubow – Science Steve Lubow – Science Andy Gerb - Spike Engineering, Emeritus Andy Gerb - Spike Engineering, Emeritus

Outline

Overview/VisionOverview/Vision Comparison with RPS2Comparison with RPS2 Preliminary DesignPreliminary Design List of RequirementsList of Requirements

Overview/Vision

VP will calculate schedulability of visits using SPIKE and VP will calculate schedulability of visits using SPIKE and provide graphical display and feedback which provide graphical display and feedback which

indicates which visits are schedulable and which are not indicates which visits are schedulable and which are not Indicate the reasons why a visit is unschedulable and Indicate the reasons why a visit is unschedulable and assists the user in making the visits in their proposal schedulableassists the user in making the visits in their proposal schedulable

VP will be a fully integrated part of the APT and will not VP will be a fully integrated part of the APT and will not run in a “stand-alone” moderun in a “stand-alone” mode

VP will contain all functionality currently available in VP will contain all functionality currently available in RPS2 (these minimum requirements to be provided in first RPS2 (these minimum requirements to be provided in first release) as well as enhancements which increase flexibility release) as well as enhancements which increase flexibility and ease of useand ease of use

Overview/Vision II

VP will facilitate “exploring” in proposal VP will facilitate “exploring” in proposal preparationpreparation

Iteration will be straight forwardIteration will be straight forward Running the Orbit Planner first is not required (e.g., VP will Running the Orbit Planner first is not required (e.g., VP will

assume SCHED30 orbit)assume SCHED30 orbit) User can turn off any of the scheduling constraints to User can turn off any of the scheduling constraints to

determine effects on schedulability determine effects on schedulability Subsets of visits can be selected for analysis (though all Subsets of visits can be selected for analysis (though all

linked visits will always be included in the calculation)linked visits will always be included in the calculation) VP will provide access to spread sheet editors as well as a VP will provide access to spread sheet editors as well as a

tool for graphically editing links between visitstool for graphically editing links between visits

Overview/Vision III.

VP will provide more useful feedback than RPS2VP will provide more useful feedback than RPS2 VP will provide general advice on techniques to obtain VP will provide general advice on techniques to obtain

desired schedulabilitydesired schedulability VP will provide analyses of how particular visits might be VP will provide analyses of how particular visits might be

modified to obtain desired schedulabilitymodified to obtain desired schedulability

Example of output currently given by RPS2

Visit Planner Tool Requirements

11 [i] The Visit Planner (VP) assists the user in making the [i] The Visit Planner (VP) assists the user in making the visits in their proposal schedulable. The VP has the following visits in their proposal schedulable. The VP has the following capabilitiescapabilities

1.11.1 [i] The VP shall be able to determine the times [i] The VP shall be able to determine the times when visits can or cannot schedule.when visits can or cannot schedule.

1.21.2 [i] The VP shall be able to indicate the reasons [i] The VP shall be able to indicate the reasons that visits are unschedulable at particular times. that visits are unschedulable at particular times.

1.31.3 [i] The VP shall provide access to editors to [i] The VP shall provide access to editors to allow the user to modify visits and relationships between visits to allow the user to modify visits and relationships between visits to modify schedulability.modify schedulability.

1.41.4 The VP shall provide general advice on The VP shall provide general advice on techniques to obtain desired schedulability. techniques to obtain desired schedulability.

1.51.5 The VP shall provide analyses of how particular The VP shall provide analyses of how particular visits might be modified to improve the schedulability over visits might be modified to improve the schedulability over particular periods of time.particular periods of time.

[i] indicates a minimum requirement expected to be available in the initial release.

2 [i] The VP shall consist of two areas: 1) A Control Panel which controls how 2 [i] The VP shall consist of two areas: 1) A Control Panel which controls how the VP computes scheduling windows and 2) a Schedulability Display Panel the VP computes scheduling windows and 2) a Schedulability Display Panel that displays calendars of the scheduling windows for visits and scheduling that displays calendars of the scheduling windows for visits and scheduling constraints.constraints.

2.12.1 [i] The VP shall compute scheduling windows for all [i] The VP shall compute scheduling windows for all visits in the current VP Inferred Context (cVPIC).visits in the current VP Inferred Context (cVPIC).

2.1.12.1.1 [i] The cVPIC shall include all visits in the current [i] The cVPIC shall include all visits in the current APT context plus all other visits that are linked to those visits in the APT context plus all other visits that are linked to those visits in the current APT context.current APT context.

2.1.22.1.2 [i] If any visit’s observer requirement for any [i] If any visit’s observer requirement for any scheduling constraint is known to be incomplete or invalid, then the VP scheduling constraint is known to be incomplete or invalid, then the VP shall report an error to the user and will not compute or display shall report an error to the user and will not compute or display scheduling windows for the visit and any other visits linked to it.scheduling windows for the visit and any other visits linked to it.

2.1.32.1.3 [i] Each time the user switches to the VP from [i] Each time the user switches to the VP from another tool in the APT, the VP shall immediately update the scheduling another tool in the APT, the VP shall immediately update the scheduling windows for visits in the cVPIC.windows for visits in the cVPIC.

2.2 The Control Panel (CP) shall include controls that govern the 2.2 The Control Panel (CP) shall include controls that govern the computation and display of scheduling windows. (See Fig. 1)computation and display of scheduling windows. (See Fig. 1)

2.2.12.2.1 The CP shall include a Visit Selector (VS) to select The CP shall include a Visit Selector (VS) to select the visits for which computed scheduling windows will be shown in the visits for which computed scheduling windows will be shown in the Schedulability Display Panel.the Schedulability Display Panel.

2.2.1.12.2.1.1 The list of visits presented in the VS shall be the The list of visits presented in the VS shall be the visits in the cVPIC.visits in the cVPIC.

2.2.1.22.2.1.2 The VS shall have a "Select All" option meaning to The VS shall have a "Select All" option meaning to display the computed scheduling windows for all visits in the cVPIC.display the computed scheduling windows for all visits in the cVPIC.

2.2.1.32.2.1.3 The VS shall have a "Clear All " option to clear the The VS shall have a "Clear All " option to clear the selection of all visits from the VS.selection of all visits from the VS.

2.2.1.42.2.1.4 The VS shall have a mechanism to select visits by The VS shall have a mechanism to select visits by link set.link set.

2.2.22.2.2 The Control Panel shall have a Scheduling Constraints Selector The Control Panel shall have a Scheduling Constraints Selector (SCS) to select which of the scheduling constraints to include in (SCS) to select which of the scheduling constraints to include in subsequent computations of scheduling windows for all visits in the subsequent computations of scheduling windows for all visits in the cVPIC.cVPIC.

2.2.2.12.2.2.1 The SCS shall have a "Select All" option meaning to compute The SCS shall have a "Select All" option meaning to compute scheduling windows for all scheduling constraints.scheduling windows for all scheduling constraints.

2.2.2.22.2.2.2 The SCS shall have a "Clear All" option to clear the selection The SCS shall have a "Clear All" option to clear the selection of all scheduling constraints.of all scheduling constraints.

2.2.2.32.2.2.3 The SCS shall make it clear to the user that turning off a The SCS shall make it clear to the user that turning off a scheduling constraint does not remove the corresponding observer scheduling constraint does not remove the corresponding observer requirements from the proposal.requirements from the proposal.

2.2.32.2.3 The CP shall have an “Update” button to update the scheduling The CP shall have an “Update” button to update the scheduling windows for all visits in the cVPIC.windows for all visits in the cVPIC.

2.2.42.2.4 The CP shall provide a tool for graphically editing links The CP shall provide a tool for graphically editing links between visits in the cVPIC.between visits in the cVPIC.

2.2.52.2.5 [i] The CP shall support limiting the starting and ending [i] The CP shall support limiting the starting and ending dates for computing scheduling windows.dates for computing scheduling windows.

2.2.5.12.2.5.1 The CP shall support displaying an observatory specific The CP shall support displaying an observatory specific dialog for specifying starting and ending dates.dialog for specifying starting and ending dates.

2.2.5.22.2.5.2 [i] The CP shall support automatic specification of the [i] The CP shall support automatic specification of the starting and ending dates inferred from properties of the visits in starting and ending dates inferred from properties of the visits in the cVPIC.the cVPIC.

2.2.62.2.6 [i] The CP shall have a tool bar to provide additional [i] The CP shall have a tool bar to provide additional functions.functions.

2.2.6.12.2.6.1 [i] There shall be an Update button in the CP tool bar to [i] There shall be an Update button in the CP tool bar to update the scheduling windows for all visits in the cVPIC.update the scheduling windows for all visits in the cVPIC.

2.2.6.22.2.6.2 [i] There shall be a Report tool in the CP tool bar that [i] There shall be a Report tool in the CP tool bar that provides access to various reports.provides access to various reports.

2.2.6.2.12.2.6.2.1 [i] The Report tool shall include a report of the scheduling [i] The Report tool shall include a report of the scheduling windows for each visit in textual format similar to the Spike Suitable windows for each visit in textual format similar to the Spike Suitable Times Report for the visit of the currently selected SWC.Times Report for the visit of the currently selected SWC.

2.2.6.2.22.2.6.2.2 The Report tool shall include a report that shows the links The Report tool shall include a report that shows the links sets in the cVPIC.sets in the cVPIC.

2.32.3 [i] The VP shall include a Schedulability Display Panel [i] The VP shall include a Schedulability Display Panel (SDP) to display computed scheduling windows in Scheduling (SDP) to display computed scheduling windows in Scheduling Windows Calendars (SWC) for Visits and Individual Scheduling Windows Calendars (SWC) for Visits and Individual Scheduling Constraints. (See Fig. 2)Constraints. (See Fig. 2)

2.3.12.3.1 [i] Visit SWCs shall have an icon on the left side to expand [i] Visit SWCs shall have an icon on the left side to expand or collapse the display of the visit’s scheduling constraints’ SWCs.or collapse the display of the visit’s scheduling constraints’ SWCs.

2.3.22.3.2 [i] SWCs shall include a text area that identifies the [i] SWCs shall include a text area that identifies the scheduling windows and whether or not there is at least one scheduling windows and whether or not there is at least one schedulable window.schedulable window.

2.3.2.12.3.2.1 [i] For visit SWCs, if there is at least one schedulable [i] For visit SWCs, if there is at least one schedulable window and all scheduling constraints have been included, then the window and all scheduling constraints have been included, then the text area will say "Visit <visit identifier> is schedulable." and will text area will say "Visit <visit identifier> is schedulable." and will include visual cues which indicate the visit is schedulable.include visual cues which indicate the visit is schedulable.

2.3.2.22.3.2.2 [i] For visit SWCs, if there are no schedulable windows, then [i] For visit SWCs, if there are no schedulable windows, then the text area will say "Visit <visit identifier> is not schedulable." and the text area will say "Visit <visit identifier> is not schedulable." and will include visual cues which indicate the visit is not schedulable.will include visual cues which indicate the visit is not schedulable.

2.3.2.32.3.2.3 For visit SWCs, if there is at least one schedulable window, For visit SWCs, if there is at least one schedulable window, but not all scheduling constraints have been included, then the text but not all scheduling constraints have been included, then the text area will say "Visit <visit identifier> is schedulable with the selected area will say "Visit <visit identifier> is schedulable with the selected subset of scheduling constraints." and will include visual cues which subset of scheduling constraints." and will include visual cues which indicate that the scheduling windows are only partial.indicate that the scheduling windows are only partial.

2.3.2.42.3.2.4 [i] For scheduling constraint SWCs, if there is at least one [i] For scheduling constraint SWCs, if there is at least one schedulable window, then the text area will say "<scheduling schedulable window, then the text area will say "<scheduling constraint name> has at least one schedulable window." and will constraint name> has at least one schedulable window." and will include visual cues which indicate that the scheduling constraint has include visual cues which indicate that the scheduling constraint has at least on schedulable window.at least on schedulable window.

2.3.2.52.3.2.5 [i] For scheduling constraint SWCs, if there are no [i] For scheduling constraint SWCs, if there are no schedulable windows, then the text area will say "<scheduling schedulable windows, then the text area will say "<scheduling constraint name> has no schedulable windows." and will include constraint name> has no schedulable windows." and will include visual cues which indicate that the scheduling constraint has no visual cues which indicate that the scheduling constraint has no schedulable windows.schedulable windows.

2.3.32.3.3 [i] SWCs shall include a linear calendar indicating the [i] SWCs shall include a linear calendar indicating the periods of time that have schedulable windows.periods of time that have schedulable windows.

2.3.3.12.3.3.1 Linear calendars for Visit SWCs shall have a mechanism to Linear calendars for Visit SWCs shall have a mechanism to display an analysis of the visit’s schedulability over any period of display an analysis of the visit’s schedulability over any period of time.time.

2.3.3.1.12.3.3.1.1 The analysis shall display whether the visit is schedulable The analysis shall display whether the visit is schedulable at the time of interest.at the time of interest.

2.3.3.1.22.3.3.1.2 The analysis shall display the list of constraints that are The analysis shall display the list of constraints that are schedulable at the time of interest.schedulable at the time of interest.

2.3.3.1.32.3.3.1.3 The analysis shall display the list of constraints that are The analysis shall display the list of constraints that are not schedulable at the time of interest. not schedulable at the time of interest.

2.3.3.1.42.3.3.1.4 If the visit is unschedulable at the time of interest, the If the visit is unschedulable at the time of interest, the analysis shall display suggested changes to observer requirements, analysis shall display suggested changes to observer requirements, if any, which would allow the visit to be schedulable during a if any, which would allow the visit to be schedulable during a particular period of time. particular period of time.

2.3.3.22.3.3.2 Linear calendars for scheduling constraint SWCs shall Linear calendars for scheduling constraint SWCs shall have a mechanism to display values of the associated observer have a mechanism to display values of the associated observer requirements, if any, that would allow the scheduling constraint to requirements, if any, that would allow the scheduling constraint to be "schedulable" during a particular period of time.be "schedulable" during a particular period of time.

2.3.42.3.4 Visit SWCs shall clearly indicate if the computation of Visit SWCs shall clearly indicate if the computation of the scheduling windows is partial because not all scheduling the scheduling windows is partial because not all scheduling constraints were selected in the SCS.constraints were selected in the SCS.

2.3.52.3.5 SWCs shall be selectable.SWCs shall be selectable. 2.3.5.12.3.5.1 Selecting a SWC shall cause the corresponding visit row Selecting a SWC shall cause the corresponding visit row

in the APT spreadsheet to become selected.in the APT spreadsheet to become selected. 2.3.5.22.3.5.2 Selecting a visit row in the APT spreadsheet shall cause Selecting a visit row in the APT spreadsheet shall cause

the corresponding visit SWCS to become selected.the corresponding visit SWCS to become selected. 2.3.62.3.6 There shall be a mechanism to save a copy of the SWCs There shall be a mechanism to save a copy of the SWCs

to a file format suitable for printing.to a file format suitable for printing.

33 [i] The VP shall support specific requirements for HST [i] The VP shall support specific requirements for HST visits. visits. 3.13.1 [i] The VP shall support scheduling constraints specific to [i] The VP shall support scheduling constraints specific to

HST.HST. 3.1.13.1.1 [i] Scheduling windows for HST scheduling constraints shall [i] Scheduling windows for HST scheduling constraints shall

be computed using the current version of Spike.be computed using the current version of Spike. 3.1.23.1.2 [i] The VP shall support physical constraints.[i] The VP shall support physical constraints. 3.1.2.13.1.2.1 [i] The VP shall support the Sun constraint.[i] The VP shall support the Sun constraint. 3.1.2.23.1.2.2 [i] The VP shall support the Moon constraint.[i] The VP shall support the Moon constraint. 3.1.2.33.1.2.3 [i] The VP shall support the target visibility constraint.[i] The VP shall support the target visibility constraint. 3.1.2.3.13.1.2.3.1 [i] Orbit Filling shall be obtained from the visit data as [i] Orbit Filling shall be obtained from the visit data as

computed by the Orbit Planner Tool.computed by the Orbit Planner Tool. 3.1.2.3.23.1.2.3.2 [i] If Orbit Filling is not available, the SCHED Parameter shall [i] If Orbit Filling is not available, the SCHED Parameter shall

be used in its place.be used in its place.

3.1.2.43.1.2.4 The VP shall support moving target constraints.The VP shall support moving target constraints. 3.1.2.53.1.2.5 The VP shall support the Guide Star constraints.The VP shall support the Guide Star constraints. 3.1.33.1.3 [i] The VP shall support absolute user constraints.[i] The VP shall support absolute user constraints. 3.1.3.13.1.3.1 [i] The VP shall support the Between constraint.[i] The VP shall support the Between constraint. 3.1.3.23.1.3.2 [i] The VP shall support the After constraint.[i] The VP shall support the After constraint. 3.1.3.33.1.3.3 [i] The VP shall support the Before constraint.[i] The VP shall support the Before constraint. 3.1.3.43.1.3.4 [i] The VP shall support the Phase constraint.[i] The VP shall support the Phase constraint. 3.1.3.53.1.3.5 [i] The VP shall support the Low Sky constraint.[i] The VP shall support the Low Sky constraint. 3.1.3.63.1.3.6 [i] The VP shall support the Orient constraint.[i] The VP shall support the Orient constraint. 3.1.43.1.4 [i] The VP shall support relative user constraints.[i] The VP shall support relative user constraints. 3.1.4.13.1.4.1 [i] The VP shall support timing link constraints.[i] The VP shall support timing link constraints.

3.1.4.23.1.4.2 [i] The VP shall support Save/Use Offset constraints.[i] The VP shall support Save/Use Offset constraints. 3.1.4.33.1.4.3 [i] The VP shall support the Orient From constraint.[i] The VP shall support the Orient From constraint. 3.1.4.43.1.4.4 [i] The VP shall support the Same Orient constraint.[i] The VP shall support the Same Orient constraint. 3.1.4.53.1.4.5 The VP shall support the Ephemeris Correction The VP shall support the Ephemeris Correction

constraint.constraint. 3.23.2 [i] The starting and ending dates for computing [i] The starting and ending dates for computing

scheduling windows for HST visits shall be inferred from scheduling windows for HST visits shall be inferred from the cycle of their parent proposal.the cycle of their parent proposal.

3.33.3 [i] The SDP Report tool shall include a Roll Range [i] The SDP Report tool shall include a Roll Range Report similar to what is currently available in RPS2 for Report similar to what is currently available in RPS2 for the visit of the currently selected SWC.the visit of the currently selected SWC.