CLI : Linia de comandă

**Chloros CLI** oferă acces puternic prin linia de comandă la motorul de procesare a imaginilor Chloros, permițând automatizarea, scriptarea și funcționarea fără interfață grafică pentru fluxurile dvs. de lucru de imagistică.

Caracteristici cheie

  • 🚀 Automatizare - Procesare scriptată în lot a mai multor seturi de date

  • 🔗 Integrare - Încorporare în fluxurile de lucru și pipeline-urile existente

  • 💻 Funcționare fără interfață grafică - Rulare fără GUI

  • 🌍 Multilingv - Suport pentru 38 de limbi

  • Procesare paralelă - Adaptarea dinamică a calculului se optimizează automat pentru hardware-ul dvs.

Cerințe

Cerință
Detalii

Sistem de operare

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

Memorie

Minim 8 GB RAM (se recomandă 16 GB)

Internet

Necesar pentru activarea licenței

Spațiu pe disc

Variază în funcție de dimensiunea proiectului

circle-exclamation

Ghid de pornire rapidă

Instalare

Windows

CLI este inclus automat în programul de instalare Chloros:

  1. Descărcați și rulați Chloros Installer.exe

  2. Finalizați expertul de instalare

  3. CLI instalat în: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-check

Linux

Instalați pachetul .deb pentru arhitectura dvs.:

Pentru configurarea detaliată a Linux, consultați Instalarea Linux.

Configurarea inițială

Înainte de a utiliza CLI, activați licența Chloros+:

Windows:

Linux:

Utilizare de bază

Procesați un folder cu setările implicite:

Windows:

Linux:


Referință comenzi

Sintaxă generală


Comenzi

process - Procesare imagini

Procesarea imaginilor dintr-un folder cu calibrare.

Sintaxă:

Exemple:

Opțiuni ale comenzii de procesare

Opțiune
Tip
Implicit
Descriere

<input-folder>

Cale

Obligatoriu

Dosar care conține imagini multispectrale RAW/JPG

-o, --output

Cale

La fel ca intrarea

Dosar de ieșire pentru imaginile procesate

-n, --project-name

Șir

Generat automat

Nume personalizat al proiectului

--vignette

Indicator

Activat

Activează corectarea vignetării

--no-vignette

Indicator

-

Dezactivează corectarea vignetării

--reflectance

Indicator

Activat

Activează calibrarea reflectanței

--no-reflectance

Indicator

-

Dezactivează calibrarea reflectanței

--ppk

Indicator

Dezactivat

Aplică corecții PPK din datele senzorului de lumină .daq

--format

Opțiune

TIFF (16 biți)

Format de ieșire: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)

--min-target-size

Număr întreg

Auto

Dimensiunea minimă a țintei în pixeli pentru detectarea panoului de calibrare

--target-clustering

Număr întreg

Auto

Pragul de grupare a țintelor (0-100)

--debayer

Opțiune

standard

Metoda de debayer: standard sau texture-aware (numai Chloros+)

--target, --targets

Indicator

Dezactivat

Căutați ținte de calibrare numai într-un subfolder „target” sau „targets” (accelerează procesarea)

--indices

Listă

Niciuna

Indici de vegetație de calculat (de ex., --indices NDVI NDRE GNDVI)

--exposure-pin-1

Șir

Niciuna

Blochează expunerea pentru modelul de cameră (Pin 1)

--exposure-pin-2

Șir

Niciunul

Blocare expunere pentru modelul camerei (Pin 2)

--recal-interval

Număr întreg

Auto

Interval de recalibrare în secunde

--timezone-offset

Număr întreg

0

Decalaj de fus orar în ore


login - Autentificare cont

Conectați-vă cu datele de autentificare Chloros+ pentru a activa procesarea CLI.

Sintaxă:

Exemplu:

circle-exclamation

Rezultat:

***

logout - Ștergeți datele de autentificare

Ștergeți datele de autentificare stocate și deconectați-vă de la contul dvs.

Sintaxă:

Exemplu:

Rezultat:

circle-info

Utilizatori SDK: Python SDK oferă, de asemenea, o metodă programatică logout() pentru ștergerea datelor de autentificare în cadrul scripturilor Python. Consultați documentația Python SDK pentru detalii.


status - Verificarea stării licenței

Afișează starea actuală a licenței și a autentificării.

Sintaxă:

Exemplu:

Rezultat:


export-status - Verificare progres export

Monitorizează progresul exportului Thread 4 în timpul sau după procesare.

Sintaxă:

Exemplu:

Caz de utilizare: Apelați această comandă în timp ce procesarea este în curs de desfășurare pentru a verifica progresul exportului.***

