Dokumentasi & Panduan Pengguna

Panduan lengkap penggunaan Data Music Visualizer, mulai dari input data, sonifikasi, hingga pengelolaan playlist.

Daftar Isi

Memulai

Selamat datang di Data Music Visualizer. Aplikasi ini mengubah data numerik (seperti cuaca, saham, atau data sensor) menjadi komposisi musik (sonifikasi) dan visualisasi interaktif.

Alur Kerja Utama:

  1. Input Data: Masukkan data manual, unggah CSV, atau gunakan generator Cuaca.
  2. Pemetaan (Mapping): Tentukan kolom mana yang menjadi nada, volume, dan durasi.
  3. Pengaturan Musik: Pilih instrumen, tangga nada (scale), dan kunci dasar.
  4. Proses: Klik tombol hijau untuk menghasilkan musik.
  5. Simpan: Hasil musik otomatis tersimpan dalam Sesi Anda dan bisa ditambahkan ke Playlist.

Metode Input Data

Input Manual

Masukkan data Anda langsung melalui area teks yang tersedia. Metode ini sangat fleksibel untuk testing cepat.

  • Pastikan baris pertama adalah header (nama kolom).
  • Pisahkan kolom menggunakan tanda koma (CSV format).
  • Anda bisa langsung menyalin (Copy-Paste) data dari Spreadsheet atau Notepad.

Weather API

Hasilkan data cuaca riil dari server meteorologi. Cukup masukkan nama kota dan pilih durasi hari (1-3 hari).

Data otomatis mencakup: Suhu, Kelembapan, Tekanan, dan Awan.

Unggah CSV/Excel

Unggah file dataset besar Anda. Sistem mendukung file berekstensi .csv, .xls, dan .xlsx.

Klik "Unggah File" pada dashboard untuk membuka jendela pemilihan file.

📋 Contoh Format CSV Manual

timestamp,value,category
2024-01-01 08:00,10,A
2024-01-01 09:00,25,B
2024-01-01 10:00,15,A

Pemetaan & Pengaturan Audio

Kunci dari sonifikasi yang baik adalah bagaimana Anda memetakan data ke elemen musik.

Kolom Not (Pitch)

Menentukan tinggi-rendahnya nada. Gunakan kolom dengan variasi nilai yang dinamis (contoh: Suhu, Harga Saham).

Kolom Velocity (Volume)

Menentukan keras-lembutnya nada. Nilai yang lebih besar akan menghasilkan suara yang lebih keras.

Instrumen

Pilih karakter suara: Piano (Klasik), Gitar (Akustik), Strings (Orkestra), atau Synth (Elektronik).

Scale & Key

Mengatur "mood" musik.
Major = Ceria/Normal.
Minor = Sedih/Serius.
Pentatonic = Harmonis tradisional.

Fitur Playlist

Fitur Playlist memungkinkan Anda untuk mengumpulkan dan menyimpan hasil sonifikasi (output) favorit Anda ke dalam satu daftar putar.

Cara Menggunakan Playlist:

  • 1 Proses Data Terlebih Dahulu: Lakukan sonifikasi data di halaman Beranda. Setiap kali Anda klik "Process Data", hasilnya disimpan dalam riwayat Sesi Anda.
  • 2 Buka Menu Playlist: Klik tombol "Playlist" di navigasi atas.
  • 3 Buat Playlist Baru: Klik "Buat Playlist", beri nama, dan centang track/lagu dari riwayat sesi yang ingin Anda masukkan.
  • 4 Putar: Buka playlist yang sudah dibuat. Anda akan melihat pemutar musik khusus dengan visualisasi gelombang dan kontrol daftar putar.

Sesi & Berbagi

Aplikasi ini menggunakan sistem Sesi Unik (Unique Session ID). Artinya, setiap kali Anda membuka aplikasi, Anda diberikan ruang kerja pribadi sementara.

Simpan Pekerjaan Anda

Jika Anda belum login (Tamu), pekerjaan Anda disimpan berdasarkan URL di browser.

Gunakan tombol "Salin Sesi" di pojok kanan atas untuk menyimpan Link unik Anda. Buka link tersebut di perangkat lain untuk melanjutkan pekerjaan.

Mulai Ulang

Ingin kanvas kosong? Gunakan tombol "Sesi Baru" di menu navigasi.

Ini akan membuat ID sesi baru yang bersih tanpa menghapus sesi lama Anda (selama Anda menyimpan link sesi lama).

FAQ (Tanya Jawab)

Apakah data saya disimpan permanen?

Tergantung status pengguna Anda:

  • Pengguna Tamu (Guest): Data sesi disimpan sementara di server dan terikat pada Session ID (URL unik) Anda. Kami secara rutin membersihkan sesi tamu yang tidak aktif selama lebih dari 30 hari untuk menjaga performa server.
  • Admin/User Terdaftar: Data sesi dan playlist tersimpan secara permanen di akun Anda selama Anda tidak menghapusnya secara manual.
Mengapa tidak ada suara saat saya menekan tombol Play?

Ini adalah kebijakan keamanan browser modern. Audio tidak dapat diputar otomatis (autoplay) tanpa interaksi pengguna terlebih dahulu.

Solusi: Klik area kosong di halaman dashboard atau lakukan interaksi lain (seperti klik tombol proses) sebelum menekan tombol Play. Juga, pastikan volume perangkat Anda aktif dan tidak di-mute.

Bagaimana cara mengunduh hasil musik (MIDI)?

Ada dua cara untuk mengunduh file MIDI:

  1. Dari Dashboard: Setelah data diproses dan visualisasi muncul, tombol "Download MIDI" di pojok kanan atas area visualisasi akan aktif.
  2. Dari Playlist: Buka menu Playlist, lalu pada daftar lagu, arahkan kursor ke lagu yang diinginkan (atau klik pada tampilan mobile) dan tekan ikon Download.
Jenis data apa yang paling bagus untuk disonifikasi?

Data time-series (berbasis waktu) dengan variasi nilai yang dinamis memberikan hasil terbaik. Contohnya:

  • Data Cuaca (Suhu harian yang naik turun menciptakan melodi).
  • Harga Saham atau Mata Uang Kripto (Volatilitas pasar menjadi ritme yang menarik).
  • Data Sensor IoT (Detak jantung, kelembapan tanah, dll).

Tips: Hindari data yang nilainya statis (datar) karena akan menghasilkan nada yang monoton (satu nada terus menerus).

Bisakah saya menggunakan Weather API untuk kota mana saja?

Ya! Generator Weather API kami terhubung ke layanan cuaca global. Anda dapat memasukkan nama kota besar (misal: "Jakarta", "New York", "London") maupun kota kecil. Sistem akan otomatis mencari data prakiraan cuaca terkini untuk lokasi tersebut.