Skip to content

Commit f8fee0b

Browse files
nszczygl9pbartosikdmichalo
authored
[DLStreamer] Fix docs. (#851)
Co-authored-by: Bartosik, Pawel <pawel.bartosik@intel.com> Co-authored-by: dmichalo <dawid.michalowski@intel.com>
1 parent dfcdec3 commit f8fee0b

File tree

4 files changed

+35
-32
lines changed

4 files changed

+35
-32
lines changed

libraries/dl-streamer/docs/source/get_started/install/install_guide_ubuntu.md

Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -83,17 +83,19 @@ drivers. For more details see [prerequisites](#prerequisites).
8383
- **In Ubuntu 22**
8484

8585
```bash
86-
sudo -E wget -O- https://apt.repos.intel.com/edgeai/dlstreamer/GPG-PUB-KEY-INTEL-DLS.gpg | sudo tee /usr/share/ keyrings/dls-archive-keyring.gpg > /dev/null
87-
echo "deb [signed-by=/usr/share/keyrings/dls-archive-keyring.gpg] https://apt.repos.intel.com/edgeai/dlstreamer/ ubuntu22 ubuntu22 main" | sudo tee /etc/apt/sources.list.d/intel-dlstreamer.list
88-
sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/ openvino/2025 ubuntu22 main" | sudo tee /etc/apt/sources.list.d/intel-openvino-2025.list'
86+
sudo -E wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | gpg --dearmor | sudo tee /usr/share/keyrings/oneapi-archive-keyring.gpg > /dev/null
87+
sudo -E wget -O- https://apt.repos.intel.com/edgeai/dlstreamer/GPG-PUB-KEY-INTEL-DLS.gpg | sudo tee /usr/share/keyrings/dls-archive-keyring.gpg > /dev/null
88+
echo "deb [signed-by=/usr/share/keyrings/dls-archive-keyring.gpg] https://apt.repos.intel.com/edgeai/dlstreamer/ubuntu22 ubuntu22 main" | sudo tee /etc/apt/sources.list.d/intel-dlstreamer.list
89+
sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/openvino/2025 ubuntu22 main" | sudo tee /etc/apt/sources.list.d/intel-openvino-2025.list'
8990
```
9091

9192
- **Ubuntu 24**
9293

9394
```bash
94-
sudo -E wget -O- https://apt.repos.intel.com/edgeai/dlstreamer/GPG-PUB-KEY-INTEL-DLS.gpg | sudo tee /usr/share/ keyrings/dls-archive-keyring.gpg > /dev/null
95-
echo "deb [signed-by=/usr/share/keyrings/dls-archive-keyring.gpg] https://apt.repos.intel.com/edgeai/dlstreamer/ ubuntu24 ubuntu24 main" | sudo tee /etc/apt/sources.list.d/intel-dlstreamer.list
96-
sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/ openvino/2025 ubuntu24 main" | sudo tee /etc/apt/sources.list.d/intel-openvino-2025.list'
95+
sudo -E wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | gpg --dearmor | sudo tee /usr/share/keyrings/oneapi-archive-keyring.gpg > /dev/null
96+
sudo -E wget -O- https://apt.repos.intel.com/edgeai/dlstreamer/GPG-PUB-KEY-INTEL-DLS.gpg | sudo tee /usr/share/keyrings/dls-archive-keyring.gpg > /dev/null
97+
echo "deb [signed-by=/usr/share/keyrings/dls-archive-keyring.gpg] https://apt.repos.intel.com/edgeai/dlstreamer/ubuntu24 ubuntu24 main" | sudo tee /etc/apt/sources.list.d/intel-dlstreamer.list
98+
sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/openvino/2025 ubuntu24 main" | sudo tee /etc/apt/sources.list.d/intel-openvino-2025.list'
9799
```
98100

99101
> **NOTE:** If you have OpenVINO™ installed in a version different from 2025.2.0,
@@ -125,7 +127,7 @@ To see the full list of installed components check the
125127
The Python packages required to run Intel® DL Streamer python elements
126128
or samples are not installed by default. You can install them using
127129
commands from
128-
[Advanced Install Guide Compilation / Install Python dependencies](https://dlstreamer.github.io/dev_guide/advanced_install/advanced_install_guide_compilation.html#step-6-install-python-dependencies)
130+
[Advanced Install Guide Compilation / Install Python dependencies](../../dev_guide/advanced_install/advanced_install_guide_compilation.html#step-6-install-python-dependencies)
129131

130132
### [Optional] Step 5: Post installation steps
131133

@@ -171,40 +173,40 @@ following command:
171173

172174
```bash
173175
export LIBVA_DRIVER_NAME=iHD
174-
export GST_PLUGIN_PATH=/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:/opt/intel/ dlstreamer/streamer/lib/
175-
export LD_LIBRARY_PATH=/opt/intel/dlstreamer/gstreamer/lib:/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/lib/ gstreamer-1.0:/sr/lib:/opt/intel/dlstreamer/lib:/usr/local/lib/gstreamer-1.0:/usr/local/lib
176+
export GST_PLUGIN_PATH=/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:/opt/intel/dlstreamer/streamer/lib/
177+
export LD_LIBRARY_PATH=/opt/intel/dlstreamer/gstreamer/lib:/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/lib/gstreamer-1.0:/sr/lib:/opt/intel/dlstreamer/lib:/usr/local/lib/gstreamer-1.0:/usr/local/lib
176178
export LIBVA_DRIVERS_PATH=/usr/lib/x86_64-linux-gnu/dri
177179
export GST_VA_ALL_DRIVERS=1
178180
export PATH=/opt/intel/dlstreamer/gstreamer/bin:/opt/intel/dlstreamer/bin:$PATH
179181
export GST_PLUGIN_FEATURE_RANK=${GST_PLUGIN_FEATURE_RANK},ximagesink:MAX
180-
export GI_TYPELIB_PATH=/opt/intel/dlstreamer/gstreamer/lib/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1. 0
182+
export GI_TYPELIB_PATH=/opt/intel/dlstreamer/gstreamer/lib/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1.0
181183
```
182184

183185
- **Ubuntu 22**
184186

185187
```bash
186188

187189
export LIBVA_DRIVER_NAME=iHD
188-
export GST_PLUGIN_PATH=/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:/opt/intel/ dlstreamer/streamer/lib/
189-
export LD_LIBRARY_PATH=/opt/intel/dlstreamer/gstreamer/lib:/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/lib/ gstreamer-1.0:/sr/lib:/opt/intel/dlstreamer/lib:/usr/local/lib/gstreamer-1.0:/usr/local/lib:/opt/opencv:/opt/rdkafka
190+
export GST_PLUGIN_PATH=/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:/opt/intel/dlstreamer/streamer/lib/
191+
export LD_LIBRARY_PATH=/opt/intel/dlstreamer/gstreamer/lib:/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/lib/gstreamer-1.0:/sr/lib:/opt/intel/dlstreamer/lib:/usr/local/lib/gstreamer-1.0:/usr/local/lib:/opt/opencv:/opt/rdkafka
190192
export LIBVA_DRIVERS_PATH=/usr/lib/x86_64-linux-gnu/dri
191193
export GST_VA_ALL_DRIVERS=1
192194
export PATH=/opt/intel/dlstreamer/gstreamer/bin:/opt/intel/dlstreamer/bin:$PATH
193195
export GST_PLUGIN_FEATURE_RANK=${GST_PLUGIN_FEATURE_RANK},ximagesink:MAX
194-
export GI_TYPELIB_PATH=/opt/intel/dlstreamer/gstreamer/lib/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1. 0
196+
export GI_TYPELIB_PATH=/opt/intel/dlstreamer/gstreamer/lib/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1.0
195197
```
196198

197199
- **Fedora 41**
198200

199201
```bash
200202
export LIBVA_DRIVER_NAME=iHD
201-
export GST_PLUGIN_PATH=/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:/opt/intel/ dlstreamer/gstreamer/lib/
202-
export LD_LIBRARY_PATH=/opt/intel/dlstreamer/gstreamer/lib:/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/lib/ gstreamer-1.0:/usr/lib:/opt/intel/dlstreamer/lib:/usr/local/lib/gstreamer-1.0:/usr/local/lib:/opt/opencv:/opt/ rdkafka:/opt/ffmpeg
203+
export GST_PLUGIN_PATH=/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:/opt/intel/dlstreamer/gstreamer/lib/
204+
export LD_LIBRARY_PATH=/opt/intel/dlstreamer/gstreamer/lib:/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/lib/gstreamer-1.0:/usr/lib:/opt/intel/dlstreamer/lib:/usr/local/lib/gstreamer-1.0:/usr/local/lib:/opt/opencv:/opt/rdkafka:/opt/ffmpeg
203205
export LIBVA_DRIVERS_PATH=/usr/lib64/dri-nonfree
204206
export GST_VA_ALL_DRIVERS=1
205207
export PATH=/opt/intel/dlstreamer/gstreamer/bin:/opt/intel/dlstreamer/bin:$PATH
206208
export GST_PLUGIN_FEATURE_RANK=${GST_PLUGIN_FEATURE_RANK},ximagesink:MAX
207-
export GI_TYPELIB_PATH=/opt/intel/dlstreamer/gstreamer/lib/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1. 0
209+
export GI_TYPELIB_PATH=/opt/intel/dlstreamer/gstreamer/lib/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1.0
208210
```
209211

210212
or run:

libraries/dl-streamer/samples/gstreamer/benchmark/README.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -27,17 +27,17 @@ or use any other media/video file.
2727

2828
Benchmark video decode and inference on single model (using gvainference element):
2929
```sh
30-
./benchmark_one_model.sh VIDEO_FILE [MODEL_PATH] [DECODE_DEVICE] [INFERENCE_DEVICE] [NUMBER_STREAMS] [NUMBER_PROCESSES] [DECODE_ELEMENT] [SINK_ELEMENT]
30+
./benchmark_one_model.sh VIDEO_FILE [MODEL_PATH] [DECODE_DEVICE] [INFERENCE_DEVICE] [NUMBER_STREAMS] [NUMBER_PROCESSES] [DECODE_ELEMENT] [INFERENCE_ELEMENT] [SINK_ELEMENT]
3131
```
3232

3333
Benchmark video decode and inference on two models (object detection and object classification models) using gvadetect and gvaclassify elements:
3434
```sh
35-
./benchmark_two_models.sh VIDEO_FILE [MODEL1_PATH] [MODEL2_PATH] [DECODE_DEVICE] [INFERENCE_DEVICE] [NUMBER_STREAMS] [NUMBER_PROCESSES] [DECODE_ELEMENT] [SINK_ELEMENT]
35+
./benchmark_two_models.sh VIDEO_FILE [MODEL1_PATH] [MODEL2_PATH] [DECODE_DEVICE] [INFERENCE_DEVICE] [NUMBER_STREAMS] [NUMBER_PROCESSES] [DECODE_ELEMENT] [INFERENCE1_ELEMENT] [INFERENCE2_ELEMENT] [SINK_ELEMENT]
3636
```
3737

38-
The sample `benchmark_one_model.sh` takes one to eight command-line parameters (last seven are optional):
39-
1. [INPUT_VIDEO] to specify input video file
40-
2. [MODEL] to specify model in OpenVINO™ toolkit IR format. Default is `face-detection-adas-0001` model in `INT8` precision.
38+
The sample `benchmark_one_model.sh` takes one to eight command-line parameters (last eight are optional):
39+
1. [VIDEO_FILE] to specify a path to input video file
40+
2. [MODEL_PATH] to specify a path to model in OpenVINO™ toolkit IR format. Default is `face-detection-adas-0001` model in `INT8` precision.
4141
3. [DECODE_DEVICE] to specify device for video decode, could be
4242
* CPU (Default)
4343
* GPU
@@ -48,8 +48,9 @@ The sample `benchmark_one_model.sh` takes one to eight command-line parameters (
4848
* ...
4949
5. [NUMBER_STREAMS] number of simultaneous streams to benchmark
5050
6. [NUMBER_PROCESSES] number of processes. If multiple processes, streams distributed equally across processes
51-
7. [DECODE_ELEMENT] element (or pipeline of elements in gst-launch format) for demuxing and video decoding. Default is 'decodebin3'
52-
8. [SINK_ELEMENT] sink element (or pipeline of elements in gst-launch format), default is `fakesink async=false`
51+
7. [DECODE_ELEMENT] element (or pipeline of elements in gst-launch format) for demuxing and video decoding. Default is `decodebin3`
52+
8. [INFERENCE_ELEMENT] DL Streamer pipeline element to perform the inference, default is `gvainference`
53+
9. [SINK_ELEMENT] sink element (or pipeline of elements in gst-launch format), default is `fakesink async=false`
5354

5455
The sample `benchmark_one_model.sh` has similar parameters with additional parameter for second model.
5556

libraries/dl-streamer/samples/gstreamer/benchmark/benchmark_one_model.sh

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@
88
set -e
99

1010
if [ -z "${MODELS_PATH:-}" ]; then
11-
echo "Error: MODELS_PATH is not set." >&2
11+
echo "Error: MODELS_PATH is not set." >&2
1212
exit 1
13-
else
13+
else
1414
echo "MODELS_PATH: $MODELS_PATH"
1515
fi
1616

@@ -27,12 +27,12 @@ SINK_ELEMENT=${9:-"fakesink async=false"}
2727
# check if model exists in local directory
2828
if [ ! -f $MODEL_PATH ]; then
2929
echo "Model not found: ${MODEL_PATH}"
30-
exit
30+
exit
3131
fi
3232

3333
if [ -z "${1}" ]; then
3434
echo "ERROR set path to video"
35-
echo "Usage : ./benchmark_one_model.sh VIDEO_FILE [MODEL_PATH] [DECODE_DEVICE] [INFERENCE_DEVICE] [NUMBER_STREAMS] [NUMBER_PROCESSES] [DECODE_ELEMENT] [SINK_ELEMENT]"
35+
echo "Usage : ./benchmark_one_model.sh VIDEO_FILE [MODEL_PATH] [DECODE_DEVICE] [INFERENCE_DEVICE] [NUMBER_STREAMS] [NUMBER_PROCESSES] [DECODE_ELEMENT] [INFERENCE_ELEMENT] [SINK_ELEMENT]"
3636
echo "You can download video with"
3737
echo "\"curl https://raw.githubusercontent.com/intel-iot-devkit/sample-videos/master/head-pose-face-detection-female-and-male.mp4 --output /path/to/your/video/head-pose-face-detection-female-and-male.mp4\""
3838
echo "and run sample ./benchmark.sh /path/to/your/video/head-pose-face-detection-female-and-male.mp4"

libraries/dl-streamer/samples/gstreamer/benchmark/benchmark_two_models.sh

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@
88
set -e
99

1010
if [ -z "${MODELS_PATH:-}" ]; then
11-
echo "Error: MODELS_PATH is not set." >&2
11+
echo "Error: MODELS_PATH is not set." >&2
1212
exit 1
13-
else
13+
else
1414
echo "MODELS_PATH: $MODELS_PATH"
1515
fi
1616

@@ -29,18 +29,18 @@ SINK_ELEMENT=${11:-"fakesink async=false"}
2929
# check if model exists in local directory
3030
if [ ! -f $MODEL1_PATH ]; then
3131
echo "Model not found: ${MODEL1_PATH}"
32-
exit
32+
exit
3333
fi
3434

3535
# check if model exists in local directory
3636
if [ ! -f $MODEL2_PATH ]; then
3737
echo "Model not found: ${MODEL2_PATH}"
38-
exit
38+
exit
3939
fi
4040

4141
if [ -z "${1}" ]; then
4242
echo "ERROR set path to video"
43-
echo "Usage : ./benchmark_two_models.sh VIDEO_FILE [MODEL1_PATH] [MODEL2_PATH] [DECODE_DEVICE] [INFERENCE_DEVICE] [NUMBER_STREAMS] [NUMBER_PROCESSES] [DECODE_ELEMENT] [SINK_ELEMENT]"
43+
echo "Usage : ./benchmark_two_models.sh VIDEO_FILE [MODEL1_PATH] [MODEL2_PATH] [DECODE_DEVICE] [INFERENCE_DEVICE] [NUMBER_STREAMS] [NUMBER_PROCESSES] [DECODE_ELEMENT] [INFERENCE1_ELEMENT] [INFERENCE2_ELEMENT] [SINK_ELEMENT]"
4444
echo "You can download video with"
4545
echo "\"curl https://raw.githubusercontent.com/intel-iot-devkit/sample-videos/master/head-pose-face-detection-female-and-male.mp4 --output /path/to/your/video/head-pose-face-detection-female-and-male.mp4\""
4646
echo "and run sample ./benchmark.sh /path/to/your/video/head-pose-face-detection-female-and-male.mp4"

0 commit comments

Comments
 (0)