The Advanced Search Window
Advanced searches, using an expanded set of metadata, are provided for certain MAST data collections, including the default search of MAST Missions. Clicking the Advanced Search link below the Portal target name/coordinates dialog box will bring up the MAST Advanced Search window, which is shown below.
Applied Filters Panel
Filters for which values or ranges have been applied are summarized in the Applied Filters Panel. Filters may be removed individually, or with the Clear All button. Specific filters may be selected in the Columns Panel; values or ranges of values may be set in the individual Filter dialogs.
The term "filters" is, unfortunately, overloaded. Astronomers often think of filters as passband-limiting optical elements. In this context, filters are used to select a subset of available results using one or more criteria.
The Advanced Search enables custom searches with a wider variety of criteria that may, but do not necessarily, include a target name or coordinates (as with Basic Search). As criteria are applied, preliminary searches will be performed in the background to update the Records Found count at the top of the window. This helps narrow the search to a manageable number of results.
The count of search results must be <50,000 to load the results into the MAST Portal, or <500,000 to download the results to a local file.
Search criteria are specified by:
- selecting one or more available filters in the Columns panel, and
- specifying the values (or range of values) in the corresponding dialogs in the Filters panel.
Filters dialogs come in three flavors depending upon the type of parameter, as described below.
About 30 filters are available for restricting search parameters. They map to user-accessible metadata in the MAST CAOM (Common Archive Observation Model) database.
Object Name or Position
|Search for a given target name or coordinates, which is analogous to the primary search Portal search bar (see Basic Search).
|Restrict the search to 'science' or 'calibration' observations.
|Name or acronym for the mission that obtained the data. High-Level Science Products are collected in the 'HLSP' mission.
|Identifier of the software or team that produced the data.
|Acronym for the science instrument used to obtain the data.
|Similar to the 'Mission' field (identical in most cases) but reflects the originating mission, e.g. HST-based HLSPs will have 'HST' in this field.
|Select one or more specific instrument filter names (i.e., pass-bands).
|Designation of wavebands (broadly defined).
|Target name or field as specified by the PI in the observing program.
|Target classification in the STScI proposal database, such as 'STAR' or 'GALAXY'.
|The meaning is specific to a missions, e.g. the Sector number for TESS observations.
|Search for a specific observation ID or similar observation ID's using wildcards.
|Specify a range of Right Ascension. Values are displayed in sexagesimal but can be entered in degrees.
|Specify a range of Declination. Values are displayed in sexagesimal but can be entered in degrees.
|Filter on proposal/program ID number. Remember to zero-pad on the left to 5 digits, or use a wildcard character.
|Filter on certain Principal Investigator names. Wildcards are advised.
|Specify certain data product types, such as 'image' or 'spectrum'.
|Filter on numerical calibration levels assigned to observations. High-Level Science Product (HLSP) data are designated Level 4, while planned-but-not-executed observations are Level –1. The meaning of a level is mission-specific.
|Specify a range of observation start date-times in UTC
|Specify a range of observation end date-times in UTC.
|Specify a range of exposure lengths in seconds.
|Specify a range of lower-bound wavelengths in nm.
|Specify a range of upper-bound wavelengths in nm.
|Filter on specific proposal titles.
|Specify a range of data release dates. For Exclusive Access data, this date may be in the future.
|Filter on specific proposal types, such as 'GO' or 'SNAP'. The appropriate types will vary by mission.
|Filter for 'PUBLIC' or 'EXCLUSIVE_ACCESS' data permissions (or 'PROPRIETARY' but this is being phased out going forward).
|Use this boolean flag to filter moving target objects.
|Product Group ID
|Filter on product group ID's from MAST databases.
|Filter on object ID's from MAST databases.
Executing a Search
After adding the desired search parameters, there are two options to inspect the matching observations.
|Click the Search button to load the search results into a tab in the MAST Portal. The 'Records Found' count must be under 50,000 for this option to become available.
|Click the Export Table button to download the table of search results as a file (CSV, VO Table, or JSON). This will work with search result counts up to 500,000.