%-----------------------README-----------------------------------%
README for Rugosity Program.
-----------------------------------------------------------------
Este arquivo contm informaes bsicas de como 
executar e testar o programa de clculo de rugosidade para imagens de AFM.


Princpios desse programa
-----------------------------------------------------------------

Este programa em Matlab calcula a Rugosidade de uma figura 
atravs da tcnica de  Box-Counting e a inclinao log/log entre a 
rugosidade e o tamanho da caixa. 

INSTRUES
-----------------------------------------------------------------

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

Para executar a parte grfica do programa  necessria a instalao 
do componente SGRID presente no endereo: http://adfsoft.hypermart.net/sgrid/
e registrar o arquivo: sgrid.ocx com o comando:  regsvr32 sgrid.ocx 
              

Utilize imagens no padro ASCII que so exportadas do programa 
TOPOMETRIX SPMLab com extenso ".TXT", ou imagens ".bmp" .

Para iniciar o programa de clculo de rugosidade 
digite na tela de comando do matlab o seguinte: main 

Para executar o programa de clculo de rugosidade 
sem a interface grfica 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 grfica.
main.m        - contm cdigo para a interface grfica.
CalculaRugosidade.m - recebe uma estrutura com informaes sobre a
                      imagem e calcula a rugosidade e inclinao 
                      log/log a dimenso fractal.
MostraGrafico.m - plota os grficos de vrias imagens em um nico quadro.
LerDoc .m       -l uma imagem do padro ASCII com extenso .txt
Fitting.m     - ajusta 2 retas aos pontos do grfico




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

Os arquivos de entrada desse programa so imagens '.txt' ou '.bmp'



PARAMETROS DE SADA
------------------------------------------------------------------
       imagem- imagem original
       inclinao - inclinao da reta log-log da rugosidade x tamanho da caixa (box)
       variancia  - vetor com o log  da rugosidade para cada interao
       dimensao fractal de cada imagens
       tamanhocaixa  - vetor com o log  do tamanho da caixa(box) para cada interao
       inclinao 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






