pyglotaran 0.7.0

The Glotaran fitting engine.

pyglotaran

pyglotaran is a Python library for Global and Target Analysis

A common use case for the library is the analysis of time-resolved spectroscopy measurements in the study of energy transfer pathways in photosynthesis, or the characterization of energy transfer (in-)efficiencies in photovoltaics.

Warning: This is an early access release, please refer to the usage notice down below prior to committing to use pyglotaran to avoid surprises down the line.

Installation

Prerequisites:

• Python 3.10
• On Windows only 64bit is supported

Note for Windows Users: The easiest way to get python for Windows is via Anaconda

Stable Release

To install pyglotaran from pypi, run this command in your terminal:

pip install pyglotaran

If you want to install it via conda, you can run the following command:

conda install -c conda-forge pyglotaran

To install pyglotaran together with pyglotaran-extras which provides common plotting functionality you can run:

pip install pyglotaran[extras]

From Source

To install from source, e.g. for testing or development purposes, run these commands in your shell/terminal:

git clone https://github.com/glotaran/pyglotaran.git
cd pyglotaran
pip install .

Note (for Linux users): use pip3 instead of pip if Python2 is the system default Python installation.

Note (for Anaconda users): please make sure to update your distribution prior to install since some packages managed by Anaconda cannot be updated by pip.

Usage notice

This software package is made available as an early access release, to the advantage of the (scientific) community who wishes to make use of it before it has fully matured, but without any warranties.

Anyone using this package for serious work - scientists and academic users in particular - are cautioned, and treat it as any other instrument or tool that requires calibration or validation. Also be prepared for some refactoring of models or analysis specifications, sometime down the line.

As of yet, the pyglotaran package has not yet been used in any peer-reviewed scientific publications (contribution welcome), but it has been partially cross-validated against comparable software, such as the R-package TIMP, and the TIM software described in this publication (DOI: 10.1016/j.bbabio.2004.04.011).

The examples used in this validation process can be obtained from the pyglotaran-examples repository.

An early access version of the v0.6.0 release was used in scientific teaching by a number of students in the 2022 Photosynthesis and Energy course under supervision by dr. Ivo van Stokkum (profile, github: ism200). Course material can be found here: ism200\PE2022

Glotaran legacy

The pyglotaran package derives its name from the Glotaran software package (now called glotaran-legacy), first released in 2011 and described in a highly-cited publication in the Journal of Statistical Software, under the title Glotaran: A Java-Based Graphical User Interface for the R Package TIMP (DOI: 10.18637/jss.v049.i03).

The pyglotaran software can be considered the spiritual successor of the glotaran-legacy software and has the backing of many of its original creators.

The future of global and target analysis

Eventually, and hopefully sooner than later, a (scientific) publication about the architecture and the design of the software package will appear, detailing the flexibility of the software and showing why we believe this software package is the future of global and target analysis.

Until then, enjoy your glimpse into the future.

Community Support

For questions / suggestion please reach out to us via:

1. GitHub issues
2. Discord
3. Google-Groups mailing list

Credits

The credits can be found in the documentation authors section