Physio ROM stands for "Automated Range of Motion (ROM) calculation for Physiotherapists" and is an application that helps physiotherapists and their patient to understand the range of motion of their limbs around a joint.
This is important for people that have hurt their joints or for some other reason and cannot use their limbs to the full extent, such as after a fall, a stroke, a dislocation, a fracture or an accident.
The system consists of:
- a Web front-end that captures the video,
- a python based backend system to where the video is uploaded and pre-processed,
- a C++ based computer vision system that calculates the limbs and the angles on the limbs from the pre-processed video,
- a Web service that serves a JSON file with the results
- a Web page that serves the video with the results rendered and overlayed on top of the video.
The Web front end through which the video is captured can be found in the templates directory.
The python based backend system is run via the __main__.py python program.
Auto-setup is set up via the python virtualenv. Install python virtualenv and run the
following
make env
. env/bin/activate
make getreqs
The C++ based computer vision system requires the installation and compilation of the openpose software suite. This is detailed in the openpose documentation. The dependencies for this package are listed in requirements.txt.
Start the flask server by running:
python __main__.py
The server side implementation has, thus far only been tested on unix systems. We cannot guarantee. Certain linux distros may require running the code in sudo, because in-browser web camera streaming only functions in web ports (apparently security reasons)
Further detailed usage information is included in the doc/ folder.
Third-party dependencies that have been used or modified for this project that have their own software licence include:
| Software | Copyright | Licence | Link | Use |
|---|---|---|---|---|
| openpose | - | LGPL | - | Pose detection |
| caffe | - | BSD | - | ML framework |
| numpy | - | BSD | - | Faster searching |
| flask | - | BSD | - | web serving |
Copyright (C) 2017 Aqeel Akber and collaborators - All Rights Reserved
You should have received a copy of the [licence][LICENCE] with this file. If not, please write to: Aqeel Akber [email protected]. This licence applies to all files held under the copyright of this project only and not third-party dependencies.
If you believe that anything in this project infringes your copyright, please contact us with your information and a detailed description of your intellectual property, including the specific place in this project where you believe your intellectual property is being infringed.
Those interested, see [CONTRIBUTING][CONTRIBUTING.org] for guidelines.