
Abstract 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- and 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.
Smoking, Humans, Reproducibility of Results, Smoking Cessation
Smoking, Humans, Reproducibility of Results, Smoking Cessation
| selected citations These citations are derived from selected sources. This is an alternative to the "Influence" indicator, which also reflects the overall/total impact of an article in the research community at large, based on the underlying citation network (diachronically). | 1 | |
| popularity This indicator reflects the "current" impact/attention (the "hype") of an article in the research community at large, based on the underlying citation network. | Average | |
| influence This indicator reflects the overall/total impact of an article in the research community at large, based on the underlying citation network (diachronically). | Average | |
| impulse This indicator reflects the initial momentum of an article directly after its publication, based on the underlying citation network. | Average |
