💻 computer science

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

Este artigo apresenta a FRIENDS GUI, uma interface gráfica de código aberto baseada em Python que extrai, decodifica e visualiza dados de topografia de inalação de 24 horas do monitor passivo de vaporização FRIENDS, a fim de aprimorar a acessibilidade e a interpretação do uso de sistemas eletrônicos de entrega de nicotina para fins de pesquisa e regulamentação.

Autores originais: Shehan Irteza Pranto, Brett Fassler, Md Rafi Islam, Ashley Schenkel, Larry W. Hawk, Edward Sazonov

Publicado 2026-04-29

📖 4 min de leitura☕ Leitura rápida

CC BY 4.0

Autores originais: Shehan Irteza Pranto, Brett Fassler, Md Rafi Islam, Ashley Schenkel, Larry W. Hawk, Edward Sazonov

Artigo original sob licença CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). ✨ Esta é uma explicação gerada por IA do artigo abaixo. Não foi escrita nem endossada pelos autores. Para precisão técnica, consulte o artigo original. Ler aviso legal completo

Imagine que você quer entender exatamente como alguém usa seu cigarro eletrônico (vape). Eles dão tragadas curtas e rápidas ou longas e lentas? Eles seguram o dispositivo por muito tempo entre as tragadas? No passado, os pesquisadores tinham que pedir às pessoas para lembrar desses detalhes, o que é como pedir a alguém para recordar exatamente quantas vezes piscou ontem — frequentemente impreciso e cheio de erros.

Para resolver isso, os autores criaram uma pequena "etiqueta inteligente" de código aberto chamada FRIENDS que se fixa ao vape. Este dispositivo age como um detetive de alta tecnologia, observando e registrando silenciosamente cada vez que o vape é tocado, aquecido ou utilizado. Ele captura os dados com extrema precisão, até o microssegundo.

No entanto, o dispositivo FRIENDS fala uma linguagem que parece um código secreto (dados binários e longas sequências de números). É aí que entra este artigo. Ele introduz a FRIENDS GUI (Interface Gráfica do Usuário), que atua como um tradutor e um contador de histórias.

Veja como o sistema funciona, dividido em partes simples:

1. O Tradutor (Conversão de Dados)

Quando você conecta o dispositivo FRIENDS a um computador, ele despeja um arquivo cheio de números brutos e confusos. A GUI é a ferramenta que pega esse "código secreto" e o traduz para inglês claro.

A Magia: Ela pega uma sequência de números como 100065CA42C88D44 e instantaneamente a transforma em algo que um humano pode ler: "12 de fevereiro de 2024, às 10:09:44 da manhã, o usuário iniciou uma tragada."
A Limpeza: Às vezes, o dispositivo pode ficar confuso com ruído elétrico e registrar uma "tragada falsa". O software possui um filtro embutido (como um porteiro de clube) que verifica os dados. Se uma "tragada" for muito curta (menos de 0,4 segundos) ou não corresponder à mudança de temperatura, o software a descarta como um erro.

2. O Contador de Histórias (Visualização)

Uma vez que os dados são traduzidos, a GUI desenha um quadro dos eventos do dia.

A Linha do Tempo: Imagine um relógio de 24 horas. O software desenha linhas nele mostrando exatamente quando o usuário pegou o vape (Toque), quando começou a inalar (Início da Tragada) e quando parou (Fim da Tragada).
O Mapa de Calor: Ele também rastreia a temperatura da boquilha do vape. Se o dispositivo aquece, é um sinal de que uma tragada está acontecendo. Isso ajuda o software a verificar seu trabalho para garantir que não contou um glitch elétrico aleatório como uma tragada.

3. A Prova (Funcionou?)

Os autores testaram este sistema para garantir que não era apenas uma imagem bonita. Eles não usaram voluntários humanos para o teste; em vez disso, usaram uma máquina para "vapear" de maneira muito controlada.

