gri-iono-data 0.2.1

No project description provided

Iono Data (Ionospheric Data Processing)

Ionospheric data download and processing tools for generating ionospheric delay datasets used by gri-iono. Requires Python 3.12+.

Overview

This package provides scripts for:

• Downloading solar flux data from NOAA Space Weather Prediction Center (for bent ionospheric model)
• Downloading NeQuickG coefficients from European GNSS Service Centre (for NeQuickG model)
• Processing solar flux data to NPZ format for bent iono model
• Processing NeQuickG coefficients to NPZ format for NeQuickG model

The output NPZ files are consumed by the gri-iono library for ionospheric delay correction calculations.

Installation

# Clone and setup
git clone https://gitlab.com/geosol-foss/python/gri-iono-data.git
cd gri-iono-data
. .init_venv.sh

# Activate environment
source .venv/bin/activate

Usage

Solar Flux Data (Bent Ionospheric Model)

1. Download Solar Flux Data

Download F10.7 solar flux data from NOAA for a specific date:

python gri_iono_data/download_solar_flux 2025 03 15

Output:

• ./data/solar_flux_raw/solar_flux_2025_03_15.json - Raw solar flux data from NOAA

2. Process Solar Flux Data

Process all unprocessed solar flux data to generate NPZ files:

python gri_iono_data/update_solar_flux

Output:

• ./data/solar_flux/solar_flux_2025_03_15.npz - Processed F10.7 solar flux data

NeQuickG Coefficients

1. Download NeQuickG Coefficients

Download NeQuickG ionospheric coefficients from GSC for a specific date:

python gri_iono_data/download_nequickg 2025 03 15

Output:

• ./data/nequickg_raw/nequickg_2025_03_15.txt - Raw NeQuickG coefficients from GSC

2. Process NeQuickG Coefficients

Process all unprocessed NeQuickG data to generate NPZ files:

python gri_iono_data/update_nequickg

Output:

• ./data/nequickg/nequickg_2025_03_15.npz - Processed NeQuickG coefficients

Data Formats

Solar Flux Data

Raw Data:

• F10.7 solar flux index from NOAA SWPC
• JSON format with daily observations
• Units: Solar Flux Units (SFU) where 1 SFU = 10^-22 W/m^2/Hz

Processed NPZ Files:

Contains:

• f107: F10.7 solar flux value (float)
• year, month, day: Date information
• observation_time: ISO format timestamp

NeQuickG Coefficients

Raw Data:

• Effective ionization level (Az) coefficients from European GSC
• Text format with three coefficients: ai0, ai1, ai2
• Broadcast by Galileo satellites

Processed NPZ Files:

Contains:

• ai0, ai1, ai2: Individual coefficients
• coefficients: Array of all three coefficients
• year, month, day: Date information

Configuration

All scripts default to ./data/ for input/output but can be configured by modifying the paths in the scripts.

Data Sources

• Solar Flux: NOAA Space Weather Prediction Center (https://www.swpc.noaa.gov/)
• NeQuickG: European GNSS Service Centre (https://www.gsc-europa.eu/)

Project Structure

gri-iono-data/
├── gri_iono_data/
│   ├── solar_flux/         # Solar flux data processing
│   │   ├── download.py
│   │   ├── read.py
│   │   ├── process.py
│   │   └── write.py
│   ├── nequickg/           # NeQuickG coefficient processing
│   │   ├── download.py
│   │   ├── read.py
│   │   ├── process.py
│   │   └── write.py
│   ├── file_handling/      # Common utilities
│   │   ├── date_from_filename.py
│   │   ├── available_file_dates.py
│   │   └── unprocessed_file_dates.py
│   ├── download_solar_flux.py    # Main download script
│   ├── download_nequickg.py      # Main download script
│   ├── update_solar_flux.py      # Main processing script
│   └── update_nequickg.py        # Main processing script
├── data/
│   ├── solar_flux_raw/     # Raw solar flux downloads
│   ├── solar_flux/         # Processed solar flux NPZ
│   ├── nequickg_raw/       # Raw NeQuickG downloads
│   └── nequickg/           # Processed NeQuickG NPZ
└── test/                   # Test suite

Other Projects

Current list of other GRI FOSS Projects we are building and maintaining.

License

MIT License. See LICENSE for details.