Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DraftMASTDOCS and version 1.3
Warning
titleUnder Construction

This page is under construction.

Excerpt
hiddentrue

Panel
borderColor#00617E
borderWidth2px
borderStylesolid

On this page...

Component Overview

A description of the Search Results Page: Column Sorting, Pagination, Page Size, Row Selection, Download Button, Export Search Results Button, Edit Search Button.

Component Features and Functionality

Below you can find a description of the features and capabilities of this component.

<200px image or animated gif>


Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Widget Connector
width100%
urlhttps://www.youtube.com/watch?v=vZvlsPops_4

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Anchor
sort_columns
sort_columns

How To Sort Columns

Component description text.

Sorting Columns

The columns of the search results table can be sorted in ascending or descending order by clicking on the column names. Multi-sort is supported—the table can be sorted by first one column, then a second, then a third, etc. Click a column name once to sort by ascending order (upward arrow and a number will show up next to the column), then again to sort by descending order (downward arrow and a number shows up next to column). Click a third time to turn off sorting for that column and the arrow and number will disappear.

Specification of multi-sort:

  • A number and an arrow will show up when sort functionality is active.

  • Ascending order can be verified by the upward arrow next to the column name

  • Descending order can be checked by the downward arrow next to the column name
  • The order of multi-sort can be determined by the number next to the arrow and the column name
Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image Added

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>

Anchor
pagination
pagination

How To Use Pagination

Component description text.

  Using Pagination

For search results larger than the page size, use the pagination buttons on either the top right of the table just above column names, or at the bottom right of the table to jump through the pages. To the left of pagination, the number of rows shown per table page is listed compared to the total number of observations retrieved. The pagination has options to jump to the first page (Image Added), the previous page(Image Added), the next page (Image Added), and the last page of search results(Image Added).

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image Added

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>

Anchor
page_size
page_size

How To Set

Setting The Page Size

Component description text.

The page size is controlled with the 'Rows per page' drop-down menu. By default, 500 results per page are displayed. It can be adjusted to show 50, 100, 250, 500 or 1000 rows per page. 

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image Added

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>

Anchor
row_select
row_select
 Row Selection

Component description text.

To select datasets to download or select rows to export, use the selection checkboxes on the far left in the table. The top-most checkbox that is inside the header row will select all the rows on the current page. Click that box again to deselect all rows on the current page. The checkbox at the far left of  each row of the results table will select or deselect that individual row.

Info

NOTE: The top-most checkbox selects all rows only on the current page. It does not select all the rows across all the pages. Rows that are selected or deselected will remain selected/deselected as the results table is paginated.

If there are too many results, consider constraining the search with Search Parameter Overview and Additional Search Parameters

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image Added

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>

Anchor
download_button
download_button
 The Download Button

Component description text.

As datasets are selected in the results table, the 'DOWNLOAD DATA' button will become active. When ready to retrieve products for the selected datasets, press the button to begin the download process.  From the download data menu, either press the 'Choose Files' option to open the Download Overlay or use one of the 'Quick API Script' options to download a curl script to programmatically retrieve the files associated with the selected datasets.

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image Added

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>

Anchor
export_button
export_button
 The Export Button (Exporting Search Results Table)

Component description text.

The search results table itself (that is, all the metadata shown in the table) can be exported in a variety of formats. All rows in the entire search results table can be exported, unlike downloading datasets. Alternatively, only selected rows can be exported. The supported export formats are CSV, JSON, and VO Table formats.

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image Added

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>

Anchor
edit_search_button
edit_search_button
 The Edit Search Button

Use the 'EDIT QUERY' button to change the search parameters. To start a new search, use the button and then use the 'CLEAR FORM' button to reset the search form.

Warning

Clicking the back button of the browser will lose the previous search history. Make sure to use "EDIT QUERY" to further constrain the existing search.

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image Added

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Anchor
non_public_results
non_public_results
 Non-Public (Exclusive Access) Search Results

Some data collections have products that are not publicly available to download, for example some of the HST observations. However, the metadata associated with those observations are publicly available. Any search results that contain observations that are not publicly released yet are shown with a yellow background in the search results table. The observational metadata in the search results table may be exported, but the products may not be downloaded unless signed into a MyST account that is authorized by the Principal Investigator of the observations to download those products. For login information, see MAST User Accounts. For more information, see Download Overlay section

Component description text

.


For Further Reading...