Inference CLI (#308)

* Delete .vscode

* Delete configure

* CLI.OperatorAPI

* CLI.Finished + Update.Inference.Doc

* Refine installation

format

Fix FAKE

Compatible => OpenCV3.2

CI => Compile OpenCV from source.

Accelerate CI

Accelerate CI

Author: ganler

.github/workflows/ci.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-18.04
     strategy:
       matrix:
-        python-version: [3.6, 3.7, 3.8]
+        python-version: [3.7]
 
     steps:
     - uses: actions/checkout@v2
@@ -19,8 +19,19 @@ jobs:
         python-version: ${{ matrix.python-version }}
     - name: Initialize Python Env
       run: python3 -m pip install --upgrade pip
+#    - name: Build OpenCV from scratch
+#      run: |
+#        sudo apt install software-properties-common
+#        sudo add-apt-repository "deb http://security.ubuntu.com/ubuntu xenial-security main"
+#        sudo apt update
+#        sudo apt install git cmake libgtk2.0-dev libavcodec-dev libavformat-dev libswscale-dev libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libjasper-dev libdc1394-22-dev
+#        git clone --depth 1 --branch 4.4.0 https://github.com/opencv/opencv.git
+#        cd opencv && mkdir build && cd build
+#        cmake .. -DCMAKE_BUILD_TYPE=Release
+#        cmake --build .
+#        sudo make install
     - name: Install System Dependencies
-      run: sudo apt-get install libopencv-dev libgflags-dev # dependencies
+      run: sudo apt install libgflags-dev libopencv-dev # dependencies
     - name: Check download scripts.
       run: |
         sh scripts/download-test-data.sh

.gitignore

@@ -11,6 +11,7 @@ __pycache__
 *.out
 *.png
 *.uff
+.vscode/
 /3rdparty
 /bazel-*
 /bin

.vscode/settings.json

@@ -13,6 +13,7 @@ INCLUDE(cmake/3rdparty.cmake)
 
 OPTION(WITH_TRACE "Build with tracing library." OFF)
 OPTION(BUILD_FAKE "Build fake target without CUDA libraries." OFF)
+OPTION(BUILD_CLI "Build HyperPose command line tool." ON)
 OPTION(BUILD_EXAMPLES "Build examples." ON)
 OPTION(BUILD_USER_CODES "Build user codes." ON)
 OPTION(BUILD_TESTS "Build tests." ON)
@@ -25,7 +26,7 @@ IF(WITH_TRACE)
 ENDIF()
 
 IF(BUILD_LIB)
-    MESSAGE("BUILD_LIB ${BUILD_LIB}")
+    MESSAGE("[HyperPose] BUILD_LIB is ON.")
     IF(BUILD_FAKE)
         INCLUDE(cmake/hyperpose.fake.cmake)
     ELSE()
@@ -36,6 +37,11 @@ IF(BUILD_LIB)
     ENDIF()
 ENDIF()
 
+IF(BUILD_CLI)
+    MESSAGE("[HyperPose] BUILD_CLI is ON.")
+    INCLUDE(cmake/cli.cmake)
+ENDIF()
+
 IF(BUILD_EXAMPLES)
     MESSAGE(STATUS "[HyperPose] Examples Building Enabled.")
     INCLUDE(cmake/examples.cmake)

CMakeLists.txt

@@ -23,11 +23,12 @@ We provide an example to show human pose estimation achieved by HyperPose. You n
 
 ```bash
 sudo apt -y install git cmake build-essential subversion libgflags-dev libopencv-dev
-sh scripts/download-test-data.sh         # Install data for examples.
-sh scripts/download-tinyvgg-model.sh     # Install tiny-vgg model.
+git clone https://github.com/tensorlayer/hyperpose.git && cd hyperpose
+sh scripts/download-test-data.sh                       # Install data for examples.
+sh scripts/download-tinyvgg-model.sh                   # Install tiny-vgg model.
 mkdir build && cd build
-cmake .. -DCMAKE_BUILD_TYPE=RELEASE && make -j # Build library && examples.
-./example.operator_api_batched_images_paf    # The ouput images will be in the build folder.
+cmake .. -DCMAKE_BUILD_TYPE=Release && cmake --build . # Build library && examples.
+./hyperpose-cli                                        # The ouput images will be in the build folder.
 ```
 
 ## Performance

README.md

@@ -0,0 +1,9 @@
+INCLUDE(${CMAKE_SOURCE_DIR}/cmake/helpers.cmake)
+
+SET(CLI hyperpose-cli)
+SET(CLISRC ${CMAKE_SOURCE_DIR}/examples/cli.cpp)
+
+MESSAGE(STATUS ">>> To build [CLI]: ${CLISRC} --> ${CLI}")
+ADD_EXECUTABLE(${CLI} ${CLISRC})
+TARGET_LINK_LIBRARIES(${CLI} helpers hyperpose gflags)
+ADD_GLOBAL_DEPS(${CLI})

cmake/cli.cmake

@@ -3,10 +3,11 @@ INCLUDE(${CMAKE_SOURCE_DIR}/cmake/helpers.cmake)
 FILE(GLOB_RECURSE POSE_TESTS ${CMAKE_SOURCE_DIR}/examples/*.example.cpp)
 
 foreach(EXAMPLE_FULL_PATH ${POSE_TESTS})
-    MESSAGE(STATUS ">>> [EXAMPLE] TO BUILD ${EXAMPLE_FULL_PATH}")
     GET_FILENAME_COMPONENT(EXAMPLE_NAME ${EXAMPLE_FULL_PATH} NAME_WE)
-
     SET(EXAMPLE_TAR example.${EXAMPLE_NAME})
+
+    MESSAGE(STATUS ">>> To build [EXAMPLE]: ${EXAMPLE_FULL_PATH} --> ${EXAMPLE_TAR}")
+
     ADD_EXECUTABLE(${EXAMPLE_TAR} ${EXAMPLE_FULL_PATH})
     TARGET_LINK_LIBRARIES(${EXAMPLE_TAR} helpers hyperpose gflags)
     ADD_GLOBAL_DEPS(${EXAMPLE_TAR})

cmake/examples.cmake

@@ -3,7 +3,7 @@ set(POSE_LIB_NAME hyperpose)
 
 # Dependencies(OpenCV & CUDA)
 INCLUDE(cmake/cuda.cmake)
-FIND_PACKAGE(OpenCV)
+FIND_PACKAGE(OpenCV REQUIRED)
 
 ADD_LIBRARY(
         ${POSE_LIB_NAME} # SHARED

cmake/hyperpose.cmake

@@ -3,13 +3,15 @@ INCLUDE(${CMAKE_SOURCE_DIR}/cmake/helpers.cmake)
 FILE(GLOB_RECURSE POSE_TESTS ${CMAKE_SOURCE_DIR}/examples/tests/*.test.cpp)
 
 FOREACH(TEST_FULL_PATH ${POSE_TESTS})
-    MESSAGE(STATUS ">>> [TEST] TO BUILD ${TEST_FULL_PATH}")
     GET_FILENAME_COMPONENT(TEST_NAME ${TEST_FULL_PATH} NAME_WE)
     # ~ NAME_WE means filename without directory | longest extension ~ See more
     # details at
     # https://cmake.org/cmake/help/v3.0/command/get_filename_component.html
 
     SET(TEST_TAR test.${TEST_NAME})
+
+    MESSAGE(STATUS ">>> To build [TEST]: ${TEST_FULL_PATH} --> ${TEST_TAR}")
+
     ADD_EXECUTABLE(${TEST_TAR} ${TEST_FULL_PATH} src/thread_pool.cpp)
     TARGET_LINK_LIBRARIES(${TEST_TAR} helpers)
     SET_PROPERTY(TARGET ${TEST_TAR} PROPERTY COMPILE_FLAGS "")

cmake/tests.cmake

@@ -3,10 +3,12 @@ INCLUDE(${CMAKE_SOURCE_DIR}/cmake/helpers.cmake)
 FILE(GLOB_RECURSE USER_CODES ${CMAKE_SOURCE_DIR}/examples/user_codes/*.cpp)
 
 foreach(USERCODE_FULL_PATH ${USER_CODES})
-    MESSAGE(STATUS ">>> [USER CODES] TO BUILD ${USERCODE_FULL_PATH}")
     GET_FILENAME_COMPONENT(USER_CODE_NAME ${USERCODE_FULL_PATH} NAME_WE)
 
     SET(USER_CODE_TAR user.${USER_CODE_NAME})
+
+    MESSAGE(STATUS ">>> To build [USER CODES]: ${USERCODE_FULL_PATH} --> ${USER_CODE_TAR}")
+
     ADD_EXECUTABLE(${USER_CODE_TAR} ${USERCODE_FULL_PATH})
     TARGET_LINK_LIBRARIES(${USER_CODE_TAR} helpers hyperpose gflags)
     ADD_GLOBAL_DEPS(${USER_CODE_TAR})