From dae2571d8499cac834d7e6361b2545761a627ae5 Mon Sep 17 00:00:00 2001 From: Carlos Carreiras Date: Thu, 1 Oct 2015 17:01:15 +0100 Subject: [PATCH] Prepare release of v0.2.0 --- CHANGES | 15 ++++++++- biosppy/version.py | 2 +- docs/conf.py | 4 +-- docs/tutorial.rst | 80 ++++++++++++++++++++++++++++------------------ 4 files changed, 66 insertions(+), 35 deletions(-) diff --git a/CHANGES b/CHANGES index 7c1ebd2c..13cb7ef2 100644 --- a/CHANGES +++ b/CHANGES @@ -3,9 +3,22 @@ Here you can see the full list of changes between each BioSPPy release. +Version 0.2.0 +------------- + +Released on October 1st 2015 + +- Added the biometrics module, including k-NN and SVM classifiers +- Added outlier detection methods to the clustering module +- Added text-based data storage methods to the storage module +- Changed docstring style to napoleon-numpy +- Complete code style formatting +- Initial draft of the tutorial +- Bug fixes + Version 0.1.2 ------------- Released on August 29th 2015 -- Alpha release \ No newline at end of file +- Alpha release diff --git a/biosppy/version.py b/biosppy/version.py index ad6f6614..3153e434 100644 --- a/biosppy/version.py +++ b/biosppy/version.py @@ -9,4 +9,4 @@ :license: BSD 3-clause, see LICENSE for more details. """ -version = '0.1.2' +version = '0.2.0' diff --git a/docs/conf.py b/docs/conf.py index 13a0e7a5..af51a576 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -85,9 +85,9 @@ def __getattr__(cls, name): # built documents. # # The short X.Y version. -version = '0.1.2' +version = '0.2.0' # The full version, including alpha/beta/rc tags. -release = '0.1.2' +release = '0.2.0' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/docs/tutorial.rst b/docs/tutorial.rst index bd4a4ac8..975b3790 100644 --- a/docs/tutorial.rst +++ b/docs/tutorial.rst @@ -23,39 +23,59 @@ instance). Finally, for complex biological systems like the human being, biosignals also include blood and urine test measurements, core body temperature, motion tracking signals, and imaging techniques such as CAT and MRI scans. However, the term biosignal is most often applied to bioelectrical, -time-varying signals. The following sub-sections briefly describe the biosignals +time-varying signals, such as the electrocardiogram. + +The task of obtaining biosignals of good quality is time-consuming, +and typically requires the use of costly hardware. Access to these instruments +is, therefore, usually restricted to research institutes, medical centers, +and hospitals. However, recent projects like `BITalino `__ +or `OpenBCI `__ have lowered the entry barriers of biosignal +acquisition, fostering the Do-It-Yourself and Maker communities to develop +physiological computing applications. You can find a list of biosignal +platform `here `__. + + + + + +The following sub-sections briefly describe the biosignals covered by `biosppy`. +Blood Volume Pulse +------------------ + +Blood Volume Pulse (BVP) signals are... + +Electrocardiogram +----------------- +Electrocardiogrm (ECG) signals are... -The following biosignals form the focus of `biosppy`: +Electrodermal Activity +---------------------- -* Blood Volume Pulse (BVP); -* Electrocardiogram (ECG); -* Electrodermal Activity (EDA); -* Electroencephalogram (EEG); -* Electromyogram (EMG); -* Respiration (Resp). +Electrodermal Activity (EDA) signals are... -Bla. +Electroencephalogram +-------------------- -ECG ---- +Electroencephalogram (EEG) signals are... -Bla. +Electromyogram +-------------- -EMG ---- +Electromyogram (EMG) signals are... -Bla. +Respiration +----------- + +Respiration (Resp) signals are... -A very cool thing [ABCD88a]_. -Another cool thing [ABCD88b]_. What is Pattern Recognition? ============================ -Bla. +To do. A Note on Return Objects ======================== @@ -122,9 +142,9 @@ extract. In this case, the user typically already knows what a function does, but it is cumbersome to remember by heart the order of the outputs, without having to constantly check out the documentation. -For instance, the `numpy.histogram -`_ -function returns first the edges or the values of the histogram? Maybe it's the +For instance, does the `numpy.histogram +`__ +function first return the edges or the values of the histogram? Maybe it's the edges first, which correspond to the x axis. Oops, it's actually the other way around... @@ -200,7 +220,7 @@ And to list all the available keys: ['sum', 'sub', 'mult', 'div'] It is also possible to convert the object to a more traditional dictionary, -specifically an `OrderedDict `_: +specifically an `OrderedDict `__: .. code:: python @@ -214,7 +234,7 @@ Dictionary-like unpacking is supported: >>> some_function(**out) -`ReturnTuple` is heavily inspired by `namedtuple `_, +`ReturnTuple` is heavily inspired by `namedtuple `__, but without the dynamic class generation at object creation. It is a subclass of `tuple`, therefore it maintains compatibility with the native return pattern. It is still possible to unpack the variables in the usual way: @@ -255,7 +275,7 @@ typical methods to filter, transform, and extract signal features. Let's see how this works for the example of the ECG signal. The GitHub repository includes a few example signals (see -`here `_). To load +`here `__). To load and plot the raw ECG signal follow: .. code:: python @@ -306,26 +326,24 @@ It should produce a plot like the one below. Signal Processing ================= -Bla. +To do.. Clustering ========== -Bla. +To do.. Biometrics ========== -Bla. +To do.. What's Next? ============ -Bla. +To do.. References ========== -.. [ABCD88a] Reference - -.. [ABCD88b] Haha +To do.