pymagnetos

Collection of Python tools for high magnetic field experiments analysis.

It provides libraries and apps to analyse data acquired at the LNCMI in Toulouse.

Currently available apps :

• linx : digital lock-in
• pyuson : for ultrasound experiments
• pytdo : for TDO experiments

Those are also available as a library that can be used within custom Python scripts. They use a common framework that can also be used to build other experiment-specific app.

The documention is hosted here.

Installation

For more detailed instructions, see the installation instructions.

Method 1 : as an app

If you plan to just use the graphical user interfaces, consider installing pymagnetos as a tool managed by uv, a modern Python package manager, that will install the required Python version and dependencies.

uv tool upgrade pymagnetos

Method 2 : as a library

Installing pymagnetos as a library will allow you to use it from scripts and Jupyter notebooks (e.g. you will be able to import it with import pymagnetos).

pip install pymagnetos

pip install pymagnetos[jupyter]

pip install --upgrade pymagnetos

Usage

All apps and the corresponding backend libraries require a configuration file. Grab a configuration file template from the configs folder, edit it according to your settings (essentially the path to the data directory) and drag & drop in the app window.

Run an app

Once installed, the pymagnetos command should be available from the shell (PowerShell in Windows). You can check its usage with : pymagnetos --help

Which comes down to :

• Run the app for digital lock-in : pymagnetos linx
• Run the app for ultrasound experiments : pymagnetos pyuson
• Run the app for TDO experiments : pymagnetos pytdo

Tip : hit the top arrow on the keyboard to show previous commands you ran.

You can then drag & drop your configuration file in the window and click some buttons !

Use in a script

Subpackages (e.g. pyuson or pytdo) can be imported in Python scripts or Jupyter notebooks. There are some examples in the examples folder. You can copy them and edit them according to your need.

To run the examples, matplotlib is required to display the figures. Install it with :

pip install matplotlib

To open and run the notebooks (file with the .ipynb extension), the Jupyter package needs to be installed, along with a package to make the figures interactive. If pymagnetos was installed with the [jupyter] extra, they are already installed. Otherwise, install those packages with :

pip install jupyter matplotlib ipympl

To open a Jupyter notebook, open the Jupyter Lab web interface :

jupyter lab

Then, browse to your .ipynb file and run it ! Alternatively, Visual Studio Code supports Jupyter notebooks natively through the Jupyter extension.

Contribute

See the developer documentation.

To run the tests in a container :

podman run -it $(podman build -q .)

Acknowledgments

pymagnetos is developed in the Laboratoire National des Champs Magnétiques Intenses (LNCMI) in Toulouse, France, with the support of the OSCARS HiMagnetOS project. Built by humans, no LLM were used anywhere in the project.