Repositório de Análises de Vitimização e Percepção de Segurança

Introdução

O presente repositório tem por finalidade centralizar, processar e analisar dados de vitimização e percepção de segurança, com foco especial em pesquisas realizadas no Brasil. O projeto foi concebido para assegurar a gestão da informação científica e a reprodutibilidade das análises, em conformidade com as melhores práticas de organização de código e dados.

Nesta plataforma, são disponibilizados desde os microdados brutos e scripts de tratamento (ETL) até as análises estatísticas e os relatórios consolidados.

Metodologia e Estrutura Técnica

Estrutura do Repositório

O projeto está organizado na seguinte estrutura de diretórios para segregar de forma clara os dados, códigos e resultados:

/analises_vitimizacao
├── dados_brutos/
│   └── "identificação_data_dataset"/
├── dados_tratados/
│   ├── csv/
│   └── excel/
├── scripts/
│   ├── tratamento/
│   └── analise/
├── analises/
│   └── relatorios/
├── documentos/
│   └── "identificação_data_dataset"/
└── metadados/
    ├── por_fonte/
    └── dicionario_unificado.csv
            

• dados_brutos/: Contém os dados originais e imutáveis, conforme foram coletados.
• dados_tratados/: Armazena os dados após o processo de limpeza e tratamento, prontos para a análise.
• scripts/: Abriga o código-fonte, dividido em tratamento (ETL) e análise (modelagem e visualização).
• analises/: Guarda os resultados finais, como relatórios (.pdf) e gráficos.
• documentos/: Inclui documentação de apoio, como os questionários originais das pesquisas.
• metadados/: Contém dicionários de variáveis, logs de integração e outra documentação técnica.

Acesso e Configuração do Ambiente

Para replicar o ambiente e executar as análises, os seguintes passos são recomendados:

1. Clonagem do Repositório: O repositório pode ser clonado por meio do seguinte comando Git:

   git clone https://github.com/vitimizacaocrisp/Repositorio_pesquisas

2. Acesso aos Dados Brutos: Os dados originais, devido ao seu volume, não são versionados diretamente no repositório. O download pode ser realizado a partir do seguinte link:
   Acessar Dados no Google Drive
3. Organização dos Dados: Os arquivos baixados devem ser descompactados e alocados na pasta /dados_brutos/.
4. Instalação de Dependências: As bibliotecas Python necessárias para a execução dos scripts estão listadas no arquivo pyproject.toml. A instalação pode ser feita com o pip, utilizando um arquivo requirements.txt.

   pip install -r requirements.txt

Fluxo de Trabalho (Workflow)

O fluxo de trabalho foi desenhado para garantir clareza e reprodutibilidade:

• Coleta e Armazenamento: Os dados brutos são inseridos no diretório dados_brutos/ e permanecem inalterados.
• Tratamento (ETL): Scripts localizados em scripts/tratamento/ são executados para limpar, padronizar e unificar os dados.
• Armazenamento de Dados Tratados: Os datasets resultantes são salvos em dados_tratados/, nos formatos CSV e Excel.
• Análise: Scripts em scripts/analise/ utilizam os dados tratados para gerar modelagens, visualizações e insights.
• Resultados: Relatórios, dashboards e gráficos finais são armazenados no diretório analises/.

Estratégia de Branches

O repositório utiliza duas branches principais para diferentes finalidades de desenvolvimento:

• notebook: Contém arquivos .ipynb (Jupyter Notebooks) utilizados para análise exploratória, prototipagem e desenvolvimento interativo.
• script: Contém arquivos .py (Python scripts) otimizados para produção, automação e reprodutibilidade de código.

Descrição dos Scripts de Processamento e Análise

Scripts de Tratamento

Scripts de Análise

Metadados e Documentação Técnica

• Metadados por Fonte: Documentação detalhada sobre a origem, o escopo e as características de cada conjunto de dados.
• Dicionário de Variáveis Unificado: Arquivo dicionario_unificado.csv contendo a descrição padronizada de todas as variáveis utilizadas no projeto.
• Log de Integração: Histórico detalhado das operações de combinação, transformação e enriquecimento de dados.

Projetos de Análise e Resultados

A tabela a seguir detalha o status dos projetos de análise, indicando os concluídos (✅), os dados utilizados, os resultados gerados e as análises futuras planejadas (⬜).

Fontes de Dados Utilizadas

Esta seção detalha os arquivos de dados brutos utilizados, incluindo uma breve descrição do seu conteúdo principal.

Inventário de Pesquisas Relevantes em Segurança Pública

Tabela 1: Projetos e Pesquisas Geradoras de Dados

Esta tabela lista os principais projetos e pesquisas que resultaram na coleta de dados sobre vitimização e percepção de segurança no Brasil.

Tabela 2: Catálogo Detalhado de Pesquisas de Vitimização (Características Técnicas)

Esta tabela apresenta um panorama de diversas pesquisas de vitimização realizadas no Brasil, com detalhes sobre sua metodologia, abrangência e escopo temporal. Nota: Algumas informações podem estar incompletas.