granted 2.0.22

GranTED: Gran-Schwartz Titration Analysis Tool

GranTED

GranTED (Gran-Schwartz Titration Equivalence point Determination) is an open-source Python package for automated and robust analysis of potentiometric titration data using the Gran and Schwartz methods.

Designed with analytical and green chemistry in mind, GranTED provides reliable equivalence point detection, uncertainty estimation, and advanced diagnostic tools — particularly useful for method development, optimization, and validation of titration procedures.

---

Features

• Automatic computation of Gran and Schwartz functions
• Robust linear region detection with R² optimization
• Schwartz k-optimization and re-identification of linear interval
• Analytical uncertainty estimation on equivalence volume (EQP)
• Advanced method development tools: Backward trimming analysis + earliest acceptable point detection with configurable thresholds
• High-quality, publication-ready diagnostic plots (PNG + PDF) with full-dataset insets for context
• Multiple operation modes:
  • method_development — full trimming + convergence analysis
  • method_validation / method_application — standard analysis
  • method_debug — detailed diagnostic plots
• Clean command-line interface with extensive options

---

Installation

from PyPI (Recommended)

pip install granted

From Source (for development)

git clone https://github.com/sgiani95/GranTED.git
cd GranTED
pip install -e .

---

Quick Start

# Basic usage with default settings
granted --data_file data.dat --mode method_development

# With custom thresholds for method development
granted --data_file data.dat --mode method_development \
        --veq-tolerance 0.010

---