Skip to content
This repository was archived by the owner on Oct 23, 2024. It is now read-only.

Commit 4cf8feb

Browse files
authored
Update analytics document (#702)
1 parent 85411ea commit 4cf8feb

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

doc/servermd/AnalyticsGuide.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,18 @@ docker exec -it gst-analytics bash
6060

6161
Besides basic OWT dependencies, analytics agent requires OpenVINO and GStreamer to do video analytics. Please download OpenVINO 2021.1.110 and dlstreamer_gst 1.2.1 version and refer to option 3 steps in [dlstreamer_gst install guide](https://github.com/openvinotoolkit/dlstreamer_gst/wiki/Install-Guide#install-on-host-machine) to install OpenVINO, gst-video-analytics plugins and related dependencies.
6262

63+
For dlstreamer installation in CentOS, required version is >=3.1, if your system installed cmake version is < 3.1, build process will fail. In this case, following steps below:
64+
```
65+
yum remove cmake
66+
wget https://github.com/Kitware/CMake/releases/download/v3.14.5/cmake-3.14.5-Linux-x86_64.tar.gz
67+
tar zxf cmake-3.14.5-Linux-x86_64.tar.gz -C /opt/
68+
export CMAKE_HOME=/opt/cmake-3.14.5-Linux-x86_64
69+
export PATH=$PATH:$CMAKE_HOME/bin
70+
cmake --version
71+
```
72+
73+
Then you can continue to build dlstreamer.
74+
6375
### 2.3 Download models for analytics<a name="dependencies3"></a>
6476

6577
Download [open model zoo package](https://github.com/opencv/open_model_zoo/releases/tag/2020.4) and uncompress file in docker container or host machine:
@@ -129,6 +141,10 @@ cd Release-vxxx
129141

130142
Start up OWT in host machine:
131143
````
144+
source /opt/intel/openvino_2021/bin/setupvars.sh
145+
##dl_streamer_lib_path is the build library path in step 2.2
146+
export GST_PLUGIN_PATH=${dl_streamer_lib_path}:/usr/lib/x86_64-linux-gnu/gstreamer-1.0:${GST_PLUGIN_PATH} #for ubuntu18.04
147+
export GST_PLUGIN_PATH=${dl_streamer_lib_path}:/usr/lib64/gstreamer-1.0::${GST_PLUGIN_PATH} #for centos7.6
132148
cd Release-vxxx
133149
cp ${OWT_SOURCE_CODE}/docker/analyticspage/index.js apps/current_app/public/scripts/
134150
cp ${OWT_SOURCE_CODE}/docker/analyticspage/rest-sample.js apps/current_app/public/scripts/
@@ -156,6 +172,15 @@ Make sure face detection with cpu pipeline has been installed and model path has
156172
Check ````analytics_agent/plugin.cfg````, The pipeline ID for face detection with CPU is ````dc51138a8284436f873418a21ba8cfa9````, so on the page, in "pipelineID" input text, input the pipeline ID in "analytics id"
157173
edit control, that is, ````dc51138a8284436f873418a21ba8cfa9```` without any extra spaces, and press "startAnalytics" button. The stream you selected will be analyzed, with annotation on the faces in the stream.
158174

175+
Note: If the sample cpu_pipeline analytics failed, please debug as following:
176+
a. Check sample cpu_pipeline is successfully compiled and generated libraries are copied to analytics_agent/lib folder
177+
b. Check ```modelpath``` in analytics_agent/plugin.cfg and make sure it is configured to the correct openmodel zoo model path.
178+
c. For sample cpu_pipeline, the failure is mostly caused by gvadetect and x264enc elements cannot be found, use ```gst-inspect-1.0 gvadetect``` and ```gst-inspect-1.0 x264enc``` to check if used GStreamer elements are successfully installed or configured. If x264enc element is not found, please make sure gstreamer1-plugins-ugly (for CentOS) and gstreamer1.0-plugins-ugly(for Ubuntu). If gvadetect element is not found, please make sure dlstreamer is successfully compiled. Check environment variable GST_PLUGIN_PATH and add x264 and gvadetect libraries to the GST_PLUGIN_PATH as:
179+
````
180+
export GST_PLUGIN_PATH=${dl_streamer_lib_path}:/usr/lib/x86_64-linux-gnu/gstreamer-1.0:${GST_PLUGIN_PATH} #for ubuntu18.04
181+
export GST_PLUGIN_PATH=${dl_streamer_lib_path}:/usr/lib64/gstreamer-1.0::${GST_PLUGIN_PATH} #for centos7.6
182+
````
183+
159184
#### Subscribe analyzed stream
160185

161186
On the page and drop down from "subscribe video" and select the stream id with ````algorithmid+video from streamid```` and click subscribe, then analyzed stream will display on page.

0 commit comments

Comments
 (0)