CLI : Baris Perintah

Chloros CLI menyediakan akses baris perintah yang berkuasa kepada enjin pemprosesan imej Chloros, membolehkan automasi, penskripan dan operasi tanpa kepala untuk aliran kerja pengimejan anda.

Ciri Utama

  • 🚀 Automasi - Pemprosesan kelompok skrip berbilang set data

  • 🔗 Integrasi - Benamkan dalam aliran kerja dan saluran paip sedia ada

  • 💻 Operasi Tanpa Kepala - Jalankan tanpa GUI

  • 🌍 Berbilang Bahasa - Sokongan untuk 38 bahasa

  • Pemprosesan Selari - Skala secara dinamik kepada CPU anda (sehingga 16 pekerja selari)

Keperluan

Keperluan
Butiran

Sistem Pengendalian

Windows 10/11 (64-bit)

Memori

8GB RAM minimum (16GB disyorkan)

Internet

Diperlukan untuk pengaktifan lesen

Ruang Cakera

Berbeza mengikut saiz projek

Keperluan Lesen: CLI memerlukan langganan Chloros+ berbayar. Pelan standard (percuma) tidak mempunyai akses CLI. Lawati https://cloud.mapir.camera/pricingarrow-up-right untuk menaik taraf.

Mula Pantas

Pemasangan

CLI disertakan secara automatik dengan pemasang Chloros:

  1. Muat turun dan jalankan Chloros Installer.exe

  2. Lengkapkan wizard pemasangan

  3. CLI dipasang pada: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

Pemasang secara automatik menambah chloros-cli pada PATH sistem anda. Mulakan semula terminal anda selepas pemasangan.

Persediaan Kali Pertama

Sebelum menggunakan CLI, aktifkan lesen Chloros+ anda:

Penggunaan Asas

Proses folder dengan tetapan lalai:


Rujukan Perintah

Sintaks Umum


Perintah

process - Proses Imej

Proses imej dalam folder dengan penentukuran.

Sintaks:

Contoh:

Pilihan Perintah Proses

Pilihan
Taip
Lalai
Penerangan

<input-folder>

Laluan

Diperlukan

Folder yang mengandungi imej berbilang spektrum RAW/JPG

-o, --output

Laluan

Sama seperti input

Folder output untuk imej yang diproses

-n, --project-name

Rentetan

Dijana secara automatik

Nama projek tersuai

--vignette

Benderakan

Didayakan

Dayakan pembetulan vignet

--no-vignette

Benderakan

-

Lumpuhkan pembetulan vignet

--reflectance

Benderakan

Didayakan

Dayakan penentukuran pantulan

--no-reflectance

Benderakan

-

Lumpuhkan penentukuran pantulan

--ppk

Benderakan

Dilumpuhkan

Gunakan pembetulan PPK daripada data penderia cahaya .daq

--format

Pilihan

TIFF (16-bit)

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

--min-target-size

Integer

Auto

Saiz sasaran minimum dalam piksel untuk pengesanan panel penentukuran

--target-clustering

Integer

Auto

Ambang pengelompokan sasaran (0-100)

--exposure-pin-1

Rentetan

Tiada

Dedahan kunci untuk model kamera (Pin 1)

--exposure-pin-2

Rentetan

Tiada

Dedahan kunci untuk model kamera (Pin 2)

--recal-interval

Integer

Auto

Selang penentukuran semula dalam saat

--timezone-offset

Integer

0

Zon waktu diimbangi dalam jam


login - Sahkan Akaun

Log masuk dengan bukti kelayakan Chloros+ anda untuk mendayakan pemprosesan CLI.

Sintaks:

Contoh:

Watak Khas: Gunakan petikan tunggal di sekitar kata laluan yang mengandungi aksara seperti $, ! atau ruang.

Keluaran:

***

logout - Kosongkan Bukti Kelayakan

Kosongkan bukti kelayakan yang disimpan dan log keluar daripada akaun anda.

Sintaks:

Contoh:

Keluaran:

circle-info

Pengguna SDK: Python SDK juga menyediakan kaedah logout() terprogram untuk mengosongkan bukti kelayakan dalam skrip Python. Lihat dokumentasi Python SDK untuk butiran.