language - Gestionați limba interfeței

Vizualizați sau modificați limba interfeței CLI.

Sintaxă:

Exemple:

Limbi acceptate (38 în total)

Cod
Limbă
Nume nativ

en

Engleză

English

es

Spaniolă

Español

pt

Portugheză

Português

fr

Franceză

Français

de

Germană

Deutsch

it

Italiană

Italiano

ja

Japoneză

日本語

ko

Coreeană

한국어

zh

Chineză (simplificată)

简体中文

zh-TW

Chineză (tradițională)

繁體中文

ru

Rusă

Русский

nl

Olandeză

Nederlands

ar

Arabă

العربية

pl

Poloneză

Polski

tr

Turcă

Türkçe

hi

Hindi

हिंदी

id

Indoneziană

Bahasa Indonesia

vi

Vietnameză

Tiếng Việt

th

Thailandeză

ไทย

sv

Suedeză

Svenska

da

Daneză

Dansk

no

Norvegiană

Norsk

fi

Finlandeză

Suomi

el

Greacă

Ελληνικά

cs

Cehă

Čeština

hu

Maghiară

Magyar

ro

Română

Română

uk

Ucraineană

Українська

pt-BR

Portugheză braziliană

Português Brasileiro

zh-HK

Cantoneză

粵語

ms

Malay

Bahasa Melayu

sk

Slovacă

Slovenčina

bg

Bulgară

Български

hr

Croată

Hrvatski

lt

Lituaniană

Lietuvių

lv

Letonă

Latviešu

et

Estonă

Eesti

sl

Slovenă

Slovenščina

circle-check

set-project-folder - Setare folder proiect implicit

Modificați locația folderului de proiect implicit (partajat cu GUI în Windows).

Sintaxă:

Exemple:


get-project-folder - Afișează folderul proiectului

Afișează locația curentă a folderului implicit al proiectului.

Sintaxă:

Exemplu:

Rezultat:


reset-project-folder - Resetare la valorile implicite

Resetează folderul proiectului la locația implicită.

Sintaxă:


selftest - Executare diagnosticare sistem

Execută 7 verificări de diagnosticare pentru a verifica configurația sistemului.

Sintaxă:

Diagnostice efectuate:

  1. Verificare versiune

  2. Disponibilitate port (5000)

  3. Pornire backend

  4. Test de conectivitate API

  5. Informații sistem și detectare GPU

  6. Verificare modele de denoizare

  7. Verificare disponibilitate CUDA

circle-info

Util pentru depanare: Rulați selftest după instalare pentru a verifica dacă sistemul dvs. este configurat corect, în special pe Linux/Jetson, unde configurarea GPU și CUDA poate necesita verificare.


update - Verificare actualizări (numai pentru Linux)

Verificați și instalați actualizările CLI pe sistemele Linux.

Sintaxă:

Opțiune
Descriere

--check

Verifică doar actualizările, nu le instalează

circle-info

Această comandă este disponibilă numai pe Linux. Pe Windows, actualizările sunt livrate prin intermediul programului de instalare.


Opțiuni globale

Aceste opțiuni se aplică tuturor comenzilor:

Opțiune
Tip
Implicit
Descriere

--backend-exe

Cale

Detectat automat

Calea către executabilul backend

--port

Număr întreg

5000

Numărul portului backend API

--restart

Indicator

-

Forțează repornirea backend-ului (închide procesele existente)

--version

Indicator

-

Afișează informații despre versiune și iese

--help

Indicator

-

Afișează informații de ajutor și iese

circle-info

Detectarea automată a backend-ului: Calea --backend-exe este detectată automat pentru fiecare 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

Exemplu cu opțiuni globale:

Windows:

Linux:


Ghid de setări de procesare

Procesare paralelă și adaptare dinamică a calculului

Chloros 1.1.0 include Adaptarea dinamică a calculului — motorul de procesare detectează automat hardware-ul și selectează strategia optimă:

Platformă
Strategie
Lucrători
Pipeline
Note

Jetson Nano 8 GB

GPU_SINGLE

1

tiled_gpu

Eficient din punct de vedere al memoriei, serializat

Jetson Orin NX 16 GB

GPU_PARALLEL

3

fused_gpu

Procesare GPU simultană

Desktop cu GPU de 8 GB

GPU_SINGLE

3

tiled_gpu

Performanță bună pentru desktop

Desktop cu GPU de 12 GB+

GPU_PARALLEL

3-4

fused_gpu

Performanță optimă a desktopului

Sistem doar cu CPU

CPU_PARALLEL

nuclee - 1

cpu_fallback

Nu este necesar GPU

circle-check

Metode de debayer

Metodă
CLI Indicator
Calitate
Viteză
Licență

