Opencv

source/_components/image_processing.opencv.markdown

@@ -0,0 +1,18 @@
+---
+layout: page
+title: "OpenCV"
+description: "Instructions how to integrate OpenCV image processing into Home Assistant."
+date: 2017-01-25 00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: OpenCV_Logo.png
+ha_category: Image Processing
+featured: false
+ha_release: 0.44
+---
+
+The `opencv` image processing platform allows you to create a standalone image processor without the linked camera entity as mentioned in the [OpenCV page](https://home-assistant.io/components/opencv).
+
+Please refer to the [component](/components/opencv/) configuration on how to setup the image processor.

source/_components/opencv.markdown

@@ -0,0 +1,76 @@
+---
+layout: page
+title: "OpenCV"
+description: "Instructions how to setup OpenCV within Home Assistant."
+date: 2017-04-01 22:36
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: OpenCV_Logo.png
+ha_category: Hub
+ha_release: 0.44
+ha_iot_class: "Local Push"
+---
+
+[OpenCV](https://www.opencv.org) is an open source computer vision image and video processing library.
+
+Some pre-defined classifiers can be found here: https://github.com/opencv/opencv/tree/master/data
+
+### {% linkable_title Configuration %}
+
+To setup OpenCV with Home Assistant, add the following section to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+
+opencv:
+  classifier_group:
+    - name: Family
+      add_camera: True
+      entity_id:
+        - camera.front_door
+        - camera.living_room
+      classifier:
+        - file_path: /path/to/classifier/face.xml
+          name: Bob
+        - file_path: /path/to/classifier/face_profile.xml
+          name: Jill
+          min_size: (20, 20)
+          color: (255, 0, 0)
+          scale: 1.6
+          neighbors: 5
+        - file_path: /path/to/classifier/kid_face.xml
+          name: Little Jimmy
+```
+
+Configuration variables:
+
+- **name** (*Required*): The name of the OpenCV image processor.
+- **entity_id** (*Required*): The camera entity or list of camera entities that this classification group will be applied to.
+- **classifier** (*Required*): The classification configuration for to be applied:
+  - **file_path** (*Required*): The path to the HAARS or LBP classification file (xml).
+  - **name** (*Optional*): The classification name, the default is `Face`.
+  - **min_size** (*Optional*): The minimum size for detection as a tuple `(width, height)`, the default is `(30, 30)`.
+  - **color** (*Optional*): The color, as a tuple `(Blue, Green, Red)` to draw the rectangle when linked to a dispatcher camera, the default is `(255, 255, 0)`.
+  - **scale** (*Optional*): The scale to perform when processing, this is a `float` value that must be greater than or equal to `1.0`, default is `1.1`.
+  - **neighbors** (*Optional*): The minimum number of neighbors required for a match, default is `4`. The higher this number, the more picky the matching will be; lower the number, the more false positives you may experience.
+
+Once OpenCV is configured, it will create an `image_processing` entity for each classification group/camera entity combination as well as a camera so you can see what Home Assistant sees.
+
+The attributes on the `image_processing` entity will be:
+
+```json
+'matches': {
+  'Bob': [
+    (x, y, w, h)
+  ],
+  'Jill': [
+    (x, y, w, h)
+  ],
+  'Little Jimmy': [
+    (x, y, w, h)
+  ]
+}
+```
+