From 171133da6e24047165add543b096a1532095d144 Mon Sep 17 00:00:00 2001
From: Thomas Fillon <thomas@parisson.com>
Date: Fri, 15 Nov 2013 21:11:00 +0100
Subject: [PATCH] Doc : Add documentation for analyzer preprocessor decorators

---
 doc/source/api/analyzer/index.rst         |  1 +
 doc/source/api/analyzer/preprocessors.rst | 18 ++++++++++++++++++
 timeside/analyzer/preprocessors.py        |  8 +++++++-
 3 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 doc/source/api/analyzer/preprocessors.rst

diff --git a/doc/source/api/analyzer/index.rst b/doc/source/api/analyzer/index.rst
index d21dd91..5b4575f 100644
--- a/doc/source/api/analyzer/index.rst
+++ b/doc/source/api/analyzer/index.rst
@@ -7,6 +7,7 @@ Analyzer package
 
    Analyzer Core module <core>
    Analyzers processors <analyzers>
+   Analyzer preprocessors <preprocessors>
     
 
 	      
diff --git a/doc/source/api/analyzer/preprocessors.rst b/doc/source/api/analyzer/preprocessors.rst
new file mode 100644
index 0000000..958dab1
--- /dev/null
+++ b/doc/source/api/analyzer/preprocessors.rst
@@ -0,0 +1,18 @@
+===============
+ Preprocessors
+===============
+
+.. toctree::
+
+.. automodule:: timeside.analyzer.preprocessors
+   
+
+downmix_to_mono
+===============
+ .. autofunction:: timeside.analyzer.preprocessors.downmix_to_mono
+
+
+
+frames_adapter
+==============
+ .. autofunction:: timeside.analyzer.preprocessors.frames_adapter
diff --git a/timeside/analyzer/preprocessors.py b/timeside/analyzer/preprocessors.py
index d1dd8b3..bf9fda2 100644
--- a/timeside/analyzer/preprocessors.py
+++ b/timeside/analyzer/preprocessors.py
@@ -34,6 +34,7 @@ def downmix_to_mono(process_func):
 
     Downmix is achieved by averaging all channels
 
+    >>> from timeside.analyzer.preprocessors import downmix_to_mono
     >>> @downmix_to_mono
     ... def process(analyzer,frames,eod):
     ...     print 'Frames, eod inside process :'
@@ -48,6 +49,7 @@ def downmix_to_mono(process_func):
     [ 1.5  3.5  5.5  7.5  9.5] False
 
     Outside Process frames and eod are preserved :
+
     >>> frames_
     array([[ 1,  2],
            [ 3,  4],
@@ -79,6 +81,7 @@ def frames_adapter(process_func):
     Pre-processing decorator that adapt frames to match input_blocksize and
     input_stepsize of the decorated analyzer
 
+    >>> from timeside.analyzer.preprocessors import frames_adapter
     >>> @frames_adapter
     ... def process(analyzer,frames,eod):
     ...     analyzer.frames.append(frames)
@@ -97,16 +100,19 @@ def frames_adapter(process_func):
 
     Inside the process the frames have been adapted to match input_blocksize
     and input_stepsize
+
     >>> analyzer.frames
     [array([0, 1, 2, 3]), array([3, 4, 5, 6]), array([6, 7, 8, 9])]
 
-    Outside the process, the original frames and eod are preserved :
+    Outside the process, the original frames and eod are preserved:
+
     >>> frames_
     array([ 0,  1,  2,  3,  4,  5,  6,  7,  8,  9, 10, 11])
     >>> eod_
     False
 
     Releasing the process with eod=True will zeropad the last frame if necessary
+
     >>> frames = np.asarray(range(12,14))
     >>> eod = True
     >>> frames_, eod_ = process(analyzer,frames,eod)
-- 
2.39.5