The VDA tool helps in the automation of Velocity Dispersion Analysis (VDA) of one or multiple Solar Energetic Particle (SEP) events. Each event is provided to the tool as a point in time. The user can parameterize the given Notebook and control which particle species are used, the sensor from which they are detected, and the viewings to be considered.
The tool utilizes the Pandas module and generates multiple DataFrames during its execution. The final output of the tool is a plot of the VDA analysis for each inputted event.
Tool is still under active development and its results should be handled with caution.
Tested in Ubuntu 22.04 with Python version 3.10.12, and MacOS 15.1.1 with Python 3.10.16 and 3.12.8
- This tool requires a recent Python (>=3.10) installation. Following SunPy's approach, we recommend installing Python via miniforge (click for instructions).
- Download this file and extract to a folder of your choice (or clone the repository https://github.com/spearhead-he/VDA if you know how to use
git). - Open a terminal or the miniforge prompt and move to the directory where the code is.
- (Optional, but recommended) Create a new virtual environment (e.g.,
conda create --name vda, orpython -m venv venv_vda_toolif you don't use miniforge/conda) and activate it (e.g.,conda activate vda, orsource venv_vda_tool/bin/activateif you don't use miniforge/conda). - Install the Python dependencies from the requirements.txt file with
pip install -r requirements.txt - Open the Jupyter Notebook by running
jupyter-lab vda_tool.ipynb
The Notebook is separated into three main sections:
- Imports & Setup
- User Inputs
- Run
The user should run the cell(s) of the first section and then follow the instructions iside the Notebook to properly fill the input forms. The cells of the "Run" section can then be run without changing anything.
Contributions to this tool are very much welcome and encouraged! Contributions can take the form of issues to report bugs and request new features or pull requests to submit new code.
If you don't have a GitHub account, you can sign-up for free here, or you can also reach out to us with feedback by sending an email to [email protected].
This tool is developed within the SPEARHEAD (SPEcification, Analysis & Re-calibration of High Energy pArticle Data) project. SPEARHEAD has received funding from the European Union’s Horizon Europe programme under grant agreement No 101135044.
The tool reflects only the authors’ view and the European Commission is not responsible for any use that may be made of the information it contains.