Python Package abstcal: An Open-Source Tool for Calculating Abstinence From Timeline Followback Data

Introduction: In smoking cessation clinical trials, timeline followback (TLFB) interviews are widely used to track daily cigarette consumption. However, there are no standard tools for calculating abstinence based on TLFB data. Individual research groups have to develop their own calculation tools, which is not only time- A nd resource-consuming but might also lead to variability in the data processing and calculation procedures. Aims and Methods: To address these issues, we developed a novel open-source Python package named abstcal to calculate abstinence using TLFB data. This package provides data verification, duplicate and outlier detection, missing-data imputation, integration of biochemical verification data, and calculation of a variety of definitions of abstinence, including continuous, point-prevalence, and prolonged abstinence. Results: We verified the accuracy of the calculator using data derived from a clinical smoking cessation study. To improve the package's accessibility, we have made it available as a free web app. Conclusions: The abstcal package is a reliable abstinence calculator with open-source access, providing a shared validated online tool to the addiction research field. We expect that this open-source abstinence calculation tool will improve the rigor and reproducibility of smoking and addiction research by standardizing TLFB-based abstinence calculation. Implications: Abstinence calculation is an essential task in any smoking intervention study. However, there have not been standard open-source tools available to the researchers. This commentary describes a Python-based package called abstcal that can calculate abstinence from TLFB data, a common methodology to collect smoking consumption data in research settings. The package supports the calculation of point-prevalence, prolonged, and continuous abstinence. Importantly, the package has a web app interface that allows researchers to use the tool without any coding experience. This tool will facilitate smoking research by providing a standardized and easy-to-use abstinence calculation tool.