People Analytics
Analitik video real-time untuk menghitung orang yang melintas, memantau zona, mendeteksi orang yang berdiam, dan mengestimasi kepadatan — dengan atribut demografis opsional.
Pengenalan
People Analytics adalah keluarga pipeline analitik video real-time yang mendeteksi dan melacak orang (atau kepala) dalam stream video untuk menghitung jumlah yang melintasi garis, memantau zona (ROI), mendeteksi orang yang berdiam di suatu area, dan mengestimasi kepadatan secara periodik. Beberapa varian juga mengklasifikasikan atribut visual seperti usia, gender, dan warna pakaian pada setiap orang yang terdeteksi.
Tersedia delapan varian pipeline yang terbagi menjadi dua kelas:
- Multi-Logics — satu pipeline dapat menjalankan counting, ROI counting, dwelling, dan density sekaligus pada stream yang sama (
NFV4-MPA,NFV4-MPAA,NFV4-MPA2). - Sederhana — satu pipeline hanya menjalankan satu logic yang selalu aktif, dengan parameter yang jauh lebih ringkas (
NFV4-PC,NFV4-PCA,NFV4-HC,NFV4-PD,NFV4-HD).
Dokumentasi People Analytics dibagi menjadi beberapa halaman. Mulai dari Varian & Cara Kerja untuk memilih pipeline yang sesuai, lalu pastikan kamera memenuhi Persyaratan. Referensi endpoint ada di API Reference.
Varian & Cara Kerja
Tabel delapan varian, perbedaan Multi-Logics vs Sederhana, dan alur pemrosesan dari frame video sampai event.
Persyaratan
Spesifikasi kamera dan panduan penempatan kamera untuk counting, ROI, dwelling, dan density.
Konfigurasi
Semua parameter pipeline per varian, format area garis/polygon, dan environment variable.
Best Practices & Troubleshooting
Penempatan kamera, tuning threshold, keterbatasan, dan runbook untuk pesan error umum.
API Reference
Endpoint pipeline, event channel WebSocket, dan struktur event JSON.
Kemampuan
- Counting garis virtual — menghitung orang (atau kepala) yang melewati garis, dengan arah masuk/keluar/keduanya (
countingpada varian Multi-Logics;NFV4-PC/NFV4-PCA/NFV4-HCpada varian sederhana). - ROI counting — menghitung orang yang melintasi tepi zona polygon (
roi_counting, hanya pada varian Multi-Logics). - Dwelling — mendeteksi dan mengukur durasi orang berdiam di suatu ROI, dengan opsi alert dini jika durasi melewati ambang (
dwellingpada Multi-Logics;NFV4-PDpada varian sederhana, tanpa parameter tuning). - Density — estimasi jumlah orang dalam ROI secara periodik (
densitypada Multi-Logics;NFV4-HDpada varian sederhana, berbasis deteksi kepala). - Atribut demografis & visual (
NFV4-MPAA,NFV4-MPA2) — usia, gender, masker, kacamata, penutup kepala, warna pakaian, dan padaNFV4-MPA2juga jenis pakaian, ekspresi wajah, warna alas kaki, serta barang bawaan. Hanya threshold confidence yang bisa dikonfigurasi — tidak ada cara mengaktifkan/menonaktifkan atribut tertentu. - Deteksi berbasis kepala (
NFV4-HC,NFV4-HD) — cocok untuk kamera bersudut curam/top-down di area padat, tempat tubuh bagian bawah sering terhalang.
Yang TIDAK Dilakukan
- Identifikasi atau pengenalan wajah — gunakan Face Recognition untuk itu.
- Pelacakan orang lintas kamera (cross-camera tracking) — setiap pipeline hanya melacak dalam satu stream.
- Atribut pada
NFV4-PCA— pipeline ini mencoba memanggil endpoint atribut, tetapi hasilnya tidak pernah tergabung ke event pada versi ini (lihat Varian & Cara Kerja). - Tuning dwelling lanjutan pada
NFV4-PD— hanyaobject_confidence_thresholddanareasyang berpengaruh; gunakan sub-analyticdwellingpadaNFV4-MPA*jika butuh kontrol ambang alert/idle time/durasi minimum. - Pengenalan plat kendaraan atau analisis kendaraan — gunakan License Plate Recognition atau modul Vehicle Analytics.
Use Cases
Retail — Foot Traffic
Hitung pengunjung masuk/keluar toko dengan NFV4-PC/NFV4-MPA dan analisis tren kunjungan harian atau mingguan.
Mall & Pusat Perbelanjaan
Pahami demografi pengunjung (usia, gender, pakaian) dengan NFV4-MPAA/NFV4-MPA2 untuk perencanaan tenant dan marketing.
Keamanan — Loitering Detection
Deteksi orang yang berdiam terlalu lama di area ATM, lobi, atau zona restricted dengan sub-analytic dwelling pada NFV4-MPA.
Gedung & Office — Occupancy
Monitor kepadatan meeting room, lobby, atau area kerja secara periodik dengan sub-analytic density atau NFV4-HD.
Kerumunan Padat — Sudut Top-Down
Gunakan NFV4-HC/NFV4-HD (deteksi kepala) untuk counting dan density di area padat dengan kamera bersudut curam.
Modul Terkait
API Reference — License Plate Recognition
Endpoint REST API untuk membuat pipeline License Plate Recognition pada stream Visionaire4, event streaming hasil OCR via WebSocket, dan struktur event JSON.
Varian & Cara Kerja
Delapan varian pipeline People Analytics, perbedaan antara Multi-Logics dan Counting/Dwelling/Density sederhana, dan alur pemrosesan dari frame video sampai event.