00 Visit Planner Tool The Visit Planner (VP) assists the user in making the visits in their proposal schedulable. The VP has the following capabilities: - Determines the times when visits can or cannot schedule - Indicates the reasons that visits are unschedulable at particular times. - Provides access to editors to change visits and relationships between visits to modify schedulability. - Provides general advice on techniques to obtain desired schedulability. - Provides analyses of how particular visits might be modified to improve the schedulability for particular dates. The VP will consist of two areas: 1) A Control Panel which controls how the VP computes scheduling windows and 2) a Schedulability Display Panel that displays calenders of the scheduling windows for visits and scheduling constraints. 00.1 The Control Panel (CP) shall include controls that govern the computation of scheduling windows. 00.1.1 The CP shall include a Visit Selector (VS) to select which visits from the current APT context to include in subsequent computations of scheduling windows. 00.1.1.1 The list of visits presented in the VS shall include all visits in the current APT context and other visits to which they have links. 00.1.1.2 Only those visits explicitly selected in the VS shall be included in subsequent computations of scheduling windows. (A visit not selected will not be included, even if it is linked to a selected visit.) 00.1.1.3 The VS shall have a "Select All" option meaning to compute scheduling windows for all visits in the current APT context. 00.1.1.4 The VS shall have a "Clear All " option meaning to clear the selection of all visits. 00.1.2 The Control Panel shall have a Scheduling Constraints Selector (SCS) to select which scheduling constraints to include in subsequent computations of scheduling windows. 00.1.2.1 The SCS shall have a "Select All" option meaning to compute scheduling windows for all scheduling constraints whose observer requirements have been specified in the selected visits. 00.1.2.2 The SCS shall have a "Clear All" option meaning to clear the selection of all scheduling constraints. (In the requirements for the VP, the selected visits or constraints shall mean those visits or constraints selected in the VS and SCS.) 00.1.4 If the observer requirement of a scheduling constraint is not specified in a visit, then the scheduling constraint will be treated as if it has no schedulable windows. 00.1.3 The CP shall have a Compute Button to compute and/or update the scheduling windows for the selected visits with the selected scheduling constraints. 00.1.4 The CP shall have a button to invoke a tool for graphically editing links between visits. 00.1.5 The CP shall have a display/controller to set the starting and ending dates for computing scheduling windows. 00.2 The VP shall include a Schedulability Display Panel (SDP) to display computed scheduling windows in Scheduling Windows Calenders (SWC). 00.2.1 SWCs shall include a text area that identifies the scheduling windows and whether or not there is at least one scheduling window. 00.2.1.1 For visit SWCs, the indentifier will be the identifier of the visit. 00.2.1.2 For visit SWCs, if there is at least one schedulable window and all scheduling constraints have been included, then the text area will say "Visit is schedulable." in green text. 00.2.1.3 For visit SWCs, if there are no schedulable windows, then the text area will say "Visit is not schedulable." in red text. 00.2.1.4 For visit SWCs, if there is at least one schedulable window, but not all scheduling constraints have been included, then the text area will say "Visit may be schedulable." in yellow text. 00.2.1.5 For scheduling constraint SWCs, if there is at least one schedulable window, then the text area will say " has at least one schedulable window." in green text. 00.2.1.6 For scheduling constraint SWCs, if there are no schedulable windows, then the text area will say " has no schedulable windows." in red text. 00.2.2 SWCs shall include a linear calender indicating the days that have scheduable windows. 00.2.2.1 Visit SWCs shall have an icon on the left side to expand or collapse the display of the SWCs for the associated scheduling constraints. 00.2.2.2 For visit SWCs, left clicking at a point on the SWC shall display an analysis of the schedulability at that point in time. 00.2.2.2.1 The analysis shall display whether or not the visit is schedulable at the time of interest. 00.2.2.2.2 The analysis shall display the list of constraints that are "schedulable" at the time of interest. 00.2.2.2.3 The analysis shall display the list of constraints that are "schedulable" at the time of interest. 00.2.2.2.4 If the visit is unschedulable at the time of interest , the analysis shall display suggested changes to observer requirements to that would allow the visit to become schedulable. 00.2.2.3 For scheduling constraint SWCs, left clicking at a point on the SWC shall display values of the associated observer requirements that allow the constraint to be "schedulable". 00.2.3 SWCs shall include a "More Info..." button which brings up a pop-up dialog with additional information. 00.2.3.1 If there are no schedulable windows because they have not been computed, then the "More Info..." dialog will state one of the following reasons as appropriate: Scheduling windows have not been computed. Please press the "Compute" button to compute them. Scheduling windows have not been computed because the following proposal parameters have not been specified: Scheduling windows have not been computed because the previous attempt to compute them failed. () Scheduling windows have not been computed because the proposal parameters are not valid. () 00.2.3.2 For a visit, if the scheduling windows do not include all scheduling constraints, then the "More Info..." dialog will state one of the following reasons as appropriate: Not all constraints have been selected to compute the scheduling windows for this visit. Not all constraints have been included to compute the scheduling windows for this visit because the following proposal parameters have not been specified: (). 00.2.3.3 If a visit has schedulable windows, but the scheduling windows do not include all scheduling constraints, then the "More Info..." dialog will state: WARNING: This visit may not be schedulable if all constraints are included. 00.2.3.4 If a visit is linked to one or more other visits, then the "More Info..." dialog will state: This visit is linked to . 00.2.3.5 If a visit has not been selected, but has been included in the computation of scheduling windows because it has a link to one or more visits that have been selected, then the "More Info..." dialog will state: This visit has been included because it is linked to selected other visits. 00.2.4 SWCs shall be selectable. 00.2.4.1 Selecting a visit row in the APT spreadsheet shall cause the corresponding visit SWCS to become selected. 00.2.5 There shall be a pan-zoom panel below the SWCs which allows the view of the SWCs to be zoomed and shifted within the nominal start and ending dates of the computed scheduling windows. 00.3 The VP shall provide feedback to the APT spreadsheet 00.3.1 Selecting a visit SWC shall cause the corresponding visit row in the APT spreadsheet to become selected. 00.3.2 The visit row for any visit selected in the VP for which scheduling windows have not been computed shall be given an error highlighting. 00.3.3 The visit row for any visit selected in the VP which has no schedulable windows shall be given an error highlighting. 00.3.4 The visit row for any visit selected in the VP whose scheduling windows are out-of-date shall be given a warning highlighting. 00.3.5 Selecting a scheduling constraint SWC shall cause the corresponding observer requirement cells in the APT spreadsheet to be highlighted. 00.3.6 The cell for any observer requirement corresponding to a scheduling constraint selected in the VP for which scheduling windows have not been computed shall be given an error highlighting. 00.3.7 The cell for any observer requirement corresponding to a scheduling constraint selected in the VP which has no schedulable windows shall be given an error highlighting. 00.3.8 The cell for any observer requirement corresponding to a scheduling constraint selected in the VP whose scheduling windows are out-of-date shall be given a warning highlighting.