Nexa Flot

Konstruktor

Untuk mulai menggunakan NexaFlot, ikuti langkah-langkah berikut:

Inisialisasi Object

// Inisialisasi Nexa
$nexa = new Nexa();
// Cara 1: Tanpa nama tabel
$flot = $nexa->Flot();
// Cara 2: Dengan nama tabel spesifik
$flot = $nexa->Flot('users');
      

Query Builder Methods

NexaFlot menyediakan beberapa method untuk membangun query:

• table($table) - Menentukan tabel yang akan digunakan
• select($columns) - Memilih kolom yang akan diambil
• where($column, $operator, $value) - Menambahkan kondisi WHERE
• orderBy($column, $direction) - Mengurutkan hasil
• groupBy($columns) - Mengelompokkan hasil
• limit($limit) - Membatasi jumlah hasil

Contoh Penggunaan

$flot->table('sales')
     ->select(['date', 'amount'])
     ->where('year', 2024)
     ->orderBy('date')
     ->limit(10);
      

Grafik Dasar

NexaFlot mendukung beberapa tipe grafik dasar yang sering digunakan.

Grafik Garis (Line Chart)

Grafik garis ideal untuk menampilkan trend data sepanjang waktu.

$options = [
    'title' => 'Penjualan Bulanan',
    'xAxis' => 'Bulan',
    'yAxis' => 'Total Penjualan'
];

$data = $flot->table('sales')
             ->select(['month', 'total'])
             ->getLineChartData($options);
      

Grafik Batang (Bar Chart)

Grafik batang efektif untuk membandingkan nilai antar kategori.

$data = $flot->table('products')
             ->select(['category', 'sales'])
             ->getBarChartData([
                 'title' => 'Penjualan per Kategori'
             ]);
      

Grafik Lingkaran (Pie Chart)

Grafik pie menampilkan proporsi dari keseluruhan data.

$data = $flot->table('market_share')
             ->select(['company', 'percentage'])
             ->getPieChartData([
                 'title' => 'Market Share'
             ]);
      

Time Series

Grafik time series khusus untuk data berbasis waktu dengan format yang dapat disesuaikan.

$options = [
    'title' => 'Time Series',
    'xAxis' => 'Time',
    'yAxis' => 'Value',
    'timeFormat' => 'YYYY-MM-DD'  // Format waktu yang dapat disesuaikan
];

$data = $flot->table('metrics')
             ->select(['timestamp', 'value'])
             ->getTimeSeriesData($options);
      

Heatmap

Heatmap memvisualisasikan data dalam format matriks dengan gradasi warna.

$options = [
    'title' => 'Heatmap',
    'xAxis' => 'X Label',
    'yAxis' => 'Y Label',
    'colorScale' => [
        'min' => 0,
        'max' => 100
    ]
];

$data = $flot->table('temperature')
             ->select(['x', 'y', 'value'])
             ->getHeatmapData($options);
      

Radar

Grafik radar efektif untuk membandingkan multiple variabel dalam format polar.

$options = [
    'title' => 'Radar Chart',
    'categories' => ['Speed', 'Power', 'Range', 'Accuracy'],
    'scale' => [
        'min' => 0,
        'max' => 100
    ]
];

$data = $flot->table('performance')
             ->select(['metric', 'score'])
             ->getRadarData($options);
      

Waterfall

Grafik waterfall menunjukkan bagaimana nilai awal dipengaruhi oleh nilai positif dan negatif.

$options = [
    'title' => 'Waterfall Chart',
    'xAxis' => 'Categories',
    'yAxis' => 'Amount',
    'initialValue' => 1000,  // Nilai awal
    'colors' => [
        'positive' => '#4CAF50',
        'negative' => '#F44336'
    ]
];

$data = $flot->table('financial_changes')
             ->select(['item', 'amount'])
             ->getWaterfallData($options);
      

Format Output

Semua method grafik mengembalikan data dalam format JSON yang kompatibel dengan library visualisasi JavaScript. Format output mencakup:

• type: Tipe grafik
• data: Data yang akan divisualisasikan
• options: Konfigurasi tambahan seperti judul, label axis, dll

Format Data per Jenis Grafik

Line dan Bar Chart

{
    "labels": ["Label1", "Label2", "Label3"],
    "datasets": [{
        "label": "Dataset Name",
        "data": [10, 20, 30]
    }]
}
      

Pie Chart

[
    {
        "label": "Category 1",
        "value": 30
    },
    {
        "label": "Category 2",
        "value": 70
    }
]