diff --git a/README.md b/README.md index 0ac1d3feb04deedf804e75c5bccbe1af10f3552f..e79332839d12fdc50be884bc7115b480a895697f 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,10 @@ OpenPose ==================================== +OpenPose is a **library for real-time multi-person keypoint detection and multi-threading written in C++** using OpenCV and Caffe*, authored by [Gines Hidalgo](http://gines-hidalgo.site123.me/), [Zhe Cao](http://www.andrew.cmu.edu/user/zhecao), [Tomas Simon](http://www.cs.cmu.edu/~tsimon/), [Shih-En Wei](https://scholar.google.com/citations?user=sFQD3k4AAAAJ&hl=en), [Hanbyul Joo](http://www.cs.cmu.edu/~hanbyulj/) and [Yaser Sheikh](http://www.cs.cmu.edu/~yaser/). + +\* It uses Caffe, but it could easily be ported to other frameworks (Tensorflow, Torch, etc.). If you implement any of those, feel free to make a pull request! + ## Latest News - Jul 2017: **Windows**, New [**portable demo**](doc/installation.md#installation---demo) **and** [**easier library installation**](doc/installation.md#installation---library)! - Jul 2017: **Hands** released! @@ -9,25 +13,58 @@ OpenPose - Apr 2017: **Body** released! - Check all the [release notes](doc/release_notes.md). -We are offering [internships at Carnegie Mellon University as OpenPose programmer](https://docs.google.com/document/d/14SygG39NjIRZfx08clewTdFMGwVdtRu2acyCi3TYcHs/edit?usp=sharing) (need to live in or be willing to move to Pittsburgh). +## Results +### Body + Hands + Face Estimation +

+ +

+### Body Estimation +

+ +

+ +### Body + Face Estimation +

+ +

+### Body + Hands +

+ +

-## Introduction -OpenPose is a **library for real-time multi-person keypoint detection and multi-threading written in C++** using OpenCV and Caffe*, authored by [Gines Hidalgo](http://gines-hidalgo.site123.me/), [Zhe Cao](http://www.andrew.cmu.edu/user/zhecao), [Tomas Simon](http://www.cs.cmu.edu/~tsimon/), [Shih-En Wei](https://scholar.google.com/citations?user=sFQD3k4AAAAJ&hl=en), [Hanbyul Joo](http://www.cs.cmu.edu/~hanbyulj/) and [Yaser Sheikh](http://www.cs.cmu.edu/~yaser/). +## Contents +1. [Latest News](#latest-news) +2. [Results](#results) +3. [Introduction](#introduction) +4. [Functionality](#functionality) +5. [Operating Systems](#operating-systems) +6. [Installation, Reinstallation and Uninstallation](#installation-reinstallation-and-uninstallation) +7. [Custom Caffe](#custom-caffe) +8. [Quick Start](#quick-start) + 1. [Demo](#demo) + 2. [OpenPose Wrapper](#openpose-wrapper) + 3. [OpenPose Library](#openpose-library) +9. [Output](#output) +10. [Speed Up Openpose And Benchmark](#speed-up-openpose-and-benchmark) +11. [Send Us Failure Cases!](#send-us-failure-cases) +12. [Send Us Your Feedback!](#send-us-your-feedback) +13. [Citation](#citation) +14. [Other Contributors](#other-contributors) -\* It uses Caffe, but the code is ready to be ported to other frameworks (Tensorflow, Torch, etc.). If you implement any of those, feel free to make a pull request! +## Introduction OpenPose represents the **first real-time system to jointly detect human body, hand and facial keypoints (in total 130 keypoints) on single images**. In addition, the system computational performance on body keypoint estimation is invariant to the number of detected people in the image. OpenPose is freely available for free non-commercial use, and may be redistributed under these conditions. Please, see the [license](LICENSE) for further details. [Interested in a commercial license? Check this link](https://flintbox.com/public/project/47343/). For commercial queries, contact [Yaser Sheikh](http://www.cs.cmu.edu/~yaser/). In addition, OpenPose would not be possible without the [CMU Panoptic Studio](http://domedb.perception.cs.cmu.edu/). +The pose estimation work is based on the C++ code from [the ECCV 2016 demo](https://github.com/CMU-Perceptual-Computing-Lab/caffe_rtpose), "Realtime Multiperson Pose Estimation", [Zhe Cao](http://www.andrew.cmu.edu/user/zhecao), [Tomas Simon](http://www.cs.cmu.edu/~tsimon/), [Shih-En Wei](https://scholar.google.com/citations?user=sFQD3k4AAAAJ&hl=en), [Yaser Sheikh](http://www.cs.cmu.edu/~yaser/). The [original repo](https://github.com/ZheC/Multi-Person-Pose-Estimation) includes Matlab and Python version, as well as the training code. -Library main functionality: - +## Functionality * Multi-person 15 or **18-keypoint body pose** estimation and rendering. **Running time invariant to number of people** on the image. * Multi-person **2x21-keypoint hand** estimation and rendering. Note: In this initial version, **running time** linearly **depends** on the **number of people** on the image. **Coming soon (in around 1-5 days)!** @@ -44,8 +81,6 @@ Library main functionality: * All the functionality is wrapped into a **simple-to-use OpenPose Wrapper class**. -The pose estimation work is based on the C++ code from [the ECCV 2016 demo](https://github.com/CMU-Perceptual-Computing-Lab/caffe_rtpose), "Realtime Multiperson Pose Estimation", [Zhe Cao](http://www.andrew.cmu.edu/user/zhecao), [Tomas Simon](http://www.cs.cmu.edu/~tsimon/), [Shih-En Wei](https://scholar.google.com/citations?user=sFQD3k4AAAAJ&hl=en), [Yaser Sheikh](http://www.cs.cmu.edu/~yaser/). The [full project repo](https://github.com/ZheC/Multi-Person-Pose-Estimation) includes Matlab and Python version, as well as training code. - ## Operating Systems @@ -55,45 +90,6 @@ The pose estimation work is based on the C++ code from [the ECCV 2016 demo](http -## Results -### Body + Hands + Face Estimation -

- -

- -### Body Estimation -

- -

- -### Body + Face Estimation -

- -

- -### Body + Hands -

- -

- - -## Contents -1. [Installation, Reinstallation and Uninstallation](#installation-reinstallation-and-uninstallation) -2. [Quick Start](#quick-start) - 1. [Demo](#demo) - 2. [OpenPose Wrapper](#openpose-wrapper) - 3. [OpenPose Library](#openpose-library) -3. [Output](#output) -4. [Custom Caffe](#custom-caffe) -5. [Standalone Face Or Hand Keypoint Detector](#standalone-face-or-hand-keypoint-detector) -6. [Speed Up Openpose And Benchmark](#speed-up-openpose-and-benchmark) -7. [Send Us Failure Cases!](#send-us-failure-cases) -8. [Send Us Your Feedback!](#send-us-your-feedback) -9. [Citation](#citation) -10. [Other Contributors](#other-contributors) - - - ## Installation, Reinstallation and Uninstallation You can find the installation, reinstallation and uninstallation steps on: [doc/installation.md](doc/installation.md).