Related Links | Frequently Asked Questions | Community Feedback | Downloads | Sitemap
CCMC Home | CCMC Stakeholders | Our Team | Publications | Meetings and Workshops | Concept of Operations
Models At A Glance | ModelWeb Catalog and Archive
Request Procedures | Generate Input Data Files & Parameters | Movies on Request | About the Run Process | Publications Policy
Search run database | Request run output | Special events | Kameleon Software | Space Weather Explorer | Publications policy
Instant Model Run
Forecasting Support tools | iSWA | DONKI | Mission Support | Experimental Real Time Simulations | Operational Geospace Model Validations
Intl Forum | GEM Challenge | CEDAR ETI Challenge | GEM-CEDAR Challenge | SHINE Challenge | CME Arrival Time Scoreboard | Flare Scoreboard | SEP Scoreboard | IMF Bz Scoreboard
Educational materials &activities | Space Weather REDI Initiative | SW REDI Bootcamp | Student Research Contest | Tutorial at CEDAR | Forecaster Tools
Missions near Earth/in Earth-orbit | MMS | Van Allen Probes | THEMIS | MESSENGER | STEREO | Spitzer | MAVEN | MSL | Dawn | Kepler | EPOXI | Juno | CASSINI | Voyager | New Horizons | Sounding Rockets | International
Research Community Support | CCMC Workshops | NASA Robotic Mission Operator Workshops | LWS Support | Exo-CCMC | DREAM2 Support | HELCATS Support
iSWA | DONKI | Kameleon | StereoCat | EEGGL | CME Scoreboard | SEP Scoreboard | FLR Scoreboard | SEA5
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

National Aeronautics and Space Administration Air Force Materiel Command Air Force Office of Scientific Research Air Force Research Laboratory Air Force Weather Agency NOAA Space Environment Center National Science Foundation Office of Naval Research

| | Privacy, Security Notices

CCMC logo designed by artist Nana Bagdavadze