DataShop

a demonstration HAPI Server offering uniform access to Heliophysics data
   
point of contact: jon.vandegriff at jhuapl.edu

This server supports the HAPI 2.0 specification for delivery of time series data. The server consists of the following 4 REST-like endpoints that will respond to HTTP GET requests.
A small selection of datasets are available to showcase the server API.

Note that this web page allows manual interaction with a data server, but the intended use of this site is not this type of direct (human) interaction. Rather the data server is meant to be accessed via client software and so serve as infrastructure providing uniform and seamless data access.

The API is designed to be very simple so that it could be overlaid on top of any existing time series data collection. There are 4 types of requests the server can answer:
  1. capabilities - describe the capabilities of the server; this lists the output formats the server can emit (CSV and binary)
  2. catalog - list the datasets that are available; each dataset is associated with a unique id
  3. info - obtain a description for dataset of a given id; the description defines the parameters in every dataset record
    info?id=CASSINI_MAG_HI_RES
  4. data - stream digital content for a dataset of a given id; the streaming request must have time bounds (specified by request parameters time.min and time.max) and may indicate a subset of parameters (default is all parameters)
    data?id=CASSINI_MAG_HI_RES&time.min=2004-07-01T00:00:00Z&time.max=2004-07-01T01:00:00Z&include=header

The above API is shown in a generic way, with clickable examples. The following examples illustrate each of the four methods of the API on this particular server. In each example, when you click the button, an HTTP GET request is sent to the server and the response is displayed in the text area below.
http://datashop.elasticbeanstalk.com/hapi/catalog
http://datashop.elasticbeanstalk.com/hapi/info?id=CHEMS_RATES_FLUXES_FULL_TIME_RES
http://datashop.elasticbeanstalk.com/hapi/data?id=CHEMS_RATES_FLUXES_FULL_TIME_RES&time.min=2004-07-01&time.max=2004-07-01T02:00:00.000&include=header
Here are several different requests, which you can click on directly, and your browser will show the streamed result. You can also copy/paste the request (just the part shown) into the custom request box. Note that you can adapt or modify these requests by hand to play with different time ranges.

(results will be shown here)

List of all datasets

Below is a clickable list of links to the info (data header) and sample data (in several formats) for all dastsets available at this server.

CAPS_ELS_FLUX_HIRES
Description: Cassini CAPS/ELS electron spectra at the highest time resolution
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=CAPS_ELS_FLUX_HIRES
Sample Data Links
  CSV (with header): hapi/data?id=CAPS_ELS_FLUX_HIRES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&include=header
  CSV (no header): hapi/data?id=CAPS_ELS_FLUX_HIRES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z
  JSON (with header): hapi/data?id=CAPS_ELS_FLUX_HIRES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=CAPS_ELS_FLUX_HIRES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=binary&include=header
 
CASSINI_LEMMS_PHA_CHANNEL_1_MIN_AVG
Description: Cassini MIMI LEMMS PHA channel intensities at 1 min resolution
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=CASSINI_LEMMS_PHA_CHANNEL_1_MIN_AVG
Sample Data Links
  CSV (with header): hapi/data?id=CASSINI_LEMMS_PHA_CHANNEL_1_MIN_AVG&time.min=2004-05-02T00:00:00.000Z&time.max=2004-05-02T06:00:00.000Z&include=header
  CSV (no header): hapi/data?id=CASSINI_LEMMS_PHA_CHANNEL_1_MIN_AVG&time.min=2004-05-02T00:00:00.000Z&time.max=2004-05-02T06:00:00.000Z
  JSON (with header): hapi/data?id=CASSINI_LEMMS_PHA_CHANNEL_1_MIN_AVG&time.min=2004-05-02T00:00:00.000Z&time.max=2004-05-02T06:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=CASSINI_LEMMS_PHA_CHANNEL_1_MIN_AVG&time.min=2004-05-02T00:00:00.000Z&time.max=2004-05-02T06:00:00.000Z&format=binary&include=header
 