Standard (Rapid, Calitate medie)

--debayer standard

Bună

Rapid

Gratuit / Chloros+

Sensibil la textură (lent, calitate maximă)

--debayer texture-aware

Maximă

Lent

Numai Chloros+

Metoda implicită de debayer este Standard. MetodaSensibilă la textură utilizează un model de denoizare AI/ML pentru o ieșire de cea mai înaltă calitate, dar necesită o licență Chloros+ și un GPU NVIDIA.

Corecția vignetării

Ce face: Corectează scăderea intensității luminoase la marginile imaginii (colțurile mai întunecate, frecvente în imaginile capturate de cameră).

  • Activată implicit - Majoritatea utilizatorilor ar trebui să păstreze această opțiune activată

  • Utilizați --no-vignette pentru a o dezactiva

circle-check

Calibrarea reflectanței

Convertește valorile brute ale senzorului în procente de reflectanță standardizate folosind panouri de calibrare.

  • Activată implicit - Esențială pentru analiza vegetației

  • Necesită panouri țintă de calibrare în imagini

  • Utilizați --no-reflectance pentru a dezactiva

circle-info

Cerințe: Asigurați-vă că panourile de calibrare sunt expuse corespunzător și vizibile în imaginile dvs. pentru o conversie precisă a reflectanței.

Corecții PPK

Ce face: Aplică corecții cinematice post-procesate utilizând datele de jurnal DAQ-A-SD pentru o precizie GPS îmbunătățită.

  • Dezactivat implicit

  • Utilizați --ppk pentru a activa

  • Necesită fișiere .daq în folderul proiectului de la senzorul de lumină DAQ-A-SD MAPIR.

Formate de ieșire

Format
Adâncime de biți
Dimensiune fișier
Ideal pentru

TIFF (16 biți)

Număr întreg pe 16 biți

Mare

Analiză GIS, fotogrammetrie (recomandat)

TIFF (32 de biți, procent)

Număr real pe 32 de biți

Foarte mare

Analiză științifică, cercetare

PNG (8 biți)

Număr întreg pe 8 biți

Mediu

Inspecție vizuală, partajare web

JPG (8 biți)

Număr întreg pe 8 biți

Mic

Previzualizare rapidă, ieșire comprimată

***

Automatizare și scripturi

Procesare în lot PowerShell (Windows)

Procesați automat mai multe foldere cu seturi de date pe Windows:

Script de lot Windows (Windows)

Buclă simplă pentru procesarea în lot pe Windows:

Procesare batch Bash (Linux)

Procesarea mai multor foldere cu seturi de date pe Linux:

Script de automatizare Python (multiplatformă)

Automatizare avansată cu gestionarea erorilor (funcționează pe Windows și Linux):


Fluxul de lucru al procesării

Flux de lucru standard

  1. Intrare: Dosar care conține perechi de imagini RAW/JPG

  2. Descoperire: CLI scanează automat fișierele imagine acceptate

  3. Prelucrare: Modul paralel se adaptează la nucleele procesorului (Chloros+)

  4. Ieșire: Creează subfoldere pentru fiecare model de cameră cu imaginile procesate

Exemplu de structură de ieșire

Estimări privind timpul de procesare

Timpuri tipice de procesare pentru 100 de imagini (12 MP fiecare):

Platformă
Mod
Timp estimat
Note

Desktop 12 GB+ GPU

GPU_PARALLEL

5-10 min

Cea mai rapidă opțiune

Desktop 8 GB GPU

GPU_SINGLE

10-15 min

Performanță bună

Jetson Orin NX 16 GB

GPU_PARALLEL

15-25 min

Calcul la margine

Jetson Nano 8 GB

GPU_SINGLE

30-60 min

Memorie limitată

Numai CPU

CPU_PARALLEL

20-40 min

Nu este necesar GPU

circle-info

Sfat privind performanța: Timpul de procesare variază în funcție de numărul de imagini, rezoluție, metoda de debayer și hardware. Metoda de debayer Texture Aware durează semnificativ mai mult decât cea Standard. Consultați Adaptarea dinamică a calculului pentru detalii.


Depanare

CLI Nu a fost găsit

Eroare Windows:

Windows Soluții:

  1. Verificați locația de instalare:

  1. Utilizați calea completă dacă nu se află în PATH:

  1. Adăugați manual la PATH:

    • Deschideți Proprietăți sistem → Variabile de mediu

    • Editați variabila PATH

    • Adăugați: C:\Program Files\Chloros\resources\cli

    • Reporniți terminalul

Eroare Linux:

Linux Soluții:

  1. Verificați instalarea:

  1. Reîncărcați shell-ul:

  1. Verificați permisiunile:


