Merge branch 'CMU-Perceptual-Computing-Lab:master' into master

Author: xiangyann

README.md

@@ -146,7 +146,7 @@ Our library is open source for research purposes, and we want to improve it! So
 
 
 ## Citation
-Please cite these papers in your publications if OpenPose helps your research. All of OpenPose is based on [OpenPose: Realtime Multi-Person 2D Pose Estimation using Part Affinity Fields](https://arxiv.org/abs/1812.08008), while the hand and face detectors also use [Hand Keypoint Detection in Single Images using Multiview Bootstrapping](https://arxiv.org/abs/1704.07809) (the face detector was trained using the same procedure than the hand detector).
+Please cite these papers in your publications if OpenPose helps your research. All of OpenPose is based on [OpenPose: Realtime Multi-Person 2D Pose Estimation using Part Affinity Fields](https://arxiv.org/abs/1812.08008), while the hand and face detectors also use [Hand Keypoint Detection in Single Images using Multiview Bootstrapping](https://arxiv.org/abs/1704.07809) (the face detector was trained using the same procedure as the hand detector).
 
     @article{8765346,
       author = {Z. {Cao} and G. {Hidalgo Martinez} and T. {Simon} and S. {Wei} and Y. A. {Sheikh}},

doc/10_community_projects.md

@@ -3,9 +3,10 @@ OpenPose Doc - Community-based Projects
 
 Here we expose all projects created with OpenPose by the community and that were shared with us. Do you want to share yours? Simply create a pull request and add to this file your demo and a description of it!
 
-1. [**ROS OpenPose**](https://github.com/ildoonet/ros-openpose)
+1. [**ROS OpenPose**](https://github.com/ravijo/ros_openpose): ROS wrapper for OpenPose
 2. [**Hand gesture classification application - OpenHand**](https://github.com/ArthurFDLR/OpenHand-App): Third-party application that eases hand keypoints datasets creation and real-time hand gesture classification. You can deploy your own Neural Network classification model on top of OpenPose and play with it in real-time through a GUI!
 3. Integrated to [Huggingface Spaces](https://huggingface.co/spaces) with [Gradio](https://github.com/gradio-app/gradio). See demo: [![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/akhaliq/openpose)
+4. [**RealSense2OpenPose3D**](https://github.com/foxtierney/RealSense2OpenPose3D): Use an Intel RealSense RGB-D camera to add depth to OpenPose. Generates JSON files with 3D keypoints.
 
 
 Disclaimer: We do not support any of these projects, we are simply exposing them. GitHub issues or questions about those will result in strict user bans and the posts being deleted.

doc/advanced/3d_reconstruction_module.md

@@ -23,13 +23,13 @@ This module performs 3-D keypoint (body, face, and hand) reconstruction and rend
 
 
 ## Installation
-Check [doc/installation/0_index.md#3d-reconstruction-module](../installation/0_index.md#3d-reconstruction-module) for installation steps.
+Check [doc/installation/2_additional_settings.md#3d-reconstruction-module](../installation/2_additional_settings.md#3d-reconstruction-module) for installation steps.
 
 
 
 
 ## Non Linear Optimization
-In order to increase the 3-D reconstruction accuracy, OpenPose optionally performs non-linear optimization if Ceres solver support is enabled (only available in Ubuntu for now). To enable it, check [doc/installation/0_index.md#3d-reconstruction-module](../installation/0_index.md#3d-reconstruction-module) for more details.
+In order to increase the 3-D reconstruction accuracy, OpenPose optionally performs non-linear optimization if Ceres solver support is enabled (only available in Ubuntu for now). To enable it, check [doc/installation/2_additional_settings.md#3d-reconstruction-module](../installation/2_additional_settings.md#3d-reconstruction-module) for more details.
 
 
 

doc/installation/0_index.md

@@ -72,7 +72,7 @@ The instructions in the following subsections describe the steps to build OpenPo
 
 
 ### Problems and Errors Installing OpenPose
-Any problem installing OpenPose while following this guidelines? Check [doc/05_faq.md](../05_faq.md) and/or check existing GitHub issues. If you do you find your issue, post a new one. We will not respond to duplicated issues, as well as GitHub issues about Caffe, OpenCV or CUDA installation errors, as well as issues that do not fill all the information that the GitHub template asks for.
+Any problem installing OpenPose while following this guidelines? Check [doc/05_faq.md](../05_faq.md) and/or check existing GitHub issues. If you don't find your issue, post a new one. We will not respond to duplicated issues, as well as GitHub issues about Caffe, OpenCV or CUDA installation errors, as well as issues that do not fill all the information that the GitHub template asks for.
 
 
 
@@ -192,6 +192,8 @@ In order to build the project, select and run only one of the 2 following altern
     copy x64\Release\*  bin\
     ```
 
+**NOTE**: To set `GPU_MODE` flag to `CPU_ONLY` when building the tool via cli, append `-D GPU_MODE:STRINGS=CPU_ONLY` to the `cmake` command.
+
 **VERY IMPORTANT NOTE**: In order to use OpenPose outside Visual Studio, and assuming you have not unchecked the `BUILD_BIN_FOLDER` flag in CMake, copy all DLLs from `{build_directory}/bin` into the folder where the generated `openpose.dll` and `*.exe` demos are, e.g., `{build_directory}x64/Release` for the 64-bit release version.
 
 If you are facing errors with these instructions, these are a set of alternative instructions created by the community:

doc/installation/1_prerequisites.md

@@ -76,7 +76,7 @@ sudo pip install numpy opencv-python
 
 ## Mac OS Prerequisites
 1. If you don't have `brew`, install it by running `bash scripts/osx/install_brew.sh` on your terminal.
-2. Install **CMake GUI**: Run the command `brew cask install cmake`.
+2. Install **CMake GUI**: Run the command `brew install --cask cmake`.
 3. Install **Caffe, OpenCV, and Caffe prerequisites**: Run `bash scripts/osx/install_deps.sh`.