Python wrapper to the International Reference Ionosphere (IRI) 2016 model.

pip install pyiri2016

Or

pip install -e .

This also installs Time Utilities.

This project uses a modern CMake-based build system with scikit-build-core for cross-platform compilation.

For detailed setup instructions, build troubleshooting, and advanced configuration, see QUICKSTART.md.

# Create venv and install dependencies with Fortran extension
make dev

This target:

• Creates .venv virtual environment
• Installs NumPy, scikit-build-core, CMake, Ninja
• Compiles and installs the package in editable mode
• Installs development tools (pytest, coverage, pre-commit)

Expected time: 2-5 minutes on first run (gfortran compilation)

make build

Creates source distribution and binary wheel in dist/ directory.

# Run health checks
make health

# Run syntax check (smoke test)
make smoke

# Run all tests
make test

# Run tests with coverage report
make coverage

# Code quality checks
make lint          # Check code with ruff
make lint-fix      # Auto-fix linting issues
make format        # Auto-format code with ruff
make typecheck     # Type checking with mypy

# Run all quality checks
make pre-commit    # lint + typecheck + test

make smoke: Runs fast syntax validation without network or Fortran build requirements. make health: Verifies Python, gfortran, and cmake are available, then runs smoke tests. make coverage: Runs all tests with coverage analysis and generates HTML report in htmlcov/.

For running examples and plotting demonstrations, see examples/README.md.

Example outputs:

The build system uses:

• CMakeLists.txt: Modern CMake 3.15+ configuration for cross-platform builds
• generate_f2py.py: Python wrapper that generates f2py C/Fortran interface code
• f2py_wrapper.sh: Shell wrapper ensuring UTF-8 environment variables are set for f2py
• pyproject.toml: PEP 517/518 compliant build system using scikit-build-core

The system automatically handles:

• Fortran source compilation with gfortran
• f2py wrapper generation (only wraps iriwebg subroutine as public interface)
• NumPy integration for array handling
• UTF-8 encoding for source files with non-ASCII characters

For advanced build control, see CMakeLists.txt and generate_f2py.py.