solarwindpy 0.1.0

Python package for solar wind data analysis.

Python data analysis tools for solar wind measurements.

Installation

SolarWindPy requires Python 3.10 or later.

SolarWindPy will soon be installable from pip via pip install solarwindpy. We plant to target conda quickly there after, most likely through the conda-forge channel.

User

Install from pip (when available):

pip install solarwindpy  # Requires Python 3.10+

Development

1. Fork the repository and clone your fork.

2. Create a Conda environment using the provided YAML file (Python 3.10+):

   conda env create -f solarwindpy-20250403.yml  # Python 3.10+
   conda activate solarwindpy-20250403
   pip install -e .

   Alternatively generate the environment from requirements-dev.txt:

   python scripts/requirements_to_conda_env.py --name solarwindpy-dev
   conda env create -f solarwindpy-dev.yml
   conda activate solarwindpy-dev
   pip install -e .

3. Run the test suite with pytest:

   pytest -q

4. Regenerate the Conda recipe if the version or dependencies change:

   python scripts/update_conda_recipe.py

5. Optionally install the pre-commit hooks:

   pre-commit install

   This will run black and flake8 automatically when committing.

6. Build the documentation and fail on warnings:

   cd docs
   make html SPHINXOPTS=-W

License

SolarWindPy is licensed under a standard 3-clause BSD license. See LICENSE.rst.

Acknowledging and Citing SolarWindPy

See CITATION.rst for instructions on citing SolarWindPy.