# 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 |