Nodeflux Central
Crowd Estimation

Best Practices & Troubleshooting

Praktik terbaik, keterbatasan sistem, dan runbook untuk pesan yang muncul di log/side message Crowd Estimation.

Best Practices

Penempatan Kamera

Gunakan sudut elevated overview, bukan bird's-eye langsung ke bawah — model deteksi orang pelengkap mengasumsikan siluet tubuh masih terlihat. Lihat Persyaratan — Penempatan Kamera untuk detailnya.

Definisi ROI

  • Batasi areas pada zona yang benar-benar ingin dipantau — ROI yang jauh lebih kecil dari FOV kamera membuang resolusi efektif per orang setelah frame di-resize.
  • Beri name yang deskriptif ("Pintu Masuk Utara", "Area Panggung") karena nilai ini yang muncul pada pipeline_data.area di setiap event.
  • Selalu kirim ulang seluruh array areas setiap kali melakukan PUT, meskipun Anda hanya ingin mengubah interval. Konfigurasi tidak digabung (merge) secara parsial — jika areas tidak disertakan pada body PUT, pipeline kembali memakai ROI default tunggal yang mencakup seluruh frame.

Tuning Interval

  • Default interval: 10 cocok untuk monitoring real-time.
  • Naikkan ke 30–60 untuk skenario analitik historis yang tidak memerlukan respons cepat — ini juga mengurangi volume event.
  • Turunkan ke 5 jika Anda memerlukan respons lebih cepat untuk alert overcrowding.

Memahami Mode Pelengkap Kepadatan Rendah

Pipeline otomatis menyalakan model deteksi orang tambahan saat estimasi seluruh frame di bawah ±10 orang, dan mematikannya di atas ±500 orang. Ambang ini dihitung dari total frame, bukan per-ROI — jadi pada pipeline dengan beberapa ROI, penyalaan/pematian model pelengkap dipengaruhi kepadatan gabungan seluruh area, bukan kepadatan salah satu ROI saja. Perilaku ini tidak dapat dikonfigurasi.

Alerting

NFV4-CE tidak memiliki threshold alert bawaan. Implementasikan logika kapasitas di sisi aplikasi Anda, misalnya membandingkan pipeline_data.estimation terhadap batas kapasitas venue setiap event masuk.


Keterbatasan

  • Tidak ada tracker_id / identitas individu — NFV4-CE hanya menghasilkan angka estimasi agregat per ROI. Gunakan People Analytics untuk data per-individu.
  • Estimasi statistik, bukan hitungan exact — nilai estimation berasal dari jumlah titik yang jatuh dalam ROI selama satu interval, dirata-rata; ini adalah pendekatan, bukan sensus presisi.
  • Tidak ada parameter ukuran minimum objek — berbeda dari Face Recognition (fr_min_face_size), tidak ada filter ukuran yang bisa Anda tuning untuk menolak titik/objek yang terlalu kecil akibat FOV yang terlalu lebar.
  • roi_type diterima tetapi tidak berpengaruh — mengirim "roi_type": "blacklist" tidak membuat area tersebut dikecualikan dari penghitungan; kode filter titik pada Crowd Estimation selalu menghitung titik yang berada di dalam polygon, apa pun nilai roi_type-nya.
  • Ambang mode pelengkap bersifat tetap — batas 10/500/2 pada mekanisme kepadatan rendah adalah nilai internal (hardcoded), tidak dapat diubah lewat parameter API atau environment variable.
  • Frame rate pipeline tetap 1 FPS — tidak ada parameter untuk menaikkan sampling rate; ini cukup untuk estimasi kepadatan tetapi tidak untuk analitik gerakan cepat.
  • Konfigurasi areas tidak di-merge parsial — lihat catatan "Definisi ROI" di atas.
  • Tidak ada preset, environment variable, atau argumen CLI khusus — seluruh tuning hanya lewat areas, interval, dan confidence pada body request.

Troubleshooting

Gunakan docker logs <container_visionaire4> untuk melihat log lengkap. Sebagian pesan berikut adalah side message pipeline (terlihat di status pipeline/live view), sebagian lain hanya muncul di container log.

On this page