Metadata-Version: 2.4
Name: redcamel
Version: 0.1.3
Summary: GUI tool to simulate Reaction Microscope detector images.
Project-URL: Homepage, https://codeberg.org/FlashREMI/RedCamel
Project-URL: Repository, https://codeberg.org/FlashREMI/RedCamel.git
Author: Patrizia Schoch
Author-email: Hannes Lindenblatt <hannes.lindenblatt@desy.de>
Maintainer-email: Hannes Lindenblatt <hannes.lindenblatt@desy.de>
License-Expression: GPL-3.0-or-later
License-File: LICENSES/CC-BY-4.0.txt
License-File: LICENSES/CC0-1.0.txt
License-File: LICENSES/GPL-3.0-or-later.txt
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.8
Requires-Dist: chemformula>=1.2
Requires-Dist: graphviz>=0.20
Requires-Dist: ipywidgets>=8
Requires-Dist: matplotlib>=3.7
Requires-Dist: numba>=0.58
Requires-Dist: numpy>=1.2
Requires-Dist: plopp>=23
Requires-Dist: scipp>=23
Requires-Dist: scipy>=1.10
Description-Content-Type: text/markdown

<!--
SPDX-FileCopyrightText: 2025 Patrizia Schoch
SPDX-FileContributor: Hannes Lindenblatt

SPDX-License-Identifier: GPL-3.0-or-later
-->

# Remi Detector Calculation for Monitoring Electrons

GUI tool to simulate Reaction Microscope detector images.

# Example Outputs

![Electron Wiggles](https://codeberg.org/FlashREMI/RedCamel/media/tag/v0.1.3/Electrons.png)
![Ion fragmentation](https://codeberg.org/FlashREMI/RedCamel/media/tag/v0.1.3/Ions.png)

# Usage

## With uv (recommended)

> [!WARNING]
> You currently have to use your system python with included tkinter
> library (e.g. `apt install python3-tk`). uv apparently can not bring a working
> tk library. (Until
> https://github.com/astral-sh/python-build-standalone/pull/676 is merged) If
> you can not get tk to run, you can try to follow the "For developers" section.
> You would notice something like
> `ImportError: module '_tkinter' has no attribute '__file__'`.

Try out with temporary python environment:

```bash
uvx redcamel
```

Permanently install in isolated python environment:

```bash
uv tool install redcamel
```

Run:

```bash
redcamel
```

Upgrade

```bash
uv tool upgrade redcamel
```

uv can be found here: https://docs.astral.sh/uv/getting-started/installation/

## With pipx (recommended)

Install in isolated python environment:

```bash
pipx install redcamel
```

Run:

```bash
redcamel
```

Update:

```bash
pipx upgrade redcamel
```

pipx can be found here: https://pipx.pypa.io/latest/installation/

## With pip

Installing in your current python environment:

Install:

```bash
pip install redcamel
```

Run:

```bash
redcamel
```

Update:

```bash
pip install --upgrade redcamel
```

## With conda/mamba/pixi

Not yet implemented, sorry..

# Authors

- Initial implementation by Patrizia Schoch
- Maintained by Hannes Lindenblatt

# For developers

First get the repository

```bash
git clone https://codeberg.org/FlashREMI/RedCamel.git
```

or if you have an codeberg.org account with an ssh key set up:

```bash
git clone ssh://git@codeberg.org/FlashREMI/RedCamel.git
```

Then work inside the RedCamel folder. uv or pixi will find their configuration
files there.

## Usage with uv

```bash
uv run redcamel
```

uv can be found here: https://docs.astral.sh/uv/getting-started/installation/

## Usage with pixi

> [!TIP]
> pixi / the conda-forge python distribution actually includes tk
> libraries so you do not need installed system tk :)

```bash
pixi run redcamel
```

pixi can be found here: https://pixi.sh/latest/#installation

## Usage with mamba / conda

### Setup

- install environment with dependencies:

```bash
mamba env create
```

### Usage

- activate environment:

```bash
mamba activate redcamel
```

- run GUI with:

```bash
python src/redcamel/remi_gui.py
```

- Play around with plots and sliders!

### Updating

- pull changes:

```bash
git pull
```

- update environment:

```bash
mamba activate redcamel
mamba env update
```
