On this page...

The Portal enables searches of a few special collections, most of which can be selected from the collection menu.

Search Virtual Observatory Collections

The Virtual Observatory (VO) is composed of electronic archives from many astronomical centers around the world. These archives contain a wide variety of data and other resources, including catalogs, images, and spectra. The results of a VO search will look similar to that shown in the figure below.

VO search for M57A search of the VO for the target M 57. The results table shows all VO resources (images, spectra, or catalogs) within a 1 arcmin radius. The Data Load button in each row will provide more descriptive information and links to retrieve the data.

Searching the VO with the Portal differs from a basic search in a few important respects:

  1. Searches are only by target name or sky coordinates; there is no "advanced search" option.
  2. The resuts of a VO search are not observations of a target. Rather, the table rows contain metadata about each VO resource, including the type of data objects (images, spectra, catalog).
  3. To access science data, click the Data Load buttonData Load button, which in effect initiates a search of that resource to return the associated science data. This action is referred to as a drill-down, and is a key component of using the Portal to explore multi-tiered data hierarchies, such as those in the VO.
  4. Click the file iconFile iconin a given row to retrieve the science metadata (in XML format) associated with that resource.
  5. Optionally download the metadata in the results table to a file on your local system by clicking the export button Export Button. Select your desired output format in the Export dialog.

VO searches are effectively simultaneous searches of multiple astronomical archives. It may take considerable time (minutes) for the last archive to return results. Since the results are displayed as they become available, it is possible to browse or download some results while others are still being loaded.

Search the Hubble Source Catalog

The Hubble Source Catalog (HSC) consists of photometry of sources that have been imaged with one or more instruments on HST. MAST supports multiple ways to search the HSC; the Portal allows searches in a circular region around a user-specified position on the sky (a cone search). Searching the HSC is a form of catalog search, and the chapter on Demos and Tutorials shows several science-motivated example searches.

Although an earlier version of the HSC is still available, it is best to search the version 3 catalog (HSCv3), which is substantially better and now contains the Hubble Catalog of Variables.

As with VO searches, an HSC search returns results that differ from a basic search in a few important respects:

  1. Searches are only by target name or sky coordinates; there is no "advanced search" option.
  2. It is possible to retrieve brightness measurements that were made using a finite aperture (MagAper2), or an approximate total brightness (MagAuto). See Whitmore, et al. 2016 for details.
  3. The results of an HSC search are not exposures of a target. Rather, the table rows contain photometric measurements and other metadata about each source.
  4. It is possible to access the images that contributed to each photometric measurement by clicking the Data Load iconData Load Icon. These images can be overlayed in the AstroView tool by clicking the Overlay iconOverlay icon.
    1. To retrieve one or more of the contributing images, click the Download Basket iconDownload Basket Icon; or click the File iconFile Icon to instantly download a single image.
  5. Optionally download the photometric results table (or selected rows within the table) to a file on your local system by clicking the Export button Export Button. Select your desired output format in the Export Dialog.

Create a DOI

A Digital Object Identifier (DOI) is a persistent link to a resource on the internet, and is often used in astronomy to provide access to specific data collections. Investigators can use a special instance of the Portal to generate a DOI for one or more datasets hosted by MAST. This will generate a permanent link that may be included in a research paper to refer to the data that were analyzed.

DOIs for many collections, including High-Level Science Products, certain catalogs, and Kepler/K2 campaigns have already been created. To use them in your work, see the detailed DOI documentation. To create a new custom DOI for data you wish to publish, see the following how-to video, or follow the written instructions below.


Create-a-DOI walkthrough video.



InstructionNotes
1

Navigate to the DOI Portal at: https://mast.stsci.edu/portal/Mashup/Clients/DOI/DOIPortal.html.

You must login to the Portal to create a DOI.

DOI Portal Logo

Portal Login Box
2Execute a Portal search for observations that include the data to be published.

'Search by' dropdown menu

3

Select rows in the results table that correspond to the specific observations to which the DOI should refer, and place them in the download basket.

If necessary, make multiple searches and place relevant observations from each in the download basket.

'Add to DOI basket' button

