This is the most up-to-date version of the vlf4ions Python library, which is hosted on Codeberg. This library is designed for VLF-antenna owners. It allows the detection of solar flares in real-time from ground-based VLF data. An estimate of the solar X-ray flux from the Sun is also made possible.
Though it was designed with an AWESOME instrument in mind, it can be adapted to any type of VLF antennas, provided that both amplitude and phase measurements are available for any transmitter of interest.
Installation
To install the package, you can simply type in a virtual environment:
pip install vlf4ions
This should download the more recent version.
Another way to install the package is to go to Release at the top of the page and download the latest version. In the zip or tar.gz folder, you should find a file ending in .whl. In a terminal, write
pip install file_in_.whl
Note that sometimes we also implement new features or fix some bugs, but this version is not yet released (usually before it doesn't differ enough from the previous one.) In this case, you can download these stable sub-version from the Tags page. The differences between each versions are outlined in the CHANGELOG file
Testing
To test the entire package, you can run (when you are in the top folder)
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=vlf4ions --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
Documentation
The documentation may be found here.
Contributing
Any feedback or contribution is very welcome. Please use pull requests to contribute to this package, or directly open an issue if you notice that something is wrong or can be enhanced.
Any question may also be sent to me by email if needed, or by pinging me on Codeberg.
Acknowledgements
Many thanks to Pierre-Yves Martin and Xavier Bonnin for their help with the licence and all other aspects of publishing an open-source project. This project really would have taken much longer to deploy if not for their advice !
Citing
If you use this library in a scientific context, please cite the paper 'Real-time detection of solar flares from ground-based data' by P. Teysseyre, C. Briand and M. Cohen. As of now (January 2026), it is still in review.
1 maintainer
Metadata
1 maintainer
Release files for vlf4ions 1.3.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vlf4ions-1.3.7.tar.gz | 41.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vlf4ions-1.3.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 79.8 kB
Release files / vlf4ions-1.3.7.tar.gz
| Download URL | vlf4ions-1.3.7.tar.gz |
|---|---|
| Size | 41.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1796e0970337db25ebc5a310ea0b6dcc92fd2ba0f9d3098eaea6d02e3341dea3
|
|
BLAKE2b-256 checksum How to use checksums |
ed5a9d9ad5b0d04bb6132181ae33e5e45b1a16a85e557249dbbb45fb29a50383
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.12
|
Release files / vlf4ions-1.3.7-py3-none-any.whl
| Download URL | vlf4ions-1.3.7-py3-none-any.whl |
|---|---|
| Size | 38.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1e325e5e073a3ab31dab4e770490ea4bdedc72c700e5a98f87aff25c7f6a9e49
|
|
BLAKE2b-256 checksum How to use checksums |
0dc5685df408170de3245a73604f7fbad59fa51a1fda6dcdd86c6d681ccd7090
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.12.12
|
