PathsViewer

PathsViewer é uma ferramenta para visualização de dados espaço-temporais em tempo real ou pós-eventos. Essa ferramenta busca suprir a demanda por ferramentas de visualização de trajetórias de objetos, em vista do grande interesse em pesquisas nesse tipo de dado.

É possível utilizar conjuntos de dados variados, com estruturas diversas, tais como traces de 5G georreferenciados e trajetórias de veículos.

Esse repositório (e sua Wiki) contém todo o código da ferramenta, como também instruções para execução, deploy, contribuição e demais informações.

Demonstração de Uso

Para uma breve demonstração, acesse o PathsViewer no endereço intrig-unicamp.github.io/paths-viewer.

• A tela inicial apresenta a seleção dos modos de operação

• Modo de operação pós-eventos

  Veja na imagem abaixo a interface para carregar os dados a serem utilizados no modo pós-eventos. É possível selecionar a visualização de mapa 2D ou satélite. Usando o ícone de edição ao lado de cada dataset, o usuário pode editar o nome e cor do traço. Também são listadas as coordenadas de cada coleta

  💡 Teste com os datasets de exemplo na pasta examples

• Modo de operação em tempo real

  Também podemos realizar o envio de dados em tempo real através de dispositivos distribuídos. Na imagem abaixo, são exibidos os parâmetros de conexão para enviar dados para a API do PathsViewer, para que a interface no navegador exiba em tempo real as coletas realizadas

  💡 Utilize o script realtime-sim para simular o envio dos dados em tempo real

Formato de arquivo

A ferramenta aceita o envio de arquivos no formato .csv sem cabeçalho. Exemplo:

C13062,10-03-2014,07:00:54,-23.007013,-43.311646
C13062,10-03-2014,07:01:54,-23.007328,-43.306889
C13062,10-03-2014,07:02:54,-23.009064,-43.305984
C13062,10-03-2014,07:03:54,-23.010941,-43.309719
C13062,10-03-2014,07:04:53,-23.013695,-43.313404

As colunas devem ser na ordem:

• Identificador
• Data, no formato <dia>-<mês>-<ano>
• Hora, no formato <horas>-<minutos>-<segundos>
• Latitude em graus decimais
• Longitude em graus decimais

🚀 Configuração inicial

Essas instruções vão permitir que você tenha uma cópia funcional do projeto na sua máquina local para desenvolvimento e testes.

📋 Requisitos

• NodeJS v18.3.0 LTS / NPM v8.11 (recomenda-se fortemente a utilização do NVM para gerenciar facilmente as versões do NodeJS)
• Yarn
• Gerar as credenciais do Firebase

🔧 Instalação

• Clone o repositório

git clone https://github.com/intrig-unicamp/paths-viewer.git
cd paths-viewer # entre na pasta onde foi feito o clone

• (se utilizar NVM): Configure a versão NodeJS correspondente

nvm install
nvm use # necessário executar sempre que for iniciar o projeto

• Instale as dependências do projeto

yarn install

• Inicie o projeto no modo desenvolvedor

yarn dev

Por padrão, a interface deverá iniciar no endereço http://localhost:3000.

💡 Consulte o guia de instalação na Wiki para mais exemplos e casos de uso.

📊 Banco de Dados

Utilizamos o Firebase como solução de banco de dados, tanto em produção quanto desenvolvimento. É necessário gerar as credenciais necessárias para executar o projeto sem problemas. Siga o guia respectivo na Wiki para mais informações.

👏 Contribuições

Todos são bem-vindos a realizar contribuições e sugestões no código! Recomenda-se enviar pull requests ou então criar issues. A nossa equipe analisará em breve.

Licença

Esse projeto adere à licença MIT. Consulte o arquivo LICENSE para mais informações.

Copyright © INTRIG Research Group.