pytdo 0.2.4

Add your description here

pytdo

Description

pytdo provides a Python API to read and analyse tunnel diode oscillator experiments on samples exposed to a high magnetic field. It is bundled with a graphical user interface written with PyQt.

Installation

As an app

If you plan to just use the graphical user interface, consider installing pytdo as a tool managed by uv, a modern Python package manager.

To do so, install uv : https://docs.astral.sh/uv/getting-started/installation/.

Then, from the command line (PowerShell in Windows), install pytdo with uv :

uv tool install pytdo

pytdo will be installed along its dependencies in an isolated environment with no risks to mess up with your current tools and Python versions.

Then, launch the GUI by running pytdo from the command line.

To update, run : uv tool upgrade pytdo.

As a library

Installing pytdo 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 pytdo). Note that you can re-use the same environment than the one for pyuson.

1. Create a Python environment :

   With conda :

   conda create -n pytdo-env -c conda-forge python=3.12
   

   You may replace the environment name pytdo-env with whatever you want.

   Activate the environment with :

   conda activate pytdo-env
   

2. Install the pytdo package :

   With pip, with the pytdo-env activated :

   pip install pytdo
   

Updates

To upgrade pytdo to the latest version, simply run from the activated environment :

pip install pytdo --upgrade

Manual download

1. Download the repository and extract it on your computer (or clone it).
2. Create and activate a conda environment as shown above.
3. Install the extracted repository with pip :

pip install "/path/to/pytdo-main"

Alternatively, if you wish to make modification to the source code so that your change is reflected immediately, use the editable mode :

pip install -e /path/to/pytdo-main

Usage

You can use this package through the graphical user interface, or directly from Python prompt, script or Jupyter notebook using the Processor classes. All this methods rely on a TOML configuration file that specifies the experiment parameters and analysis settings.

A template configuration file is provided in the configs folder. Copy-paste and edit it according to your need. Each entry of the file is commented so it should be somewhat straightforward to configure. Then :

• Run the graphical interface with python -m pytdo from a terminal with the pyuson-env environment activated. Drag & drop the configuration file in the window, load the data, extract the TDO signal and interactively choose the field-window in which the signal is detrended.
• Write your own script using the library :

  import pytdo
  
  cfg_filename = "/path/to/your/config.toml"
  r = pytdo.TDOProcessor(cfg_filename)
  r.extract_tdo().remove_background().fft_inverse()
  r.save_results_csv()