Skip to content
This repository has been archived by the owner on Aug 2, 2022. It is now read-only.

Commit

Permalink
Prepare release of v0.2.0
Browse files Browse the repository at this point in the history
  • Loading branch information
Carlos Carreiras committed Oct 1, 2015
1 parent d14f624 commit dae2571
Show file tree
Hide file tree
Showing 4 changed files with 66 additions and 35 deletions.
15 changes: 14 additions & 1 deletion CHANGES
Expand Up @@ -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
- Alpha release
2 changes: 1 addition & 1 deletion biosppy/version.py
Expand Up @@ -9,4 +9,4 @@
:license: BSD 3-clause, see LICENSE for more details.
"""

version = '0.1.2'
version = '0.2.0'
4 changes: 2 additions & 2 deletions docs/conf.py
Expand Up @@ -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.
Expand Down
80 changes: 49 additions & 31 deletions docs/tutorial.rst
Expand Up @@ -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 <http://bitalino.com/>`__
or `OpenBCI <http://openbci.com/>`__ 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 <https://opensource.com/life/15/4/five-diy-hardware-physiological-computing>`__.





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
========================
Expand Down Expand Up @@ -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
<http://docs.scipy.org/doc/numpy/reference/generated/numpy.histogram.html>`_
function returns first the edges or the values of the histogram? Maybe it's the
For instance, does the `numpy.histogram
<http://docs.scipy.org/doc/numpy/reference/generated/numpy.histogram.html>`__
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...

Expand Down Expand Up @@ -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 <https://docs.python.org/2/library/collections.html#collections.OrderedDict>`_:
specifically an `OrderedDict <https://docs.python.org/2/library/collections.html#collections.OrderedDict>`__:

.. code:: python
Expand All @@ -214,7 +234,7 @@ Dictionary-like unpacking is supported:
>>> some_function(**out)
`ReturnTuple` is heavily inspired by `namedtuple <https://docs.python.org/2/library/collections.html#collections.namedtuple>`_,
`ReturnTuple` is heavily inspired by `namedtuple <https://docs.python.org/2/library/collections.html#collections.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:
Expand Down Expand Up @@ -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 <https://github.com/PIA-Group/BioSPPy/tree/master/examples>`_). To load
`here <https://github.com/PIA-Group/BioSPPy/tree/master/examples>`__). To load
and plot the raw ECG signal follow:

.. code:: python
Expand Down Expand Up @@ -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.

0 comments on commit dae2571

Please sign in to comment.