Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip

Creating Detection Tools

General Information on Configuring Detection

Extra information overlay (Masks)

To configure a VMD:

...

Video stream and scene requirements for the Motion detector and its sub-detectors

Image requirements for the Motion detector and its sub-detectors

To configure the Motion detector, do the following:

  1. Go to the Detectors tab.
  2. Below the required camera, click Create…  Category: Trackers → Motion detector.

The Motion detector is based on detecting differences between the current frame and the static background, and it generates an event when there is a movement in the camera FOV.

You can set a number of parameters for all sub-detectors of the Motion detector at the same time.

If necessary, you can change the detector parameters. The list of parameters is given in the table:

ParameterValueDescription
Object features
Record mask to archiveYesBy default, mask is recorded to the archive. To disable the parameter, select the No value
No
Record objects trackingYes

By default, object tracks are recorded to the database. To disable the parameter, select the No value.

Note
titleAttention!

To obtain metadata, video is decompressed and analyzed, which results in a heavy load on the server and limits the number of cameras that you can use on it.

No
Video streamMain stream

If the camera supports multistreaming, select

...

the stream for which detection is needed

...

. Selecting a low

...

quality video stream

...

reduces the load on the

...

server.

...

In the Alarm end delay field, set a value in seconds for the time interval within which the detection tool remains triggered after motion stops (4). If motion is re-detected within this interval, no new event will be created.

...

Note
titleAttention!

To ensure the correct display of streams on a multi-stream camera, all video streams must have the same frame aspect ratio.

Other
EnableYesBy default, the detector is enabled. To disable, select the No value
No
NameMotion detectorEnter the detector name or leave the default name
Decode key framesYes

By default, the parameter is disabled. This parameter reduces the load on the server, but at the same time the detection quality decreases.

If you want to decode key frames only, select the Yes value. We recommend enabling this parameter for "blind" (without video image display) servers, on which you want to perform detection.

 For the MJPEG codec, decoding isn’t relevant, as each frame is considered a key frame.

Note
title

...

This setting applies to all codecs. If a codec has keyframes and p-frames, the keyframe is decoded no more often than every 500 milliseconds. For the MJPEG codec, each frame is considered to be I-frame.

This feature reduces the Server load but, as can be expected, negatively impacts the quality of detection.

Attention!

The Number of frames processed per second and Decode key frames parameters are interrelated.

If a local client isn’t connected to the server, the following rules work for remote clients:

  • If the key frame rate is less than the value specified in the Number of frames processed per second field, the detector will work by key frames.
  • If the key frame rate is greater than the value specified in the Number of frames processed per second field, the detection will be performed according to the set period.

If a local client is connected to the server, the detector will always work according to the set period. After disconnecting the local client, the above rules will be relevant again.

No
Decoder modeAuto

...

Select a processing resource for decoding video streams

...

. When you select a GPU, a stand-alone graphics card takes priority (when decoding with

...

Nvidia NVDEC chips). If there

...

is no appropriate GPU, the decoding will use the Intel Quick Sync Video technology. Otherwise, CPU resources will be used for decoding
CPU
GPU
HuaweiNPU
TypeMotion detectorName of the detector type (non-editable field)
Advanced settings
Alarm end delay10Enter the time in seconds during which the generation of an event won't stop after the motion stops.

...

If motion is detected again within the specified time, it will be considered as one event
Camera positionWallTo eliminate false events from the detector when using a fisheye camera (see Configuring fisheye cameras), select the correct device location
Ceiling
Motion maskYes

By default, motion mask is enabled.

Image Added

  • If motion doesn't exceed the Sensitivity: Contrast and Sensitivity: Size parameters, the mask cells are colored green.
  • If motion generates an event, the cells are colored red.

To disable the parameter, select the No value.

No
Object trackingYes

By default, the parameter is disabled. Select the Yes value to operate the sub-detectors and to display tracks and parameters (width and height as a percentage of the frame width or height and color) of tracking objects in the preview window:

Image Added

No
Track lifespan (starting with Detector Pack 3.14)
Yes

By default, the parameter is disabled. If you want to display the track lifespan for an object in seconds, select the Yes value

 

No
Basic settings
Sensitivity: Contrast12

Specify the values of sensitivity to contrast and object size depending on the scene in the frame:

  • Sensitivity: Contrast. The value must be in the range [0

...

  • ,

...

  • 20]
  • Sensitivity: Size. 

...

  • The value must be in the range [0, 20]

By default, the values of medium sensitivity are used. These values are recommended for most scenes:

  • Sensitivity: Contrast12.
  • Sensitivity: Size9.

If objects are far away and small in size, the maximum sensitivity is required. Recommended values:

  • Sensitivity: Contrast16.
  • Sensitivity: Size10.

If a camera is located indoors with a distance to objects of about four meters, the minimum sensitivity is required. Recommended values:

  • Sensitivity: Contrast8.
  • Sensitivity: Size8.

Sensitivity: Size

9

By default, the entire frame is a detection area. If necessary, in the preview window, set:

Info
titleNote

For convenience of configuration, you can "freeze" the frame. Click the Image Added button. To cancel the action, click this button again.

The detection area is displayed by default. To hide it, click the Image Added button. To cancel the action, click this button again.

To save the parameters of the detector, click the Apply Image Added button. To cancel the changes, click the Cancel Image Added button.

Configuration of the Motion detector is complete. If necessary, you can create and configure the necessary sub-detectors on the basis of the Motion detector (see Standard sub-detectors).

...

The VMD analyzes differences between the current frame and the static background (11, 12). Depending on a particular scene, we recommend the following sensitivity values for contrast and size:

  1. Maximum sensitivity (street scenes where target objects are smaller):

    1. Sensitivity: contrast = 16.

    2. Sensitivity: size = 10.

  2. Medium sensitivity (default values for generic scenes):

    1. Sensitivity: contrast = 12.

    2. Sensitivity: size = 9.

  3. Low sensitivity (indoor cameras with an average distance to object of ca. 4m):

    1. Sensitivity: contrast = 8.

    2. Sensitivity: size = 8.

      For your convenience with setting sensitivity value, in the preview window you can see the Motion mask. To disable it, select No in the Motion mask (9) field.

      Image Removed
      If there is motion, but it does not exceed the threshold value (because of the detection sensitivity), the mask cells are colored green. If motion triggers VMD, the cells turn red.

...

To get tracked objects and their parameters (percentage of the FoV width/height, color) displayed in the Preview window, select Yes in the Object tracking field (10). 

...

Click Apply.

VMD configuration is now complete.

...