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
`galoa-proceedings--sbsr-2023--156515.pdf`	Artigo de referencia
`Referencias.bib`	Referencias gerais
`Referencias_SVM.bib`	Referencias especificas do trabalho SVM

Como funciona

O fluxo atual do projeto e:

Manter os dados brutos RGB apenas localmente.
Extrair atributos das imagens RGB e/ou por transferencia de aprendizado.
Treinar e avaliar modelos SVM.
Registrar resultados em outputs/.
Gerar tabelas, figuras e relatorios em Quarto/HTML.
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

Os dados brutos RGB nao estao no repositorio remoto.
A reproducao completa depende da disponibilidade local da pasta RGB/.
Algumas saidas HTML carregam pastas auxiliares geradas pelo Quarto.
O repositorio ainda nao possui scripts organizados em uma pasta propria de software ou processamento.
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

3.7 KiB Raw Blame History