Grundlagen
Der primäre Zweck des Heatmap-Moduls / -Features ist das Zählen von Personen in abgeschlossenen Bereichen in der Realität (ab jetzt als „Räume“ bezeichnet).
Zu diesem Ziel müssen:
- In der Realität an jedem Eingang / Ausgang / Zugang zu den entsprechenden Räumen Kameras in Betrieb sein, welche alle eingehenden und ausgehenden Menschen zählen
- In NeuroomNet entsprechend die Kameras angebunden sein und die Räume entsprechend konfiguriert sein mit Zuordnung zu den Kameras
Kameras und Anbindung an NeuroomNet
Derzeit werden folgende Kameras von NeuroomNet zur Personenzählung unterstützt (ggf. auch verwandte mit gleicher API):
- Xovis PC2
- Xovis PC2R (neueres Modell)
Anmerkung: Im Kontext dieser Dokumentation verwenden wir die Begriffe "Kamera" und "Sensor" synonym. Die Dokumentation der Kameras differenziert zwischen diesen Begriffen (dort enthält ein Sensor genau genommen jeweils zwei integrierte Kameras).
Die o.g. Kameras unterstützen verschiedene Modi und Zählmöglichkeiten. Von den gegebenen (Zähl-)Möglichkeiten nutzt NeuroomNet Folgenden:
- Die Kameras müssen in der realen Welt irgendwo oben (an der Decke, hängend oder ähnlich) über den Eingängen befestigt werden, so dass sie nach unten schauen
- Die Kameras werden entsprechend konfiguriert, in welchem Sichtbereich genau gezählt wird und welche Bewegungs-Richtung zu eingehenden Menschen korrespondiert und welche Bewegungs-Richtung zu ausgehenden Menschen korrespondiert
- Die Kameras haben jeweils einen sog. Vorwärtszähler und einen sog. Rückwärtszähler
- Jeder eingehende Mensch erhöht den Vorwärtszähler um 1
- Jeder ausgehende Mensch erhöht den Rückwärtszähler um 1
- Diese Zähler innerhalb der Kameras werden normal nie zurückgesetzt, sondern deren Zahlen wachsen immer weiter an
- Die Kameras können bei Vorliegen bestimmter Voraussetzungen auch zu Zonen zusammengeschaltet werden in der Kamera-Konfigurations-Software von Xovis mit einer repräsentativen Master-Kamera, welche zusammen für die zusammengeschalteten Kameras eingehende und ausgehende Personen zählt. In einem solchen Fall kann NeuroomNet dann mit der jeweiligen Master-Kamera kommunizieren (Flag "Multiple Cameras combined" in Modul Setup).
- NeuroomNet pollt die Kameras in einem vorgegebenem Zeitintervall (Default und gleichzeitig Minimum ist einmal pro Minute) und besorgt sich dadurch die aktuellen Werte der jeweiligen Vorwärts- und Rückwärtszähler
Die Kameras sind in NeuroomNet als Komponenten vom Provider "Heatmap" repräsentiert. Zu den Kameras / Komponenten speichert NeuroomNet intern jeweils die aktuellen (d.h. zuletzt gepollten) Werte vom Vorwärts- und Rückwärtszähler, so dass NeuroomNet ermitteln kann nach jedem neuen Polling, wie viele Menschen eingehend und ausgehend waren.
Variablen zu Räumen und Kameras
Damit wirklich Personen gezählt werden und / oder entsprechende Zahlen nutzbar sind für die Anzeige oder Verwendung in Modulen wie den Skript Blöcken, Dashboards und Statistiken müssen (globale NeuroomNet-) Variablen angelegt werden inkl. Zuordnungen zu Kameras gemacht werden.
- Für jeden Raum legt man eine Variable von Typ Number an und i.d.R. weist man diese Variablen über das Feld "Counter" einer NeuroomNet Gruppe zu (siehe Modul Setup).
- Diesen Variablen lassen sich Kameras zuordnen, so dass dadurch dann automatisch die Variable den aktuellen Zählerstand der Personen im Raum enthält (siehe Modul Setup).
Im nächsten Kapitel werden die Benutzeroberflächen zur Einrichtung der Personenzählungs-Funktionalität vorgestellt.