4Click the My DOI Basket button to bring up Download Manager, which will look something like the picture below.

'My DOI basket' button


Example DOI basket

5Select the rows corresponding to the desired observation IDs and filters, then click the button to create a DOI. If you need to update an existing DOI you created, contact MAST.

Create and Upload DOI buttons


6Fill in the DOI requested metadata in the dialog box, then click the Create DOI button.

'Create DOI' box with metadata fields

To update a DOI you created with new information, contact the HelpDesk.

Load a DOI

There are three ways to access the data that a MAST DOI points to:

  1. Resolve the DOI in your browser. For example, for the TESS Input Catalog (doi:10.17909/fwdt-2x66, from the list of pre-made MAST DOIs), the following URLs will both work:
           https://dx.doi.org/10.17909/fwdt-2x66
           https://archive.stsci.edu/doi/resolve/resolve.html?doi=10.17909/fwdt-2x66
    These will lead you to a landing page, where you can follow a link to "display data":

    A MAST DOI landing page. A link labeled Display Data is highlighted.

    Depending on the nature of the data cited by the DOI, the "display data" link will either load a set of observations in the Portal, or lead to another webpage with information about retrieving the data.

  2. You can search for a MAST DOI's observations using the general-purpose MAST Portal as follows. This will only work if the DOI you wish to access points directly to observations in the MAST Portal. (So it won't work for the TESS Input Catalog pre-made DOI we used above. We'll instead use 10.17909/t9-z1c2-ye93, a DOI created using the MAST DOI Portal by the authors of a paper who wanted a permanent reference to the data that they employed. You would typically find a DOI like this one by encountering it in a paper.) 


    InstructionNotes
    1Navigate to the Portal at: https://mast.stsci.edu/portal/Mashup/Clients/Mast/Portal.html

    MAST Portal logo.

    2Under the Select a collection... dropdown menu, choose Observations in a DOI.

    Dropdown for Select a collection. Observations in a DOI is highlighted.

    3Enter the DOI string (e.g., 10.17909/t9-z1c2-ye93) into the search field, and click Search.

    Under Enter a DOI, a number beginning 10.17909 is typed into the search field.

    This method will not work for certain pre-made MAST DOIs for catalogs, HLSP webpages, or bulk mission data, which point to informational webpages or custom download scripts even when the data actually are available in the Portal.

  3. You can use the MAST DOI Portal view any DOIs that you have created using your account. You will not be able to download data using this method; see above for data retrieval options.


    InstructionNotes
    1
    Navigate to the DOI Portal at: https://mast.stsci.edu/portal/Mashup/Clients/DOI/DOIPortal.html.

    You must login to the Portal to see the list of DOIs that you have created.

    DOI Portal Logo.

    Portal Login Box
    2Select Show my DOIs in the Search by... dropdown menu, and click the Load All button.

    Search By dropdown, with Show my DOIs highlighted. A button labeled Load All is to the right.

    3Select the Show DOI Data entry in the Actions column.

    Arrow points to an image of a telescope in the Actions column, which is the link to Show DOI Data.

Other Searches

A few special searches enable access to lesser-used or mission-specific collections, which are listed in the table below.

CollectionDescription
HSC SpectraA collection of tens of thousands of spectra in various bands associated with sources in the Hubble Source Catalog. Many of the sources are categorized by astrophysical type.
Hubble Spectroscopic Legacy ArchiveView representative UV spectra from a variety of astrophysical objects (just over 2000 sources in all). The data include co-added spectra where possible. See the HSLA Mission page for details.
WFC3 PSFSearch a library of observed point-spread functions (PSFs) from archived HST/WFC3 observations. These PSFs enable higher precision photometry of WFC3 observations. See PSF Search for more information about this collection.
JWST Instrument KeywordsSearch for JWST science data using header keyword metadata. See the Data Search page for more information about how to perform a search on JWST data.
JWST WSSSearch for JWST wavefront sensing (optical path difference) data. See the Supplemental Products page for details about this and other ancillary file types.

For Further Reading...

Data Use | Acknowledgements | DOI | Privacy

Send comments & corrections on this MAST document to: archive@stsci.edu