Installation

Requirements

  • Python 3.8 or higher

  • NumPy

  • (Optional) Matplotlib for visualization

Installing from Source

  1. Clone the repository:

    git clone https://github.com/skyelaird/dvoacap-python.git
cd dvoacap-python

  2. Install in development mode:

    pip install -e .

  3. Verify installation:

    python -c "import dvoacap; print(dvoacap.__version__)"

Data Files

DVOACAP requires coefficient data files (DVoaData directory) which should be included in the repository. These files contain:

  • Coeff01.dat through Coeff12.dat: Monthly ionospheric coefficients

  • FOF2CCIR01.dat through FOF2CCIR12.dat: F2 layer critical frequency data

The data files should be located at DVoaData/ in the project root.

Dependencies

Core dependencies:

numpy>=1.20.0

Optional dependencies for examples and visualization:

matplotlib>=3.3.0
scipy>=1.6.0

Development dependencies:

sphinx>=4.0.0
pytest>=6.0.0
mypy>=0.900

Troubleshooting

Import Error: If you get an import error, make sure you’ve installed the package:

pip install -e .

Missing Data Files: If you see FileNotFoundError for coefficient files, ensure the DVoaData directory is in the correct location.

NumPy Compatibility: Some operations require NumPy 1.20 or higher for proper type handling.