O Teste: Eles fizeram a máquina dar 72 tragadas específicas em horários exatos (com durações de 2 segundos, 3 segundos e 4 segundos).
O Resultado: O dispositivo FRIENDS e o software GUI detectaram 100% das tragadas reais. Eles calcularam o tempo total gasto vapeando com precisão quase perfeita (99,5% de correspondência).
A Correção de Glitch: O dispositivo registrou acidentalmente 17 "tragadas fantasmas" (falsos positivos), mas o filtro do software identificou e removeu com sucesso, provando que o processo de limpeza funciona.

Por Que Isso Importa

Pense na GUI FRIENDS como um painel de controle para o comportamento de vape. Assim como o painel de um carro informa sua velocidade e nível de combustível, este software informa aos pesquisadores exatamente como um vape está sendo usado.

Transforma dados bagunçados e ilegíveis em gráficos claros e coloridos.
É gratuito para qualquer pessoa usar (código aberto).
Funciona em qualquer computador (Windows, Mac ou Linux).

O artigo conclui que esta ferramenta está pronta para uso imediato pelos pesquisadores. Ajuda-os a parar de adivinhar e começar a ver os padrões reais de como as pessoas usam cigarros eletrônicos, tudo isso sem precisar ser um programador de computadores para fazê-lo. O software está disponível para download no GitHub, pronto para qualquer pessoa instalar e começar a decifrar hábitos de vape.

1. Declaração do Problema

O rápido aumento no uso de Sistemas Eletrônicos de Entrega de Nicotina (ENDS) exige um monitoramento preciso dos comportamentos de vaping (topografia da tragada) para avaliar a exposição a toxinas e informar decisões regulatórias. No entanto, a pesquisa atual enfrenta limitações significativas:

Dependência de Auto-relato: A maioria dos estudos depende da recordação do usuário, que é propensa a erros significativos (por exemplo, baixa correlação entre contagens de tragadas relatadas e reais).
Falta de Padronização: Há uma escassez de métodos objetivos e padronizados para medir métricas críticas como tempo, duração e frequência das tragadas.
Limitações de Hardware: As soluções de sensores existentes frequentemente exigem modificações internas invasivas no dispositivo ou carecem da capacidade de capturar dados contínuos de alta resolução por longos períodos (por exemplo, 24 horas).

2. Metodologia

O artigo apresenta o FRIENDS GUI, uma ferramenta de software de código aberto baseada em Python projetada para interfacear com o dispositivo de hardware FRIENDS (Instrumentação Flexível e Robusta de ENDS).

Contexto de Hardware (Dispositivo FRIENDS)

Componentes: Um microcontrolador MSP430G2433 conectado a um sensor eletromagnético (EM) (detecta atividade do atomizador), um sensor de toque (detecta segurar o dispositivo) e um termistor NTC (mede a temperatura da boca).
Registro de Dados: Registra eventos com timestamps POSIX estendidos de 64 bits de alta resolução (15 µs) na memória flash interna, suportando até 10 dias de dados contínuos.

Arquitetura de Software (FRIENDS GUI)

Desenvolvido em Python 3.11 usando tkinter para a interface, pandas/numpy para processamento de dados e matplotlib para visualização. O sistema opera via comunicação serial (pyserial) e inclui três módulos funcionais principais:

Gerenciamento de Dispositivo:
- Sincroniza o relógio de tempo real do dispositivo com o computador host.
- Gerencia a memória flash (limpando dados antes de novas sessões, apagando dados antigos).
- Gerencia o estabelecimento de conexão serial e atualização de portas.
Extração e Pré-processamento de Dados:
- Decodificação: Converte registros hexadecimais brutos de 16 caracteres em formatos legíveis por humanos.
- Validação e Limpeza:
  - Detecta cabeçalhos de arquivo duplicados (indicando sobrescritas acidentais).
  - Filtra dados de transmissão serial corrompidos (linhas vazias, registros incompletos).
  - Emparelhamento Lógico: Valida se eventos (Tragada, Toque, Temperatura) ocorrem em pares ON/OFF válidos (por exemplo, PUFF_ON seguido de PUFF_OFF).
  - Redução de Ruído: Implementa um algoritmo de filtragem baseado em termistor. Se habilitado, calcula as diferenças de temperatura ( $\Delta T$ ) entre eventos ON/OFF. Tragadas com mudança de temperatura $\le 10$ unidades (aprox. $<1^\circ C$ ) são marcadas como falsos positivos e removidas. Se desabilitado, aplica-se um filtro padrão de duração mínima (400ms).
