Apr 09, 2026
Sleep scoring processing
- 1Universidade de São Paulo;
- 2USP
Protocol Citation: Daniel Vartanian, Alicia Rafaelly Vilefort Sales, Maria Augusta Medeiros Andrade 2026. Sleep scoring processing. protocols.io https://dx.doi.org/10.17504/protocols.io.j8nlkwmnwl5r/v1
License: This is an open access protocol distributed under the terms of the Creative Commons Attribution License, which permits unrestricted use, distribution, and reproduction in any medium, provided the original author and source are credited
Protocol status: Working
We use this protocol and it's working
Created: January 23, 2023
Last Modified: April 09, 2026
Protocol Integer ID: 75749
Keywords: actigrafia, sono, cronobiologia, condor instruments, sleep scoring, research project sleep, data collection process of the research project sleep, process flowchart, processo como, process, processing, data collection process
Abstract
Este protocolo foi desenhado para o processo de coleta de dados do projeto de pesquisa Sono e Gravidez. Consulte a aba Guidelines para visualizar o fluxograma do processo como um todo.
Caso tenha dúvidas ou sugestões, entre em contato com um dos autores.
---
This protocol was designed for the data collection process of the research project Sleep and Pregnancy. See the Guidelines tab to view the process flowchart as a whole.
If you have any questions or suggestions, please contact one of the authors.
Guidelines
Salve o processamento, em um arquivo diferente do arquivo dos dados brutos, a cada etapa.
Before start
Leia todas as instruções ao menos uma vez e tenha os seguintes materiais à mão antes de realizar o protocolo.
- Computador.
- Os dados da coleta actigráfica e outros dados complementares (e.g., diário de sono).
- Conexão com a internet.
Preparação dos dados
Baixe os dados actigráficos em seu computador
Note
Ao salvar o arquivo em seu computador, certifique-se de que o local onde irá salvar NÃO esteja sincronizado com algum serviço de nuvem (e.g., Google Drive; OneDrive). Isso é muito importante para não comprometer a segurança dos dados da voluntária.
Extraia o conteúdo do arquivo
Clique no arquivo com o segundo botão do mouse, e depois clique em "extrair tudo". Em alguns computadores essa opção pode aparecer de forma diferente. Faça todo o processo de extração dos dados, selecionando a pasta de destino.
Note
Caso você não consiga realizar a descompactação da pasta, baixe e instale o aplicativo 7zip para auxiliá-lo. Clique aqui para realizar o download.
Selecione o sistema referente ao seu computador e faça o download. Se seu sistema operacional for o Windows 10 ou superior, faça o download da opção 64-bit Windows x64"
Após o download e instalação do 7-zip, realize o mesmo processo apresentado no início deste passo.
Clique no arquivo com o botão direito do mouse, vá em 7-zip e depois em Extrair aqui.
Note
O arquivo com os dados actigráficos está criptografado e só poderá ser aberto/lido com uma senha. Após clicar em Extrair aqui será solicitado que você insira essa senha. A senha foi enviada a você junto com o arquivo.
Digite a senha e clique em OK.
Diário de Sono - acesse as respostas
Para ter acesso às respostas do diário de sono e formulário de campo das voluntárias baixe o programa CSViewer.
Abra o CSViewer e clique em open file
CSViewer
Abra a pasta descompactada com os dados actigráficos e selecione o arquivo raw do diário do sono
Clique na pasta em amarelo (1) --> selecione o local e a pasta dos dados actigráficos que você salvou no seu computador -> selecione a pasta sleep diary (2) e abra o arquivo raw.
Clique em load (3)
Veja as respostas do diário de sono e tenha a mão durante o processamento dos dados.
Note
Utilize esses dados no processamento dos dados actigráficos. Esses dados auxiliarão, principalmente, para identificar a presença de cochilos, ver os comentários,
Importação
Abra o software ActStudio
Note
Ao abrir o ActStudio, é possível que as seguintes janelas apareçam. Clique em Não ou feche a janela caso isso aconteça. Essas configurações não são necessárias para este protocolo.
Importe os dados
Note
Vá até a tela Dados, clique em IMPORTAR/EXPORTAR DADOS e depois em ABRIR.
Clique na aba Dados, vá em IMPORTAR/EXPORTAR DADOS e depois em ABRIR.
Procure e selecione o arquivo que contém os dados brutos (raw) da coleta actigráfica que irá processar
Caso apareça a seguinte mensagem, clique em NÃO.
Não salve no banco de dados do ActStudio
Os dados devem ser armazenados somente em locais seguros. Isso representa um risco à segurança deles.
Recorte os dados
Vá até os arquivos que você descompactou em seu computador e abra o arquivo [id da voluntária] delivery-receipt. Veja o dia e a hora em que o actígrafo foi instalado.
Volte ao ActStudio e insira o período inicial (Start) e final (End) da coleta no ActStudio conforme as informações que você coletou no arquivo "Readme"
Na aba "seleção de período" selecione a data e hora inicial e final que você reservou no passo anterior. Após, clique em "aplicar".
Altere o fuso horário da coleta (opcional)
Alteração do fuso horário
Note
Altere o fuso horário apenas quando necessário.
Processamento automático
Gere a pontuação do sono
Vá para a aba "análise" (1), desmarque as caixas de seleção de: "luz vermelha", "luz verde", "temperatura externa", "luz IR", "luz UVA" e "luz UVB" (2). Depois, clique em "gerar" (3)
Dados brutos
Importe o diário de sono.
Note
Certifique-se que você já gerou a pontuação do sono antes de importar os dados do diário de sono. Caso isso não aconteça, todo o processamento da pontuação do sono estará comprometido.
Vá para "dados" (1) -> "diário de sono" (2) -> "importar" (3)
Selecione a pasta "actigraphy" -> "subject_id_1_sleep-diary.txt " -> "abrir"
Note
Após importar o diário de sono, volte para a aba "análise" e inicie o processamento dos seus dados.
Processamento por inspeção visual
Identifique os estados de Offwrist
Pontuação do sono mostrando o intervalo de tempo no qual houve retirada do aparelho do braço (Offwrist), representado pela cor roxa. As linhas tracejadas representam os momentos em que o sujeito apertou o botão de evento.
O período Offwrist deve ser detectado quando houver cessação da atividade em conjunto com a diminuição da temperatura.
Note
Como mudar os estados:
Clique em cima do estado que você quer alterar com o botão direito do mouse -> clique em "dividir zona" ou "alterar estado" para acrescentar/dividir ou simplesmente alterar o estado.
Dividir zona: irá dividir a zona selecionada em dois estados diferentes.
Alterar estado: irá alterar o estado de toda a zona selecionada.
Cometeu um erro? Não se preocupe, pressione Ctrl + Z para voltar a ação.
Remova possíveis falsos positivos e micro estados
O software reconhece erroneamente alguns períodos como um estado de sono ou de descanso. Assim, é necessário que o excluamos para que a análise não seja impactada. Preste muita atenção, pois eles podem ser difíceis de serem percebidos.
Note
Na aba "Análise" -> Seleção de períodos -> "períodos de sono" você conseguirá identificá-los de forma mais efetiva.
Em vermelho você verá os períodos secundários de sono, i.e., os micro estados e os cochilos. Identifique os micro estados e volte na aba "análise" --> "pontuação de sono" para exclui-los.
Retire os estados "descansando" do início e final dos períodos de sono principal e dos cochilos
Note
Os estados "Descansando" (representados pela cor verde-clara) devem permanecer durante os episódios de sono/cochilo, mas NÃO durante o dia de forma isolada e NÃO NO COMEÇO OU FINAL dos episódios de sono/cochilo.
Observe que os estados "descansando" (em verde) devem permanecer apenas no meio (durante) o período do sono. Nunca no início e no final do período do sono/cochilo.
Ajuste o horário de inicio do sono (HIS) e horário do final do sono (HFS)
Note
Evite mexer muito no processamento automático. Faça correções pontuais.
Utilize os dados informados no diário de sono para melhorar suas decisões.
Lembre-se: O objetivo deste processamento é corrigir a inferência automática dos estados de sono, vigília e offwrist. Não é algo com a pretensão de exatidão, mas é necessário haver um certo rigor.
Lembre-se: O começo e o final do sono NÃO podem começar/terminar com o estado "descansando", representado pela cor verde-clara.
Note
Utilize os critérios apresentados nas tabelas abaixo para corrigir os momentos de início e final dos episódios de sono/cochilos.
Critérios de decisão graduada para o horário de início do sono (HIS)
Critérios de decisão graduada para o Horário do Final do Sono (HFS)
Finalização
Revise toda a pontuação do sono
Note
Certifique-se que você não deixou nada para trás.
Salve os dados processados
Note
Importante: Salve o processamento em um arquivo diferente do arquivo dos dados brutos (raw). NUNCA salve em cima do arquivo raw.
Note
Caso você não finalize o processamento no mesmo dia, é importante que você salve no seu computador todas as edições que você fizer antes de sair do ActStudio. Assim, será possível continuar de onde parou (abrindo o arquivo salvo e não o raw), e não precisará começar tudo do zero.
É também recomendado que você salve o processamento regularmente para evitar perdas.
Note
Para salvar vá na aba "Dados" -> "importar/exportar" -> "Salvar"
Instrução para salvar cada log
Envie os dados processados à equipe de pesquisa
Feche o software ActStudio
Caso todos os dados (inclusive os brutos), estejam armazenados em locais seguros e você não precisar mais trabalhar com eles, delete todos os dados de seu computador.
Note
Atenção: Certifique-se que você pode deletar os dados.
Não esqueça de esvaziar a lixeira do seu sistema.
Note
Os dados devem ser armazenados somente em locais seguros. Cópias locais representam um risco à segurança deles.