FRIENDS GUI: A graphical user interface for data collection and visualization of vaping behavior from a passive vaping monitor

Shehan I Pranto, Brett Fassler, Md Rafi Islam, Ashley Schenkel, Larry W Hawk, Edward Sazonov · 2025

Read FRIENDS GUI: A graphical user interface for data collection and visualization of vaping behavior from a passive vaping monitor by Shehan I Pranto, Brett Fassler, Md Rafi Islam, Ashley Schenkel, Larry W Hawk, Edward Sazonov (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2511-15007.txt.

Introduction

Shehan Irteza Pranto and five co-authors introduce a graphical interface for collecting and viewing vaping behavior data. Puff duration, gaps between puffs, and puffs per session shape exposure to toxicants. A passive monitor device records puffing and touching events from nicotine delivery systems. Raw logs alone are hard for researchers and regulators to interpret.

The Python interface extracts, decodes, and visualizes a full day of puffing data. Tests on experimental data confirm correct time conversion and event decoding. Behavior plots are clear and effective for analysis. The software is open source and freely shared. Better tooling should improve studies that inform regulation of vaping products.

Catalog record

CREATORShehan I Pranto, Brett Fassler, Md Rafi Islam, Ashley Schenkel, Larry W Hawk, Edward Sazonov
YEAR2025
COLLECTIONPAPERS
FORMATTXT
FILE SIZE22 KB
VERSION1.0
LICENSEhttp://creativecommons.org/licenses/by/4.0/
RIGHTSCC BY
SOURCEarXiv

Source: https://arxiv.org/abs/2511-15007

Browse the full library · About the Tower of Babel

Full text

The opening of the work, from the library's hosted text:

FRIENDS GUI: A graphical user interface for data collection and visualization of vaping behavior from a passive vaping monitor Shehan I Pranto, Brett Fassler, Md Rafi Islam, Ashley Schenkel, Larry W Hawk, Edward Sazonov Abstract Understanding puffing topography (PT), which includes puff duration, intra puff interval, and puff count per session, is critical for evaluating Electronic Nicotine Delivery Systems (ENDS) use, toxicant exposure, and informing regulatory decisions. We developed FRIENDS (Flexible Robust Instrumentation of ENDS), an open-source device that records puffing and touch events of ENDS by attaching to it. This paper introduces the FRIENDS GUI that improves accessibility and interpretability of data collected by FRIENDS. The GUI is a Python-based open-source tool that extracts, decodes, and visualizes 24-hour puffing data from the FRIENDS device. Validation using 24-hour experimental data confirmed accurate timestamp conversion, reliable event decoding, and effective behavioral visualization. The software is freely available on GitHub for public use. K eywords Graphical User Interface \cdot Vaping behavior \cdot Wearable sensors \cdot Visualization 1 Introduction The global use of Electronic Nicotine Delivery Systems (ENDS), commonly known as e-cigarettes or vapes, has increased significantly in recent years. In 2020, approximately 68 million people were using ENDS worldwide, nearly doubling the estimated 35 million users in 2015 [ 19 , 11 ] . ENDS use has grown steadily since 2010 in the United States, with 8.1 million adults identified as users by 2018 [ 2 ] . As of 2021, 4.5% of U.S. adults reported current ENDS use, with the highest prevalence (11%) among young adults aged 18–24 [ 23 ] . Although ENDS are often promoted as a safer alternative to combustible cigarettes, studies have shown that their vapor contains harmful chemicals, including acetaldehyde and formaldehyde, which are associated with respiratory and cardiovascular diseases [ 15 ] . Nevertheless, emerging evidence also suggests that ENDS can support smoking cessation, with systematic reviews such as the Cochrane review highlighting their effectiveness for adult smokers attempting to quit [ 3 ] . A growing body of research has emphasized that vaping patterns-such as the frequency, timing, and duration of puffs-play a critical role in smoking cessation outcomes [ 9 , 12 , 10 ] . However, a lack of standardized, objective methods to measure vaping behavior hinders cross-study comparisons and limits understanding of nicotine intake and usage trends [ 5 ] . Most studies rely heavily on self-reporting [ 17 , 4 , 14 , 18 ] , which is inherently limited. Many relevant behavioral metrics, such as puff timing and duration, cannot be accurately self-reported, and recall errors further reduce the reliability of such data [ 20 ] . Even over a 4-hour session, self-reported puff counts correlated poorly with actual counts (r = 0.37) [ 6 ] . Taking inspiration from sensors designed for monitoring of cigarette smoking [ 13 , 16 ] , sensors offer a promising alternative for more accurate monitoring of ENDS use. For example, a system described in [ 1 ] enables detailed measurement of vaping behavior, including puff depth and intensity. However, its reliance on internal electrical connections limits its practical utility. To address these challenges, the Flexible Robust Instrumentation of Electronic Nicotine Delivery Systems (FRIENDS) was developed as an open-source monitoring device that attaches externally to ENDS. FRIENDS integrates an electromagnetic (EM) sensor to detect puff events, a touch sensor to log when the device is held, and a thermistor to measure temperature changes during each puff and touch event. These components collectively record data to onboard memory with high-resolution ( 15\,\mu\text{s} ) 64-bit extended POSIX timestamps with the event code. This paper introduces the FRIENDS GUI, an open-source Python-based graphical user interface that supports seamless interaction with the FRIENDS device. The GUI facilitates data retrieval, processing, and conversion of raw binary logs into human-readable formats. It calculates key metrics such as event duration, enables users to set or synchronize device time, and supports flash memory management. The software also generates interactive, customizable visualizations that allow users to explore daily vaping patterns. Similar to other advanced processing tools [ 21 , 7 , 22 ] , the FRIENDS GUI aids in data-driven decision-making and supports refinement of experimental protocols [ 8 ] . Figure 1: FRIENDS system architecture: (a) Device placement on ENDS; (b) user interaction with sensors; (c) graphical interface; (d) extended POSIX timestamp file; (e) converted timestamp file; (f) extracted event data; (g) graph of collected data (High-confidence puffs involve both EM and touch detections) 2 Implementation and architecture The FRIENDS system integrates hardware and software components to enable precise monitoring of vaping behavior. As shown in figure 1 , the core hardware includes an MSP430G2433 microcontroller connected to three sensors: an electromagnetic (EM) sensor for detecting atomizer activity during puffs, a touch sensor for identifying when the device is held, and a negative thermal coefficient (NTC) thermistor for measuring temperature at the mouthpiece. The device attaches adhesively to ENDS and logs the start and end times of puffing and touching events in its internal flash memory, supporting continuous data collection for up to 10 days (figure 1 a). The software components of the system have three primary responsibilities: 1. Data Collection Control: The software facilitates synchronization of the device’s internal clock with the host computer and clears flash memory before a new session. This ensures accurate timestamping and reliable data capture for all events. 2. Data extraction and conversion: The GUI extracts and decodes the binary data after data collection and provides key metrics, such as puff count, puff duration, and time of occurrence for a puff. Events are stored using extended POSIX timestamps (figure 1 d), which include event codes, standard time, and fractional seconds (Table- 1 ). Temperature is sampled at the start and end of puff and touch events, with values ranging from 0 to 1024, calculated via an internal voltage divider circuit. Although not timestamped independently, these readings are used to improve puff classification accuracy and eliminate false positives (Algorithm 1 ). Converted timestamps and extracted data, including puff durations and timing, are displayed in human-readable formats (figure 1 e–f). 3. Visualization: The software generates 24-hour graphs showing puffing, touch, and temperature data for the beginning and end of puffs. It also summarizes total puff duration and frequency per day (figure 1 g). Table 1: Formatting of original and converted timestamps. Extended POSIX timestamp Event code Standard POSIX in HEX Fractional part Event Converted timestamp 100065CA42C88D44 1000 65CA42C8 8D44 PUFF ON PUFF_ON 2024-02-12 10:09:44.55 200065CA42C9AAE0 2000 65CA42C9 AAE0 PUFF OFF PUFF_OFF 2024-02-12 10:09:45.67 50000000000001F9 5000 – – TEMPERATURE ON TEMPERATURE_ON 505 6000000000000104 6000 – – TEMPERATURE OFF TEMPERATURE_OFF 260 300065CA42CE04A0 3000 65CA42CE 04A0 TOUCH ON TOUCH_ON 2024-02-12 10:09:50.02 400065CA42D007CD 4000 65CA42D0 07CD TOUCH OFF TOUCH_OFF 2024-02-12 10:09:52.03 Figure 2: The main window of the FRIENDS GUI 3 Graphical User Interface User interaction with the FRIENDS system is facilitated through a graphical user interface (GUI), developed using Python 3.11 and the tkinter package. Multithreaded operations, implemented via Python’s threading library, allow real-time GUI responsiveness during serial communication. Data processing tasks such as timestamp conversion, event extraction, and formatting are handled using the Pandas and NumPy libraries, while Matplotlib is used for generating visualizations within the GUI (figure 2

Read the complete text