CLI : Baris Perintah

**Chloros CLI** menyediakan akses baris perintah yang kuat ke mesin pemrosesan gambar Chloros, yang memungkinkan otomatisasi, pembuatan skrip, dan operasi tanpa antarmuka pengguna untuk alur kerja pencitraan Anda.

Fitur Utama

  • 🚀 Otomatisasi - Pemrosesan batch skrip untuk beberapa dataset

  • 🔗 Integrasi - Dapat diintegrasikan ke dalam alur kerja dan pipeline yang sudah ada

  • 💻 Operasi Tanpa Antarmuka Grafis - Dapat dijalankan tanpa antarmuka grafis

  • 🌍 Multi-Bahasa - Mendukung 38 bahasa

  • Pemrosesan Paralel - Adaptasi Komputasi Dinamis secara otomatis mengoptimalkan sesuai dengan perangkat keras Anda

Persyaratan

Persyaratan
Detail

Sistem Operasi

Windows 10/11 (64-bit), Linux x86_64 (amd64), Linux arm64 (NVIDIA Jetson JetPack 6)

Memori

Minimal 8GB RAM (disarankan 16GB)

Internet

Diperlukan untuk aktivasi lisensi

Ruang Disk

Bervariasi sesuai ukuran proyek

circle-exclamation

Panduan Cepat

Instalasi

Windows

CLI secara otomatis disertakan dalam penginstal Chloros:

  1. Unduh dan jalankan Chloros Installer.exe

  2. Selesaikan wizard pemasangan

  3. CLI terpasang di: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-check

Linux

Pasang paket .deb untuk arsitektur Anda:

Untuk pengaturan Linux yang lebih rinci, lihat Linux Instalasi.

Pengaturan Awal

Sebelum menggunakan CLI, aktifkan lisensi Chloros+ Anda:

Windows:

Linux:

Penggunaan Dasar

Proses folder dengan pengaturan default:

Windows:

Linux:


Referensi Perintah

Sintaks Umum


Perintah

process - Memproses Gambar

Memproses gambar dalam folder dengan kalibrasi.

Sintaks:

Contoh:

Opsi Perintah Pemrosesan

Opsi
Tipe
Default
Deskripsi

<input-folder>

Jalur

Diperlukan

Folder yang berisi gambar multispektral RAW/JPG

-o, --output

Jalur

Sama dengan input

Folder keluaran untuk gambar yang telah diproses

-n, --project-name

String

Dibuat otomatis

Nama proyek khusus

--vignette

Bendera

Diaktifkan

Aktifkan koreksi vignette

--no-vignette

Bendera

-

Nonaktifkan koreksi vignette

--reflectance

Bendera

Diaktifkan

Aktifkan kalibrasi reflektansi

--no-reflectance

Bendera

-

Nonaktifkan kalibrasi reflektansi

--ppk

Bendera

Dinonaktifkan

Terapkan koreksi PPK dari data sensor cahaya .daq

--format

Pilihan

TIFF (16-bit)

Format keluaran: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)

--min-target-size

Bilangan bulat

Otomatis

Ukuran target minimum dalam piksel untuk deteksi panel kalibrasi

--target-clustering

Bilangan bulat

Otomatis

Ambang batas pengelompokan target (0-100)

--debayer

Pilihan

standard

Metode debayer: standard atau texture-aware (hanya Chloros+)

--target, --targets

Bendera

Dinonaktifkan

Hanya cari target kalibrasi di subfolder "target" atau "targets" (mempercepat pemrosesan)

--indices

Daftar

Tidak ada

Indeks vegetasi yang akan dihitung (misalnya, --indices NDVI NDRE GNDVI)

--exposure-pin-1

String

Tidak ada

Mengunci eksposur untuk model kamera (Pin 1)

--exposure-pin-2

String

Tidak ada

Mengunci eksposur untuk model kamera (Pin 2)

--recal-interval

Bilangan bulat

Otomatis

Interval kalibrasi ulang dalam detik

--timezone-offset

Bilangan bulat

0

