https://github.com/ssc-maire/spacecherenkovsimulator
A Python-based tool to simulate the effect of interplanetary charged particles and the van Allen belts on count rates and pulse height distributions in simple Cherenkov detectors in space.
https://github.com/ssc-maire/spacecherenkovsimulator
ae8 ap8 cherenkov detector geant4 magnetocosmics magnetosphere particle physics radiation solar space van-allen
Last synced: 4 months ago
JSON representation
A Python-based tool to simulate the effect of interplanetary charged particles and the van Allen belts on count rates and pulse height distributions in simple Cherenkov detectors in space.
- Host: GitHub
- URL: https://github.com/ssc-maire/spacecherenkovsimulator
- Owner: ssc-maire
- License: other
- Created: 2023-12-06T14:42:54.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-08-13T13:54:12.000Z (10 months ago)
- Last Synced: 2026-02-16T08:49:18.746Z (4 months ago)
- Topics: ae8, ap8, cherenkov, detector, geant4, magnetocosmics, magnetosphere, particle, physics, radiation, solar, space, van-allen
- Language: Jupyter Notebook
- Homepage: https://pypi.org/project/SpaceCherenkovSimulator/
- Size: 13.5 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SpaceCherenkovSimulator
A Python-based tool to simulate the effect of interplanetary charged particles and the van Allen belts on count rates and pulse height distributions in simple Cherenkov detectors in space.
If you use this software for scientific research, please reference SpaceCherenkovSimulator according to the appropriate journal publication rules.
**N.B. Currently this tool only runs on Linux-based machines (if you are a Windows user, you must use [Windows Subsystem for Linux](https://ubuntu.com/wsl) or a virtual machine with Linux to install and run this tool)**
**To use this tool, you must first ensure you have MAGNETOCOSMICS and GRAS installed, as this software acts as a tool to run both of these Geant4-based tools**
This software is relatively complete from a programmatic perspective (although currently only containing relatively simple fused silica Cherenkov radiator geometries), but a relatively easy-to-use user interface and documentation has not yet been created. These should be added over time. For now, I have provided several Jupyter notebooks, `testing_simulator.ipynb` and the more complex notebooks in `rough_example_notebooks`, which provide some examples of how this software can be used. Note that the examples in `rough_example_notebooks` are for an older version of the software, and therefore do not directly work with this version - although the general logic for the calculations remains intact.
Feel free to use and modify/contribute to this software if you wish, and feel free to contact me if you have any questions or run into issues.
## Installation
To install SpaceCherenkovSimulator, simply run
```
sudo pip install SpaceCherenkovSimulator
```