Estrada Real: grafo curado, desambiguação de homônimos e scripts da varredura

DOI deste depósito: 10.5281/zenodo.20867698 Explorador interativo sobre o mesmo grafo curado: https://buscaestradareal.netlify.app/ Resumo Este conjunto de dados reúne os artefatos que sustentam os resultados do artigo: o grafo dirigido ponderado curado da Estrada Real (108 nós, 226 arestas dirigidas, 6 rotas), a tabela de desambiguação de homônimos, os scripts do pipeline (curadoria → busca → varredura) e as saídas da varredura exaustiva (108 × 107 = 11.556 pares dirigidos por agente; 34.668 execuções por algoritmo). Permite verificação independente das três decisões de modelagem avaliadas no artigo e da subotimalidade da Busca Gulosa (3.715 pares divergentes, ≈ 10,7%). Conteúdo Estrada_real_final.ipynb Pipeline completo (Python 3.11 / NetworkX 3.x): carga das fontes, fusão, desambiguação de homônimos, grafo + funções de custo por agente, heurística por Dijkstra reverso, UCS / Gulosa / A*, e varredura exaustiva. grafo/ estrada_real_graph_unified.json Grafo curado unificado (nós, arestas dirigidas, route_origins, status, elevation_status, etc.). desambiguacao_homonimos.csv Resolução de homônimos por contexto de rota (caso Pequeri → dois nós distintos). varredura/ gulosa_diverge_otimo.csv Custo Gulosa vs. ótimo, por par e agente. gulosa_divergencias_varredura_notebook.csv Pares em que a Gulosa diverge do ótimo. mapeamento_razao_por_agente.csv Resumo da subotimalidade por agente (Tabela 4 do artigo). mapeamento_par_rotas.csv Divergências por par de rotas. mapeamento_top_origens.csv Origens mais associadas à divergência. mapeamento_sensibilidade_agente.csv Sensibilidade por agente. fontes/ Traços geográficos de origem usados na reconstrução: caminho_caminho_velho_mapa.gpx caminho_caminho_novo_mapa.kml caminho_caminho_dos_diamantes_mapa.kml caminho_caminho_do_sabarabucu_mapa.kml novo_caminho_da_piedade_graph.json Reprodução Abrir Estrada_real_final.ipynb em Jupyter ou Google Colab (a primeira célula instala as dependências; preferencialmente Python 3.11, NetworkX 3.x). Executar as células na ordem. O notebook regenera grafo/estrada_real_graph_unified.json e as tabelas da varredura/. Para apenas inspecionar resultados sem reexecutar, usar os arquivos já incluídos nas pastas grafo/ e varredura/. Notas de proveniência Desambiguação de homônimos: o nome normalizado, isoladamente, identifica entidades incorretamente. "Pequeri" existe no Caminho Velho (Congonhas/Alto Maranhão) e na Zona da Mata, a mais de 200 km; o contexto de rota gera IDs distintos (n_pequeri_congonhas, n_pequeri_zm). A regra geral (chave canônica = rota + nome normalizado) e os overrides explícitos estão em NODE_ID_OVERRIDES no notebook. Novo Caminho da Piedade: é uma reconstrução do projeto, não uma das quatro rotas oficiais. O trecho até Bananal/SP vem de um traço GPX real da Rodovia dos Tropeiros (SP-068); o trecho de Bananal ao Rio de Janeiro foi reconstruído por nós históricos manuais, sem altimetria medida (campo elevation_status = manual_no_altimetry). O nó de São João Marcos aponta para as ruínas da cidade (inundada pela Usina Hidrelétrica de Lajes). Custos de elevação nesse corredor são, portanto, subestimados. Arestas sintéticas: transversais históricas (Caminho de Cima; Borda do Campo / Rio das Mortes) e a travessia marítima da Baía de Guanabara entram como arestas com status = synthetic (sem GPX), testando conectividade documentada, não traçado real. Fontes originais Instituto Estrada Real; Descaminhos do Ouro (Cicloturismo); IBGE (coordenadas de sedes municipais); e dados do Novo Caminho da Piedade reconstruídos pelo autor. Ver as referências do artigo. Licença Sugestão: dados sob CC BY 4.0 e código (notebook) sob MIT.