Perbedaan zona waktu dalam jam


login - Otentikasi Akun

Masuk menggunakan kredensial Chloros+ Anda untuk mengaktifkan pemrosesan CLI.

Sintaks:

Contoh:

circle-exclamation

Output:

***

logout - Hapus Kredensial

Hapus kredensial yang tersimpan dan keluar dari akun Anda.

Sintaks:

Contoh:

Output:

circle-info

Pengguna SDK: Python SDK juga menyediakan metode programatik logout() untuk menghapus kredensial dalam skrip Python. Lihat dokumentasi Python SDK untuk detailnya.


status - Periksa Status Lisensi

Menampilkan status lisensi dan otentikasi saat ini.

Sintaks:

Contoh:

Output:


export-status - Periksa Kemajuan Ekspor

Memantau kemajuan ekspor Thread 4 selama atau setelah pemrosesan.

Sintaks:

Contoh:

Kasus Penggunaan: Jalankan perintah ini saat pemrosesan sedang berjalan untuk memeriksa kemajuan ekspor.***

language - Kelola Bahasa Antarmuka

Lihat atau ubah bahasa antarmuka CLI.

Sintaks:

Contoh:

Bahasa yang Didukung (Total 38)

Kode
Bahasa
Nama Asli

en

Inggris

English

es

Spanyol

Español

pt

Portugis

Português

fr

Prancis

Français

de

Jerman

Deutsch

it

Italia

Italiano

ja

Jepang

日本語

ko

Korea

한국어

zh

Tionghoa (Sederhana)

简体中文

zh-TW

Tionghoa (Tradisional)

繁體中文

ru

Rusia

Русский

nl

Belanda

Nederlands

ar

Arab

العربية

pl

Polandia

Polski

tr

Turki

Türkçe

hi

Hindi

हिंदी

id

Indonesia

Bahasa Indonesia

vi

Vietnam

Tiếng Việt

th

Thailand

ไทย

sv

Swedia

Svenska

da

Denmark

Dansk

no

Norwegia

Norsk

fi

Finlandia

Suomi

el

Yunani

Ελληνικά

cs

Ceko

Čeština

hu

Hongaria

Magyar

ro

Rumania

Română

uk

Ukraina

Українська

pt-BR

Portugis Brasil

Português Brasileiro

zh-HK

Kanton

粵語

ms

Melayu

Bahasa Melayu

sk

Bahasa Slovakia

Slovenčina

bg

Bahasa Bulgaria

Български

hr

Bahasa Kroasia

Hrvatski

lt

Lituania

Lietuvių

lv

Latvia

Latviešu

et

Estonia

Eesti

sl

Slovenia

Slovenščina

circle-check

set-project-folder - Atur Folder Proyek Default

Ubah lokasi folder proyek default (dibagikan dengan antarmuka pengguna pada Windows).

Sintaks:

Contoh:


get-project-folder - Tampilkan Folder Proyek

Tampilkan lokasi folder proyek default saat ini.

Sintaks:

Contoh:

Hasil:


reset-project-folder - Atur Ulang ke Default

Atur ulang folder proyek ke lokasi default.

Sintaks:


selftest - Jalankan Diagnostik Sistem

Jalankan 7 pemeriksaan diagnostik untuk memverifikasi konfigurasi sistem Anda.

Sintaks:

Pemeriksaan yang dilakukan:

  1. Pemeriksaan versi

  2. Ketersediaan port (5000)

  3. Pengaktifan backend

  4. Uji konektivitas API

  5. Informasi sistem dan deteksi GPU

  6. Verifikasi model denoiser

  7. Pemeriksaan ketersediaan CUDA

circle-info

Berguna untuk pemecahan masalah: Jalankan selftest setelah instalasi untuk memverifikasi bahwa sistem Anda telah dikonfigurasi dengan benar, terutama pada Linux/Jetson di mana pengaturan GPU dan CUDA mungkin memerlukan verifikasi.


update - Periksa Pembaruan (Hanya Linux)

Periksa dan instal pembaruan CLI pada sistem Linux.

