APT Graphical Timeline

APT contains a graphical timeline tool to provide a high level insight to users on the detailed components comprising requested observations.

See also: JWST Observing Overheads and Time Accounting OverviewAPT Smart Accounting

 APT Graphical Timeline Video Tutorial

When developing a proposal, APT uses a timing model and standard assumptions about overheads to report both the science time and the total time (including overheads) that will be needed to execute a given visit and observation.  Running Smart Accounting at the end of your proposal development looks at the proposal in its entirety and adjusts the charged overheads to provide a total accounting of the resources needed for the program.  However, just reporting a total roll-up of overhead time often leaves users wondering about the details, which are difficult to discern with the reports and information previously available.

Beginning with APT version 27.1 released in winter 2019, the JWST branch of APT now includes a graphical Timeline tool that provides the user with a breakdown of the various overheads affecting their proposed observations.  Labeled color bars show the different components of the overheads in the context of each selected visit or observation.  Controls for zooming the display in the time dimension or providing additional details and labeling are available, as shown in the Figures below. Also, hovering the cursor over a color bar results in a pop-up window with additional information.

The graphical timeline is not meant to represent the actual detailed set of events that occur in the onboard execution of the observation. Rather, it is a tool to provide the user with insight into the major steps that occur and the times accounted to each within the APT timing model.

Figure 1. Example View of APT Graphical Timeline

To access the APT Graphical Timeline, select an observation or visit in the Tree editor at left, and then select Timeline on the top tool bar (red oval #1). The timeline tool then becomes active in the main GUI window as shown above. Use the Zoom (red oval #2) and the More or Less Detail buttons (red oval #3) to adjust the display to your liking. Note that left and right mouse clicks can also activate actions. Hovering your cursor over a given color bar provides a pop-up with more information. This example uses a simple observation from APT Demonstration proposal #6 on Mosaics.
Figure 2. Accessing more detailed Information

This example shows a more complicated observation from APT Demo proposal #7 (MIRI Coronagraphy) fully expanded to show detailed labels and additional colors. The Visit Slew (olive bar at left) has been cut off to focus on the details of the observational setup. Note that in addition to Zooming in and showing More Detail, the slider bar (red oval) has been used to position the display to the region of interest.
Figure 3. A Key to Graphical Timeline Colors

Hovering your cursor over any of the color bars in the timeline plot provides more information as to what it is, but the colors are used consistently, according to the labeled example above. The color bars are also labeled directly in the timeline plot if the More Detail button is selected. Also, hovering the cursor momentarily over a color bar results in a pop-up window containing additional information.



Published

 

Latest updates
  •  Added video link; minor updates.

  •  Initial publication.