Welcome to the new CCMC website!

Please note that some pages may have moved during the migration. If you experience any issues with the new website, please reach out to gsfc-ccmc-support@lists.hq.nasa.gov.

Last Updated: 05/03/2022

DONKI

Go to DONKI Web App

About

The Space Weather Database Of Notifications, Knowledge, Information (DONKI) is a comprehensive on-line tool for space weather forecasters, scientists, and the general space science community.

DONKI provides:

  • Chronicles the daily interpretations of space weather observations, analysis, models, forecasts, and notifications provided by the Moon-to-Mars (M2M) Space Weather Analysis Office.
  • Comprehensive knowledge-base search functionality to support anomaly resolution and space science research.
  • Intelligent linkages, relationships, cause-and-effects between space weather activities.
  • Comprehensive webservice API access to information stored in DONKI

DONKI Goals:

  • One-stop on-line tool for space weather researchers and forecasters.
  • Gathers and organizes space weather scientists interpretations and daily activities with correlations and direct links between relevant space weather observations.
  • Enables remote participation by students, world-wide partners, model and forecasting technique developers.

Using DONKI:

Disclaimer

The real-time space weather information and simulations stored in DONKI should be considered only as prototyping quality and in research context.

DONKI webservice calls/API

Coronal Mass Ejection (CME)

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/CME?startDate=yyyy-MM-dd&endDate=yyyy-MM-dd
startDate: default to 30 days prior to current UTC date
endDate: default to current UTC date

return JSON object:
activityID, startTime, sourceLocation, activeRegionNum, instruments, cmeAnalyses, linkedEvents[(list of) activityID], note, catalog

example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/CME?startDate=2017-01-03&endDate=2017-01-03

Coronal Mass Ejection (CME) Analysis

JSON example:

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/CMEAnalysis?startDate=2016-09-01&endDate=2016-09-30&mostAccurateOnly=true&speed=500&halfAngle=30&catalog=ALL
startDate: default 30 days prior to current UTC time
endDate: default to current UTC time
mostAccurateOnly: default is set to true
completeEntryOnly: default is set to true
speed (lower limit): default is set to 0
halfAngle (lower limit): default is set to 0
catalog: default is set to ALL (choices: ALL, M2M_CATALOG, JANG_ET_AL_CATALOG)
keyword: default is set to NONE (example choices: swpc_annex)

JSON object returned:
[{"time21_5":"2016-09-06T14:18Z","latitude":-20.0,"longitude":120.0,"halfAngle":31.0,"speed":674.0,"type":"C","isMostAccurate":true,"associatedCMEID":"2016-09-06T08:54:00-CME-001","note":"","catalog":"M2M_CATALOG"},{"time21_5":"2016-09-15T04:24Z","latitude":-18.0,"longitude":-122.0,"halfAngle":43.0,"speed":722.0,"type":"C","isMostAccurate":true,"associatedCMEID":"2016-09-14T23:36:00-CME-001","note":"Measured with swpc_cat using C3 and STA Cor2 imagery.","catalog":"M2M_CATALOG"}]

TEXT example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/CMEAnalysis.txt?startDate=2016-09-01&endDate=2016-09-30&mostAccurateOnly=true&speed=500&halfAngle=30
startDate: default 30 days prior to current UTC time
endDate: default to current UTC time
mostAccurateOnly: default is set to true
completeEntryOnly: default is set to true
speed (lower limit): default is set to 0
halfAngle (lower limit): default is set to 0
catalog: default is set to ALL (choices: ALL, M2M_CATALOG, JANG_ET_AL_CATALOG)
keyword: default is set to NONE (example choices: swpc_annex)

TEXT output:
2016-09-06T14:18Z lat=-20.0 lon=120.0 rad=31.0 vel=674.0 #2016-09-06T08:54:00-CME-001
2016-09-15T04:24Z lat=-18.0 lon=-122.0 rad=43.0 vel=722.0 #2016-09-14T23:36:00-CME-001

Geomagnetic Storm (GST)

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/GST?startDate=yyyy-MM-dd&endDate=yyyy-MM-dd
startDate: default to 30 days prior to current UTC date
endDate: default to current UTC date

