From 6266d8afbe71d52f264c1b40ab77bfe2495ef4ed Mon Sep 17 00:00:00 2001
From: Leonardo Robol <leo@robol.it>
Date: Mon, 22 Mar 2010 18:38:31 +0100
Subject: [PATCH] Aggiunto README e migliorato makefile.

---
 Filtering/Makefile |  3 ++-
 Filtering/README   | 41 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 43 insertions(+), 1 deletion(-)
 create mode 100644 Filtering/README

diff --git a/Filtering/Makefile b/Filtering/Makefile
index fa1a0cc..61fe2dd 100644
--- a/Filtering/Makefile
+++ b/Filtering/Makefile
@@ -1,6 +1,7 @@
 F2PY=f2py
 MODULE_NAME=fast_filters
 SOURCE_FILES=fast_filters.f90
+OBJ_FILES=*.so *.pyc
 
 all: fast_filters.so
 
@@ -8,4 +9,4 @@ fast_filters.so:
 	$(F2PY) -c -m $(MODULE_NAME) $(SOURCE_FILES)
 
 clean:
-	rm -f fast_filters.so
+	rm -f $(OBJ_FILES)
diff --git a/Filtering/README b/Filtering/README
new file mode 100644
index 0000000..df8a6eb
--- /dev/null
+++ b/Filtering/README
@@ -0,0 +1,41 @@
+DWT 0.0.1 -- Leonardo Robol <robol@poisson.phc.unipi.it>
+
+ == Cos'è ==
+
+ DWT è un piccolo script python che permette di effettuare
+ la decomposizione wavelet di un file audio RAW. 
+ Si basa su un paio di routine in fortran che sono ottimizzate
+ per i filtraggi necessari, e sulle librerie numpy (le quali
+ fanno il resto del lavoro che è abbastanza generico). 
+
+ == How to ==
+
+ make
+ 
+ # Mostrare la decomposizione di un file RAW
+ ./dwt.py --show file.raw
+
+ # Decomporre e ricostruire un file.raw, per poi
+ # controllare di averlo effettivamente fatto. 
+ # Qui usiamo la filterbank D4
+ ./dwt.py --rebuild --filterbank d4 --write rebuilt.raw file.raw
+ ./shell.sh check rebuilt.raw file.raw
+
+ # Convertire un file audio qualsiasi in formato RAW
+ # Questa operazione richiede ffmpeg e sox installati
+ # e nel PATH
+ ./shell.sh convert fileaudio.mp3 file.raw
+ 
+ # Ascoltare un file RAW
+ ./shell.sh file.raw
+
+ # Altro help
+ ./dwt.py --help
+
+ == Note sul formato ==
+
+ Il formato audio che immagino è PCM RAW signed a 16bit (mono).
+ In realtà, dal punto di vista pratico, la decomposizione fornirà
+ un approssimazione di qualsiasi file binario. Nella maggior parte
+ delle prove restituirà esattamente lo stesso file, ma non c'è
+ nessuna garanzia che lo faccia. 
\ No newline at end of file
-- 
2.1.4