Last Updated: 10/23/2023

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 output, and notifications provided primarily 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.

Publication Policy

For tracking purposes for our government sponsors, we ask that you notify the CCMC whenever you use any CCMC tools/software systems in any scientific publications and/or presentations. Follow the steps on the publication submission page

See our full publication policy for a sample 'acknowledgement statement' to be included in your publication.

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, SWPC_ANNEX_CME_CATALOG, SEPVAL_CME_CATALOG)

keyword: default is set to NONE (example choices: swpc_annex, sepval2023)

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, SWPC_ANNEX_CME_CATALOG, SEPVAL_CME_CATALOG)

keyword: default is set to NONE (example choices: swpc_annex, sepval2023)

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, Mars, 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.