Apêndice B — Reprodutibilidade e organização dos arquivos

B.1 Estrutura

Pasta Função
01_dados/ dados brutos, metadados e bases intermediárias
02_R/ rotinas estatísticas e de operação
03_HECRAS/ projetos e insumos do HEC-RAS 1D
04_HECHMS/ preparação hidrológica
05_FloodAdapt/ ferramentas complementares, quando aplicáveis
06_resultados/ tabelas, figuras, notas e arquivos geoespaciais
07_python/ scripts numerados da análise
docs/ site HTML gerado pelo Quarto

B.2 Pipeline mínimo

  1. conferir os insumos e seus metadados;
  2. executar os scripts na ordem numérica relevante;
  3. verificar os CSVs e as figuras em 06_resultados/;
  4. renderizar o livro com quarto render;
  5. revisar o HTML, as imagens, links de download e referências;
  6. registrar o commit e a versão dos dados.

B.3 Cartografia para comunicação

O script 07_python/49_cartografia_publica.py gera as figuras cartográficas usadas no relatório e a planta regional das alternativas destinadas à triagem no HEC-RAS 1D. As figuras estáticas usam a malha municipal, rodovias e a hidrografia BHO/ANA disponíveis no acervo local; incluem norte, escala e rótulos para facilitar a leitura. O mesmo script gera o mapa Leaflet em 06_resultados/GIS/mapa_interativo_alternativas.html, que acrescenta a base de ruas do OpenStreetMap e permite ativar ou desativar municípios, cidades, rios, rodovias, eixos existentes e pontos exploratórios.

Os pontos de cidade nas figuras são pontos representativos dos polígonos municipais, usados para rotulagem cartográfica. Eles não substituem a localização oficial de sedes urbanas. A base OSM é uma camada de referência visual e requer conexão para carregar os tiles; não participa dos cálculos de HAND, hidrologia ou HEC-RAS.

B.4 Arquivos de auditoria

O site é uma camada de apresentação; os dados e scripts permanecem no repositório para que as tabelas e conclusões possam ser conferidas.