return JSON object:
gstID, startTime, allKpIndex[(list of) observedTime, KpIndex, source], linkedEvents[(list of) activityID]

example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/GST?startDate=2016-01-01&endDate=2016-01-30

Interplanetary Shock (IPS)

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/IPS?startDate=yyyy-MM-dd&endDate=yyyy-MM-dd&location=LOCATION&catalog=CATALOG
startDate: default to 30 days prior to current UTC date
endDate: default to current UTC date
location: default to ALL (choices: Earth, MESSENGER, STEREO A, STEREO B)
catalog: default to ALL (choices: M2M_CATALOG, WINSLOW_MESSENGER_ICME_CATALOG)

return JSON object:
catalog, activityID, location, eventTime, instruments[(list of) displayName]

example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/IPS?startDate=2016-01-01&endDate=2016-01-30

Solar Flare (FLR)

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/FLR?startDate=yyyy-MM-dd&endDate=yyyy-MM-dd

startDate: default to 30 days prior to current UTC date
endDate: default to current UTC date

return JSON object:
flrID, instruments[(list of) displayName], begineTime, peakTime, endTime, classType, sourceLocation, activeRegionNum, linkedEvents[(list of) activityID]

example: https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/FLR?startDate=2016-01-01&endDate=2016-01-30

Solar Energetic Particle (SEP)

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/SEP?startDate=yyyy-MM-dd&endDate=yyyy-MM-dd

startDate: default to 30 days prior to current UTC date
endDate: default to current UTC date

return JSON object:
sepID, eventTime, instruments[(list of) displayName], linkedEvents[(list of) activityID]

example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/SEP?startDate=2016-01-01&endDate=2016-01-30

Magnetopause Crossing (MPC)

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/MPC?startDate=yyyy-MM-dd&endDate=yyyy-MM-dd
startDate: default to 30 days prior to current UTC date
endDate: default to current UTC date

return JSON object:
mpcID, eventTime, instruments[(list of) displayName], linkedEvents[(list of) activityID]

example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/MPC?startDate=2016-01-01&endDate=2016-03-31

Radiation Belt Enhancement (RBE)

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/RBE?startDate=yyyy-MM-dd&endDate=yyyy-MM-dd
startDate: default to 30 days prior to current UTC date
endDate: default to current UTC date

return JSON object:
rbeID, eventTime, instruments[(list of) displayName], linkedEvents[(list of) activityID]

example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/RBE?startDate=2016-01-01&endDate=2016-01-31

High Speed Stream (HSS)

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/HSS?startDate=yyyy-MM-dd&endDate=yyyy-MM-dd
startDate: default to 30 days prior to current UTC date
endDate: default to current UTC date

return JSON object:
hssID, eventTime, instruments[(list of) displayName], linkedEvents[(list of) activityID]

example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/RBE?startDate=2016-01-01&endDate=2016-01-31

WSA-ENLIL+Cone Simulation

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/WSAEnlilSimulations?startDate=2011-09-19&endDate=2011-09-20

startDate: default to 7 days prior to current UTC date
endDate: default to current UTC date

JSON Object returned: simulationID
modelCompletionTime
au
cmeInputs (list of): cmeStartTime, latitude, longitude, speed, halfAngel, time21_5, cmeid
estimatedShockArrivalTime
estimatedDuration
rmin_re
kp_18
kp_90
kp_135
kp_180
isEarthGB
impactList (list of): isGlancingBlow, location, arrivalTime ipsList (list of):activityID, location, eventTime, instruments

Example:
https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/WSAEnlilSimulations?startDate=2016-01-06&endDate=2016-01-06

Notifications

https://kauai.ccmc.gsfc.nasa.gov/DONKI/WS/get/notifications?startDate=2014-05-01&endDate=2014-05-08&type=all

parameters:
'startDate' and 'endDate' are in format 'yyyy-MM-dd' UT
'type' could be: all, FLR, SEP, CME, IPS, MPC, GST, RBE, report

Note:
'startDate' if left out would default to 7 days prior to the current UT date
'endDate' if left out would default to current UT date
'type' if left out would default to 'all'
The request date range is limit to 30 days. If the request range is greater than 30 days, it would limit your request range to (endDate-30) to endDate.