iSWA Webservices Interface

iSWA webservice API

List of iSWA webservice calls that users can make to obtain information from iSWA data feeds and cygnets. To learn how to locate Data ID and/or Cygnet ID look at the bottom of this page. For more details on iSWA webservice, see this presentation.

Numerical Data Streaming: DataStreamServlet

URL:
https://iswa.gsfc.nasa.gov/IswaSystemWebApp/DataStreamServlet?format=FORMAT&resource=RESOURCE&quantity=QUANTITY

Required parameters:

FORMAT = TEXT or JSON

RESOURCE/QUANTITY: One way to determine what resource/quantity pairs are available is to view the list from the live SuperTimeline Cygnet in iSWA (https://iswa.gsfc.nasa.gov/IswaSystemWebApp/index.jsp?i_1=388&l_1=40&t_1=270&w_1=800&h_1=400&s_1=0)

Optional parameters:

duration = the number of days worth of the latest data to reutrn and it must be <= 10

duration + end-time = used in pair to specify how many days worth of data to return up to the specificed end-time parameter (format: YYYY-mm-DD HH:MM:SS)

begin-time + end-time = used to specify a specific date range

Examples:
https://iswa.gsfc.nasa.gov/IswaSystemWebApp/DatabaseDataStreamServlet?format=TEXT&resource=ACE&quantity=B_x&begin-time=2011-11-29 23:59:59&end-time=2011-12-01 23:59:59
https://iswa.gsfc.nasa.gov/IswaSystemWebApp/DatabaseDataStreamServlet?format=TEXT&resource=ACE,ACE,ACE&quantity=B_x,B_y,B_z&begin-time=2011-11-29 23:59:59&end-time=2011-12-01 23:59:59

Return:
Timestamp B_x
2011-11-30 00:00:00.0 2.8
2011-11-30 00:01:00.0 3.0
2011-11-30 00:02:00.0 2.8
2011-11-30 00:03:00.0 2.6
2011-11-30 00:04:00.0 2.6
2011-11-30 00:05:00.0 2.7
...


Data File Streaming: iSWADataStreamer

URL:
https://iswa.gsfc.nasa.gov/IswaSystemWebApp/iSWADataStreamer?timestamp=YYYY-MM-DD HH:mm:SS&window=-1&dataid=DATAID

Required parameters:

timestamp = UTC timestamp in YYYY-MM-DD HH:mm:ss format

window = -1 or 0 (-1 matches the most recent data whose timestamp is less than specified AND 0 only returns data that matches the timestamp exactly)

DATAID = a unique data identifier used to select a specific iSWA datafeed
(To learn how to locate datafeed identifier look at the bottom of this page)

Optional parameters:

duration = the number of days worth of the latest data to reutrn and it must be <= 10

duration + end-time = used in pair to specify how many days worth of data to return up to the specificed end-time parameter (format: YYYY-mm-DD HH:MM:SS)

begin-time + end-time = used to specify a specific date range

Example:
https://iswa.gsfc.nasa.gov/IswaSystemWebApp/iSWADataStreamer?timestamp=2016-03-09%2000:00:00&window=-1&dataId=2

Return: Text file
*Start header*
Solar footpoint locations from wsa-enlil model combination
Model versions : WSA_V2.2 ENLIL-2.7-ccmc
Observatory gon
Carrington Rotation 2174
Magnetogram Carrington longitude 40.000000
WSA R_outer = 21.500000 Rsun
ENLIL:obs:gong
ENLIL:grd:640x30x90
ENLIL:x1l:0.1
*end header*

Planet/Body Coord1(lat deg from North Pole) Coord2(carr. long) Date
Mercury 77.7 313.0 2016-03-04T09:01:53
Venus 79.1 315.2 2016-03-04T09:01:53
...


Image Streaming via Cygnet ID: iSWACygnetStreamer

URL:
https://iswa.gsfc.nasa.gov/IswaSystemWebApp/iSWACygnetStreamer?timestamp=YYYY-MM-DD HH:mm:SS&window=-1&cygnetid=CYGNETID

Required parameters:

timestamp = UTC timestamp in YYYY-MM-DD HH:mm:ss format

window = -1 or 0 (-1 matches the most recent data whose timestamp is less than specified AND 0 only returns data that matches the timestamp exactly)

CYGNETID = a unique data identifier used to select a specific iSWA Cygnet
(To learn how to locate iSWA Cygnet identifier look at the bottom of this page)

Optional parameters:

width = image width size

height = image height size

Example:
https://iswa.gsfc.nasa.gov/IswaSystemWebApp/iSWACygnetStreamer?timestamp=2012-03-09%2000:00:00&window=-1&cygnetId=239

Return: Image file


How to locate Data ID and Cygnet ID:

DataID: Use the health page for the datafeed
https://iswa.ccmc.gsfc.nasa.gov/IswaSystemWebApp/health/datafeed.jsp

CygnetID: Use the health page for the cygnets:
https://iswa.ccmc.gsfc.nasa.gov/IswaSystemWebApp/health/cygnet.jsp



Presentation about iSWA webservices