a/README.md b/README.md
1
# Fallen Person Detector
1
# Fallen Person Detector
2
With this system we present a new , non-invasive approach for fallen people detection. Our approach uses only
2
With this system we present a new , non-invasive approach for fallen people detection. Our approach uses only
3
stereo camera data for passively sensing the environment. The key novelty is a human fall detector which uses a CNN based human pose estimator in combination with stereo data to reconstruct the human pose in 3D and estimate the ground plane in 3D. We have tested our approach in different scenarios covering most activities elderly people might encounter living at home. Based on our extensive evaluations, our systems shows high accuracy and almost no miss-classification.
3
stereo camera data for passively sensing the environment. The key novelty is a human fall detector which uses a CNN based human pose estimator in combination with stereo data to reconstruct the human pose in 3D and estimate the ground plane in 3D. We have tested our approach in different scenarios covering most activities elderly people might encounter living at home. Based on our extensive evaluations, our systems shows high accuracy and almost no miss-classification.
4
4
5
![System steps](/misc/steps.jpg)
5
6
6
7
8
9
[Click here for the associated paper.](https://arxiv.org/pdf/1707.07608.pdf)
7
[Click here for the associated paper.](https://arxiv.org/pdf/1707.07608.pdf)
10
8
11
[Original home of this project](https://github.com/solbach/fallen-person-detector)
9
[Original home of this project](https://github.com/solbach/fallen-person-detector)
12
10
13
## Requirements
11
## Requirements
14
- ROS Kinetic
12
- ROS Kinetic
15
- [openpose-ros](https://github.com/solbach/openpose-ros/blob/master/README.md) and all its requirements
13
- [openpose-ros](https://github.com/solbach/openpose-ros/blob/master/README.md) and all its requirements
16
14
17
15
18
## Installation
16
## Installation
19
- ```cd``` to your [catkin workspace](http://wiki.ros.org/catkin/Tutorials/create_a_workspace)
17
- ```cd``` to your [catkin workspace](http://wiki.ros.org/catkin/Tutorials/create_a_workspace)
20
- ```cd src/```
18
- ```cd src/```
21
- ```github clone https://github.com/solbach/fallen-person-detector```
19
- ```github clone https://github.com/solbach/fallen-person-detector```
22
- ```cd ../```
20
- ```cd ../```
23
- ``` catkin_make```
21
- ``` catkin_make```
24
- ```source devel/setup.bash```
22
- ```source devel/setup.bash```
25
  - _needs to be done with every new terminal running the fallen person detector_
23
  - _needs to be done with every new terminal running the fallen person detector_
26
24
27
25
28
## Run
26
## Run
29
1. ```roscore```
27
1. ```roscore```
30
1. ```rosrun openpose-ros openpose-ros-node```
28
1. ```rosrun openpose-ros openpose-ros-node```
31
1. ``` rosrun fallen_person_detector fallen_person_detector_node ```
29
1. ``` rosrun fallen_person_detector fallen_person_detector_node ```
32
30
33
## Tested on
31
## Tested on
34
* Ubuntu 16.04
32
* Ubuntu 16.04
35
* ROS Kinetic
33
* ROS Kinetic
36
* CUDA 8.0
34
* CUDA 8.0
37
* cuDNN 6.0
35
* cuDNN 6.0
38
* __OpenCV 3.2__
36
* __OpenCV 3.2__
39
37
40
## Citation
38
## Citation
41
Please cite this paper if you used it in your research:
39
Please cite this paper if you used it in your research:
42
40
43
```
41
```
44
Solbach, Markus D., and John K. Tsotsos.
42
Solbach, Markus D., and John K. Tsotsos.
45
"Vision-Based Fallen Person Detection for the Elderly."
43
"Vision-Based Fallen Person Detection for the Elderly."
46
arXiv preprint arXiv:1707.07608 (2017).
44
arXiv preprint arXiv:1707.07608 (2017).
47
```
45
```
48
46
49
47
50
Accepted at [ACVR 2017](http://iplab.dmi.unict.it/acvr2017/index.php): Updated citation will follow soon.
48
Accepted at [ACVR 2017](http://iplab.dmi.unict.it/acvr2017/index.php): Updated citation will follow soon.
51
49
52
## System Overview
50
53
51
54
![System steps](/misc/overview.png)
55
56
57
## COPYRIGHT NOTICE
52
## COPYRIGHT NOTICE
58
53
59
THIS SOFTWARE IS THE PROPERTY OF ITS AUTHOR MARKUS D. SOLBACH. THE AUTHOR GRANTS PERMISSION TO DISTRIBUTE THE SOFTWARE IN ITS ORIGINAL FORM WITHOUT MODIFICATION. UNDER SUCH CIRCUMSTANCES THE COPYRIGHT NOTICE AND FUNCTIONALITY OF THE SOFTWARE MUST REMAIN ENTIRELY INTACT INCLUDING ALL SYNTACTIC AND SEMANTIC ELEMENTS OF ITS FUNCTION. THE AUTHOR GRANTS A NON-EXLUSIVE LICENSE TO INDIVIDUALS WISHING TO USE THE SOFTWARE FOR NON-PROFIT RESEARCH PURPOSES. THOSE WISHING TO EMPLOY THE SOFTWARE FOR COMMERCIAL OR PROFIT SEEKING ENDEAVORS SHOULD CONTACT THE AUTHOR TO DISCUSS LICENSING.
54
THIS SOFTWARE IS THE PROPERTY OF ITS AUTHOR MARKUS D. SOLBACH. THE AUTHOR GRANTS PERMISSION TO DISTRIBUTE THE SOFTWARE IN ITS ORIGINAL FORM WITHOUT MODIFICATION. UNDER SUCH CIRCUMSTANCES THE COPYRIGHT NOTICE AND FUNCTIONALITY OF THE SOFTWARE MUST REMAIN ENTIRELY INTACT INCLUDING ALL SYNTACTIC AND SEMANTIC ELEMENTS OF ITS FUNCTION. THE AUTHOR GRANTS A NON-EXLUSIVE LICENSE TO INDIVIDUALS WISHING TO USE THE SOFTWARE FOR NON-PROFIT RESEARCH PURPOSES. THOSE WISHING TO EMPLOY THE SOFTWARE FOR COMMERCIAL OR PROFIT SEEKING ENDEAVORS SHOULD CONTACT THE AUTHOR TO DISCUSS LICENSING.
60
55
61
DERIVATIVE WORKS ARE ALLOWED BY INDIVIDUALS FOR NON-PROFIT RESEARCH PURPOSES. SUCH DERIVATIVE WORKS MAY NOT BE DISTRIBUTED WITHOUT WRITTEN CONSENT OF THE AUTHOR. ANY WORKS THAT USE THE ABOVE SOFTWARE IN WHOLE OR PART FOR A COMMERCIAL APPLICATION MUST OBTAIN A VALID LICENSE FROM THE AUTHOR.
56
DERIVATIVE WORKS ARE ALLOWED BY INDIVIDUALS FOR NON-PROFIT RESEARCH PURPOSES. SUCH DERIVATIVE WORKS MAY NOT BE DISTRIBUTED WITHOUT WRITTEN CONSENT OF THE AUTHOR. ANY WORKS THAT USE THE ABOVE SOFTWARE IN WHOLE OR PART FOR A COMMERCIAL APPLICATION MUST OBTAIN A VALID LICENSE FROM THE AUTHOR.
62
57
63
THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
58
THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.