status - Semak Status Lesen

Paparkan status lesen dan pengesahan semasa.

Sintaks:

Contoh:

Keluaran:


export-status - Semak Kemajuan Eksport

Pantau kemajuan eksport Thread 4 semasa atau selepas pemprosesan.

Sintaks:

Contoh:

Kes Penggunaan: Panggil arahan ini semasa pemprosesan sedang berjalan untuk menyemak kemajuan eksport.***

language - Urus Bahasa Antara Muka

Lihat atau tukar bahasa antara muka CLI.

Sintaks:

Contoh:

Bahasa yang Disokong (38 Jumlah)

Kod
Bahasa
Nama Asli

en

Inggeris

Inggeris

es

Sepanyol

Español

pt

Portugis

Português

fr

Perancis

Français

de

Jerman

Deutsch

it

Itali

Italiano

ja

Jepun

日本語

ko

Korea

한국어

zh

Cina (Mudah)

简体中文

zh-TW

Cina (Tradisional)

繁體中文

ru

Rusia

Русский

nl

Belanda

Belanda

ar

Bahasa Arab

العربية

pl

Poland

Polski

tr

Turki

Türkçe

hi

Hindi

हिंदी

id

Indonesia

Bahasa Indonesia

vi

Vietnam

Tiếng Việt

th

Thai

ไทย

sv

Sweden

Svenska

da

Denmark

Dansk

no

bahasa Norway

Norsk

fi

Bahasa Finland

Suomi

el

Greek

Ελληνικά

cs

Czech

Čeština

hu

Bahasa Hungary

Magyar

ro

Bahasa Romania

Română

uk

Ukraine

Українська

pt-BR

Portugis Brazil

Português Brasileiro

zh-HK

Kantonis

粵語

ms

Melayu

Bahasa Melayu

sk

Bahasa Slovak

Slovenčina

bg

Bahasa Bulgaria

Български

hr

Bahasa Croatia

Hrvatski

lt

Bahasa Lithuania

Lietuvių

lv

Bahasa Latvia

Latviešu

et

Estonia

Eesti

sl

Bahasa Slovenia

Slovenščina

circle-check

set-project-folder - Tetapkan Folder Projek Lalai

Tukar lokasi folder projek lalai (dikongsi dengan GUI).

Sintaks:

Contoh:


get-project-folder - Tunjukkan Folder Projek

Paparkan lokasi folder projek lalai semasa.

Sintaks:

Contoh:

Keluaran:


reset-project-folder - Tetapkan Semula kepada Lalai

Tetapkan semula folder projek ke lokasi lalai.

Sintaks:


Pilihan Global

Pilihan ini digunakan untuk semua arahan:

Pilihan
Taip
Lalai
Penerangan

--backend-exe

Laluan

Auto dikesan

Laluan ke bahagian belakang boleh laku

--port

Integer

5000

Bahagian belakang API nombor port

--restart

Benderakan

-

Paksa mulakan semula hujung belakang (membunuh proses sedia ada)

--version

Benderakan

-

Tunjukkan maklumat versi dan keluar

--help

Benderakan

-

Tunjukkan maklumat bantuan dan keluar

Contoh dengan Pilihan Global:


Panduan Tetapan Pemprosesan

Pemprosesan Selari

Chloros+ CLI skala automatikpemprosesan selari untuk dipadankan dengan keupayaan komputer anda:Cara Ia Berfungsi:

  • Mengesan teras CPU dan RAM anda

  • Memperuntukkan pekerja: 2× teras CPU (menggunakan hyperthreading)

  • Maksimum: 16 pekerja selari (untuk kestabilan)Tingkat Sistem:

Jenis Sistem
CPU
RAM
Pekerja
Persembahan

High-End

16+ teras

32+ GB

Sehingga 16

Kelajuan maksimum

Julat Pertengahan

8-15 teras

16-31 GB

8-16

Kelajuan yang sangat baik

Low-End

4-7 teras

8-15 GB

4-8

Kelajuan yang baik

