WaveSynt v.3.1.4 (unificada para PC/UNIX)
-------------------------------------------------------
Pacote para Anlise Wavelet em Multiresoluo (AWMR)
de sinais musicais (sinais unidimensionais)
-------------------------------------------------------

O WaveSynt  uma contribuicao em software do trabalho
de ps-graduaao em analise de gestos musicais
utilizando ferramentas wavelets, realizada pelo autor.

Consiste num pacote de rotinas MATLAB orientadas a
analise em multiresolucao de sinais unidimensionais
genricos, em especial sinais de adio.
A versao atual consta de 34 arquivos: 32 mdulos 
executaveis (rotinas MATLAB, arquivos com extensao
.m) e 2 arquivos sonoros (pronto.mat e acnddl1.mat).

Rotinas do Wavesynt chamam rotinas do WaveLab,
rotinas do prprio Wavesynt ou do MATLAB.
Para a realizacao da AWMR e/ou utilizacao dos
algoritmos wavelet requer-se que o pacote WaveLab 
de Stanford esteja instalado no computador.

O Wavelab pode ser "donwloaded" no site
http://www-stat.stanford.edu/~wavelab.

O WaveSynt, verso 3.0 ou superior, roda em 
plataformas Unix (Sun, SGI, DEC) e Windows (DOS) 
do MATLAB.
O WaveLab, entretanto, dispoe de versoes para
Unix e para PC (DOS, Windows ou Macintosh) 
separadamente.

------------------------------------------------------

A INSTALACAO do WaveSynt consiste basicamente em:

1. Criar um subdiretorio "wavesynt" sob o diretorio 
do WaveLab ou do MATLAB, 

2. Copiar todos as rotinas do WaveSynt para dentro 
deste novo subdiretorio, e 

3. Editar o arquivo "WavePath.m" do WaveLab tal que 
inclua o subdiretrio "wavesynt" no "path" do MATLAB 
no momento do disparo (quando se chama o MATLAB).


As instrucoes do WaveLab sobre como instala-lo no
computador servem de guia tambem para a instalacao
do WaveSynt.

------------------------------------------------------

GUIA BASICO:

O usurio deve entrar no MATLAB, e dispara o comando
"intrface" para iniciar a interface grafica do 
WaveSynt.

Para proceder ao carregamento de um sinal para 
analise, deve-se mover ao diretorio onde este
sinal esta', escrever o nome do arquivo no campo
alfanumerico da interface mestre (ao lado do botao 
de carregar), carregar e normalizar o sinal.

obs. Usualmente a normalizacao ocorre sobre 
     o vetor de entrada de nome "wavedata".
     Se o arquivo de entrada gerar um vetor
     com nome diferente, a normalizacao dever
     ser feita manualmente (normaliz.m).

O arquivo de entrada dever estar no formato MATLAB 
(com extensao .mat).

Procede-se entao  escolha da Wavelet, do nivel 
mais grosso da analise (usualmente o nivel 0)
e realiza-se a decomposicao (botao WMRA).

As seguintes wavelets estao disponiveis:

-Daubechies, de 2, 4, 6, ... 20
-Beylkin (numero nao  considerado)
-Coiflet, de 1 a 5
-Symmlets, de 4 a 10
-Vaidyanathan (numero nao  considerado)

Outras combinacoes nao esto disponiveis nesta
versao do WaveSynt nem do WaveLab.

O asterico seguindo o nome de alguns botes na
Interface mestre indica que apos a consecuo da
funo principal do boto o resultado ser 
guardado num arquivo (com extensao .mat) cujo
nome ser o texto que estiver escrito no campo
alfanumrico.

Para evitar que acidentes ocorram escrevendo o 
resultado de uma operacao sobre um arquivo de entrada,
o campo alfanumrico automaticamente atualiza-se
para um novo nome de arquivo (default: "teste.mat") 
apos o carregamento de um sinal (arquivo .mat em disco).
Se o campo estiver vazio, nada ser salvo em arquivo.

O usurio poder entao observar e ouvir cada nivel da 
analise (Plot Nivel e Som Nivel*),
 
poder plotar todos os coeficientes da analise (por
niveis) (Plot WCoef, Plot Coefic., Som Coefic.*),

poder ouvir o som original (Som Original),
poder criar um mapa de pesos para a reconstrucao,
reconstruir ou mixar os niveis, e ouvir os 
respectivos resultados (veja botoes na interface grafica).

Poder ainda gerar uma figura (GIF) com todas os 
niveis da analise, ou figuras com alguns niveis
especificos (que deve ser feito manualmente 
utilizando as rotinas gerafig, gerafig2 e gerafig3).

Analises espectrais (FFT) sobre os sinais (vetores)
podem ser feitas manualmente (utilizando as rotinas
wfft, wloglog, wslogx, wslogy, cwfft, pwfft, cwslogx,
cwslogy).

Para maiores informacoes sobre as rotinas, utilize
a ferramenta de "help" do MATLAB sobre a rotina que
desejar:

	> help rotina_tal

ou contate o autor nos telefones/email abaixos.
-------------------------------------------------------

Regis Rossi Alves Faria (1997, 1998, 2000, 2005)
email: wavelet@lsi.usp.br

http://www.lsi.usp.br/neac/projetos/
-------------------------------------------------------


