|
|||||||||||||||||||
|
|||||||||||||||||||
 |
|||||||||||||||||||
|
|||||||||||||||||||
|
|||||||||||||||||||
| FAQ |
|
High-Level Science Products |
|
|
Software |
|
|
FITS |
|
| Archive Manual |
|
| Related Sites |
|
|
NASA Datacenters |
|
| MAST Services |
|
|
MAST and the VO |
|
|
Newsletters & Reports |
|
| Data Use Policy |
|
| Dataset Identifiers |
|
| Acknowledgments |
|
|
MAST Web Services
HTTP GET Requests- Script Examples
- Mission Searches
- Simple Cone Search
- Simple Image Access Protocol
- Simple Spectral Access Protocol
RSS News Feed
Soap Services
HTTP GET Requests
MAST data holdings can be searched not only using HTML search forms and applications such as Aladin, Datascope, Specview, etc., but also using HTTP GET requests. The GET request allows the search parameters to be included in the URL. As such, they can be called from within programs to automate data searches. The results can be returned in a variety of formats including HTML, VOTable XML format, excel spreadsheet, and comma-separated values which can simplify ingesting results into user-written programs. In addition, submitting GET requests can bypass restrictions currently placed on the web search forms (e.g., restrictions on the max_records value). Unfortunately, there has been little documentation on how the GET requests are formulated. This document will summarize the services currently available from MAST and give examples showing how they can be used.Remember, when creating URLs, special characters must be encoded. URLs may only use alphanumerics [0-9a-zA-Z], the characters "$-_.+!*'()," and special reserved characters. The characters "<" and ">" must be specified as "%3C" and "%3E" respectively. For example, to specify a parameter such as RA > 120, the GET request parameter would be RA=%3E120. Blanks can be specified using the "+" character.
Mission search examples:
Script Examples
Scripts for retrieving MAST search results can be written
in many programming languages. Basically you just need to
download and extract information from a web page.
A few simple examples are shown below. We welcome more examples
from users.
Mission Searches
In general, mission searches are specified in the form:
http://archive.stsci.edu/[data set]/search.php?action=Search¶ms
where [data set] is the MAST-defined acronym for a particular
set of data, and params is the list of search parameters as defined below.
Note that "action=Search" is a required parameter for mission search requests.
For the pointings search however, action may equal either "Search+Pointings"
or "Search+Exposures"
The current list of data sets that can be searched in
this manner include the following:
The search parameters include both general and mission-specific.
and are described in the following pages:
In general, any parameter listed on the HTML search
form can be specified in a GET request. If you are parsing
the results, it would be easier and probably faster, to request
the search results in CSV or VOTable format using the "outputformat" parameter.
Notes:
http://archive.stsci.edu/hst/search.php?sci_pep_id=9293
&max_records=1000&outputformat=CSV&action=Search
http://archive.stsci.edu/hut/search.php?action=Search&target=m+81
&selectedColumnsCsv=hut_target_name,hut_data_id
Simple Cone Search (SCS)
MAST missions can also be searched using the
NVO Simple Cone Search protocol (SCS).
The base url is the same as for MAST mission searches
(i.e., http://archive.stsci.edu/[data_set]/search.php)
without the "action=Search" parameter.
The search radius parameter "SR" must be included in the URL
for the cgi script to recognize a simple cone search is being requested.
Besides the search radius in decimal degrees, RA and DEC parameters are also
required to perform a cone search. The results are returned in VOTable format.
The SCS protocol can be used with any MAST mission and the
general MAST parameters can be included as well.
Examples:
Simple Image Access Protocol (SIAP)
MAST missions can also be searched using the
NVO Simple Image Access protocol (SIAP).
The base URL is
http://archive.stsci.edu/siap/search.php
followed by the SIAP parameters.
Like the Simple Cone search, the base url is similiar to that for mission searches however
only missions with image data are searchable.
By default, up to 300 entries will
be returned but specifying max_records=nnn can override the default.
Adding the parameter "representative=y" will return only "representative"
images as defined for the MAST scrapbook tool.
Currently the list of instruments, and
High Level Science Products (HLSPs) that can be queried using the SIAP include:
SIAP Examples:
http://archive.stsci.edu/siap/search.php?format=metadata
Simple Spectral Access Protocol (SSAP)
The
Simple Spectral Access Protocol (SSAP) will be supported when
the new standard has become better defined. See also the
Simple Spectral Data Model.
Plans are being made to support SSAP for all MAST missions containing
spectral data.
RSS News Feed
Another MAST web service is our RSS news service.
This is a list of our most recent news items which can be
requested in HTML or RSS XML-format:
shows last 10 entries (by date) in html with descriptions
shows same in rss xml format
summary in html of last 10 (no descriptions)
show entry 25 in html
SOAP Services
We have one SOAP-based web service which is accessed via the ADS.
The web service allows users to enter a data set name and find where
it is archived. The service can be accessed from the web form at:
http://ads.harvard.edu/ws/DataVerifier,
or, using the latest
ADEC naming conventions:
http://vo.ads.harvard.edu/dv/DataVerifier.cgi
|
||||||||
|
||||||||
|
||||||||
|
||||||||
|