MOG2

The mog2 component uses the BackgroundSubtractorMOG2 algorithm built into OpenCV

The algorithm is very similar to the one used in the background_subractor component. What separates them is the fact that mog2 can detect shadows and filter those out, providing a slightly more accurate motion detector.

Configuration

Configuration example

mog2map required

MOG2 configuration.

motion_detectormap required

Motion detector domain config.

camerasmap required

Camera-specific configuration. All subordinate keys corresponds to the camera_identifier of a configured camera.

<CAMERA_IDENTIFIER>map required

Camera identifier. Valid characters are lowercase a-z, numbers and underscores.

trigger_recorderboolean deprecated

DEPRECATED. Use trigger_event_recording instead.

If true, detected motion will start the recorder.

trigger_event_recordingboolean (optional, default: false)

If true, detected motion will trigger an event recording.

recorder_keepaliveboolean (optional, default: true)

If true, recording will continue until no motion is detected.

max_recorder_keepaliveinteger (optional, default: 30)

Value in seconds for how long motion is allowed to keep the recorder going when no objects are detected.
Use this to prevent never-ending recordings.
Only applicable if recorder_keepalive: true.
A value of 0 disables this functionality.

Lowest value: 0

fpsfloat (optional, default: 1)

The FPS at which the motion detector runs.
Higher values will result in more scanning, which uses more resources.

Lowest value: 0

areafloat (optional, default: 0.08)

How big the detected area must be in order to trigger motion.

Lowest value: 0

Highest value: 1

widthinteger (optional, default: 300)

Frames will be resized to this width before applying the motion detection algorithm to save computing power.

heightinteger (optional, default: 300)

Frames will be resized to this height before applying the motion detection algorithm to save computing power.

masklist (optional)

A mask is used to exclude certain areas in the image from motion detection.

coordinateslist required

List of X and Y coordinates to form a polygon

Minimum items: 3

xinteger required

X-coordinate (horizontal axis).

yinteger required

Y-coordinate (vertical axis).

thresholdinteger (optional, default: 15)

The minimum allowed difference between our current frame and averaged frame for a given pixel to be considered motion. A smaller value leads to higher sensitivity and a larger value leads to lower sensitivity.

Lowest value: 0

Highest value: 255

historyinteger (optional, default: 500)

The number of last frames that affect the background model.

detect_shadowsboolean (optional, default: false)

Enable/disable shadow detection. If enabled, shadows will be considered as motion at the expense of some extra resources.

learning_ratefloat (optional, default: 0.01)

How fast the background model learns. 0 means that the background model is not updated at all, 1 means that the background model is completely reinitialized from the last frame. Negative values gives an automatically chosen learning rate.

Lowest value: -1

Highest value: 1

Motion detector

A motion detector scans an image for moving parts.

info

Detected motion can, if configured, signal an object detector to start scanning. This is good because object detection uses far more resources compared to motion detection.

Recorder

A motion detector can start the recorder if trigger_event_recording is set to true, meaning an object detector is not strictly needed.

Mask

Masks are used to exclude certain areas in the image from motion detection. All movement within the mask will be ignored.

The coordinates form a polygon around the masked area.
To easily generate coordinates you can use a tool like image-map.net.
Just upload an image from your camera, choose the Poly shape and start drawing your mask.
Then click Show me the code! and adapt it to the config format.
Coordinates coords="522,11,729,275,333,603,171,97" should be turned into this:

mog2:
  motion_detector:
    cameras:
      camera_one:
        ...
        mask:
          - coordinates:
              - x: 522
                y: 11
              - x: 729
                y: 275
              - x: 333
                y: 603
              - x: 171
                y: 97

Paste your coordinates here and press Get config to generate a config example

Troubleshooting

To enable debug logging for mog2, add the following to your config.yaml

/config/config.yaml
logger:
  logs:
    viseron.components.mog2: debug

MOG2

Configuration​

Motion detector​

Mask​

Troubleshooting​

Configuration

Motion detector

Mask

Troubleshooting