Add docs for statistics sensor (home-assistant#999)

fabaff · web-flow · commit 8aa97d02c50b · 2016-10-04T13:23:17.000+02:00
* Add docs for statistics sensor

* Minimizing of the configuration sample

* Fix typo
diff --git a/source/_components/sensor.statistics.markdown b/source/_components/sensor.statistics.markdown
@@ -0,0 +1,35 @@
+---
+layout: page
+title: "Statistics Sensor"
+description: "Instructions how to integrate statistical sensors into Home Assistant."
+date: 2016-09-28 12:10
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: home-assistant.png
+ha_category: Sensor
+ha_iot_class: "Local Polling"
+ha_release: "0.30"
+---
+
+
+The `statistics` sensor platform is consuming the state from other sensors. Beside the maximal and the minimal value also the total, the mean, the median, the variance, and the standard deviation are as attributes available. If it's a binary sensor then only the state changes are counted.
+
+To enable the statistics sensor, add the following lines to your `configuration.yaml`:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  - platform: statistics
+    entity_id: sensor.cpu
+  - platform: statistics
+    entity_id: binary_sensor.movement
+```
+
+Configuration variables:
+
+- **entity_id** (*Required*): The entity to monitor.
+- **name** (*Optional*): Name of the sensor to use in the frontend.
+- **sampling_size** (*Optional*): Size of the sampling. If the limit is reached then the values are rotated. Defaults to `20`.
+