CASSINI_LEMMS_PHA_PITCH_ANGLES_10_MIN
Description: Cassini/MIMI LEMMS PHA Channel pitch angle distributions; 10 minutes with 10 degrees per PA bin
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=CASSINI_LEMMS_PHA_PITCH_ANGLES_10_MIN
Sample Data Links
  CSV (with header): hapi/data?id=CASSINI_LEMMS_PHA_PITCH_ANGLES_10_MIN&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T02:00:00.000Z&include=header
  CSV (no header): hapi/data?id=CASSINI_LEMMS_PHA_PITCH_ANGLES_10_MIN&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T02:00:00.000Z
  JSON (with header): hapi/data?id=CASSINI_LEMMS_PHA_PITCH_ANGLES_10_MIN&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T02:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=CASSINI_LEMMS_PHA_PITCH_ANGLES_10_MIN&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T02:00:00.000Z&format=binary&include=header
 
CASSINI_MAG_HI_RES
Description: Cassini magnetometer data as used by the MIMI team
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=CASSINI_MAG_HI_RES
Sample Data Links
  CSV (with header): hapi/data?id=CASSINI_MAG_HI_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&include=header
  CSV (no header): hapi/data?id=CASSINI_MAG_HI_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z
  JSON (with header): hapi/data?id=CASSINI_MAG_HI_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=CASSINI_MAG_HI_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=binary&include=header
 
CHEMS_PHA_BOX_FLUXES_FULL_TIME_RES
Description: CHEMS PHA flux box intensities for many species at the highest time resolution
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=CHEMS_PHA_BOX_FLUXES_FULL_TIME_RES
Sample Data Links
  CSV (with header): hapi/data?id=CHEMS_PHA_BOX_FLUXES_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&include=header
  CSV (no header): hapi/data?id=CHEMS_PHA_BOX_FLUXES_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z
  JSON (with header): hapi/data?id=CHEMS_PHA_BOX_FLUXES_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=CHEMS_PHA_BOX_FLUXES_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=binary&include=header
 
CHEMS_RATES_FLUXES_FULL_TIME_RES
Description: CHEMS rate channel intensities for many species at the highest time resolution
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=CHEMS_RATES_FLUXES_FULL_TIME_RES
Sample Data Links
  CSV (with header): hapi/data?id=CHEMS_RATES_FLUXES_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&include=header
  CSV (no header): hapi/data?id=CHEMS_RATES_FLUXES_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z
  JSON (with header): hapi/data?id=CHEMS_RATES_FLUXES_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=CHEMS_RATES_FLUXES_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=binary&include=header
 
LEMMS_PHA_CHANNELS_FULL_TIME_RES
Description: LEMMS PHA channel intensities and uncertainties at high time resolution
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=LEMMS_PHA_CHANNELS_FULL_TIME_RES
Sample Data Links
  CSV (with header): hapi/data?id=LEMMS_PHA_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&include=header
  CSV (no header): hapi/data?id=LEMMS_PHA_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z
  JSON (with header): hapi/data?id=LEMMS_PHA_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=LEMMS_PHA_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=binary&include=header
 
LEMMS_PRIORITY_CHANNELS_FULL_TIME_RES
Description: LEMMS Priority very high time resolution proton and electron channels
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=LEMMS_PRIORITY_CHANNELS_FULL_TIME_RES
Sample Data Links
  CSV (with header): hapi/data?id=LEMMS_PRIORITY_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&include=header
  CSV (no header): hapi/data?id=LEMMS_PRIORITY_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z
  JSON (with header): hapi/data?id=LEMMS_PRIORITY_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=LEMMS_PRIORITY_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=binary&include=header
 
LEMMS_REGULAR_CHANNELS_FULL_TIME_RES
Description: LEMMS regular channel intensities and uncertainties at high time resolution
Info: http://datashop.elasticbeanstalk.com/hapi/info?id=LEMMS_REGULAR_CHANNELS_FULL_TIME_RES
Sample Data Links
  CSV (with header): hapi/data?id=LEMMS_REGULAR_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&include=header
  CSV (no header): hapi/data?id=LEMMS_REGULAR_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z
  JSON (with header): hapi/data?id=LEMMS_REGULAR_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=json&include=header
  BINARY (with header): hapi/data?id=LEMMS_REGULAR_CHANNELS_FULL_TIME_RES&time.min=2004-07-01T00:00:00.000Z&time.max=2004-07-02T00:00:00.000Z&format=binary&include=header