Cara Menyimpan Data Kamera ke File Teks untuk Proyek Nyata

Menyimpan data kamera ke file teks cukup satu baris per kejadian: waktu, isi frame, dan keterangan tambahan seperti kotak deteksi atau skor keyakinan. File teks memberi kamu riwayat yang bisa dibuka dengan aplikasi apa pun, tanpa perlu database atau library khusus. Untuk proyek pemula, cara ini paling cepat membuktikan bahwa pipeline kamera dan model berjalan.

Banyak orang baru menulis nilai mentah ke file begitu saja. Hasilnya panjang, berantakan, dan susah dicari saat ada bug. Alur di bawah ini lebih rapi, mulai dari pemilihan format sampai pembersihan log.

Pilih format teks sebelum menulis kode

Tiga format yang sering dipakai: teks polos dengan pemisah, CSV, dan JSON Lines. Masing-masing punya konsekuensi berbeda saat kamu harus membaca ulang.

  • Teks polos dengan pemisah seperti koma atau tab: paling sederhana, cocok untuk log cepat, tetapi rawan rusak kalau isi teks mengandung pemisah yang sama.
  • CSV: bisa dibuka langsung di spreadsheet, baik untuk data tabular seperti nomor frame, koordinat, dan label.
  • JSON Lines: satu baris berisi satu objek JSON, aman untuk struktur bersarang dan mudah dibaca script.

Kalau hasil deteksimu punya banyak properti per objek, pilih JSON Lines. Untuk sekadar mencatat timestamp dan jumlah objek, CSV lebih ringan. Panduan menyimpan hasil deteksi objek ke JSON di situs ini membahas struktur yang aman untuk data bersarang.

Susun kolom yang benar-benar kamu butuhkan

Kesalahan umum adalah menulis semua yang tersedia. Frame kamera bisa berisi puluhan nilai, dan sebagian besar tidak akan pernah kamu pakai lagi. Mulai dari lima kolom ini.

  1. Waktu pencatatan, bisa berupa timestamp Unix atau ISO 8601.
  2. Nomor frame atau ID rekaman.
  3. Jenis kejadian, misalnya deteksi, peringatan, atau galat.
  4. Isi utama, misalnya label objek dan skor keyakinan.
  5. Catatan tambahan untuk konteks, termasuk nama model atau sumber kamera.

Kolom nomor empat jangan dibuat terlalu lebar. Kalau semua kotak deteksi ditumpuk di satu kolom, baris akan membengkak dan susah diparsing. Simpan satu baris untuk satu objek, atau bungkus sebagai daftar pada format JSON Lines.

Contoh penulisan log di Python

Contoh di bawah menulis CSV sederhana untuk hasil deteksi. Asumsinya kamu sudah punya loop pengambilan frame dan model yang mengembalikan daftar objek.

import csv
from datetime import datetime, timezone

with open("log_kamera.csv", "a", newline="") as f:
    writer = csv.writer(f)
    for frame_id, hasil in loop_deteksi():
        for obj in hasil:
            writer.writerow([
                datetime.now(timezone.utc).isoformat(),
                frame_id,
                "deteksi",
                obj["label"],
                round(object["skor"], 3),
                "model-v1",
            ])

Perhatikan mode buka "a", bukan "w". Mode tambah membuat file lama tidak terhapus saat program dijalankan ulang. Kalau kamu ingin file baru setiap sesi, masukkan tanggal dan jam ke nama file.

Satu hal yang sering terlewat: tulis header sekali saja. Cara paling aman adalah mengecek apakah file sudah ada sebelum membuka, lalu tulis header hanya kalau file masih kosong.

import os

path = "log_kamera.csv"
baru = not os.path.exists(path)
with open(path, "a", newline="") as f:
    writer = csv.writer(f)
    if baru:
        writer.writerow(["waktu", "frame", "kejadian", "label", "skor", "sumber"])
    # lanjut menulis baris data

Jaga agar penulisan tidak memperlambat kamera

