Skip to content

A Python library for Global and Target Analysis of time-resolved spectroscopy data

License

Notifications You must be signed in to change notification settings

glotaran/pyglotaran

Repository files navigation

pyglotaran

pyglotaran is a Python library for Global and Target Analysis

latest release Conda Version Tests Documentation Status Binder Coverage Status Total alerts

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.8 or 3.9
  • 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

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 .

_To enforce the installation within a Python3 environment on systems where Python2 is the default, instead of the last command use pip3 install ..

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.

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.

Mailing List

mailing-list

Credits

The credits can be found in the documentation authors section