mxpi_qualitydetection

Function

Video quality diagnosis plugin, which can be used to analyze the quality of decoded video images and generate alarms in the case of exceptions.

The following detection scenarios are supported:

  • Abnormal brightness
  • Lens blocking
  • Image blur
  • Static noise
  • Color cast
  • Stripe noise
  • Signal loss
  • Frame freezing
  • Video jitter
  • Scene change
  • PTZ movement exception

Constraints

This plugin can be configured only after the video decoding plugin (mxpi_videodecoder) is configured.

Plugin Base Class (Factory)

mxpi_qualitydetection

Input/Output

Input: buffer (data type: MxpiBuffer) and metadata (data type: MxpiVisionList)

Output: buffer (data type: MxpiBuffer) and metadata (data type: MxpiVisionList)

Port Format (Caps)

Static input: {"image/yuv", "metadata/object"}

Static output: {"ANY"}

Property

For details, see Table 1.

Table 1 mxpi_qualitydetection plugin properties

Property Name

Description

Mandatory or Not

Modifiable or Not

dataSource

Index of the input data (generally the name of the upstream element). The default value is the key value of the output port of the upstream plugin.

No

Yes

qualityDetectionConfigContent

Quality detection algorithm properties. For details, see Table 2.

No

Yes

qualityDetectionConfigPath

Path of the quality detection algorithm property configuration file. Configure either this property or qualityDetectionConfigContent (recommended). For details, see Table 2.

No

Yes

Table 2 Quality detection algorithm properties

Property Name

Description

Default Value

FRAME_LIST_LEN

Length of the queue for storing video frames by the plugin

20

BRIGHTNESS_SWITCH

Switch of the brightness detection algorithm

false

BRIGHTNESS_FRAME_INTERVAL

Frame interval for brightness detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

BRIGHTNESS_THRESHOLD

Threshold for the brightness detection algorithm

1

OCCLUSION_SWITCH

Switch of the lens blocking detection algorithm

false

OCCLUSION_FRAME_INTERVAL

Frame interval for lens blocking detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

OCCLUSION_THRESHOLD

Threshold for the lens blocking detection algorithm

0.32

BLUR_SWITCH

Switch of the image blur detection algorithm

false

BLUR_FRAME_INTERVAL

Frame interval for image blur detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

BLUR_THRESHOLD

Threshold for the image blur detection algorithm

2000

NOISE_SWITCH

Switch of the noise detection algorithm

false

NOISE_FRAME_INTERVAL

Frame interval for noise detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

NOISE_THRESHOLD

Threshold for the noise detection algorithm

0.005

COLOR_CAST_SWITCH

Switch of the color cast detection algorithm

false

COLOR_CAST_FRAME_INTERVAL

Frame interval for color cast detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

COLOR_CAST_THRESHOLD

Threshold for the color cast detection algorithm

1.5

STRIPE_SWITCH

Switch of the stripe noise detection algorithm

false

STRIPE_FRAME_INTERVAL

Frame interval for stripe noise detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

STRIPE_THRESHOLD

Threshold for the stripe noise detection algorithm

0.0015

DARK_SWITCH

Switch of the black screen detection algorithm

false

DARK_FRAME_INTERVAL

Frame interval for video black screen detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

DARK_THRESHOLD

Threshold for the black screen detection algorithm

0.72

VIDEO_FREEZE_SWITCH

Switch of the frame freezing detection algorithm

false

VIDEO_FREEZE_FRAME_INTERVAL

Frame interval for frame freezing detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

VIDEO_FREEZE_THRESHOLD

Threshold for the frame freezing detection algorithm

0.1

VIEW_SHAKE_SWITCH

Switch of the video jitter detection algorithm

false

VIEW_SHAKE_FRAME_INTERVAL

Frame interval for video jitter detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

VIEW_SHAKE_THRESHOLD

Threshold for the video jitter detection algorithm

20

SCENE_MUTATION_SWITCH

Switch of the scene change detection algorithm

false

SCENE_MUTATION_FRAME_INTERVAL

Frame interval for scene change detection

The value must be a positive integer less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

SCENE_MUTATION_THRESHOLD

Threshold for the scene change detection algorithm

0.5

PTZ_MOVEMENT_SWITCH

Switch of the PTZ movement detection algorithm

false

PTZ_MOVEMENT_FRAME_INTERVAL

Frame interval for PTZ movement detection

The value must be a positive integer greater than 1 and less than the value of FRAME_LIST_LEN. If a decimal is entered, the value is automatically rounded down.

10

PTZ_MOVEMENT_THRESHOLD

Threshold for the PTZ movement detection algorithm

0.95