Nasa Donki Tools

Configuration File: nasa_donki_tools.json Tool Type: Local Tools Count: 6

This page contains all tools defined in the nasa_donki_tools.json configuration file.

Available Tools

NASA_DONKI_get_coronal_mass_ejections (Type: BaseRESTTool)

Search NASA DONKI (Database Of Notifications, Knowledge, Information) for Coronal Mass Ejection (…

NASA_DONKI_get_coronal_mass_ejections tool specification

Tool Information:

  • Name: NASA_DONKI_get_coronal_mass_ejections

  • Type: BaseRESTTool

  • Description: Search NASA DONKI (Database Of Notifications, Knowledge, Information) for Coronal Mass Ejection (CME) events. Returns CME observations including start time, source location, active region, speed, direction, half-angle, and linked geomagnetic storms. No API key required. Date range defaults to last 30 days if not specified. Essential for space weather research, satellite operations planning, and aurora forecasting.

Parameters:

  • startDate ([‘string’, ‘null’]) (optional) Start date in YYYY-MM-DD format (e.g., ‘2024-01-01’). Defaults to 30 days before endDate.

  • endDate ([‘string’, ‘null’]) (optional) End date in YYYY-MM-DD format (e.g., ‘2024-01-31’). Defaults to today.

Example Usage:

query = {
    "name": "NASA_DONKI_get_coronal_mass_ejections",
    "arguments": {
    }
}
result = tu.run(query)

NASA_DONKI_get_geomagnetic_storms (Type: BaseRESTTool)

Search NASA DONKI for Geomagnetic Storm (GST) events. Returns storm observations including Kp ind…

NASA_DONKI_get_geomagnetic_storms tool specification

Tool Information:

  • Name: NASA_DONKI_get_geomagnetic_storms

  • Type: BaseRESTTool

  • Description: Search NASA DONKI for Geomagnetic Storm (GST) events. Returns storm observations including Kp index values (measure of geomagnetic disturbance: 5=minor storm, 6=moderate, 7=strong, 8=severe, 9=extreme). Geomagnetic storms can cause aurora displays, GPS disruptions, power grid problems, and satellite drag. No API key required.

Parameters:

  • startDate ([‘string’, ‘null’]) (optional) Start date in YYYY-MM-DD format (e.g., ‘2024-01-01’). Defaults to 30 days before endDate.

  • endDate ([‘string’, ‘null’]) (optional) End date in YYYY-MM-DD format (e.g., ‘2024-06-30’). Defaults to today.

Example Usage:

query = {
    "name": "NASA_DONKI_get_geomagnetic_storms",
    "arguments": {
    }
}
result = tu.run(query)

NASA_DONKI_get_high_speed_streams (Type: BaseRESTTool)

Search NASA DONKI for High Speed Stream (HSS) events in the solar wind. HSSs originate from coron…

NASA_DONKI_get_high_speed_streams tool specification

Tool Information:

  • Name: NASA_DONKI_get_high_speed_streams

  • Type: BaseRESTTool

  • Description: Search NASA DONKI for High Speed Stream (HSS) events in the solar wind. HSSs originate from coronal holes on the Sun and can cause minor to moderate geomagnetic storming when they interact with Earth’s magnetosphere. They produce recurrent geomagnetic activity patterns (27-day cycle) and are a major source of space weather disturbances during solar minimum. No API key required.

Parameters:

  • startDate ([‘string’, ‘null’]) (optional) Start date in YYYY-MM-DD format (e.g., ‘2024-01-01’). Defaults to 30 days before endDate.

  • endDate ([‘string’, ‘null’]) (optional) End date in YYYY-MM-DD format (e.g., ‘2024-06-30’). Defaults to today.

Example Usage:

query = {
    "name": "NASA_DONKI_get_high_speed_streams",
    "arguments": {
    }
}
result = tu.run(query)

NASA_DONKI_get_interplanetary_shocks (Type: BaseRESTTool)

Search NASA DONKI for Interplanetary Shock (IPS) events detected at Earth or in the solar wind. I…

NASA_DONKI_get_interplanetary_shocks tool specification

Tool Information:

  • Name: NASA_DONKI_get_interplanetary_shocks

  • Type: BaseRESTTool

  • Description: Search NASA DONKI for Interplanetary Shock (IPS) events detected at Earth or in the solar wind. Interplanetary shocks are sudden increases in solar wind speed, density, and magnetic field strength, often driven by CMEs or stream interaction regions. They can trigger geomagnetic storms. Returns event time, location, detecting instruments, and linked events. No API key required.

Parameters:

  • startDate ([‘string’, ‘null’]) (optional) Start date in YYYY-MM-DD format (e.g., ‘2024-01-01’). Defaults to 30 days before endDate.

  • endDate ([‘string’, ‘null’]) (optional) End date in YYYY-MM-DD format (e.g., ‘2024-03-31’). Defaults to today.

  • location ([‘string’, ‘null’]) (optional) Shock detection location. Options: ‘Earth’, ‘STEREO A’, ‘STEREO B’, ‘MESSENGER’, ‘Mars’. Default: all locations.

Example Usage:

query = {
    "name": "NASA_DONKI_get_interplanetary_shocks",
    "arguments": {
    }
}
result = tu.run(query)

NASA_DONKI_get_solar_energetic_particles (Type: BaseRESTTool)

Search NASA DONKI for Solar Energetic Particle (SEP) events. SEPs are high-energy particles (prot…

NASA_DONKI_get_solar_energetic_particles tool specification

Tool Information:

  • Name: NASA_DONKI_get_solar_energetic_particles

  • Type: BaseRESTTool

  • Description: Search NASA DONKI for Solar Energetic Particle (SEP) events. SEPs are high-energy particles (protons, electrons, heavy ions) accelerated by solar flares and CME-driven shocks. They pose radiation hazards to astronauts, satellites, and high-altitude aircraft. Returns event time, associated instruments, and linked solar events. No API key required.

Parameters:

  • startDate ([‘string’, ‘null’]) (optional) Start date in YYYY-MM-DD format (e.g., ‘2024-01-01’). Defaults to 30 days before endDate.

  • endDate ([‘string’, ‘null’]) (optional) End date in YYYY-MM-DD format (e.g., ‘2024-06-30’). Defaults to today.

Example Usage:

query = {
    "name": "NASA_DONKI_get_solar_energetic_particles",
    "arguments": {
    }
}
result = tu.run(query)

NASA_DONKI_get_solar_flares (Type: BaseRESTTool)

Search NASA DONKI for Solar Flare (FLR) events. Returns flare observations including class (C/M/X…

NASA_DONKI_get_solar_flares tool specification

Tool Information:

  • Name: NASA_DONKI_get_solar_flares

  • Type: BaseRESTTool

  • Description: Search NASA DONKI for Solar Flare (FLR) events. Returns flare observations including class (C/M/X), begin/peak/end times, source location, and active region. Solar flares are classified by X-ray peak brightness: C-class (small), M-class (medium, can cause brief radio blackouts), X-class (major, can cause global radio blackouts). No API key required.

Parameters:

  • startDate ([‘string’, ‘null’]) (optional) Start date in YYYY-MM-DD format (e.g., ‘2024-01-01’). Defaults to 30 days before endDate.

  • endDate ([‘string’, ‘null’]) (optional) End date in YYYY-MM-DD format (e.g., ‘2024-01-31’). Defaults to today.

Example Usage:

query = {
    "name": "NASA_DONKI_get_solar_flares",
    "arguments": {
    }
}
result = tu.run(query)