Sintaks:

Opsi
Deskripsi

--check

Hanya periksa pembaruan, jangan instal

circle-info

Perintah ini hanya tersedia pada Linux. Pada Windows, pembaruan disediakan melalui penginstal.


Opsi Global

Opsi-opsi ini berlaku untuk semua perintah:

Opsi
Tipe
Default
Deskripsi

--backend-exe

Jalur

Terdeteksi otomatis

Jalur ke file eksekusi backend

--port

Bilangan bulat

5000

Nomor port backend API

--restart

Bendera

-

Memaksa restart backend (menghentikan proses yang ada)

--version

Bendera

-

Menampilkan informasi versi dan keluar

--help

Bendera

-

Menampilkan informasi bantuan dan keluar

circle-info

Deteksi otomatis backend: Jalur --backend-exe dideteksi secara otomatis per platform:

  • Windows: C:\Program Files\MAPIR\Chloros\resources\backend\chloros-backend.exe

  • Linux (.deb): /usr/lib/chloros/chloros-backend

  • Linux (manual): /opt/mapir/chloros/backend/chloros-backend

Contoh dengan Opsi Global:

Windows:

Linux:


Panduan Pengaturan Pemrosesan

Pemrosesan Paralel & Adaptasi Komputasi Dinamis

Chloros 1.1.0 mencakup Adaptasi Komputasi Dinamis — mesin pemrosesan secara otomatis mendeteksi perangkat keras Anda dan memilih strategi optimal:

Platform
Strategi
Pekerja
Jalur
Catatan

Jetson Nano 8GB

GPU_SINGLE

1

tiled_gpu

Efisien memori, serial

Jetson Orin NX 16GB

GPU_PARALLEL

3

fused_gpu

Pemrosesan GPU bersamaan

Desktop dengan GPU 8GB

GPU_SINGLE

3

tiled_gpu

Kinerja desktop yang baik

Desktop dengan GPU 12GB+

GPU_PARALLEL

3-4

fused_gpu

Kinerja desktop optimal

Sistem hanya CPU

CPU_PARALLEL

inti - 1

cpu_fallback

Tidak memerlukan GPU

circle-check

Metode Debayer

Metode
Bendera CLI
Kualitas
Kecepatan
Lisensi

Standar (Cepat, Kualitas Sedang)

--debayer standard

Baik

Cepat

Gratis / Chloros+

Texture Aware (Lambat, Kualitas Tertinggi)

--debayer texture-aware

Tertinggi

Lambat

Hanya Chloros+

Metode debayer default adalah Standar. MetodeTexture Aware menggunakan model denoising AI/ML untuk hasil berkualitas tertinggi, tetapi memerlukan lisensi Chloros+ dan GPU NVIDIA.

Koreksi Vignette

Fungsinya: Mengoreksi penurunan kecerahan di tepi gambar (sudut gelap yang umum pada gambar kamera).

  • Diaktifkan secara default - Sebagian besar pengguna sebaiknya tetap mengaktifkan ini

  • Gunakan --no-vignette untuk menonaktifkan

circle-check

Kalibrasi Reflektansi

Mengonversi nilai sensor mentah menjadi persentase reflektansi standar menggunakan panel kalibrasi.

  • Diaktifkan secara default - Penting untuk analisis vegetasi

  • Membutuhkan panel target kalibrasi dalam gambar

  • Gunakan --no-reflectance untuk menonaktifkan

circle-info

Persyaratan: Pastikan panel kalibrasi terpapar dengan baik dan terlihat jelas dalam gambar Anda untuk konversi reflektansi yang akurat.

Koreksi PPK

Fungsinya: Menerapkan koreksi Kinematik Pasca-Pemrosesan menggunakan data log DAQ-A-SD untuk meningkatkan akurasi GPS.

  • Dinonaktifkan secara default

  • Gunakan --ppk untuk mengaktifkan

  • Membutuhkan file .daq di folder proyek dari sensor cahaya DAQ-A-SD MAPIR.

Format Keluaran

Format
Kedalaman Bit
Ukuran File
Cocok Untuk

