Aggiunto README e migliorato makefile.

Leonardo Robol [2010-03-22 17:38]
Aggiunto README e migliorato makefile.
Filename
Filtering/Makefile
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
ViewGit