Repositório contendo as análises pontuais desenvolvidas pela Impulso Gov.
- Contexto
- Estrutura do repositório
- Instruções para instalação
- Executando as análises
- Contribua
- Licença
Um dos propósitos da Impulso Gov, enquanto organização, é transformar dados da saúde pública do Brasil em informações que ofereçam oferecer suporte de decisão aos gestores de saúde pública em todo o Brasil.
No decorrer desse trabalho, nossas analistas e engenheiras produzem diversas análises para explorar novas possibilidades de produtos e soluções, orientar nosso planejamento estratégico etc.
Este repositório reúne diversas dessas análises construídas em Python que não estão associadas a um produto da Impulso Gov em particular, e que utilizam apenas dados públicos.
Cada diretório dentro deste repositório contém um conjunto de análises agrupadas pelo ano de criação e o tema. Cada uma dessas pastas contém subdiretórios ou notebooks contendo análises criadas com um propósito específico dentro daquele tema:
analises-publicas-saude
├─ 2020_AnalisesCoronacidades \\ Relacionadas à resposta à Covid-19
│ ├─ 2020-06-02_ondacovid_twitter \\ Evolução das mortes em municípios e estados brasileiros
│ ├─ 2020-06-09_rt_municipios_g1 \\ Ritmos de contágio por município
│ └─ 2021-03-11_vacinacao_municipios \\ Estimativas de indivíduos em grupos prioritários
└─ 2022_AnalisesAPS \\ Relacionadas à Atenção Primária à Saúde
├─ 20210615_Analise_Repasses_Financeiros_Componente_Desempenho.ipynb \\ Repasses do programa Previne Brasil
├─ 202205_Atividade_Coletiva_Reunioes_Territorios.ipynb \\ Reuniões e atividades de monitoramento territorial
└─ 20220706_AT_Analise_Desempenho_APS_Perfil_Municipios.ipynb \\ Relação entre desempenho e características do município
As pastas de primeiro nível estão identificadas com o padrão <ano>_<TemaDasAnalises>.
Além das análises que já se encontram no repositório, outras podem ser acrescentadas com o tempo.
Como foram criadas separadamente, cada análise pode contar com dependências e formas de instalação distintas. Verifique no arquivo README.md de cada subdiretório se há instruções específicas para a análise em questão.
Para executar as análises, você precisará ter instalada uma edição recente do Python 3 (recomenda-se do 3.7 em diante) e do git.
Possivelmente você já tenha ambos instalados, mas, caso contrário, siga as instruções das páginas oficiais para fazer download e instalar ambos na sua máquina. Rode o comando a seguir em um terminal para checar se a instalação foi feita com sucesso: (os números das versões podem variar)
$ python3 --version
3.11.0
$ git --version
git version 2.38.1Em seguida, baixe o repositório com as análises para um diretório na sua máquina e abra-o no terminal:
$ cd /diretorio/onde/deseja/baixar
$ git clone https://github.com/ImpulsoGov/analises-publicas-saude.git
$ cd analises-publicas-saude(Você também pode - e deve - acessar o subdiretorio de uma análise específica; nesse caso, substitua o último comando acima por cd analises-publicas-saude/caminho/da/analise)
Como regra geral, recomenda-se instalar as dependências em um ambiente virtual do Python. Para isso, com o terminal no diretório da análise desejada, crie um novo ambiente e ative-o:
$ python3 -m venv .venv
$ source ./.venv/bin/activateSe a análise tiver as dependências listadas em um arquivo requirements.txt, você pode instalá-las de uma vez só com o comando a partir do diretório da análise:
(.venv)$ python3 -m pip install -r requirements.txtCaso contrário, recomenda-se instalar ao menos os pacotes notebook e pandas, que costumam ser utilizados em todas as análises: (este passo não é necessário caso já tenha instalado as dependências a partir do arquivo requirements.txt)
(.venv)$ python3 -m pip install notebook pandasPara abrir e executar as análises em um notebook interativo, abra um terminal no diretório com a análise e rode os seguintes comandos para ativar o ambiente virtual e inicializar o Jupyter:
$ source ./.venv/bin/activate
(.venv)$ jupyter notebook
... ...
[I 18:11:27.463 NotebookApp] Jupyter Notebook 6.5.2 is running at:
[I 18:11:27.463 NotebookApp] http://localhost:8888/?token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
[I 18:11:27.463 NotebookApp] or http://127.0.0.1:8888/?token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
[I 18:11:27.463 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).Siga um dos links impressos no terminal e aguarde até que uma nova aba seja aberta no seu navegador com o ambiente do Jupyter.
Navegue na estrutura de arquivos do diretório da análise por meio da interface do Jupyter e localize o notebook (arquivo com extensão .ipynb) que deseja explorar. Abra-o e utilize os comandos do Jupyter para executar a análise de maneira interativa - veja mais informações na documentação do usuário (em inglês).
Sinta-se à vontade para contribuir em nosso projeto! Abra uma issue ou crie um fork do projeto e envie sua contribuição como um novo pull request.
MIT (c) 2020, 2022 Impulso Gov <contato@impulsogov.org>