TIFF (16-bit)

Bilangan bulat 16-bit

Besar

Analisis GIS, fotogrametri (disarankan)

TIFF (32-bit, Persen)

Bilangan desimal 32-bit

Sangat Besar

Analisis ilmiah, penelitian

PNG (8-bit)

Bilangan bulat 8-bit

Sedang

Pemeriksaan visual, berbagi web

JPG (8-bit)

Bilangan bulat 8-bit

Kecil

Pratinjau cepat, keluaran terkompresi

***

Otomatisasi & Skrip

Pemrosesan Batch PowerShell (Windows)

Proses beberapa folder dataset secara otomatis di Windows:

Skrip Batch Windows (Windows)

Perulangan sederhana untuk pemrosesan batch pada Windows:

Pemrosesan Batch Bash (Linux)

Memproses beberapa folder dataset pada Linux:

Skrip Otomatisasi Python (Lintas Platform)

Otomatisasi lanjutan dengan penanganan kesalahan (berfungsi pada Windows dan Linux):


Alur Kerja Pemrosesan

Alur Kerja Standar

  1. Masukan: Folder yang berisi pasangan gambar RAW/JPG

  2. Deteksi: CLI secara otomatis memindai file gambar yang didukung

  3. Pemrosesan: Mode paralel menyesuaikan dengan jumlah inti CPU Anda (Chloros+)

  4. Output: Membuat subfolder berdasarkan model kamera dengan gambar yang telah diproses

Contoh Struktur Output

Perkiraan Waktu Pemrosesan

Waktu pemrosesan tipikal untuk 100 gambar (masing-masing 12MP):

Platform
Mode
Waktu Perkiraan
Catatan

Desktop 12GB+ GPU

GPU_PARALLEL

5-10 menit

Opsi tercepat

Desktop 8GB GPU

GPU_SINGLE

10-15 menit

Kinerja baik

Jetson Orin NX 16GB

GPU_PARALLEL

15-25 menit

Komputasi tepi

Jetson Nano 8GB

GPU_SINGLE

30-60 menit

Terbatas memori

Hanya CPU

CPU_PARALLEL

20-40 menit

Tidak memerlukan GPU

circle-info

Tips Kinerja: Waktu pemrosesan bervariasi tergantung pada jumlah gambar, resolusi, metode debayer, dan perangkat keras. Metode debayer Texture Aware memakan waktu jauh lebih lama daripada metode Standar. Lihat Dynamic Compute Adaptation untuk detailnya.


Pemecahan Masalah

CLI Tidak Ditemukan

Windows Kesalahan:

Windows Solusi:

  1. Periksa lokasi instalasi:

  1. Gunakan jalur lengkap jika tidak ada di PATH:

  1. Tambahkan ke PATH secara manual:

    • Buka Properti Sistem → Variabel Lingkungan

    • Edit variabel PATH

    • Tambahkan: C:\Program Files\Chloros\resources\cli

    • Mulai ulang terminal

Kesalahan Linux:

Solusi Linux:

  1. Periksa instalasi:

  1. Muat ulang shell Anda:

  1. Periksa izin:


Backend Gagal DimulaiKesalahan:

Solusi:

  1. Periksa apakah backend sudah berjalan (tutup terlebih dahulu)

  2. Periksa apakah firewall tidak memblokir (Windows) atau periksa ketersediaan port (Linux: lsof -i :5000)

  3. Coba port yang berbeda:

  1. Paksa restart backend:

  1. Pada Linux, periksa apakah file executable backend ada:


Masalah Lisensi / OtentikasiKesalahan:

Solusi:

  1. Pastikan Anda memiliki langganan Chloros+ yang aktif

  2. Masuk dengan kredensial Anda:

  1. Periksa status lisensi:

  1. Hubungi dukungan: info@mapir.camera


Tidak Ditemukan GambarKesalahan:

