Răsfoiți Sursa

Improved the README of the CMSIS-DSP Python wrapper.

More details about the installation procedure.
Christophe Favergeon 6 ani în urmă
părinte
comite
a9ef7e783f
1 a modificat fișierele cu 33 adăugiri și 5 ștergeri
  1. 33 5
      CMSIS/DSP/PythonWrapper/README.md

+ 33 - 5
CMSIS/DSP/PythonWrapper/README.md

@@ -8,15 +8,35 @@ But even with those limitations, it can be very useful to test a CMSIS-DSP imple
 
 # How to build and install
 
+## Tested configurations
+
+The building of this package has been tested on Windows with the Python install from python.org and Microsoft Visual 2017. 
+
+It has also been tested with cygwin. In that case, python-devel must be installed too. To run the examples, scipy and matplotlib must also be installed in cygwin.
+
+On Linux, it worked with standard installation.
+
+Other configurations should work but the setup.py file would have to be improved. It is a first version and the build process will have to be improved.
+
+The package is working with Python 2 and 3.
+
+## Building
+
 The build is using a customized arm_math.h in folder cmsisdsp_pkg/src to be able to compile on windows.
 
 As a consequence, if you build on an ARM computer, you won't get the optimizations of the CMSIS library. It is possible to get them by replacing the customized arm_math.h by the official one.
 
-Following command will build in place.
+Since the CMSIS-DSP wrapper is using numpy, you must first install it if not already done. So, for instance to install it locally you could do:
+
+    > pip install numpy --user
+
+Once numpy is installed, you can build the CMSIS-DSP python wrapper. Go to folder CMSIS/DSP/PythonWrapper.
+
+Following command will build in place if you have the right compiler and if Python can find it.
 
     > python setup.py build_ext --inplace
 
-If you launch Python from same directory you'll be able to play with the test scripts. You'll need to install a few additional Python packages to run the examples. See below.
+Then, if you launch Python from same directory you'll be able to play with the test scripts. You'll need to install a few additional Python packages to run the examples (scipy and matplotlib). See below.
 
 If you want to install the cmsisdsp package, it is advised to install it into a virtualenv
 
@@ -37,14 +57,14 @@ Activate the environment:
 Install some packages to be able to run the examples
 
     > pip install numpy
-    > pip instal scipy
-    > pip instal matplotplib
+    > pip install scipy
+    > pip install matplotlib
 
 Now, you can install the cmsisdsp package in editable mode:
 
     > pip install -e "Path To The Folder Containing setup.py"
 
-Then you can copy the scripts testdsp.py and example.py and try to run them from this virtual environment.
+Then you can copy the scripts testdsp.py and example.py and try to run them from this virtual environment. example.y is requiring a data file to be downloaded from the web. See below in this document for the link.
 
 # Usage
 
@@ -178,6 +198,14 @@ This example depends on a data file which can be downloaded here:
 
 https://www.physionet.org/pn3/ecgiddb/Person_87/rec_2.dat
 
+This signal was created for a master thesis:
+
+Lugovaya T.S. Biometric human identification based on electrocardiogram. [Master's thesis] Faculty of Computing Technologies and Informatics, Electrotechnical University "LETI", Saint-Petersburg, Russian Federation; June 2005. 
+
+and it is part of the PhysioNet database
+
+Goldberger AL, Amaral LAN, Glass L, Hausdorff JM, Ivanov PCh, Mark RG, Mietus JE, Moody GB, Peng C-K, Stanley HE. PhysioBank, PhysioToolkit, and PhysioNet: Components of a New Research Resource for Complex Physiologic Signals. Circulation 101(23):e215-e220 [Circulation Electronic Pages; http://circ.ahajournals.org/cgi/content/full/101/23/e215]; 2000 (June 13). 
+
 
 # LIMITATIONS