%-----------------------README-----------------------------------%
README for Rugosity Program.
-----------------------------------------------------------------
Este arquivo contém informações básicas de como 
executar e testar o programa de cálculo de rugosidade para imagens de AFM.


Princípios desse programa
-----------------------------------------------------------------

Este programa em Matlab calcula a Rugosidade de uma figura 
através da técnica de  Box-Counting e a inclinação log/log entre a 
rugosidade e o tamanho da caixa. 

INSTRUÇÕES
-----------------------------------------------------------------

Este programa executa com o programa Matlab.
Os usuários do Matlab devem ter instalado o Toolbox de 
processamento de imagem.

Para executar a parte gráfica do programa é necessária a instalação 
do componente SGRID presente no endereço: http://adfsoft.hypermart.net/sgrid/
e registrar o arquivo: sgrid.ocx com o comando:  regsvr32 sgrid.ocx 
              

Utilize imagens no padrão ASCII que são exportadas do programa 
TOPOMETRIX SPMLab com extensão ".TXT", ou imagens ".bmp" .

Para iniciar o programa de cálculo de rugosidade 
digite na tela de comando do matlab o seguinte: main 

Para executar o programa de cálculo de rugosidade 
sem a interface gráfica digite na tela de comando do matlab o seguinte: 
    imagem  = LerDoc('nome da imagem.txt');
    grafico = CalculaRugosidade(imagem);
    figure;MostraGrafico(grafico,1);
   


LiSTA DE ARQUIVOS PERTENCENTES AO PROGRAMA:
-----------------------------------------------------------------
main.fig      - interface gráfica.
main.m        - contém código para a interface gráfica.
CalculaRugosidade.m - recebe uma estrutura com informações sobre a
                      imagem e calcula a rugosidade e inclinação 
                      log/log a dimensão fractal.
MostraGrafico.m - plota os gráficos de várias imagens em um único quadro.
LerDoc .m       -lê uma imagem do padrão ASCII com extensão .txt
Fitting.m     - ajusta 2 retas aos pontos do gráfico




ARQUIVO DE ENTRADA
-----------------------------------------------------------------

Os arquivos de entrada desse programa são imagens '.txt' ou '.bmp'



PARAMETROS DE SAÍDA
------------------------------------------------------------------
       imagem- imagem original
       inclinação - inclinação da reta log-log da rugosidade x tamanho da caixa (box)
       variancia  - vetor com o log  da rugosidade para cada interação
       dimensao fractal de cada imagens
       tamanhocaixa  - vetor com o log  do tamanho da caixa(box) para cada interação
       inclinação total do conjunto de imagens
       dimensao fractal total do conjunto de imagens
      
-----------------------------------------------------------------


Mais detalhes podem ser encontrados no endereco :
http://www.cbpf.br/cat/lpdsi

AUTORES
------------------------------------------------------------------
Marcelo Portes de Albuquerque
Contact: marcelo_at_cbpf.br

Maysa Malfiza Garcia de Macedo
Contact: maysagm_at_cbpf.br
         maysa4_at_bol.com.br

Dario Oliveira
Contact: dario_at_cbpf.br

Marcio Portes de Albuquerque
Contact: albuquer_at_cbpf.br

Luiz Carlos Lima
Contact: luizlima_at_metalmat.ufrj.br






