There are a number of ways to get help both within APT and from additional sources.
APT is one of the primary tools needed by JWST observers to plan and submit their observing proposals. JWST APT has an invaluable heritage from a similar tool use by the Hubble Space Telescope, and as such there are a number of ways to get help with questions both large and small. There are general topical support articles, each covering some aspect of the APT suite of tools and/or techniques used by multiple instruments (e.g. JWST High Contrast Imaging Overview). There are descriptive articles on each of the observation templates to help the user in entering specific observation information. If you are unfamiliar with the JWST implementation of APT, you should refer to the APT Overview to obtain a grasp on the overall workings of this important tool. There is also an introductory lecture on APT posted as part of the JWST Community Lecture series that you may want to watch.
The remainder of this article addresses some other ways to get help with APT.
Help within APT
On the top toolbar of the APT GUI is a link to JWST What's New. Selecting this link opens a separate window containing APT version comments and links to training materials. With each new release of APT, a section is added highlighting the major changes from the previous version. In addition, direct links to APT training exercises including video example walkthroughs for some functionalities items are available through this link for quick reference. Figure 1 shows the location of the JWST What's New link on the toolbar.
Within APT itself, a number of checks are performed in an ongoing way as you enter information and warnings and errors are reported to the user. Red X's appear ( ) when required information is missing or if unsupported values have been selected or entered into a field. For example, ( ) will appear on your proposal cover page until such time that your science PDF proposal is completed and attached to your APT file. Yellow caution icons ( ) indicate warnings that may or may not be a real problem, depending on the context. Since warnings are conditional, APT programs can be submitted even if warnings are present.
Hovering the cursor over either error or warning icons provides a pop-up box with a short text description of the condition generating the flag. These are necessarily terse, and some are more descriptive than others. A more detailed summary of errors and warnings can be obtained via the red X icon on the top menu bar, where a "list" and "summary" tab allows viewing of the compiled errors in the proposal in different formats. Alternatively, one can select the errors and warnings box that remains at the lower right corner of the APT GUI no matter which section of the tool one is using at a given time. Often times, the information provided in these pop-up boxes or summary lists is sufficient to allow a user to correct a given situation.
Errors come in two varieties: a) missing information that is required, and b) invalid entries or problems that affect the schedulability of the proposed observations. Obviously, the former errors are removed when valid entries are entered in the required fields. Errors affecting schedulability are more serious, especially in the mode of single-stream processing where accepted proposals flow quickly into scheduling. Ideally, no errors should remain in the proposal at the time of submission. Exceptions are allowed only in cases where the error cannot be resolved with a reasonable amount of effort or if an unanticipated condition has arisen that APT cannot handle. In such cases. it is recommended that you contact the the JWST Help Desk and discuss the problem with STScI support personnel. Upon submission, you will be asked to supple a description of any remaining errors in your proposal at he time of submission.
Context-Sensitive help is another form of assistance available with APT. If you hover the cursor over many of the sectional titles in the APT GUI, a small "?" appears next to the cursor if context-sensitive help is available for that item. Clicking on the heading will pop up a separate window and connect you to relevant text descriptions within the JWST user documentation articles. In some cases, secondary links are then available for more detailed information (if needed).
APT practice files and examples
The design of the JWST branch of APT uses a concept called observation templates to make it as straightforward as possible to enter the required information for each of the instrument modes available to users. For users who want example APT programs for each instrument and available template, a "retrieve" option is available directly from within APT. After opening APT, use the File --> JWST Demonstration Proposals option to access a list of example programs by instrument. These are not intended to be valid science use case examples, although effort has been made to enter values that remove as many warning and error indicators as possible. Alternatively, you can simply open a new JWST proposal and start from scratch to practice using APT. You can choose to save your practice proposal(s) to your local disk or discard them at the end of your session. (APT will prompt you when you exit APT.)
While these examples are useful for getting you started with a practice program, there are any number of more complicated aspects to specifying JWST observations in APT that are more difficult. For these situations, a set of APT Functionality Examples are available that users can study to understand these more complicated activities. The available use cases will be expanded as time and resources permit. If you have an idea for an additional functionality example, contact the JWST Help Desk with your suggestion.
APT training examples and video tutorials
APT is used by both HST and JWST proposers to plan and submit their observing proposals.. There are generic aspects of APT that are used by both branches, and then there are aspects that are specific to one or the other of these missions. Since APT has been around for a number of years on the HST side, there are HST or generic APT training materials and videos available, some of which is general enough to be useful for JWST users as well. However, we have begun the process of providing JWST-specific training and video materials.
The training materials come in two formats: a) online "text" files with screen shots that walk you through a particular functionality or example in APT, and b) in some cases a short video tutorial that covers the same topic. Currently, four video JWST-specific help examples are available, as shown below..
Documentation for JWST APT (Updated for APT 25.1.1)
|Getting Started||Yes||10.5 min|
|Running the Visit Planner||Yes||7 min|
|Running Smart Accounting||Yes||-|
|Adding Special Requirements to Observations||Yes||2.5 min|
|Assigning Position Angles||Yes||-|
|Creating Mosaics||Yes||4.5 min|
|Resolving Scheduling Problems with JWST Mosaics||Yes||-|
APT Training Materials written for HST (but useful for JWST until they can be redone)
|General Overview of APT GUI||Yes||6 mins.|
|Using the Find feature||-||3.5 mins.|
|Reviewing Diagnostics||Yes||4.5 mins|
|The Differencing Tool||-||5.5 mins|
|How to use the MAST Portal from APT||-||7 mins.|
|How to export Exposure Maps||Yes||-|
|How to retrieve minor body orbital elements from Horizons||-||2 mins.|
Aladin Interface Training Materials written for HST (but useful for JWST until they can be redone)
Aladin is the tool for visualizing observations in APT.
|Using HLA with Aladin||Yes||3.5 mins.|
|Using Aladin with APT in Phase II||Yes||6.5 mins.|
|Using the Aladin Multiview Function||-||1.5 mins.|
For convenience, these materials and links are available directly from within APT by accessing the "JWST What's New" button on the top toolbar.
Additional JWST-specific help examples and video training support is in the planning stages and will be added when they are available. Stay tuned. If you have specific suggestions for additional help support that is needed, we suggest providing this input via the Community Forum section of the JWST Help Desk.
Reference papers and reports