- Conversão de Timestamp: Traduz timestamps POSIX estendidos de 64 bits (contendo códigos de evento, tempo padrão e frações de segundo) em objetos de data e hora locais.
Visualização:
- Gera gráficos interativos de 24 horas exibindo eventos de tragada, eventos de toque e leituras de temperatura.
- Resume métricas diárias (duração total da tragada, frequência).
- Permite que os usuários definam limites personalizados para duração da tragada para filtrar ruído visualmente.

3. Contribuições Principais

Ferramenta de Código Aberto: A primeira GUI especificamente projetada para processar, decodificar e visualizar dados de vaping passivo de alta resolução do hardware FRIENDS.
Limpeza Avançada de Dados: Uma abordagem algorítmica robusta para lidar com erros de transmissão serial e distinguir eventos reais de vaping de interferência eletromagnética usando dados de termistor.
Acessibilidade: Fornece uma interface amigável que não requer habilidades avançadas de programação, tornando dados comportamentais de alta resolução acessíveis a psicólogos e clínicos.
Flexibilidade: A base de código é modular, permitindo que pesquisadores adaptem a ferramenta para outros sistemas de entrega eletrônica (por exemplo, vapes de THC) ou sensores personalizados.

4. Resultados e Validação

O software foi validado usando um dispositivo SMOK NORD 5 em experimentos controlados (sem participantes humanos; acionamento mecânico).

Precisão:
- Detecção de Eventos: Detectou com precisão todos os 72 eventos reais de tragada em quatro sessões.
- Duração: Registrou uma duração total de tragada de 230,76 segundos, representando 99,46% dos 232,01 segundos reais.
- Falsos Positivos: O sistema inicialmente capturou 17 falsos positivos (provavelmente devido a interferência EM). A lógica de filtragem da GUI (usando um limite de 1,0s ou dados de termistor) identificou e removeu com sucesso estes, deixando apenas eventos válidos.
Precisão do Timestamp:
- A conversão de timestamp mostrou deriva mínima (até 10 segundos em um período de 24 horas), o que é aceitável para pesquisa comportamental.
Tratamento de Erros:
- O software detectou e lidou com sucesso com arquivos de entrada intencionalmente corrompidos (timestamps truncados, linhas ausentes, erros de indentação) sem travar, garantindo a integridade dos dados.
Reprodutibilidade:
- Comparações entre o executável da GUI e scripts autônomos confirmaram saída idêntica para os mesmos arquivos de entrada.

5. Significado

Impacto na Pesquisa: O FRIENDS GUI preenche a lacuna entre dados brutos de sensores e insights comportamentais acionáveis, permitindo estudos objetivos e de alta resolução de padrões de uso de ENDS, exposição à nicotina e resultados de cessação do tabagismo.
Utilidade Clínica: Ao fornecer dados precisos de topografia de tragada, a ferramenta apoia o desenvolvimento de melhores instrumentos de auto-relato e auxilia no monitoramento de transições comportamentais durante intervenções de saúde pública.
Escalabilidade: Como ferramenta baseada em Python, licenciada sob MIT e hospedada no GitHub e Zenodo, está livremente disponível para a comunidade global de pesquisa adaptar para vários sistemas eletrônicos de entrega não nicotina (ENNDS) e configurações de monitoramento personalizadas.

Disponibilidade:

Repositório: GitHub (https://github.com/eszsonic/FRIENDSGUI)
Arquivo: Zenodo (https://doi.org/10.5281/zenodo.18753292)
Licença: MIT