Metodologia e ambiente¶
A maioria dos encontros tem de 20 a 35 min de exposição e de 45 a 65 min de prática guiada num notebook, que o aluno termina em casa. Três encontros têm formato próprio: o 8 (leitura dirigida de dois estudos de cenários), o 13 (demonstração de validação e oficina de projeto) e os seminários (14 e 15). A progressão segue a dos cursos de modelagem do INPE com o TerraME: modelos pequenos e didáticos primeiro, depois dados reais e LUCC.
- Material-texto: capítulos do livro Geospatial Modeling with Python (Volume I para Python e ferramentas, Volume II para o ecossistema DisSModel), as notas de aula dos encontros 1, 4 e 8 e os notebooks da disciplina, neste repositório. A página Encontros indica a leitura de apoio de cada encontro.
- Pacotes por papel:
dissmodel-caedissmodel-sysdyncomo coleções de modelos prontos para estudar e modificar;dissmodel-abmcomo extensão de agentes, só apresentada;disscubepara os dados;dissluccpara o LUCC. - Referência: o TerraME e o LuccME não são instalados nas máquinas. As saídas deles estão publicadas, com hash e DOI, nos repositórios
terrame-goldenseluccme-goldens, gerados na imagemterrame-docker; os notebooks comparam com essas saídas. NetLogo e Dinamica EGO aparecem no encontro 1, sem prática além do NetLogo Web. - Dados: casos pequenos que rodam em segundos (labs do LuccME, exemplos do TerraME, recortes do
disscube-benchmark); os casos em escala de estado ou país aparecem como resultado já registrado, não executados em aula.
Como os notebooks são escritos¶
Como o público não programa, os notebooks de modelagem vêm com o código pronto para ler, rodar e alterar parâmetros. As marcas nas células:
- 🔧 troque um número e rode de novo;
- ✏️ responda à pergunta.
Escrever código do zero fica para o projeto, com apoio.
Ambiente¶
Python 3.11 ou mais recente. As versões ficam fixadas durante todo o semestre:
python -m venv .venv
source .venv/bin/activate # no Windows: .venv\Scripts\activate
pip install -r requirements-notebooks.txt
jupyter lab
| Pacote | Versão | Origem | A partir do encontro |
|---|---|---|---|
| dissmodel | 0.6.6 | PyPI | 4 |
| dissmodel-ca | 0.2.0 | GitHub, tag v0.2.0 |
4 |
| dissmodel-sysdyn | 0.2.0 | GitHub, tag v0.2.0 |
5 |
| dissmodel-abm | 0.2.0 | GitHub, tag v0.2.0 (ainda não está no PyPI) |
7 |
| disslucc | 0.5.0 | PyPI | 9 |
| disscube | 0.6.0 | PyPI | 10 |
| statsmodels | 0.15.0 | PyPI | 11 |
QGIS (opcional). Quem preferir montar e rodar as grades do DisSCube no mapa, em vez do terminal, pode usar o plugin DisSCube para QGIS (versão 0.1.5, DOI 10.5281/zenodo.24033974; QGIS 3.34 ou mais novo), apresentado no encontro 10. O plugin grava o mesmo arquivo TOML e abre o resultado direto no mapa; para rodar, ele usa um DisSCube instalado num Python à parte.
Demos no navegador. Os modelos dos pacotes dissmodel-sysdyn, dissmodel-ca e dissmodel-abm também rodam em demos interativos, sem instalação, usados nos encontros 5 a 7 para visualizar: dinâmica de sistemas, autômatos celulares e agentes. Servem para ver e experimentar; o registro da execução (encontro 4) fica nos notebooks.
Os notebooks dos encontros 2 a 7 e 9 a 13 têm um selo Abrir no Colab no topo, que abre o notebook no Google Colab direto do GitHub; os dos encontros 3 a 7 e 9 a 13 instalam sozinhos o que falta no Colab (rasterio; DisSModel, dissmodel-ca, dissmodel-sysdyn, dissmodel-abm, disslucc, disscube e statsmodels).
Dados e referências lidos pela internet¶
Os notebooks baixam os dados de versões fixas e conferem o hash de cada arquivo (encontro 4). Todos precisam de acesso a raw.githubusercontent.com:
| Encontros | O que é baixado | Versão |
|---|---|---|
| 3 | focos de queimada e estados do IBGE (repositórios dos livros, por commit); MapBiomas da Ilha do Maranhão (Google Cloud Storage) | commits fixos; Coleção 11 |
| 5, 6, 7 | saídas de referência do TerraME | terrame-goldens v0.1.0 |
| 9, 11, 12, 13 | espaços celulares e saídas de referência do LuccME | luccme-goldens v1.1.0 |
| 10 | camadas do exemplo Amazônia do TerraME; arquivo TOML; espaço celular do TerraME | TerraME no commit 84faddc; disscube-benchmark v1.1.0; luccme-goldens v1.1.0 |
O "para casa" do encontro 10 lê o MapBiomas pelo Google Cloud Storage, como a Parte 4 do encontro 3. Se a leitura falhar na sua rede, use o cubo Amazônia do encontro 10 ou um caso pronto do disscube-grids (BR-163 ou Ilha do Maranhão).