THEMIS Planning Layer

From JMARS Wiki

Jump to: navigation, search

The THEMIS Planning Layer, which is only available in the THEMIS release of JMARS, allows users to view and plan observations for the THEMIS instrument aboard Mars Odyssey. The observations are defined by a start time, duration, band configuration and compression algorithm, all of which can be set using the Planning Layer's focus panel. When observations are either added, deleted or edited, the changes are not recorded in the database until the observations are "Committed" to the database. Once committed, any user can view the observations using the Planning Layer, but users can only edit the observations that they have planned.


Image:planning_main.png


Contents


[edit] Open the THEMIS Planning Layer

  1. Open the ROI Layer: Chose "Add New Layer" -> "THEMIS Planning"
  2. Enter Planning Properties: A number of parameters must be set before the THEMIS Planning Layer can open:
  • Pre-Orbit:
  • Minimum Orbit: The first orbit for which the user is planning or viewing observations. (Required)
  • Maximum Orbit: The last orbit for which the user is planning or viewing observations. (Required)
  • MMC Baseline: The known or predicted amount of data (in MB) in the MMC at the beginning of the given orbit range. (Not Required)
  • Owners: The users whose observations should be displayed. (Only one user required, more are optional.)
  1. Open the Planning Layer: Clicking the "OK" button will display the THEMIS groundtrack for the given orbit range in the Viewing Window and will open the "THEMIS Planning" tab in the Layer Manager.
Image:planning_open.png


[edit] THEMIS Planning Layer Functions

The functions of the THEMIS Planning Layer can be accessed by clicking on the "THEMIS Planning" tab in the Layer Manager, which provides access to the following three function tabs.
1. Settings Tab
  • Orbit Settings
These options allow the user to change the Pre-Orbit, Orbit Range, MMC Baseline and User Name which were set when the Planning Layer was opened. The "Reload" button must be clicked after any changes in order to update the information displayed in the Viewing Window.
  • Groundtracks
These options allow the user to add or remove the displayed groundtrack in either the Main or Panning Views and change the color and transparency of both the selected and unselected groundtracks. Users are also given the option to filter the groundtracks so only certain parts are visible, such Day or Night (determined by illumination level) and Descending or Ascending (descending=traveling north to south, ascending=traveling south to north).
  • Observations
These options allow the user to add or remove the displayed observations from either the Main or Panning Views and to change the colors assocaited with different types of observations.
  • Miscellaneous
The "View Follows Ruler" option will re-center the Main and Panning Views to run parallel to a selected groundtrack. This replicates (although not exactly) the old JMARS Time Mode.


Image:planning_settings.png


2. Tooltips Tab
  • Time Formats
These check boxes allow the user to chose which time format is displayed in the tooltip when the cursor is placed on a groundtrack. Multiple time formats can be chosen.
  • Additional Tooltip Information
These check boxes allow the user to add additional information to the mouse-over tooltip, such as:
  • Observation ID
  • Orbital Events
  • Mars Local Time
  • Solar Incidence Angle
  • MMC Status (MB)
  • Downlink Status (MB)


Image:planning_tooltips.png


3. Observations Tab
  • Observations List
The table in the Observations Tab lists all observations in the given orbit range along with their various parameters. Users can sort the observations according to the parameters by clicking on the parameter names. Observations selected in Viewing Window will be highlighted. At the bottom of the table are some basic statistics: the number of observations, number of selected observations, number of modified observations and the number of observations in conflict with other observations.
  • Description:
