Konfigurasi

Referensi lengkap parameter body pipeline Crowd Estimation — areas, interval, dan confidence.

Parameter di halaman ini dikirim sebagai body JSON saat membuat pipeline (POST /pipeline/{node_num}/{stream_id}/NFV4-CE) atau mengubahnya (PUT pada endpoint yang sama tanpa perlu restart pipeline).

Dibandingkan pipeline analitik lain (mis. Face Recognition), Crowd Estimation punya permukaan konfigurasi yang jauh lebih kecil: tidak ada preset, tidak ada environment variable, dan tidak ada argumen CLI khusus untuk pipeline ini. Semua tuning dilakukan lewat tiga parameter body berikut.

Parameter

Parameter	Fungsi	Default	Kapan diubah
`areas`	Daftar ROI polygon tempat estimasi dihitung. Lihat Format `areas` di bawah.	Jika tidak dikirim, satu ROI bernama `"default"` yang mencakup seluruh frame otomatis dipakai.	Selalu kirim `areas` eksplisit untuk memberi nama area yang bermakna pada event dan membatasi cakupan estimasi pada zona yang relevan.
`interval`	Jumlah frame (pipeline berjalan 1 FPS, sehingga secara praktis ≈ detik) antara setiap event dump per ROI. Rentang valid: 1–99999.	`10`	Naikkan (30–60) untuk mengurangi volume event pada skenario historis; turunkan (5) untuk respons lebih cepat pada alert overcrowding.
`confidence`	Confidence threshold minimum yang dipakai model crowd counting utama saat memfilter titik hasil deteksi.	`0.7`	Turunkan jika kerumunan padat tampak under-count; naikkan jika banyak noise/false point pada kerumunan renggang.

confidence dibaca langsung dari body request oleh service crowd counting, tetapi tidak termasuk dalam daftar parameter yang dikembalikan GET /config/pipeline/NFV4-CE/ (hanya areas dan interval yang terdaftar di sana). Parameter ini tetap berfungsi jika dikirim, tetapi perlakukan sebagai parameter lanjutan yang kurang terdokumentasi resmi dibanding areas/interval.

Format `areas`

areas adalah array objek ROI — bukan object yang key-nya nama area. Setiap entri minimal berisi name dan points (minimal 3 titik):

{
  "areas": [
    {
      "name": "Plaza Utama",
      "roi_type": "whitelist",
      "points": [
        { "x": 0.1, "y": 0.1 },
        { "x": 0.9, "y": 0.1 },
        { "x": 0.9, "y": 0.9 },
        { "x": 0.1, "y": 0.9 }
      ]
    }
  ],
  "interval": 10
}

Field	Tipe	Wajib	Keterangan
`name`	string	Ya	Nama area — muncul sebagai `pipeline_data.area` pada setiap event dari ROI ini.
`points`	array of `{x, y}`	Ya, minimal 3 titik	Koordinat polygon. Nilai `0.0–1.0` diperlakukan sebagai koordinat relatif terhadap dimensi frame; nilai `> 1` dipotong ke lebar/tinggi frame, nilai `< 0` dipotong ke `0`.
`roi_type`	string	Tidak	`"whitelist"` (default) atau `"blacklist"`. Catatan: pada Crowd Estimation, field ini diterima dan divalidasi tetapi tidak memengaruhi penghitungan — titik yang jatuh di dalam polygon selalu dihitung, terlepas dari nilai `roi_type`.

Contoh dengan beberapa ROI dalam satu pipeline:

{
  "areas": [
    {
      "name": "Pintu Masuk",
      "points": [
        { "x": 0.0, "y": 0.0 },
        { "x": 0.4, "y": 0.0 },
        { "x": 0.4, "y": 1.0 },
        { "x": 0.0, "y": 1.0 }
      ]
    },
    {
      "name": "Area Tengah",
      "points": [
        { "x": 0.4, "y": 0.0 },
        { "x": 1.0, "y": 0.0 },
        { "x": 1.0, "y": 1.0 },
        { "x": 0.4, "y": 1.0 }
      ]
    }
  ],
  "interval": 30
}

Setiap ROI menghasilkan event terpisah pada setiap interval. Jika Anda mendefinisikan 3 ROI, setiap interval akan menerbitkan 3 event — satu per area.

Membaca Konfigurasi Aktif

GET /config/pipeline/NFV4-CE/ (atau GET /v2/config/pipeline/NFV4-CE/) mengembalikan nilai default dan areas yang sedang aktif untuk pipeline yang berjalan:

{
  "code": 200,
  "config": {
    "areas": {},
    "env": {},
    "args": {},
    "interval": 10
  }
}

env dan args selalu berupa object kosong untuk NFV4-CE — lihat catatan di bawah.

Preset Konfigurasi

Crowd Estimation tidak mendaftarkan preset apa pun (GET /config/preset/NFV4-CE/ tidak mengembalikan preset). Jika Anda butuh kombinasi parameter siap pakai untuk skenario tertentu (mis. interval pendek untuk alert real-time), simpan kombinasi tersebut di sisi aplikasi Anda dan kirim langsung sebagai body request.

Environment Variable & Argumen CLI

Crowd Estimation tidak memiliki environment variable maupun argumen CLI khusus pipeline — tidak ada pemanggilan utils::get_env(...) di dalam package ini, dan tidak ada argumen yang didaftarkan untuknya di master_controller. Seluruh parameter (areas, interval, confidence) hanya dapat diatur per pipeline lewat body request POST/PUT.