pytapas 1.1.4

Transient Absorption Processing & Analysis Software

TAPAS

Transient Absorption Processing & Analysis Software

What is TAPAS?

TAPAS is a portable, user-friendly GUI for importing, processing, fitting, and visualizing time-resolved transient absorption data. Just download and run the cross-platform binaries — no Python environment or pip installs required. For power users, every binary ships with the raw Python source and configuration files, so you can tweak kinetic models, extend fitting routines, or build custom analyses for your needs. Built on Python with JAX (XLA + JIT), TAPAS performs global fitting in seconds and provides detailed fit statistics, such as standard deviations and parameter correlations. It organizes raw inputs (including solvent and steady-state scans), processed results, and analyses into compact HDF5 files with automatically generated metadata for easy and comprehensible management.

Key features:

• free and Open-Source software

• Zero-install portable binaries for Windows, macOS, and Linux

• Intuitive GUI with clear workflow — no command-line or scripting required

• Flexible processing tools like resampling, filtering, chirp- & background correction and SVD analysis

• Fast fitting and error estimation powered by JAX (XLA + JIT)

• MCMC-based posterior analysis of fitted parameters

• Extendable kinetic models & routines via editable code and config files

• Publication-ready plotting with multiple plot types (e.g., contour maps, kinetics traces, spectral overlays)

• Combine multiple projects into unified workspaces

• HDF5 data bundles with auto-generated metadata for easy management

Installation Guide

There are three ways to install and run TAPAS

1. Download & Run the Bundled App

2. Install from PyPI

3. Install from Source

Bundled App (GitHub Release)

This is the recommended way for non python users.

1. Visit the Releases page on GitHub

2. Download the ZIP for your platform (e.g. TAPAS_vX.Y.Z.zip).

3. Extract the ZIP to a folder of your choice.

4. Your OS might flag the app since we don’t purchase a commercial code-signing certificate. You can safetly ignore these warnings

5. Run the executable. The first cold start might take several seconds.

No Python installation or environment setup is required. Because this application is built and distributed directly from source and isn’t signed by a commercial certificate authority, you may see warnings from your OS when you first download or launch it. This is expected and does not indicate any malware.

The source code can be found under:

_internal/tapas

and can be changed or extended to satify user specific needs. More information can be found here.

Install from PyPI

1. Check Interpreter Version:

   This package requires Python=3.11 due to our PyQt6 dependency:

   python --version
   conda create -n myenv python=3.11
   conda activate myenv

2. Install via pip:

   pip install pytapas

3. Launch the GUI:

   • Use the console script:

     tapas

   • Or invoke as a module:

     python -m tapas

   Both commands start the same TAPAS graphical interface.

From Source (Development Workflow)

1. Obtain the source:

   • Clone the repo:

     git clone https://github.com/PyTAPAS/TAPAS.git
     cd TAPAS

   • OR download Source code (zip) from GitHub and extract it.

2. Create and activate a virtual environment:

   • Windows (cmd.exe):

     python -m venv .venv
     .venv\Scripts\activate

   • Windows (PowerShell):

     python -m venv .venv
     .venv\Scripts\Activate.ps1

   • macOS / Linux:

     python3 -m venv .venv
     source .venv/bin/activate

3. Install dependencies and the editable package:

   pip install --upgrade pip
   pip install -e .

   (This reads pyproject.toml and installs all required dependencies.)

4. Launch TAPAS:

   python launch_tapas.py

Documentation

A detailed documentation can be found here.

License

Copyright 2025 Philipp Frech

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.