This article presents four examples of creating a solar system target in the JWST Astronomer's Proposal Tool (APT).


Main article: JWST Astronomers Proposal Tool Overview

You should first read how the JWST Astronomer's Proposal Tool (APT) defines Solar System Targets. Here we walk through four examples for creating a new solar system target in APT:

  1. Defining a Level 1 "Standard Target" planet

  2. Defining a non-"standard" Level 2 satellite

  3. Defining a Level 3 feature

  4. Defining a Level 1 minor body

To learn how to download APT and start a JWST proposal, see JWST Moving Targets in APT. After this tutorial you may want to read Tutorial: Creating Solar System Observations in APT and Tutorial on Visualizing Dithers of a Solar System Observation in APT.

The following examples are by no means exhaustive. If you have questions please contact the help desk.

Getting started creating a new Solar System target

To create new targets, select the Targets folder and click the New Solar System Target button. 

Figure 1. APT Solar System targets page.

A new Solar System Targets folder will be created with an empty sub-folder, Unnamed Target. To create additional targets, you can click the New Solar System Target button either at the Targets level or the Solar System Targets level.

To define your first target, select the Unnamed Target folder. Inside you will see that there are three "levels" to defining a solar system target.

  • Level 1 Type: Observation will track the center of a planet, comet, asteroid, etc. 

  • Level 2 Type: Observation will track a feature, satellite, ring, position angle, etc. of the Level 1 target. 

  • Level 3 Type: Observation will track a feature, satellite, ring, position angle, etc. of the Level 2 target.

See also APT Targets for a more general discussion. The following examples illustrate a subset of the solar system targets that may be defined.

Example 1: Defining a Level 1 "Standard Target" planet

The simplest target to define is a Level 1 Standard Target.

Type the name of your target in Name in the Proposal, select Planet from the Keyword drop-down box, and add a description. The keyword is for archiving purposes. Note that if you choose the Keyword  Dwarf-Planet, but you select Mars as the Level 1 target, the Keyword remains unchanged (even though it is not an accurate description). To actually define your target type, select among the three levels. For a simple observation of Jupiter, select Standard Target from the Level 1 drop-down. 

Figure 2. Keywords and Level 1 targets.

You will be taken to the following screen. Scroll through the Standard Target drop-down and select "Jupiter."

Figure 3. Choosing a standard target.

Example 2: Defining a non-"standard" Level 2 satellite

If you are observing a satellite that is not listed among the Standard Targets, you can define it. This can work in any of the levels, but we will illustrate it at Level 2 by creating a new satellite for Jupiter. 

Create a new target sub-folder, select Satellite from the Keyword drop-down, and enter a name and description. As in the example above, select "Jupiter" as the Level 1 Standard Target. Then in the Level 2 drop-down, select Satellite.

Figure 4. Level 2 targets.

You will be taken to the following form where you can enter the satellite's orbital parameters.

Figure 5. Defining a new Jovian satellite.

Example 3: Defining a Level 3 feature

At Level 3, you can define a feature to track on a Level 2 target. In this example, we will define the location of a volcano on the surface of the Jovian satellite Io. 

Select Feature from the Keyword drop-down, Jupiter as the Level 1 Standard Target, and Io as the Level 2 Standard Target. Finally, select Planetographic from Level 3 to set the Level 3 target's coordinates to be in longitude and latitude relative to the Level 2 target. You can find the full list of coordinate frames in the article Solar System Targets Position Levels 2 and 3.

Figure 6. Level 3 features.

You will be taken to this form, where you can define the volcano's longitude, latitude, etc.

Figure 7. Defining a volcano on Io as a Level 3 feature.

Example 4: Defining a Level 1 minor body

Most minor bodies such as asteroids, comets, and KBOs are not considered Standard Targets and must be selected from either the Comet or Asteroid categories, the latter including outer solar system minor planets. For example, to define the trans-Neptunian object Sedna, select Asteroid from the Level 1 drop-down. 

Figure 8. Defining a Level 1 asteroid.

On the next form, type "Sedna" into the Search box. Choose the object from the pop-up window and click OK.

Figure 9. Using the JPL Horizons search tool.

Next, APT will retrieve the object's orbital elements from JPL Horizons. If you had previously entered any elements into this form, they will be over-written unless you click Cancel.

Figure 10. Loading orbital elements.

If you wish to edit the JPL Horizons elements (not recommended), uncheck the box. 

Figure 11. Updating orbital elements.


Download the Astronomer's Proposal Tool

Last updated

Published May 26, 2017


The format for 'Last updated' is shown below. Enter updates above this internal"Comment" box. Only enter major updates (not typos or formatting changes).

Updated April 5, 2017

  • Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam fermentum vestibulum est. Cras rhoncus. 
  • Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed quis tortor. 

Published March 2, 2017