Data analysis framework for pedar plantar pressure sensor.
Fig. An example averaged foot peak pressure distribution heatmap.
The documentation web pages can be found in docs/build/html/
. Please open index.html
to enter the documentation which provides comprehensive descriptions and working examples for each class and function we provided.
Other than the documentation, examples/
folder provides some example analysis code for quick-start.
The documentation is generated with Sphinx. If you are not familiar with it, I would recommend two tutorials for quick-start:
- A “How to” Guide for Sphinx + ReadTheDocs - sglvladi provides an easy-to-follow learning curve but omitted some details.
- Getting Started - Sphinx is harder to understand, but provides some essential information to understand the background, which is vital even for very basic configuration.
The project code is stored in pedarProbe/
folder. Under it is a data/
folder, a default output folder output/
, a config/
folder storing configuration variables.
Except for these folders, you must have noticed that there are also some .py
files, including parse.py
, node.py
, analyse.py
, export.py
. These are core modules for this package:
pedarProbe.parse
Loading and parsing pedar plantar pressure data and construct a data node tree for further analysis.pedarProbe.node
Provide well-defined node type for construct the data node tree.pedarProbe.analyse
Provide data analysis functionalities. Short-cut functions are realised inpedarProbe.node.PedarNode
to facilitate the usability.pedarProbe.export
Provide analysis result export functionalities. Short-cut functions are realised inpedarProbe.node.PedarNode
to facilitate the usability.
Other than these, there is an task/
folder haven't been discussed. It's the pedarProbe.task
sub-package storing all fine-tuned, twisted analysis features derived from the core modules.
We use git
as the version control tool, which is very popular among developers and works seamlessly with GitHub. If you are not familiar with it, I would recommend this tutorial for quick-start: Git Tutorial - Xuefeng Liao
Following is a series of notes that summarise major commands:
This project is built upon various open-source packages. All dependencies are listed in requirements.txt
, please install them properly under a Python 3 environment.