Uma plataforma modular e escalável em Python projetada para automatizar todo o pipeline de fotogrametria. O sistema permite transformar arquivos de vídeo e conjuntos de imagens em nuvens de pontos e malhas tridimensionais (3D), oferecendo tanto uma Interface Gráfica (GUI em Flet) quanto uma Interface de Linha de Comando (CLI).
O software é estruturado em 5 módulos centrais de processamento:
- 📷 Aquisição (
src/acquisition/): Extração e amostragem configurável de frames a partir de arquivos de vídeo. - 🎯 Calibração (
src/camera_calibration/): Estimativa e cálculo dos parâmetros intrínsecos e estéreo para correção de distorção de lentes. - 🔄 Pós-Processamento (
src/post_processing/): Pré-processamento de imagens em lote (redimensionamento e realce de contraste via CLAHE) para otimizar os dados de entrada. - 🏗️ Reconstrução 3D (
src/reconstruction/): Pipeline base do motor de reconstrução (COLMAP) suportando abordagens Monoculares e Estéreo. - 👁️ Visualização 3D (
src/visualization/): Inspeção interativa e renderização de nuvens de pontos e malhas 3D (formatos.ply,.obj).
├── cli/ # Interface de Linha de Comando (Ações e Menus)
├── resources/ # Arquivos de configuração (.ini) do motor COLMAP
├── src/ # Motores de algoritmo e lógica de negócio
│ ├── acquisition/
│ ├── camera_calibration/
│ ├── post_processing/
│ ├── reconstruction/
│ └── visualization/
├── ui/ # Interface Gráfica (Flet Framework)
│ ├── controllers/ # Controladores e ponte de eventos
│ ├── pages/ # Views e telas da aplicação
│ ├── app_layout.py # Shell base de navegação
│ └── router.py # Mapeamento de rotas e hubs
├── config.yaml # Parâmetros globais de execução
├── main.py # Ponto de entrada (GUI ou CLI)
└── requirements.txt # Dependências Python
O projeto depende dos seguintes componentes e bibliotecas chave:
- Motor Base:
colmap=3.12.6(via Conda) - Visão Computacional & 3D:
opencv-contrib-python,open3d,pyvista,numpy,tqdm - Interface Gráfica:
flet==0.21.2(versão fixa necessária para compatibilidade dos componentes de UI) - Backend & Configurações:
PyYAML
Recomenda-se o uso do Conda para gerenciamento de dependências nativas e suporte completo à aceleração via hardware (GPU/CUDA).
No terminal, dentro da pasta raiz do projeto, execute:
# Criação do ambiente isolado Python 3.12
conda create -n condaVenv python=3.12 -y
# Ativação do ambiente (Obrigatório)
conda activate condaVenvInstale o COLMAP via conda-forge:
conda install -c conda-forge colmap=3.12.6 -yCom o ambiente condaVenv ativo, instale as bibliotecas contidas no requirements.txt:
pip install -r requirements.txtA execução é centralizada no script main.py.
Para rodar a aplicação desktop interativa:
python main.pyPara executar via terminal (ideal para servidores ou ambientes headless):
python main.py --cli- Parâmetros: Arquivos de inicialização do COLMAP estão disponíveis em
resources. - Resultados e Logs: Os modelos exportados e relatórios de progresso são salvos em
data/out/reconstructions/(ou no diretório definido pelo usuário durante a execução). EOF