tadaMZ GUI

tadaMZ GUI is a desktop application for targeted analysis of LC–MS and LC–MS/MS data. It provides a graphical workflow around the tadamz analysis package, from peak extraction and quality assessment to calibration, quantification, result inspection, and reporting.

See the changelog for the release history.

Features

• Configure absolute and relative quantification workflows with several normalization and peak-integration methods.
• Process MS1 spectra or chromatogram-only MRM data, including optional peak classification, co-elution analysis, and qualifier checks.
• Fit and inspect calibration models for absolute quantification.
• Inspect result tables, chromatograms, and interactive report plots, then export results as CSV.
• Save complete workflows as .tadamzproject files for later inspection or reanalysis.

Installation

tadaMZ GUI requires Python 3.11 or newer. Installation with pip is available on Windows, macOS, and Linux.

Windows installer

A Windows installer will be available soon. Until then, install tadaMZ GUI with pip as described below.

Install with pip

Creating a virtual environment is recommended:

python -m venv .venv

Activate it on macOS or Linux:

source .venv/bin/activate

Or on Windows PowerShell:

.venv\Scripts\Activate.ps1

Then install the application:

python -m pip install --upgrade pip
python -m pip install tadamz_gui

To start the application, activate the virtual environment and run:

tadamz_gui

Input data

A new workflow uses the following inputs:

Project files

A .tadamzproject file is a ZIP-based archive that keeps the workflow configuration and input tables together with any saved results, calibration results, workflow log, and generated report cache.

Raw LC–MS files are not copied into the project. Keep the original sample folder available if you intend to rerun processing or use functionality that needs the source data.

Support

Please report reproducible bugs and feature requests in the GitLab issue tracker. Include the version information shown in the application's start window, the workflow log, and the steps needed to reproduce the problem when possible.

Credits

tadaMZ GUI was created by Jethro Hemmann (Leibniz-HKI) and is built on the tadamz package created by Patrick Kiefer (ETH Zurich), with contributions from Johannes Hartl (BIH at Charité).

License

This project is licensed under the GNU General Public License v3.0.