**Functionality**: - **Real-time multi-person keypoint detection**. - 15 or **18-keypoint body estimation**. **Running time invariant to number of detected people**. - **2x21-keypoint hand** estimation. Currently, **running time depends** on **number of detected people**. - **70-keypoint face** estimation. Currently, **running time depends** on **number of detected people**. - **Input**: Image, video, webcam, and IP camera. Included C++ demos to add your custom input. - **Output**: Basic image + keypoint display/saving (PNG, JPG, AVI, ...), keypoint saving (JSON, XML, YML, ...), and/or keypoints as array class. - Available: command-line demo, C++ wrapper, and C++ API. - **OS**: Ubuntu (14, 16), Windows (8, 10), Nvidia TX2. ## Latest Features - Sep 2017: **CMake** installer and **IP camera** support! - Jul 2017: [**Windows portable demo**](doc/installation.md#installation---demo)! - Jul 2017: **Hands** released! - Jun 2017: **Face** released! For further details, check [all released features](doc/released_features.md) and [release notes](doc/release_notes.md). ## Contents 1. [Latest Features](#latest-features) 2. [Results](#results) 3. [Installation, Reinstallation and Uninstallation](#installation-reinstallation-and-uninstallation) 4. [Quick Start](#quick-start) 5. [Output](#output) 6. [Speeding Up OpenPose and Benchmark](#speeding-up-openpose-and-benchmark) 7. [Send Us Failure Cases and Feedback!](#send-us-failure-cases-and-feedback) 8. [Authors and Contributors](#authors-and-contributors) 9. [Citation](#citation) 10. [License](#license) ## Results ### Body Estimation
### Body, Face, and Hands Estimation
### Body and Hands Estimation
## Installation, Reinstallation and Uninstallation See [doc/installation.md](doc/installation.md) for instructions on how to build from source or how to download our portable binaries. ## Quick Start Most users do not need the [OpenPose C++ API](#openpose-c-api), but they can simply use the basic [Demo](#demo) and/or [OpenPose Wrapper](#openpose-wrapper). - **Demo**: To easily process images/video/webcam and display/save the results. See [doc/demo_overview.md](doc/demo_overview.md). E.g. run OpenPose in a video with: ``` # Ubuntu ./build/examples/openpose/openpose.bin --video examples/media/video.avi :: Windows - Portable Demo bin\OpenPoseDemo.exe --video examples\media\video.avi ``` - **OpenPose Wrapper**: If you want to read a specific input, and/or add your custom post-processing function, and/or implement your own display/saving, check the `Wrapper` tutorial on [examples/tutorial_wrapper/](examples/tutorial_wrapper/). You can create your custom code on [examples/user_code/](examples/user_code/) and quickly compile it by using `make all` in the OpenPose folder (assuming Makefile installer). - **OpenPose C++ API**: See [doc/library_introduction.md](doc/library_introduction.md). - **Adding an extra module**: Check [doc/library_add_new_module.md](./library_add_new_module.md). - **Standalone face or hand detector**: - **Face** keypoint detection **without body** keypoint detection: If you want to speed it up (but also reduce amount of detected faces), check the OpenCV-face-detector approach in [doc/standalone_face_or_hand_keypoint_detector.md](doc/standalone_face_or_hand_keypoint_detector.md). - **Use your own face/hand detector**: You can use the hand and/or face keypoint detectors with your own face or hand detectors, rather than using the body detector. E.g. useful for camera views at which the hands are visible but not the body (OpenPose detector would fail). See [doc/standalone_face_or_hand_keypoint_detector.md](doc/standalone_face_or_hand_keypoint_detector.md). - **Library dependencies**: OpenPose uses default Caffe and OpenCV, as well as any Caffe dependency. The demos additionally use GFlags. It could easily be ported to other deep learning frameworks (Tensorflow, Torch, ...). Feel free to make a pull request if you implement any of those! ## Output Output (format, keypoint index ordering, etc.) in [doc/output.md](doc/output.md). ## Speeding Up OpenPose and Benchmark Check the OpenPose Benchmark and some hints to speed up OpenPose on [doc/faq.md#speed-up-and-benchmark](doc/faq.md#speed-up-and-benchmark). ## Send Us Failure Cases and Feedback! Our library is open source for research purposes, and we want to continuously improve it! So please, let us know if... 1. ... you find videos or images where OpenPose does not seems to work well. Feel free to send them to openposecmu@gmail.com (email only for failure cases!), we will use them to improve the quality of the algorithm! 2. ... you find any bug (in functionality or speed). 3. ... you added some functionality to some class or some new Worker