Backend-ul nu a putut fi pornitEroare:

Soluții:

  1. Verificați dacă backend-ul rulează deja (închideți-l mai întâi)

  2. Verificați dacă firewall-ul nu blochează (Windows) sau verificați disponibilitatea portului (Linux: lsof -i :5000)

  3. Încercați un alt port:

  1. Forțați repornirea backend-ului:

  1. Pe Linux, verificați dacă executabilul backend-ului există:


Probleme legate de licență / autentificareEroare:

Soluții:

  1. Verificați dacă aveți un abonament Chloros+ activ

  2. Autentificați-vă cu datele de autentificare:

  1. Verificați starea licenței:

  1. Contactați serviciul de asistență: info@mapir.camera


Nu s-au găsit imaginiEroare:

Soluții:

  1. Verificați dacă folderul conține formate acceptate (.RAW, .TIF, .JPG)

  2. Verificați dacă calea către folder este corectă (utilizați ghilimele pentru căile care conțin spații)

  3. Asigurați-vă că aveți permisiuni de citire pentru folder

  4. Verificați dacă extensiile fișierelor sunt corecte


Procesarea se blochează sau se opreșteSoluții:

  1. Verificați spațiul disponibil pe disc (asigurați-vă că este suficient pentru ieșire)

  2. Închideți alte aplicații pentru a elibera memorie

  3. Reduceți numărul de imagini (procesați în loturi)


Portul este deja utilizatEroare:

Soluții:

Windows:

Linux:


Întrebări frecvente

Î: Am nevoie de o licență pentru CLI?

R:Da! CLI necesită olicență Chloros+ plătită.

  • ❌ Plan standard (gratuit): CLI dezactivat

  • ✅ Planuri Chloros+ (cu plată): CLI complet activat

Abonați-vă la: https://cloud.mapir.camera/pricingarrow-up-right


Î: Pot folosi CLI pe un server fără GUI?R: Da! CLI rulează complet fără interfață grafică. Acesta este principalul caz de utilizare pe Linux.Server Windows:

  • Server Windows 2016 sau o versiune ulterioară

  • Visual C++ Redistributable instalat

Server Linux:

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

  • Instalare prin pachetul .deb

Ambele platforme:

  • Minim 8 GB RAM (se recomandă 16 GB)

  • Activare licență unică: chloros-cli login user@example.com 'password'


Î: Unde sunt salvate imaginile procesate?R:În mod implicit, imaginile procesate sunt salvate înacelași folder ca și cele de intrare, în subfoldere denumite după modelul camerei (de ex., Survey3N_RGN/).

Utilizați opțiunea -o pentru a specifica un alt folder de ieșire:


Î: Pot procesa mai multe foldere simultan?R: Nu direct într-o singură comandă, dar puteți utiliza scripturi pentru a procesa folderele secvențial. Consultați secțiunea Automatizare și scripturi.***

Î: Cum pot salva ieșirea CLI într-un fișier jurnal?PowerShell:

Batch:

Linux Bash:


Î: Ce se întâmplă dacă apăs Ctrl+C în timpul procesării?R: CLI va:

  1. Opri procesarea în mod corespunzător

  2. Opri backend-ul

  3. Ieși cu codul 130

Imaginile procesate parțial pot rămâne în folderul de ieșire.


Î: Pot automatiza procesarea CLI?R: Desigur! CLI este conceput pentru automatizare. Consultați Automatizare și scripturi pentru PowerShell (Windows), Batch (Windows), Bash (Linux) și Python (multiplatformă).***

Î: Cum verific versiunea CLI?R:

Rezultat:


Obținerea de ajutor

Ajutor pentru linia de comandă

Vizualizați informațiile de ajutor direct în CLI:

Canale de asistență

Exemple complete

Exemplul 1: Procesare de bază

Procesare cu setările implicite (vignette, reflectanță):

Windows:

Linux:


Exemplul 2: Rezultate științifice de înaltă calitate

32-bit float TIFF:

Windows:

Linux:


Exemplul 3: Procesare rapidă a previzualizării

8 biți PNG fără calibrare pentru revizuire rapidă:

Windows:

Linux:


Exemplul 4: Procesare cu corecție PPK

Aplicați corecții PPK cu reflectanță:

Windows:

Linux:


Exemplul 5: Locație de ieșire personalizată

Procesați într-o locație diferită cu un format specific:

Windows:

Linux:


Exemplul 6: Fluxul de autentificare

Flux complet de autentificare (identic pe toate platformele):


Exemplul 7: Utilizarea mai multor limbi

Schimbarea limbii interfeței (identică pe toate platformele):

Last updated