Files
Cesa-V 6fd2918464 Renomeia PDF da referencia GALOA com nome descritivo
galoa-proceedings--sbsr-2023--156515.pdf -> lacerda-et-al_2023_classificacao-rgb-termal-arp.pdf

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-17 11:37:02 -03:00

90 lines
3.8 KiB
Markdown

# Documentacao Tecnica - Sensoriamento RGB SVM
## O que e
Este repositorio organiza o trabalho de classificacao de imagens RGB de sensoriamento remoto com SVM, usando atributos extraidos diretamente das imagens e atributos derivados por transferencia de aprendizado.
O objetivo e manter em um unico lugar os arquivos de analise, resultados, apresentacoes, referencias e textos academicos produzidos durante o desenvolvimento do trabalho CEAO 2026.
Nesta fase, o projeto contem:
* arquivos Quarto com o trabalho principal e versao completa;
* artigo em LaTeX sobre classificacao RGB com SVM;
* apresentacoes em HTML, PDF e PPTX;
* resultados em CSV e RDS;
* imagens extraidas de PDFs e figuras geradas;
* referencias bibliograficas em BibTeX;
* dados brutos RGB mantidos fora do Git por tamanho.
## Fontes de dados
A principal fonte de dados e a base RGB local, armazenada em `RGB/` e compactada em `RGB.zip`. Esses itens estao no `.gitignore` e nao devem ser enviados ao Gitea.
Arquivos de apoio e referencia atualmente versionados incluem:
| Arquivo | Conteudo |
| --- | --- |
| `datasets_2026.pdf` | Material de apoio sobre datasets |
| `lacerda-et-al_2023_classificacao-rgb-termal-arp.pdf` | Lacerda et al. (2023) — Classificacao de imagens RGB e termal obtidas por ARPs (SBSR 2023) |
| `Referencias.bib` | Referencias gerais |
| `Referencias_SVM.bib` | Referencias especificas do trabalho SVM |
## Como funciona
O fluxo atual do projeto e:
1. Manter os dados brutos RGB apenas localmente.
2. Extrair atributos das imagens RGB e/ou por transferencia de aprendizado.
3. Treinar e avaliar modelos SVM.
4. Registrar resultados em `outputs/`.
5. Gerar tabelas, figuras e relatorios em Quarto/HTML.
6. Consolidar a discussao no artigo e nas apresentacoes.
## Artefatos principais
| Caminho | Funcao |
| --- | --- |
| `trabalho_svm_rgb.qmd` | Trabalho principal em Quarto |
| `trabalho_svm_rgb.html` | Saida HTML do trabalho principal |
| `trabalho_svm_rgb_completo.qmd` | Trabalho completo em Quarto |
| `trabalho_svm_rgb_completo.html` | Saida HTML da versao completa |
| `artigo_svm_rgb.tex` | Artigo em LaTeX |
| `apresentacao_svm_rgb.qmd` | Fonte da apresentacao |
| `outputs/` | Resultados, modelos e artefatos derivados |
## Resultados
Os resultados estao separados entre execucoes parciais, completas e arquivos consolidados:
* `outputs/parcial/`: resultados e modelos de uma execucao parcial.
* `outputs/completo/`: resultados e modelos da execucao completa.
* `outputs/pdf_images/`: imagens extraidas ou usadas no material.
* `outputs/resultados_modelos_rgb.csv`: resultados consolidados dos modelos RGB.
* `outputs/resultados_kfold_rgb.csv`: resultados de validacao k-fold.
## Convencoes
* Dados brutos volumosos devem ficar fora do Git.
* Resultados derivados podem ser versionados quando forem necessarios para reproducao do trabalho.
* Arquivos fonte de texto (`.qmd`, `.tex`, `.bib`) devem ser priorizados sobre artefatos gerados.
* Mudancas relevantes devem ser registradas em `docs/changelog.md`.
## Limitacoes conhecidas
1. Os dados brutos RGB nao estao no repositorio remoto.
2. A reproducao completa depende da disponibilidade local da pasta `RGB/`.
3. Algumas saidas HTML carregam pastas auxiliares geradas pelo Quarto.
4. O repositorio ainda nao possui scripts organizados em uma pasta propria de software ou processamento.
5. A organizacao fisica dos arquivos na raiz ainda pode ser melhorada em uma etapa posterior.
## Oportunidades de melhoria
| Prioridade | Melhoria |
| --- | --- |
| Alta | Separar arquivos em `data/`, `docs/`, `reports/`, `presentations/` e `references/` |
| Alta | Criar uma pasta `scripts/` ou `software/` para processamento reprodutivel |
| Media | Documentar comandos para regenerar os arquivos em `outputs/` |
| Media | Criar um manifesto dos dados brutos esperados |
| Baixa | Adicionar exemplos pequenos de entrada para teste |