> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docku.mertani.com/llms.txt.
> For full documentation content, see https://docku.mertani.com/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docku.mertani.com/_mcp/server.

# Kalibrasi Sensor

## Overview

Menu **Kalibrasi Sensor** digunakan untuk menyesuaikan hasil pembacaan sensor agar sesuai dengan kondisi referensi di lapangan.

Sistem mendukung tiga metode kalibrasi:

* **Rumus sederhana** menggunakan variabel `x`
* **Referensi parameter lain** menggunakan `[parameter]`
* **Dataset lookup** menggunakan fungsi `DATASET()`

Sistem kalibrasi sederhana menggunakan rumus

Sistem kalibrasi turunan dari parameter sensor lain

Sistem kalibrasi non-linier berbasis tabel dataset

***

## Konsep Dasar Kalibrasi

* **x** → nilai asli dari sensor (raw data)
* **Sintetik Data** → hasil kalibrasi yang digunakan di sistem

Setelah kalibrasi disimpan:

* Berlaku hanya untuk **data berikutnya (tidak berlaku mundur)**
* Data historis tidak berubah
* Jika tidak ada kalibrasi → sistem menggunakan default `x`

***

## 1. Kalibrasi Berbasis Rumus (x)

Sistem kalibrasi menggunakan nilai sensor langsung.

### Contoh

* `x - 212`
* `(x+100) / 100`
* `3.6156 * ((302 - x) ** 1.7461)`

### Preview Hasil Kalibrasi

Berikut contoh bagaimana kalibrasi mempengaruhi data

**Rumus kalibrasi:** `200 - x`

| Jenis Data          | Nilai |
| ------------------- | ----- |
| Raw Data (x)        | 120   |
| Sintetik Data       | 80    |
| TMA = Sintetik Data | 80    |

Perhitungan: `200 - 120 = 80`

***

## 2. Kalibrasi Berbasis Parameter

Sistem kalibrasi menggunakan data dari sensor lain dalam satu device.

* Format: `[parameter]` atau `[id_sensor]`
* contoh: `[RYG8-flLev] / 100`

### Studi kasus

Device hanya tersedia sensor water level, tetapi ingin ditampilkan nilai debit menggunakan rumus rating curve.

| Parameter        | id         | kalibrasi                                 | Keterangan           |
| ---------------- | ---------- | ----------------------------------------- | -------------------- |
| Water Level (cm) | RYG8-flLev | `x`                                       | raw                  |
| Water Level (m)  | RYG8-flLev | `x/100`                                   | cm -> m              |
| Debit (m3s)      | RYG8-flw   | `3.6156 * ((302 - [RYG8-flw]) ** 1.7461)` | water level -> debit |

### Preview Hasil Kalibrasi

Berikut contoh bagaimana kalibrasi mempengaruhi data:

| Jenis Data   | Nilai       | units |
| ------------ | ----------- | ----- |
| Raw Data `x` | 200         | cm    |
| Water level  | 2           | m     |
| Debit (m3s)  | 12.12854917 | m3/s  |

### Konsep

Metode ini memungkinkan:

* Membuat parameter turunan (virtual sensor)
* Menggunakan satu sensor untuk banyak output
* Menggabungkan beberapa parameter

***

## 3. Kalibrasi Berbasis Dataset

Digunakan untuk konversi berbasis tabel referensi (lookup table).

### Contoh Dataset

| water\_level | area |
| ------------ | ---- |
| 4.0          | 40.4 |
| 3.9          | 39.0 |
| 3.8          | 37.7 |
| 3.7          | 36.5 |
| ...          | ...  |
| 0.0          | 1.1  |

### Fungsi/Rumus Dataset

`DATASET("slug", sensor_value, "column_output")`

### Contoh Implementasi

#### Dataset:

* Device: Pos Duga Air - Sungai Hulu
* id: MTI-RYG8V6VHH8XB
* Slug Dataset: penampang\_basah\_1cm

Menghitung nilai debit menggunakan dataset:

`[RYG8-flVel] * DATASET("penampang_basah_1cm", [RYG8-flLev]/100, "area")`

#### Penjelasan:

* `[RYG8-flVel]` → Sensor kecepatan aliran (Raw value sensor)
* `[RYG8-flLev] / 100` → Konversi (Raw value) tinggi air dari bacaan sensor
* `DATASET(...)` → Mencari nilai luas penampang berdasarkan tinggi air
* `Hasil akhir` → Nilai debit (flow)

***

## Akses Kalibrasi Sensor

### Open Management Device

Masuk ke halaman **Management Device**.

### Open Device Detail

Pilih device, lalu buka halaman detail device.

### Open Sensor Device

Masuk ke daftar sensor pada device.

### Open Calibration

Klik badge kalibrasi pada sensor.

### Input Calibration

* Tabel kiri → referensi kalibrasi
* Form kanan → input rumus

Input kalibrasi mendukung penggunaan **parameter turunan** berupa **fungsi** maupun **ID sensor**.
Gunakan `=` untuk membuka daftar dataset dan sensor yang tersedia. Setelah dipilih, fungsi transformasi atau pengolahan data yang relevan akan ditampilkan otomatis.

### Input Units

Input units yang digunakan setelah dilakukan kalibrasi. Unit (e.g., °C, pH, mm)

Contoh:

* units `cm` -> dikalibrasi `x/100`
* update units menjadi `meter`

### Save Calibration

Klik **"Simpan"** untuk menerapkan kalibrasi.

Data berikutnya akan menggunakan rumus tersebut.

### Open Management Sensor

Masuk ke halaman **Management Sensor**.

### Search Sensor

Cari sensor berdasarkan:

* Device Name
* Device ID
* Sensor Name
* Sensor ID

### Open Calibration

Klik badge kalibrasi pada sensor.

### Input Calibration

* Tabel kiri → referensi
* Form kanan → input rumus

Input kalibrasi mendukung penggunaan **parameter turunan** berupa **fungsi** maupun **ID sensor**.
Gunakan `=` untuk membuka daftar dataset dan sensor yang tersedia. Setelah dipilih, fungsi transformasi atau pengolahan data yang relevan akan ditampilkan otomatis.

### Save Calibration

Klik **"Simpan"** untuk menyimpan konfigurasi.

***

## Operator yang Didukung

| Operator     | Simbol     |
| ------------ | ---------- |
| Desimal      | .          |
| Penjumlahan  | +          |
| Pengurangan  | -          |
| Perkalian    | \*         |
| Pembagian    | /          |
| Pangkat      | \*\*       |
| Akar         | sqrt       |
| Eksponensial | exp        |
| Absolut      | abs        |
| Sin          | sin(value) |
| Cos          | cos(value) |
| Tan          | tan(value) |

Atau jika rumus sin/cos/tan dalam derajat, perlu diconvert menggunakan fungsi to radian:

| Operator | Simbol         |
| -------- | -------------- |
| Sin      | sin(torad(90)) |
| Cos      | cos(torad(90)) |
| Tan      | tan(torad(90)) |

## Penggunaan Data di Sistem

`Raw Data` → referensi

`Sintetik Data` → digunakan pada:

* `Dashboard`
* `Grafik`
* `Tabel`
* `Laporan`
* `Export data`

***

## Notes

 Gunakan `x` untuk kalibrasi sederhana. 

 Gunakan `[parameter]` untuk membuat parameter turunan atau konversi unit. 

 Gunakan `DATASET()` untuk hubungan non-linear berbasis tabel. 

 Kalibrasi tidak berlaku untuk data historis. 

 Kesalahan penulisan rumus dapat menyebabkan data tidak valid.