SurveyAnchor

❓ Por que isso é necessário

Em campanhas marítimas, os arquivos chegam misturados e muitas vezes sem documentação clara de coluna, sistema de coordenadas ou área. Sem ancorar os dados ao mapa, a equipe não responde com segurança: onde exatamente foi este levantamento? e o que mais existe nesta pasta?

Conferir a área no Google Earth / GIS antes de processar no software pesado
Inventariar formatos e presença de coordenadas em acervos heterogêneos
Entregar KML/SHP, catálogo e pastas organizadas a partir do mesmo fluxo

🎯 O que ela resolve

📦 A situação comum

Acervos batimétricos chegam misturados (Excel, TXT, LOG, NMEA, BAG…) sem documentação clara de coluna, CRS ou área. A pergunta básica fica: onde exatamente aconteceu este levantamento — e o que mais há nesta pasta?

✨ Com o SurveyAnchor

Identifica formato e coordenadas, limpa outliers, entrega posição no mapa (KML/SHP), inventaria o acervo (catálogo) e pode reorganizar pastas — tudo no mesmo produto.

🧰 Comandos principais (CLI)

🎯 surveyanchor export-kml KML enxuto Abre seletor de pasta e gera *.kml com pontos amostrados e profundidade — ideal para confirmar a área no Google Earth.
📐 surveyanchor export-shp-contours Contornos + linhas Shapefiles CA_*.shp (área) e L_*.shp (navegação).
〰️ surveyanchor export-shp-lines Só linhas Exporta apenas linhas de navegação (LineString).
📋 surveyanchor catalog -i PASTA Catálogo Inventaria o acervo: inventário tabular (CSV / JSON / SQLite) dos arquivos reconhecidos na pasta.
📁 surveyanchor organize -i PASTA Organizar acervo Dry-run por padrão; com --execute reorganiza cópias por ano.

👁️ Como fica na prática

Depois do export-kml, você abre o arquivo no Google Earth e confere a área do levantamento com profundidades amostradas.

Ilustração de pontos batimétricos geolocalizados e resumo do KML gerado pelo SurveyAnchor

🗺️ Ilustração esquemática — o KML real depende dos seus arquivos de campo.

📂 Formatos (resumo)

Texto tabular, NMEA, Excel multi-aba, grades BAG, nuvens LAS, rasters GeoTIFF e parsers leves de multibeam (GSF, XTF, KMALL), entre outros — em calibração contínua.

📊 Planilhas e TXT/XYZ/CSV com coordenadas + profundidade
📡 Logs NMEA / ecosonda
🗺️ BAG, GeoTIFF, LAS e formatos de campo adicionais

▶️ Como começar

cd surveyanchor
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .

surveyanchor export-kml -r
surveyanchor catalog -i "./levantamentos" -o "./saida/catalogo" -r

Referência completa de flags: docs/12-comandos-cli.md no repositório.

📚 Documentação online (GitHub Pages)

O site MkDocs do produto ainda não está no ar Em breve. URL prevista: https://andressalf.github.io/SurveyAnchor/ (landing EN: …/en/).

📚 Manual técnico (em breve) ▶️ Como começar nesta página

Enquanto isso, use esta página e docs/12-comandos-cli.md no repositório.

👥 Para quem é

⚙️ Processamento / operação — localizar onde cada arquivo “cai” no mapa e inventariar o acervo
✅ QA e entrega — conferir extensão espacial sem GIS pesado; catálogo + KML
🔬 Pesquisa — acervos heterogêneos (planilha, log, BAG, raster…)