Solusi:

  1. Pastikan folder berisi format yang didukung (.RAW, .TIF, .JPG)

  2. Periksa jalur folder sudah benar (gunakan tanda kutip untuk jalur yang mengandung spasi)

  3. Pastikan Anda memiliki izin baca untuk folder tersebut

  4. Periksa ekstensi file sudah benar


Pemrosesan Terhenti atau MacetSolusi:

  1. Periksa ruang disk yang tersedia (pastikan cukup untuk output)

  2. Tutup aplikasi lain untuk membebaskan memori

  3. Kurangi jumlah gambar (proses secara bertahap)


Port Sudah DigunakanKesalahan:

Solusi:

Windows:

Linux:


FAQ

Q: Apakah saya memerlukan lisensi untuk CLI?

A:Ya! CLI memerlukan lisensi berbayarChloros+.

  • ❌ Paket Standar (gratis): CLI dinonaktifkan

  • ✅ Paket Chloros+ (berbayar): CLI sepenuhnya diaktifkan

Berlangganan di: https://cloud.mapir.camera/pricingarrow-up-right


Q: Bisakah saya menggunakan CLI pada server tanpa antarmuka grafis (GUI)?A: Ya! CLI berjalan sepenuhnya tanpa antarmuka grafis (headless). Ini adalah kasus penggunaan utama pada Linux.Server Windows:

  • Server Windows 2016 atau yang lebih baru

  • Visual C++ Redistributable terinstal

Server Linux:

  • Ubuntu 20.04+ / Debian 11+ (amd64) atau JetPack 6 (arm64)

  • Instal melalui paket .deb

Kedua platform:

  • RAM minimal 8GB (disarankan 16GB)

  • Aktivasi lisensi satu kali: chloros-cli login user@example.com 'password'


Q: Di mana gambar yang diproses disimpan?A:Secara default, gambar yang diproses disimpan difolder yang sama dengan input dalam subfolder model kamera (misalnya, Survey3N_RGN/).

Gunakan opsi -o untuk menentukan folder output yang berbeda:


Q: Bisakah saya memproses beberapa folder sekaligus?A: Tidak secara langsung dalam satu perintah, tetapi Anda dapat menggunakan skrip untuk memproses folder secara berurutan. Lihat bagian Otomatisasi & Skrip.***

Q: Bagaimana cara menyimpan output CLI ke berkas log?PowerShell:

Batch:

Linux Bash:


Q: Apa yang terjadi jika saya menekan Ctrl+C selama pemrosesan?A: CLI akan:

  1. Menghentikan pemrosesan dengan lancar

  2. Mematikan backend

  3. Keluar dengan kode 130

Gambar yang diproses sebagian mungkin tetap ada di folder output.


Q: Bisakah saya mengotomatiskan pemrosesan CLI?A: Tentu saja! CLI dirancang untuk otomatisasi. Lihat Otomatisasi & Skrip untuk PowerShell (Windows), Batch (Windows), Bash (Linux), dan contoh Python (multi-platform).***

Q: Bagaimana cara memeriksa versi CLI?A:

Output:


Mendapatkan Bantuan

Bantuan Baris Perintah

Lihat informasi bantuan langsung di CLI:

Saluran Dukungan

Contoh Lengkap

Contoh 1: Pemrosesan Dasar

Proses dengan pengaturan default (vignette, reflektansi):

Windows:

Linux:


Contoh 2: Keluaran Ilmiah Berkualitas Tinggi

32-bit float TIFF:

Windows:

Linux:


Contoh 3: Pemrosesan Pratinjau Cepat

8-bit PNG tanpa kalibrasi untuk tinjauan cepat:

Windows:

Linux:


Contoh 4: Pemrosesan yang Dikoreksi PPK

Terapkan koreksi PPK dengan reflektansi:

Windows:

Linux:


Contoh 5: Lokasi Keluaran Kustom

Proses ke lokasi yang berbeda dengan format tertentu:

Windows:

Linux:


Contoh 6: Alur Kerja Otentikasi

Alur otentikasi lengkap (sama di semua platform):


Contoh 7: Penggunaan Multi-Bahasa

Ubah bahasa antarmuka (sama di semua platform):

Last updated