All THEMIS observations, VIS or IR, can be given descriptions. Usually these are used to describe the region being observed or the imaging campaign that targeted the observation.
  • IR Properties:
  • Start Time: The start time of the image given in ephemeris time (et).
  • ILen: The duration of the IR observation. (ILen = 7 = 1 minute)
  • Observation ID:
  • Gain:
  • Offset:
  • Summing: A summing value between 1 (full resolution) and 160 (lowest resolution).
  • Rice: Enables/Disables rice compression of the observation before downlink. The default value is "Enabled".
  • TDI:
  • Cal: Indicates whether or not the IR observation is a Calibration Image.
  • Shutter: Indicates whether or not the IR observation is a Shutter Image.
  • Bands: Sets the band configuration of the IR image using pre-set configurations.
  • VIS Properties:
  • Start Time: The start time of the image given in ephemeris time (et).
  • Frames: The duration of the image given as the number of frames.
  • Observation ID:
  • Interframe Delay: The time delay between frames. (Optimum setting is 0.9s)
  • Exposure: Length of the exposure in tenths of a millisecond. (Automatically calculated when the "Calc Exp" button is clicked.
  • Summing: A summing value of either 1 (18m), 2 (36m) or 4 (72m) resolution.
  • Compression: A compression value for the VIS image. The default value is 65535.
  • Bands: Sets the band configuration using pre-set configurations.


Image:planning_observations.png


[edit] THEMIS Planning Layer Rulers

The THEMIS Planning Layer also includes four rulers, which are displayed in the Viewing Window underneath the Panning View. (Note: If the Viewing WIndow is maximized when you load the Planning Layer, you will need to un-maximize the window for the rulers to appear.) The rulers behave similar to the Panning Window, but instead of displaying a wide-angle view of the maps they display other information related to the planning orbit range in chronological order. Clicking on an event in a ruler will automatically re-center the Main and Panning Views on that point.
If users are viewing the map with the "View Follows Ruler" option enabled the groundtrack will run parallel to the rulers, which can be synced with the Main View by adjusting their zoom levels. Otherwise, the position in the ruler does not necessarily correspond with the points in the Main and Panning Views above it. In this case, when the mouse cursor is in a ruler, a red set of crosshairs will appear in the Main and Panning Views at the corresponding location. Users also have the option to hide some or all of the rulers by right-clicking on any of them.
  1. Observations Ruler:
The Observations Ruler displays markers for all of the observations that have been entered in the given range of orbits. The markers are displayed in the same color as the observations they represent (ie: VIS images appear as green markers, etc).
  1. OPTG Ruler
The OPTG Ruler displays markers for certain events in each orbit, which are explained below. This data is obtained from the weekly OPTG file that should be updated before any THEMIS planning is done.
  • DEQUAX - Descending Equator Crossing
  • DLTERM - Dark-to-Light Terminator Crossing
  • FKSUNX - Fake Sun Crossing (Crossing the Sub-Solar Latitude)
  • LDTERM - Light-to-Dark Terminator Crossing
  • NPOLEX - North Pole Crossing
  • SPOLEX - South Pole Crossing
  1. Angle/Time Ruler
The Angle/Time Ruler displays graphs of the solar incidence angle (red) and the local time on the surface (blue). The exact numerical values of both are displayed in a tooltip when the mouse cursor is placed on the ruler.
  1. MMC/Downlink
The MMC/Downlink ruler displays the amount of data collected during the given planning range and the amount of downlink scheduled during the same period. In order to prevent filling or emptying the THEMIS mass memory card (MMC), planners usually only collect enough data to fill the daily downlink, preventing any net change in the total amount of data on-board. If there is already data on the MMC, planners can enter this number in the "MMC Baseline" field when opening the planning layer so they can ensure they will not fill the MMC during their planning range.


Image:planning_rulers.png


[edit] Adding a VIS Observation

  1. Open the THEMIS Planning Layer: Using the instructions above, open the Planning Layer and select it as the active layer in the Layer Manager.
  2. Insert a VIS Observation: In the Main View, right-click on the groundtrack at the location where the VIS observation will begin and select "New Observation" and chose from one of the available VIS observation types.
  • VIS 1 Band: A band 3 (RED) 18m resolution observation. This is the most common type of VIS image and is the type used for high-res mapping.
  • VIS Color: A four band (2,3,4,5) 18m resolution observation. This is the most commonly used multiband image and allows the propduction of approximate true-color images.
  • VIS Polar: A band 3 (RED) 36m resolution observation, most commonly used for the polar monitoring campaigns and large-area mapping.
  • If the desired VIS observation type is not in the list, chose the closest one and then edit the parameters in the focus panel manually.
  1. Adjust VIS Observation Location: If the observation needs to be re-positioned, left-click and drag the observation to a new location.
  2. Adjust VIS Observation Parameters: Users must always reset the image exposure by selecting the image and clicking the "Calc Exp" button in the focus panel. Mission planners may occasionally need to adjust some of the other parameters manually.
  3. Commit the Observation: To add the observations to the database, right-click anywhere in the Main View and chose "Commit Changes".
Image:planning_vis.png


[edit] Adding an IR Observation

  1. Open the THEMIS Planning Layer: Using the instructions above, open the Planning Layer and select it as the active layer in the Layer Manager.
  2. Insert an IR Observation: In the Main View, right-click on the groundtrack at the location where the IR observation will begin and select "New Observation" and chose from one of the pre-set IR observation lengths
  • If the desired observation length is not on the list, chose the closest one and edit the ILen manually in the focus panel.
  • The maximum length of a THEMIS IR observation is 8 min (ILen=56).
  1. Adjust IR Observation Location: If the observation needs to be re-positioned, left-click and drag the observation to a new location.
  2. Adjust IR Observation Parameters: Usually users will only need to adjust the ILen (if necessary) and the band configuration. Mission planners may occasionally need to adjust some of the other parameters.
  3. Add an Embedded VIS: THEMIS has the ability to take a VIS and an IR observation simultaneously. If desired, the user can select the IR observation, right-click, select "New Observation" and select the desired VIS image type. The VIS image can then be moved within the IR image and its parameters can be edited like normal. Don't forget to click "Calc Exp" to calculate the VIS image's exposure.
  4. Add Calibration and Shutter Images: All IR observations need to be accompanied by properly positioned calibration and shutter images in order for the image to be processed correctly. To add these images, select the IR observation in the Main View, right-click on the observation, chose "Autodrop" and chose "Create Both Auto Cal and Shutter". Users can also drop a Cal or Shutter image by itself if necessary by choosing those options under "Autodrop".
  5. Commit the Observation: To add the observations to the database, right-click anywhere in the Main View and chose "Commit Changes".
Image:planning_ir.png


Image:planning_irvis.png


[edit] Copying an Observation

  1. Select Observation(s): To select a single observation, left-click on it. To select multiple observations, left-click on them while holding the Ctrl key.
  2. Copy the Observation(s): Right-click on one of the selected observations and chose "Edit" -> Copy
  3. Paste the Observation(s): Right click on the groundtrack at the location where you wish to paste the observations, chose "Edit" and then either "Paste with Start at ET:#########" or "Paste with Center at ET:#########"
  4. Commit Observations: Right-click anywhere in the Main View and chose "Commit Observations"


[edit] Grouping Observations

  1. Select Observations: To select multiple observations, left-click on them while holding the Ctrl key.
  2. Group the Observations: Right-click on one of the selected observations and chose "Group". Once grouped, the observations will behave as if they were a single observation. They can be moved, copied and pasted without the relative spacing between them changing. When pasted, the new copy will be grouped by default.
  3. Commit Observations: Right-click anywhere in the Main View and chose "Commit Observations"
  4. Ungrouping the Observations: Right-click on the group of observations and chose "Ungroup". The observations will now behave as individual observations again.
Retrieved from "http://jmars.asu.edu/wiki/index.php/THEMIS_Planning_Layer"