Metadata-Version: 2.4
Name: lir_achem
Version: 1.3.0
Summary: Python package to implement an ions scheme in the D-region to model the dynamics of ions and electrons during solar flares. This is currently a private repository while I develop it, but will be made public later on when it's ready
Author-email: Pauline Teysseyre for the LIRA <pauline.teysseyre@obspm.fr>
Maintainer-email: Pauline Teysseyre <pauline.teysseyre@obspm.fr>
License-Expression: EUPL-1.2
Keywords: D-region,chemistry
Description-Content-Type: text/markdown
License-File: LICENCE.txt
Requires-Dist: pytest<9,>=8.4.2
Requires-Dist: sphinx<9,>=8.2.3
Requires-Dist: sphinx-rtd-theme<4,>=3.0.1
Requires-Dist: msise00<2,>=1.11.1
Requires-Dist: numpy<3,>=1.26.4
Requires-Dist: cmake<5,>=4.1.2
Requires-Dist: pyfiri<3,>=2.0.0b0
Requires-Dist: pysolar<1,>=0.13
Requires-Dist: pytz<2026,>=2025.2
Requires-Dist: DateTime<6,>=5.5
Requires-Dist: scipy<7,>=1.16.3
Requires-Dist: matplotlib<4,>=3.10.7
Requires-Dist: netCDF4<2,>=1.7.3
Requires-Dist: igrf<14,>=13.0.2
Requires-Dist: pytest-cov<8,>=7.0.0
Requires-Dist: pre-commit<5,>=4.5.0
Dynamic: license-file

![Coverage Status](./reports/coverage/coverage-badge.svg) [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

# Important

This model is available for academic purposes only. If you require any assistance, please contact us directly.

# D-region ion scheme

This is the LIR-ACheM (Lower Ionosphere Region - Absorption & Chemistry Modelling) scheme.

This code works in three steps (more details are in the documentation):
- The initialisation of the ionosphere
- The modelling of the ionosphere from a varying forcing source
- The computation of the HF absorption

This ion scheme is adapted from the six ions scheme from Mitra & Rowe, 1972.

Its main advantages compared to other more complex chemsistry schemes are:
- It is much simpler and numerically efficient
- It has been created for D-region dynamics during solar flares
- It is self-consistent, and all reaction rates are known since the actual species are specified (with the exception of cluster ions and light negative ions)

Please refer to the documentation for information on the scheme and the code used to implement it.

# Testing

To test the entire package, you can run

````
pytest
````

This is the minimal version to check that all tests are passed. If, however, you're developping your own branch of the repository, or if you want the coverage report, run:

````
pytest --cov=lir_achem --cov-report=xml:reports/coverage/coverage.xml
coverage html
genbadge coverage -o reports/coverage/coverage-badge.svg
````

This will create a full coverage report and a badge to display the new coverage

NOTE: Don't do this if you don't need this. It does take a few minutes to run all the tests.

# History

Written by P. Teysseyre and C. Briand (LIRA, Observatoire de Paris, Université PSL, Sorbonne Université, Université Paris Cité, CY Cergy Paris Université, CNRS, Meudon, France) in October 2025 - February 2026