Menulis ke disk di dalam loop utama bisa menurunkan FPS, terutama kalau kamera bekerja pada resolusi tinggi. Simpan baris di memori dulu, lalu tulis ke file setiap beberapa detik atau setiap seratus frame. Pola ini menjaga loop tetap ringan.

Kalau kamu menjalankan model di laptop tanpa GPU, beban disk bisa terasa lebih mengganggu. Ukur dulu kecepatan loop sebelum dan sesudah penambahan log. Kalau penurunannya besar, pindahkan penulisan ke thread terpisah atau kurangi frekuensinya.

Beberapa hal yang perlu dicek saat kamera mulai bermasalah di tengah pencatatan: koneksi kabel, port yang dipakai, dan suhu perangkat. Untuk perangkat tambahan seperti Arduino yang membaca sensor, kesalahan pemrograman kecil sering membuat data tidak konsisten. Daftar kesalahan umum saat memprogram Arduino bisa jadi bahan pengecekan awal.

Rapikan log sebelum dianalisis

File teks yang dibiarkan menumpuk akan menyulitkan pencarian. Begitu proyek berjalan beberapa hari, lakukan tiga hal berikut.

  • Pisahkan log per sesi dengan nama file yang memuat tanggal, misalnya log-2026-11-17.csv.
  • Hapus header ganda saat menggabungkan banyak file.
  • Simpan hanya kolom yang dipakai untuk analisis setelah sesi selesai.

Untuk data yang volumenya mulai besar, pertimbangkan menyimpan ringkasan harian: jumlah deteksi per label, waktu kejadian pertama dan terakhir, serta skor rata-rata. Ringkasan ini biasanya lebih cepat dibaca daripada file mentah.

Kesalahan yang paling sering muncul

File log yang kacau hampir selalu berasal dari kebiasaan kecil yang diabaikan. Beberapa di antaranya:

  • Menulis nilai tanpa keterangan satuan, sehingga angka 30 tidak jelas detik, menit, atau frame.
  • Mencampur pemisah koma dan titik koma dalam satu file.
  • Menyimpan hasil deteksi setelah frame di-resize tanpa mencatat ukuran asli, sehingga koordinat tidak bisa dikembalikan ke gambar asal.
  • Menutup program dengan paksa sebelum buffer file selesai ditulis.

Pastikan file selalu ditutup dengan benar, entah lewat blok with atau pemanggilan close(). Kalau program sering dimatikan manual, tambahkan penanganan sinyal agar file tertutup rapi.

Ringkasan

Data kamera yang tersimpan sebagai teks memudahkan pengecekan, pencarian, dan analisis ulang tanpa perangkat lunak tambahan. Kuncinya ada di pemilihan format, kolom yang ringkas, penulisan bertahap agar tidak membebani kamera, dan pembersihan log secara berkala. Mulai dari CSV untuk data sederhana, lalu pindah ke JSON Lines ketika struktur hasil deteksi mulai bercabang.

Pertanyaan yang Sering Diajukan

Apakah file teks cukup untuk data kamera berukuran besar?

Untuk pencatatan kejadian dan hasil deteksi, file teks masih memadai. Batasnya muncul saat kamu perlu menyimpan gambar atau video; untuk itu simpan file medianya terpisah dan catat path-nya di log.

Lebih baik pakai CSV atau JSON Lines?

Pakai CSV kalau satu baris mewakili satu kejadian dengan kolom tetap. Pakai JSON Lines kalau tiap kejadian punya struktur berbeda atau berisi daftar objek di dalamnya.

Bagaimana cara mencocokkan log dengan rekaman video?

Simpan nomor frame dan timestamp yang sama dengan yang dipakai saat merekam. Kedua nilai itu cukup untuk melompat ke momen yang tepat di video saat kamu perlu memeriksa hasil deteksi.

Perlu kamera khusus untuk mulai mencatat?

Tidak. Kamera laptop sudah bisa dipakai untuk uji awal. Kalau nanti butuh posisi tetap dan kualitas gambar lebih konsisten, pertimbangkan kamera eksternal. Perbandingan kamera USB dan kamera laptop bisa membantu memilih. Untuk kebutuhan konten video dari ponsel, ada juga panduan memilih kamera HP untuk konten video.