[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
# MuographBeta: muon tomography library
![logo](./images/muograph_logo.png)
This repo provides a library for muon scattering tomography and muon transmission tomography data analysis.
## Overview
As a disclaimer, this library is more of an aggregate of muon tomography algorithms used throughtout PhD research rather than a polished product for the general public. As such, this repo targets mostly muon tomography reaserchers and enthousiasts.
Users can find ready to use scattering density algorihms as well as samples of simulated data.
While curently being at a preliminary stage, this library is designed to be extended by users, whom are invited to implement their favorite reconstruction, material inference or image processing algorithms.
![image](./images/mst_image_example.png)
## Requierments
The Python libraries required can be installed using [Conda](https://conda.io/projects/conda/en/latest/user-guide/getting-started.html), a powerful command line tool for package and environment managment.
It can be installed following these [instructions](https://conda.io/projects/conda/en/latest/user-guide/install/index.html), based on your operating system.
Simply run the following command:
```bash
cd MuographBeta/
conda env create --file=environment.yml
```
You can then activate/deactivate the environment with:
```bash
conda activate muograph
```
```bash
conda deactivate
```
## Installation
Now that the required libraries have been installed, the repository can be cloned:
```bash
git clone https://github.com/MaximeLagrange/MuographBeta.git
```
This repo Git Large File Storage ([LFS](https://git-lfs.com/)) to handle the data files that are too large for GitHub. To ensure that all LFS files are downloaded, run the following command inside the repository folder:
```bash
git lfs pull
```
## Examples
A few examples to introduce users to the package can be found in the `./example/` folder.
![example](./images/examples_preview.png)
Raw data
{
"_id": null,
"home_page": null,
"name": "muograph",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "physics, science, statistics, tomography",
"author": "Maxime Lagrange",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/97/b7/0a857b140fcb971d5d0c97e7adfbb98307a3a27fdc40a3bda6afe8bbe787/muograph-0.1.5.tar.gz",
"platform": null,
"description": "[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n\n# MuographBeta: muon tomography library\n\n![logo](./images/muograph_logo.png)\n\n\nThis repo provides a library for muon scattering tomography and muon transmission tomography data analysis. \n\n## Overview\n\nAs a disclaimer, this library is more of an aggregate of muon tomography algorithms used throughtout PhD research rather than a polished product for the general public. As such, this repo targets mostly muon tomography reaserchers and enthousiasts.\n\nUsers can find ready to use scattering density algorihms as well as samples of simulated data.\n\nWhile curently being at a preliminary stage, this library is designed to be extended by users, whom are invited to implement their favorite reconstruction, material inference or image processing algorithms.\n\n![image](./images/mst_image_example.png)\n\n## Requierments\n\nThe Python libraries required can be installed using [Conda](https://conda.io/projects/conda/en/latest/user-guide/getting-started.html), a powerful command line tool for package and environment managment.\n\nIt can be installed following these [instructions](https://conda.io/projects/conda/en/latest/user-guide/install/index.html), based on your operating system.\n\nSimply run the following command:\n\n```bash\ncd MuographBeta/\nconda env create --file=environment.yml\n```\n\nYou can then activate/deactivate the environment with:\n\n```bash\nconda activate muograph\n```\n\n```bash\nconda deactivate\n```\n\n## Installation\n\nNow that the required libraries have been installed, the repository can be cloned:\n\n```bash\ngit clone https://github.com/MaximeLagrange/MuographBeta.git\n```\n\nThis repo Git Large File Storage ([LFS](https://git-lfs.com/)) to handle the data files that are too large for GitHub. To ensure that all LFS files are downloaded, run the following command inside the repository folder:\n\n```bash\ngit lfs pull\n```\n\n## Examples\n\nA few examples to introduce users to the package can be found in the `./example/` folder.\n\n![example](./images/examples_preview.png)\n",
"bugtrack_url": null,
"license": null,
"summary": "Muon tomography data analysis library",
"version": "0.1.5",
"project_urls": null,
"split_keywords": [
"physics",
" science",
" statistics",
" tomography"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9635d7ad93e41586c65bde193304424b42402c18349e60fb6e556e416bc16db4",
"md5": "bcbde0a9d7576c4a48d90b20b6ffb62c",
"sha256": "a34a9fa75f1d348010e540ea5b7544e070eaa47de3737409d8f6e4af552e4ba3"
},
"downloads": -1,
"filename": "muograph-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bcbde0a9d7576c4a48d90b20b6ffb62c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 12177726,
"upload_time": "2024-11-15T15:19:33",
"upload_time_iso_8601": "2024-11-15T15:19:33.863031Z",
"url": "https://files.pythonhosted.org/packages/96/35/d7ad93e41586c65bde193304424b42402c18349e60fb6e556e416bc16db4/muograph-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "97b70a857b140fcb971d5d0c97e7adfbb98307a3a27fdc40a3bda6afe8bbe787",
"md5": "f7f9f55e8c5e17b5ec83e940960275b7",
"sha256": "e976cb1dbfd8996e8e527899a070b2d4b2d57cdd9fc548ede671e84c7c91d0d5"
},
"downloads": -1,
"filename": "muograph-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "f7f9f55e8c5e17b5ec83e940960275b7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 12051260,
"upload_time": "2024-11-15T15:19:38",
"upload_time_iso_8601": "2024-11-15T15:19:38.806032Z",
"url": "https://files.pythonhosted.org/packages/97/b7/0a857b140fcb971d5d0c97e7adfbb98307a3a27fdc40a3bda6afe8bbe787/muograph-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-15 15:19:38",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "muograph"
}