Excerpt |
---|
This page provides an overview on how to use the MAST Mission Search to find MAST data collections. The description of each form component on this page |
Warning |
---|
|
This page is under construction. |
Excerpt |
---|
On this page, we'll review each component of the Mission Search user interface. The example we will use is based on theHST search form: by design, other data collections will use the . Info |
---|
Future Searches for other MAST mission data and collections will adopt the same or similar components. | When relevant, we will specify any Any components that are only available | in for specific data collections will be documented. |
|
Form
To guide discussion, it is helpful to define This section describes the field guide to the major components of the Mission Search form. There There are two three main areas: the front-page search form and , the search results table, and the download overlay. Each numbered box in these figures is described in a corresponding numbered section below.
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
borderStyle | solid |
---|
|
<image here - annotated screenshot of front page breaking down the major areas>
Figure 1 — The major components of the front-page search form. Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
borderStyle | solid |
---|
|
<image here - annotated screenshot of search results table breaking down the major areas>
Figure 2 — The major components of the search results table. Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
borderStyle | solid |
---|
|
<image here - annotated screenshot of download overlay breaking down the major areas>
Figure 3 — The major components of the download overlay.<200 pixel screenshot of the major component>Image Added
The search form is where users specify the search parameters and constraints to create their search. The available searches include:
Each field in this search form provides a tooltip as a quick guidance. Users can hover over each field with their mouse to see the tips. Specific functionality of each component is summarized below.
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
|
Description of what you can do within this component.
Perform a cone search by typing either an object name or the coordinates directly. Multiple object names, coordinates, or combinations of both are allowed by pressing 'return' or 'tab' keys after each object. Use the 'UPLOAD LIST OF TARGETS' button to upload a comma-separated file containing the object names, coordinates, or specific dataset IDs. Users can set the size of their cone search in arcminutes or arcseconds. This section is not required to conduct a search: users can leave it blank and search based only on other parameters. To start querying, click the Search bar at the bottom of the page. More info. Note |
---|
Object names in this component are used only to resolve into coordinates using a name resolver. |
|
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Use these fields to build advanced searches. Add search constraints based on the most commonly used observation parameters like instrument, proposal information, filter/grating, or start/end times. Each parameter accepts regular expressions, for example, greater than or less than for numerical fields or wildcard characters for string fields. If the default filters on the component do not include the specific parameter needed, see the 'Add Condition' section below for further search options. More info. |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Use 'Add Condition' to further constrain the search. Search for a column based on names and descriptions, or scroll through the complete list in the 'Column Name' text box. The search condition can include numerical constraints or wildcard characters for string fields. Use the 'ADD ANOTHER CONDITION' button to add multiple constraints and columns.More info. |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
The search bar is always located at the bottom of your screen. Clicking the 'SEARCH' button starts the search. Clicking the 'SHOW API QUERY' button generates a script using the Application Programming Interface (API) for MAST Mission Search, based on the search parameters entered into the form. This can be a great way to learn how to construct queries programmatically. Reset the form using the 'CLEAR FORM' button on the left. More info |
<200 pixel screenshot of the major component>
Description of what you can do within this component Anchor |
---|
| search_results_table |
---|
| search_results_table |
---|
|
Image Added
The search results table contains observations that match the search parameters. If a list of targets (object names, coordinates, or dataset names along with other information) is uploaded, all uploaded parameters will be included as additional columns in the results table. See the section Cone Search And Upload List Search for valid file formats. <200 pixel screenshot of the major component>
Anchor |
---|
| download_overlay |
---|
| download_overlay |
---|
|
Image Added
Each dataset contains one or more files, including calibration files, uncalibrated observations, and calibrated observations at various levels of processing. It is possible to download only specific file types across the datasets or all the files that are available. The Download Overlay allows filtering by product types and extensions, and selection of specific files to download from each dataset. Files that are selected using the checkboxes remain selected to be downloaded even if additional filters are applied in the overlay to make them no longer visible in the overlay. Only deselecting a file will exclude it from the download.
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Use this component to show and hide product types in the table. Then use checkboxes to select the newly visible rows to mark for download. By default, the table shows only calibrated products, all of which are selected. More info. |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Use this component to show and hide files by product extension. By default, all product extensions are selected. More info. |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Filter files by typing any string in the search box, which will match against file name, extension, instrument, or the filter/grating. This search box will only show files that are already visible in the table, so make sure to select all file types and extensions to find specific files. More info. |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Download selected files directly using the 'START DOWNLOAD' button at the bottom of the download overlay window. The files will download as a zip file. The majority of data collections are publicly available, but a small amount is temporarily available for certain people. Downloading non-public datasets requires permission to retrieve those files (granted by the Principal Investigator of each observing program) and logging into your MyST account. For login information, see MAST User Accounts. More info. |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Image Added |
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
The 'DOWNLOAD WITH API QUERY' button provides an alternative to downloading the zip file. It allows downloading a script containing terminal commands such as cURL to download the selected files sequentially. This button can also be used to learn how to write a programmatic script to download files. More info |
Description of what you can do within this component