Search Page

The Data Products Search page allows you to search for products across missions, instruments, and data sets. You accomplish this in three steps: Select your desired data sets; filter your request by Product ID, location, or time; and elect to view your query results in either the product results table or on a map of the planetary target (Mars, Mercury, Venus, or Earth's Moon).

ODE Data Product Search pages:

Mars ODE Data Product Search Page

Mercury ODE Data Product Search Page

Lunar ODE Data Product Search Page

Venus ODE Data Product Search Page

 

Click here to access the new Faceted Search help for the new beta feature of this page.

You’ll notice that when opening this page, there are a set of bars with a small down arrow. These bars can be expanded or contracted by clicking anywhere on the bar.

Notice the Reset Form button in the upper right? This clears all your search criteria. ODE saves your search criteria whenever you submit a search query. This allows you to use run a search and later come back to the same search. It also allows you to adjust the search criteria without having to reenter other search criteria. The Reset Form button clears all your search criteria at once.

Example:

Step 1. Select Data Sets

The first step in finding data products is to select one or more Mission/Instrument/Product Types that hold the data products you want (in most cases, these are synonymous with data sets but there are a few product types such as ANCILL that are included with the primary product type in a data set). Expand the “Select One or More Desired Data Sets” bar. This reveals a list of available product types organized by mission and instrument. Only the most commonly used product types are shown by default in the list. Some instruments have additional, less commonly used product types, typically raw data product types that can be seen by selecting the “Other Product Types” in the instrument header bar. Mission/Instrument/Product Type entries containing products with latitude and longitude location information are identified with the following icon: . Entries containing observation time data are identified with the following icon: . Entries containing product emission, incidence, and phase angles data are identified with the following icon: . Entries containing solar longitude data are identified with the following icon: .

To select a product type, simply click in the box next to the type name. You may select one or more product types however you must select at least one before you may query ODE. Additional information on the data sets that contain these product types may be found in the “Data Set Description” link. Please note that CRISM is a complex instrument and ODE offers several specialized product type queries. These are found under "TRDR / Additional TRDR Subsets". If you are unfamiliar with CRISM data sets and are interested in CRISM data products, please review the “CRISM Product Primer”, the “CRISM Product Description”, and the “Suggestions on Finding CRISM Products” links before proceeding.

You may use the check boxes to select the desired products types to include in your search. Remember to use the Reset Form button if you want to clear all selected product types at once.

Example:

Step 2. Set Additional Filtering Parameters (Optional)

This is an optional step of the product search. From this section you can filter results by Product ID, to a specific latitude / longitude range, by a specific creation or observation time range, and/or observation angle.

Example:

Filter by Product ID

Each PDS data product has a “Product IDentifier (Product ID)”. The Product ID is a permanent, unique identifier assigned to a data product by its producer. The Product ID is unique within a data set. The Product ID is a character string up to 40 characters in length. Many producers embed information about the data product in the Product ID. For example, the Product IDs of HiRISE data products include both the mission phase and the orbit number in which the data product was generated.

The “Select a Product ID or filter by a partial Product ID” field allows you to select an individual data product via its Product ID or, more commonly, select only those data products who’s ids match a wildcard string. Additionally, the search has been expanded to accept a list of Product IDs or wildcard combinations. The list is limited to 50 entries.

Basic examples:

Exact Product ID match: FRT000175F3_01_RA156L_TRR3

Partial Product ID matches: FRT000175F3* (any Product ID starting with this pattern)

FRT000175F3_01_RA156L_TRR* (a more narrow wildcard search for any version of this product in the selected data set)

*175F3_01_RA156L* (any product containing the text in the middle of the Product ID)

You could limit your search to only those HiRISE data products that occurred during the Primary Science Phase of the MRO mission by entering PSP* into the Product ID field. NOTE: Using this field requires knowledge of the Product IDs. If you do not know the Product ID structure of the data set you are interested in, refer to the data set's software interface specification document (SIS).

Example:

Find by Product Latitude / Longitude

Expand this bar and you will be able to filter your product query based on their footprints in areocentric (Mars ODE) or planetocentric (Lunar ODE, Venus ODE, & Mercury ODE) latitude / longitude coordinates.

The areocentric coordinate system is a right-handed system with the origin at the center of mass of Mars. Areocentric latitude is the angle between the equatorial plane and a vector connecting a point on the surface and the origin of the coordinate system. Latitudes are positive in the northern hemisphere and negative in the southern hemisphere. Areocentric longitude increases to the east.

The planetocentric coordinate system has an origin at the center of mass of the body. The planetocentric latitude is the angle between the equatorial plane and a vector connecting the point of interest and the origin of the coordinate system. Latitudes are defined to be positive in the northern hemisphere of the body, where north is in the direction of Earth's angular momentum vector, i.e., pointing toward the hemisphere north of the solar system invariant plane. Planetocentric longitude is measured around the equator of the body from a prime meridian defined and adopted by international agreement. Longitudes increase toward the east making the Planetocentric system right-handed. Radius is the distance from the planetary body’s center of mass to the point of interest.

A warning will be displayed if data sets have been selected that do not have product latitude / longitude footprint coordinates. The message explains that no results will be returned for the listed data sets if coordinates are entered because the products will not match the search criteria.

There are three options for selecting a location. First, a list of USGS features are available from the drop down boxes "Feature Types" and "Feature Names". Once a feature name is selected, it's bounding box limits are entered in the Lat/Lon range text boxes below. The location is also highlighted in the image to the right of the range text boxes. The second option is to manually enter your desired Lat/Lon range in the text boxes. After all four parameters are entered, click the Refresh Map Button to display the selected area on the mini-map image.

The third option is the new beta feature, which supports the selection of a custom coverage area on a small interactive map. A further description of this new feature is listed after the following image.

Find by Location or Feature options:

Select custom coverage area

This new feature allow a user to zoom in and out of a map interface and interactively select a custom coverage area. A selected query area of either a rectangle or a free hand polygon is used for the product search. Below is a table describing the actions of each map toolbar item. Use the "Select Area as Rectangle" or "Select Area as Polygon" buttons to select the desired area on the map. Once an area is highlighted with a red line (using one of the previously mentioned buttons) to indicated the selected area, text will be displayed under the map stating: "Custom coverage area - Selected". The text confirms that the user's desired custom location will be used for the product search. To cancel a custom selection, click the "remove area selection" button on the map toolbar, the "clear feature selection" button, or the "reset form" button.

Contact the ODE development team (ode@wunder.wustl.edu) with any questions or feedback about this new feature.

Map Toolbar Reference Guide

Name

Icon

Description

Zoom in

Click and drag a rectangle: Click and hold the left mouse button down on the map at one corner of the rectangle to zoom in to. Drag the mouse to the other corner of the rectangle, and release the mouse button. The map will zoom in to the area of the rectangle.

Zoom out

Click and drag a rectangle: the map will zoom out so that the current map area will fit into the rectangle drawn. The smaller the rectangle you draw, the more the map will zoom out.

Full Extent

Full extent: Immediately zooms the map out to the area of all features and layers. The active tool does not change.

Pan

Click and drag the map: Click and hold the left mouse button on the map, and drag the map. The map will be re-centered, with the location dragged at the location you dropped it.

Select Area as Rectangle

Click and drag a rectangle: Click and hold the left mouse button down on the map at one corner of the rectangle to highlight on the map. Drag the mouse to the other corner of the rectangle, and release the mouse button. The map search interface will query your selected (and possibly filtered) map layers for products with footprints intersecting your selected area. The results will be displayed in the View Selection Results Tab of the map interface

Select Area as Polygon

Click and drag a desired shape: Click and hold the left mouse button down on the map at the starting location. A counter clockwise motion to draw the desired shape is recommended. Release the mouse button, and the polygon will be automatically closed from that location to the starting point. The map search interface will query your selected (and possibly filtered) map layers for products with footprints intersecting your selected area. The results will be displayed in the View Selection Results Tab of the map interface.

Remove Area Selection

Click Button: Click this button to remove your selection area. This will also reset the View Selection Results tab contents because no area selection will exist after pressing the button.

Map Help

Click Button: Click this button to display the search page's map help overview page (this page).

Filter by Time Range

You may also filter your query by observation time or product creation time. An observation time query filters products by observation UTC Start and Stop time range. It will find products with an observation time within the specified range, and products with an observation range covering your query parameters. The product creation time query finds products that were created by instrument teams within the specified UTC time range. The product creation time is set from the product’s PRODUCT_CREATION_TIME label field.

You may filter by either a single value or a value range. If you enter just a single value in the first field, ODE will select products that start with the entered value. For example, if you enter “2007-11”, ODE will return only products with an observation time that covers or falls in 2007-11-xxTxx:xx:xx. If you enter “2007-11-01T00.13.27”, ODE will return only products with an observation period during that point in time. You may also enter a range by entering values in both fields. ODE will select products within that range, products that cover the range, and products that overlap the range.

Example:

Solar Longitude Filter

The solar_longitude element provides the value of the angle between the body_Sun line at the time of interest and the body_Sun line at the vernal equinox. This provides a measure of season on a target body, with values of 0 to 90 degrees representing northern spring, 90 to 180 degrees representing northern summer, 180 to 270 degrees representing northern autumn and 270 to 360 degrees representing northern winter. More information on the Mars calendar is found here.

Enter a desired range to filter by season. An individual solar longitude can be entered for a very narrow search, limited to just that solar longitude.

Example:

Mars Year Filter

April 11, 1955 (Ls=0 deg) has been adopted as the beginning of year 1. The solar longitude range 0°-360° is used to define a Mars year. More information on the Mars calendar is found here.

If a only a Mars year minimum is entered, the search will limit the query to PDS products having an observation time during that Mars year. An entered Mars year range will limit the search to PDS products having an observation time during the entered minimum and maximum year range, including the entire maximum year.

Example:

Table of Mars Years and UTC start times

Mars Year

UTC Start Time

1

1955-04-11T10:43:58

2

1957-02-26T09:43:56

3

1959-01-14T09:44:54

4

1960-12-01T09:20:52

5

1962-10-19T08:12:50

6

1964-09-05T07:31:48

7

1966-07-24T06:50:46

8

1968-06-10T05:28:44

9

1970-04-28T04:57:42

10

1972-03-15T04:49:39

11

1974-01-31T04:22:34

12

1975-12-19T03:36:31

13

1977-11-05T03:01:27

14

1979-09-23T01:37:23

15

1981-08-10T00:48:54

16

1983-06-28T00:43:51

17

1985-05-15T00:02:48

18

1987-04-01T22:56:45

19

1989-02-16T22:47:42

20

1991-01-04T21:50:38

21

1992-11-21T20:36:35

22

1994-10-09T20:18:31

23

1996-08-26T19:52:28

24

1998-07-14T18:53:25

25

2000-05-31T18:19:58

26

2002-04-18T17:29:56

27

2004-03-05T16:15:54

28

2006-01-21T16:11:51

29

2007-12-09T16:00:49

30

2009-10-26T15:00:46

31

2011-09-13T14:11:44

32

2013-07-31T13:42:41

33

2015-06-18T12:20:39

34

2017-05-05T11:32:36

35

2019-03-23T11:20:34

36

2021-02-07T10:59:32

37

2022-12-26T10:06:30

38

2024-11-12T09:33:28

39

2026-09-30T08:16:26

40

2028-08-17T07:12:24

41

2030-07-05T07:05:22

Filter by Observation Angle

Products that are cataloged in ODE can be filtered by observation angles, assuming the values have been provided in the corresponding PDS product labels. The minimum and maximum ranges in the system are displayed in this section. Search results are limited to values greater than or equal to the user provided minimum numbers and less than or equal to the maximum user provided values. A user can filter with just maximum or minimum values, as well. This would provide all results with a value less than x or greater than x.

Example:

Below are the PDS data dictionary definitions for the PDS product label values that are stored in ODE and filtered from the product search page.

Emission Angle

The emission_angle element provides the value of the angle between the surface normal vector at the intercept point and a vector from the intercept point to the spacecraft. The emission_angle varies from 0 degrees when the spacecraft is viewing the subspacecraft point (nadir viewing) to 90 degrees when the intercept is tangent to the surface of the target body. Thus, higher values of emission_angle indicate more oblique viewing of the target. Values in the range of 90 to 180 degrees are possible for ring data.

Incidence Angle

The incidence_angle element provides a measure of the lighting condition at the intercept point. Incidence angle is the angle between the local vertical at the intercept point (surface) and a vector from the intercept point to the sun.

The incidence_angle varies from 0 degrees when the intercept point coincides with the sub_solar point to 90 degrees when the intercept point is at the terminator (i.e., in the shadowed or dark portion of the target body). Thus, higher values of incidence_angle indicate the existence of a greater number of surface shadows. Note: In PDS labels for Magellan's altimetry and radiometry products, and for Lunar Reconnaissance Orbiter Mini-RF products, incidence_angle is defined as the value of the angle between the local vertical and the spacecraft direction. For Magellan this is measured at the center of the radiometer footprint at rad_spacecraft_epoch_time.

Phase Angle

The phase_angle element provides a measure of the relationship between the instrument viewing position and incident illumination (such as solar light). Phase_angle is measured at the target; it is the angle between a vector to the illumination source and a vector to the instrument. If not specfied, the target is assumed to be at the center of the instrument field of view. If illumination is from behind the instrument, phase_angle will be small.

Step 3. Preview Search Results Summary (Optional)

A new optional feature of ODE is the ability to preview a summary of the search results before proceeding to view the search results in table or on the map. After entering your desired search criteria, click the “Preview Search Results Summary” button to view the results summary. Remember that a data set selection is required to preview the search results summary and to submit a query.

Example:

Step 4. Submit Query

Once you have completed your selections and filters, you query ODE via the “View in Table” and “View on Map” buttons. “View in Table” will show your results in a Product Search Results page. “View on Map” will show your results on the map page. NOTE, only products that have areocentric (Mars ODE) or planetocentric (Mercury, Venus, and Lunar ODE) locations will be shown in the map. This is, in effect, an additional query filter.

A warning will be displayed if more than 50,000 products match your selected search criteria. The message warns that you may experience a slow response time when viewing large query result sets on the map, but you can still proceed by clicking the desired view results button again.