Pengoptimuman Automatik: CLI secara automatik mengesan spesifikasi sistem anda dan mengkonfigurasi pemprosesan selari yang optimum. Tiada konfigurasi manual diperlukan!

Kaedah Debayer

CLI menggunakan Kualiti Tinggi (Lebih Cepat) sebagai algoritma debayer lalai dan disyorkan:

Kaedah
Kualiti
Kelajuan
Penerangan

Kualiti Tinggi (Lebih Cepat)

⭐⭐⭐⭐

⚡⚡⚡

Algoritma sedar tepi (lalai, disyorkan)

Pembetulan Vignette

Apa yang dilakukannya: Membetulkan kejatuhan cahaya pada tepi imej (sudut gelap biasa dalam imejan kamera).

  • Didayakan secara lalai - Kebanyakan pengguna harus memastikan ini didayakan

  • Gunakan --no-vignette untuk melumpuhkan

circle-check

Penentukuran Pantulan

Menukar nilai sensor mentah kepada peratusan pemantulan piawai menggunakan panel penentukuran.

  • Didayakan secara lalai - Penting untuk analisis tumbuh-tumbuhan

  • Memerlukan panel sasaran penentukuran dalam imej

  • Gunakan --no-reflectance untuk melumpuhkan

circle-info

Keperluan: Pastikan panel penentukuran didedahkan dengan betul dan kelihatan dalam imej anda untuk penukaran pantulan yang tepat.

Pembetulan PPK

Apa yang dilakukannya: Menggunakan pembetulan Kinematik Pasca Diproses menggunakan data log DAQ-A-SD untuk ketepatan GPS yang dipertingkatkan.

  • Dilumpuhkan secara lalai

  • Gunakan --ppk untuk mendayakan

  • Memerlukan fail .daq dalam folder projek daripada penderia cahaya MAPIR DAQ-A-SD.

Format Output

Format
Kedalaman Bit
Saiz Fail
Terbaik Untuk

TIFF (16-bit)

integer 16-bit

Besar

Analisis GIS, fotogrametri (disyorkan)

TIFF (32-bit, Peratus)

Apungan 32-bit

Sangat Besar

Analisis saintifik, penyelidikan

X4PROTX000TX2 (8-bit)

8-bit integer

Sederhana

Pemeriksaan visual, perkongsian web

JPG (8-bit)

8-bit integer

Kecil

pratonton, output termampat


Automasi & Skrip

Pemprosesan Kelompok PowerShell

Proses berbilang folder set data secara automatik:

Skrip Kelompok Windows

Gelung mudah untuk pemprosesan kelompok:

Skrip Automasi Python

Automasi lanjutan dengan pengendalian ralat:


Memproses Aliran Kerja

Aliran Kerja Standard

  1. Input: Folder yang mengandungi pasangan imej RAW/JPG

  2. Penemuan: CLI auto-imbasan untuk fail imej yang disokong

  3. Pemprosesan: Skala mod selari kepada teras CPU anda (Chloros+)

  4. Output: Mencipta subfolder model kamera dengan imej yang diproses

Contoh Struktur Output

Anggaran Masa Pemprosesan

Masa pemprosesan biasa untuk 100 imej (12MP setiap satu):

Mod
Masa
Perkakasan

Mod Selari

5-10 min

i7/Ryzen 7, 16GB RAM, SSD (sehingga 16 pekerja)

Mod Selari

10-15 min

i5/Ryzen 5, 8GB RAM, HDD (sehingga 8 pekerja)

circle-info

Petua Prestasi: Masa pemprosesan berbeza-beza berdasarkan kiraan imej, peleraian dan spesifikasi komputer.


Menyelesaikan masalah

CLI Tidak Ditemui

Ralat:

Penyelesaian:

  1. Sahkan lokasi pemasangan:

  1. Gunakan laluan penuh jika tidak dalam PATH:

  1. Tambahkan pada PATH secara manual:

    • Sifat Sistem Terbuka → Pembolehubah Persekitaran

    • Edit pembolehubah PATH

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

    • Mulakan semula terminal


Bahagian Belakang Gagal DimulakanRalat:

