# 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
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ssc-maire/SpaceCherenkovSimulator",
"name": "SpaceCherenkovSimulator",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "space physics earth asymptotic trajectory Cherenkov detector Geant4 GRAS geomagnetic rigidity magnetocosmics trapped particles AE8 AP8",
"author": "Space Environment and Protection Group, University of Surrey",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/30/20/e6cfbb43ee2ca76a92a74bb3844dcfe92efa4723395e06304cc75059cf64/spacecherenkovsimulator-0.2.9.tar.gz",
"platform": null,
"description": "# SpaceCherenkovSimulator\n\nA 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.\n\nIf you use this software for scientific research, please reference SpaceCherenkovSimulator according to the appropriate journal publication rules.\n\n**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)**\n\n**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**\n\nThis 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.\n\nFeel 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. \n\n## Installation\n\nTo install SpaceCherenkovSimulator, simply run\n\n```\nsudo pip install SpaceCherenkovSimulator\n```\n\n",
"bugtrack_url": null,
"license": "CC BY-NC-SA 4.0",
"summary": "Python library containing tools for simulating Cherenkov detector count rates in space.",
"version": "0.2.9",
"project_urls": {
"Homepage": "https://github.com/ssc-maire/SpaceCherenkovSimulator"
},
"split_keywords": [
"space",
"physics",
"earth",
"asymptotic",
"trajectory",
"cherenkov",
"detector",
"geant4",
"gras",
"geomagnetic",
"rigidity",
"magnetocosmics",
"trapped",
"particles",
"ae8",
"ap8"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ef5af2cd460509c09160fdfc38db8febeb5f6eb8ddd3c92f62b4df2a7ae90485",
"md5": "470f8c57ce0ae6b5beba9063ee4fbddc",
"sha256": "993799ae0cca8ded8d0cb2a26f108d252b005e1b58866b98db28804e76258935"
},
"downloads": -1,
"filename": "SpaceCherenkovSimulator-0.2.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "470f8c57ce0ae6b5beba9063ee4fbddc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 218442,
"upload_time": "2024-09-02T14:13:42",
"upload_time_iso_8601": "2024-09-02T14:13:42.001752Z",
"url": "https://files.pythonhosted.org/packages/ef/5a/f2cd460509c09160fdfc38db8febeb5f6eb8ddd3c92f62b4df2a7ae90485/SpaceCherenkovSimulator-0.2.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3020e6cfbb43ee2ca76a92a74bb3844dcfe92efa4723395e06304cc75059cf64",
"md5": "ea48b09599edce1bdd4ed6b6a3822807",
"sha256": "0c036d5ec5c41c59df2ec979f211eaa68eeadf883eb9f40b3a264c633ca955fb"
},
"downloads": -1,
"filename": "spacecherenkovsimulator-0.2.9.tar.gz",
"has_sig": false,
"md5_digest": "ea48b09599edce1bdd4ed6b6a3822807",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 205397,
"upload_time": "2024-09-02T14:13:43",
"upload_time_iso_8601": "2024-09-02T14:13:43.291536Z",
"url": "https://files.pythonhosted.org/packages/30/20/e6cfbb43ee2ca76a92a74bb3844dcfe92efa4723395e06304cc75059cf64/spacecherenkovsimulator-0.2.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-02 14:13:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ssc-maire",
"github_project": "SpaceCherenkovSimulator",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "spacecherenkovsimulator"
}
JSON
