🎵🧭 ComPasso — Documentação
ComPasso é uma plataforma de pesquisa em psicofisiologia que sincroniza a reprodução de
músicas com a aquisição contínua do sinal do BITalino (via OpenSignals + Lab Streaming
Layer). As amostras do sinal e os marcadores de evento compartilham um único relógio
(pylsl.local_clock()), garantindo sincronia precisa entre o estímulo auditivo e os dados
fisiológicos coletados. Um gráfico do sinal em tempo real 📈 acompanha cada faixa durante a
gravação.
O programa toca uma sequência pseudoaleatória de faixas (músicas e ruído) e grava, para cada
faixa, um par de arquivos (CSV + XLSX) com o sinal e os marcadores de evento alinhados no tempo.
🔎 Para que serve
- Contexto: experimento de laboratório (ex.: condutância da pele) em que a reprodutibilidade
e a rastreabilidade dos dados são prioritárias.
- O que faz: conecta ao BITalino (com suporte a diferentes tipos de sensor — EDA/ECG/EMG/EOG/
EEG/EGG), coleta dados do participante, monta uma playlist a partir de uma pasta de áudios e de
uma planilha de condições, grava o sinal sincronizado por faixa e exibe um gráfico do sinal em
tempo real durante a coleta.
- Multiplataforma: Windows e macOS (Linux como melhor esforço).
📚 Índice da documentação
- Primeiros passos — requisitos, instalação e como executar.
- Conexão com o BITalino — OpenSignals, LSL e o watchdog de conexão.
- BITalino simulado — teste a interface inteira sem hardware.
- Menus Experimento / Configurações / Tema / Atualizações / Ajuda — criação
e uso de configurações, incluindo as opções do gráfico do sinal.
- Configurações do App — preferências do operador/máquina (6 abas) e
ambiente.json.
- Arquivo de configuração
.config — o schema real dos campos.
- Arquivos de entrada — pasta de músicas e planilha de condições.
- Executando um experimento — passo a passo completo de uma sessão,
incluindo o gráfico do sinal em tempo real e a calibração de volume.
- Dados de saída — nomes de pastas/arquivos e colunas do CSV/XLSX.
- Solução de problemas — erros comuns e como resolvê-los.