Penyelesaian:

  1. Semak sama ada bahagian belakang sudah berjalan (tutup dahulu)

  2. Periksa Windows Firewall tidak menyekat

  3. Cuba port yang berbeza:

  1. Paksa mulakan semula hujung belakang:


Isu Lesen / PengesahanRalat:

Penyelesaian:

  1. Sahkan anda mempunyai langganan Chloros+ yang aktif

  2. Log masuk dengan kelayakan anda:

  1. Semak status lesen:

  1. Hubungi sokongan: info@mapir.camera


Tiada Imej DitemuiRalat:

Penyelesaian:

  1. Sahkan folder mengandungi format yang disokong (.RAW, .TIF, .JPG)

  2. Semak laluan folder adalah betul (gunakan petikan untuk laluan dengan ruang)

  3. Pastikan anda telah membaca kebenaran untuk folder tersebut

  4. Semak sambungan fail adalah betul


Memproses Gerai atau GantungPenyelesaian:

  1. Semak ruang cakera yang tersedia (pastikan cukup untuk output)

  2. Tutup aplikasi lain untuk membebaskan memori

  3. Kurangkan kiraan imej (proses dalam kelompok)


Pelabuhan Sudah DigunakanRalat:

Penyelesaian:

Tentukan port yang berbeza:


Soalan Lazim

S: Adakah saya memerlukan lesen untuk CLI?

**J:Ya! CLI memerlukan lesenChloros+ berbayar.

  • ❌ Pelan standard (percuma): CLI dilumpuhkan

  • ✅ Pelan Chloros+ (berbayar): CLI didayakan sepenuhnya

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


S: Bolehkah saya menggunakan CLI pada pelayan tanpa GUI?J: Ya! CLI berjalan tanpa kepala sepenuhnya. Keperluan:

  • Windows Server 2016 atau lebih baru

  • Visual C++ Redistributable dipasang

  • RAM yang mencukupi (minimum 8GB, disyorkan 16GB)

  • Satu kali pengaktifan lesen GUI pada mana-mana mesin


S: Di manakah imej yang diproses disimpan?J:Secara lalai, imej yang diproses disimpan dalamfolder yang sama seperti input dalam subfolder model kamera (cth., Survey3N_RGN/).

Gunakan pilihan -o untuk menentukan folder output yang berbeza:


S: Bolehkah saya memproses berbilang folder sekaligus?J: Tidak secara langsung dalam satu arahan, tetapi anda boleh menggunakan skrip untuk memproses folder secara berurutan. Lihat bahagian Automasi & Skrip.***

S: Bagaimanakah cara saya menyimpan output CLI ke fail log?PowerShell:

Batch:


S: Apakah yang berlaku jika saya menekan Ctrl+C semasa pemprosesan?J: CLI akan:

  1. Hentikan pemprosesan dengan baik

  2. Tutup bahagian belakang

  3. Keluar dengan kod 130

Imej yang diproses separa mungkin kekal dalam folder output.


S: Bolehkah saya mengautomasikan pemprosesan CLI?J: Sudah tentu! CLI direka untuk automasi. Lihat Automasi & Skrip untuk contoh PowerShell, Batch dan Python.***

S: Bagaimanakah cara saya menyemak versi CLI?J:

Keluaran:


Mendapatkan Bantuan

Bantuan Baris Perintah

Lihat maklumat bantuan terus dalam CLI:

Saluran Sokongan

Contoh Lengkap

Contoh 1: Pemprosesan Asas

Proses dengan tetapan lalai (vignet, pantulan):


Contoh 2: Output Saintifik Berkualiti Tinggi

Terapung 32-bit TIFF:


Contoh 3: Pemprosesan Pratonton Pantas

8-bit PNG tanpa penentukuran untuk semakan pantas:


Contoh 4: Pemprosesan Dibetulkan PPK

Gunakan pembetulan PPK dengan pemantulan:


Contoh 5: Lokasi Output Tersuai

Proses ke pemacu yang berbeza dengan format tertentu:


Contoh 6: Aliran Kerja Pengesahan

Aliran pengesahan lengkap:


Contoh 7: Penggunaan Pelbagai Bahasa

Tukar bahasa antara muka:

Last updated