anaMamiTools

This is anaMamiTools, a set of a Python- and Jupyter-based data handling and analysis tools for the STORM (former ELIOT) team experimental studies performed at the MAMI (MAinzer MIkrotron) B beamtest facility and focused on the electromagnetic interactions between high-energy particles and oriented crystalline lattices. In particular, measurements are taken of both the electromagnetic radiation emitted in the particle-crystal interaction, from the standpoint of the energy spectra — with a NaI+PMT detector, and the output beam 2D tansverse profile — with a LYSO screen placed across the beam path and framed by pixel cameras. Further information on both the particle-crystal interaction physics and on the experimental setup features can be found, for example, here.

In practice:

• anaMamiDefl(ection) performs the output beam spatial analysis, with the main focus on the case of channeling in bent cystalline targets; beam profile data are stored in TIFF files coming from the pixel cameras. It is optimised for the analysis of a dataset obtained with a single sample.
• anaMamiRad(iation) performs the analysis of the radiation data, which come from the NaI+PMT detector acquisition system and are stored in CNF (Canberra Nuclear File) files. It supports comparison between different-sample datasets.
• In order to easily handle the radiation data, it is necessary to convert the CNF files into formatted text files (TXT): cnfconv by messlinger (on GitHub here) was included in this bundle to ease this stage.

An extensive description of how these tools work can be found in the code comments.

Basic dependencies:

All these are automatically installed if using Anaconda (this project was developed and tested with Anaconda 3) and generating the environment described in the environment.yml file. In order to fully exploit the potential of these software tools, it is best to enable the interactive plots in the working environment. A Bash script is available to perform the complete installation of the environment itself, of the interactive mode and of other minor features; it could be run via

bash -i createEnvComplete.sh

Note: running the script via ./createEnvComplete.sh won't work since the Bash interactive mode is needed.

The anaMamiTools set can be downloaded either as a ZIP archive, from the Code drop-down menu here, or directly from the terminal (open in your project working directory) via

git clone https://github.com/mattiasoldani/anaMamiTools.git

Note: the latter requires Git installed on your machine.

Found a bug? Or simply have any questions, comments or suggestions you'd like to talk about? Feel free to contact me at [email protected]. And brace yourself, for the best is yet to come!