CLI: Komandu rinda

**Chloros CLI** nodrošina jaudīgu komandrindas piekļuvi attēlu apstrādes dzinējam Chloros, ļaujot automatizēt, veidot skriptus un izmantot bezgalvas režīmu jūsu attēlu apstrādes darba plūsmās.

Galvenās funkcijas

  • 🚀 Automatizācija — vairāku datu kopu skriptu pakotņu apstrāde

  • 🔗 Integrācija — iekļaušana esošajos darba plūsmās un procesa posmos

  • 💻 Darbība bez grafiskās saskarnes — darbināšana bez GUI

  • 🌍 Daudzvalodība — atbalsts 38 valodām

  • Paralēlā apstrādeDinamiskā aprēķinu pielāgošana automātiski optimizējas jūsu aparatūrai

Prasības

Prasība
Sīkāka informācija

Operētājsistēma

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

Atmiņa

Vismaz 8 GB RAM (ieteicams 16 GB)

Internets

Nepieciešams licences aktivizēšanai

Diska vieta

Atšķiras atkarībā no projekta lieluma

circle-exclamation

Ātrs sākums

Instalēšana

Windows

CLI automātiski ir iekļauts Chloros instalētājā:

  1. Lejupielādējiet un palaidiet Chloros Installer.exe

  2. Pabeidziet instalācijas vedni

  3. CLI instalēts: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-check

Linux

Instalējiet .deb paketi jūsu arhitektūrai:

Sīkāku informāciju par Linux konfigurēšanu skatiet sadaļā Linux instalēšana.

Pirmā konfigurēšana

Pirms CLI lietošanas aktivizējiet savu Chloros+ licenci:

Windows:

Linux:

Pamata lietošana

Apstrādājiet mapi ar noklusējuma iestatījumiem:

Windows:

Linux:


Komandu atsauces

Vispārīgā sintakse


Komandas

process - Apstrādāt attēlus

Apstrādā attēlus mapē ar kalibrēšanu.

Sintakse:

Piemēri:

Komandas apstrādes opcijas

Opcija
Tips
Noklusējums
Apraksts

<input-folder>

Celiņš

Obligāts

Mapes, kas satur RAW/JPG multispektrālos attēlus

-o, --output

Celiņš

Tāds pats kā ievade

Izvades mape apstrādātajiem attēliem

-n, --project-name

Virkne

Automātiski ģenerēts

Pielāgots projekta nosaukums

--vignette

Karodziņš

Iespējots

Iespējot vinjetes korekciju

--no-vignette

Karodziņš

-

Atspējot vinjetes korekciju

--reflectance

Karodziņš

Iespējots

Iespējot atstarojuma kalibrēšanu

--no-reflectance

Karodziņš

-

Atspējot atstarojuma kalibrēšanu

--ppk

Karodziņš

Atspējots

Piemērot PPK korekcijas no .daq gaismas sensora datiem

--format

Izvēle

TIFF (16 bitu)

Izvades formāts: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)

--min-target-size

Vesels skaitlis

Automātiski

Minimālais mērķa izmērs pikseļos kalibrēšanas paneļa noteikšanai

--target-clustering

Vesels skaitlis

Automātiski

Mērķa klasterizācijas slieksnis (0–100)

--debayer

Izvēle

standard

Debayer metode: standard vai texture-aware (tikai Chloros+)

--target, --targets

Karodziņš

Atspējots

Meklēt kalibrēšanas mērķus tikai apakšmapē „target” vai „targets” (paātrina apstrādi)

--indices

Saraksts

Nav

Aprēķināmie veģetācijas indeksi (piem., --indices NDVI NDRE GNDVI)

--exposure-pin-1

Virkne

Nav

Fiksē ekspozīciju kameras modelim (1. kontakts)

--exposure-pin-2

Virkne

Nav

Ekspozīcijas fiksēšana kameras modelim (2. kontakts)

--recal-interval

Vesels skaitlis

Automātiski

Pārkalibrēšanas intervāls sekundēs

--timezone-offset

Vesels skaitlis

0

Laika zonas nobīde stundās


login - Konta autentifikācija

Piesakieties ar savām Chloros+ autentifikācijas datiem, lai aktivizētu CLI apstrādi.

Sintakse:

Piemērs:

circle-exclamation

Rezultāts:

***

logout - Dzēst autentifikācijas datus

Dzēst saglabātos autentifikācijas datus un iziet no sava konta.

Sintakse:

Piemērs:

Rezultāts:

circle-info

SDK lietotāji: Python SDK nodrošina arī programmatisku logout() metodi, lai dzēstu autentifikācijas datus Python skriptos. Sīkāku informāciju skatiet Python SDK dokumentācijā.


status - Licences statusa pārbaude

Parāda pašreizējo licences un autentifikācijas statusu.

Sintakse:

Piemērs:

Rezultāts:


export-status — eksporta gaitu pārbaude

Uzrauga 4. pavediena eksporta gaitu apstrādes laikā vai pēc tās.

Sintakse:

Piemērs:

Lietošanas gadījums: Izsauciet šo komandu apstrādes laikā, lai pārbaudītu eksporta gaitu.***

language - Pārvaldīt saskarnes valodu

Skatīt vai mainīt CLI saskarnes valodu.

Sintakse:

Piemēri:

Atbalstītās valodas (kopā 38)

Kods
Valoda
Nativais nosaukums

en

Angļu

English

es

Spāņu

Español

pt

Portugāļu

Português

fr

Franču

Français

de

Vācu

Deutsch

it

Itāļu

Italiano

ja

Japāņu

日本語

ko

Korejiešu

한국어

zh

Ķīniešu (vienkāršotā)

简体中文

zh-TW

Ķīniešu (tradicionālā)

繁體中文

ru

Krievu

Русский

nl

Holandiešu

Nederlands

ar

Arābu

العربية

pl

Poļu

Polski

tr

Turku valoda

Türkçe

hi

Hindi

हिंदी

id

Indonēziešu valoda

Bahasa Indonesia

vi

Vjetnamiešu

Tiếng Việt

th

Taizemiešu

ไทย

sv

Zviedru

Svenska

da

Dāņu

Dansk

no

Norvēģu

Norsk

fi

Somu

Suomi

el

Grieķu

Ελληνικά

cs

Čehu

Čeština

hu

Ungāru

Magyar

ro

Rumāņu

Română

uk

Ukraiņu

Українська

pt-BR

Brazīlijas portugāļu valoda

Português Brasileiro

zh-HK

Kantoniešu valoda

粵語

ms

Malajiešu valoda

Bahasa Melayu

sk

Slovāku

Slovenčina

bg

Bulgāru

Български

hr

Horvātu

Hrvatski

lt

Lietuviešu

Lietuvių

lv

Latviešu

Latviešu

et

Igauniešu

Eesti

sl

Slovēņu

Slovenščina

circle-check

set-project-folder - Noklusējuma projekta mapes iestatīšana

Mainiet noklusējuma projekta mapes atrašanās vietu (kopīga ar GUI Windows).

Sintakse:

Piemēri:


get-project-folder - Parādīt projekta mapi

Parāda pašreizējo noklusējuma projekta mapes atrašanās vietu.

Sintakse:

Piemērs:

Rezultāts:


reset-project-folder - Atjaunot noklusējuma iestatījumus

Atjaunot projekta mapes noklusējuma atrašanās vietu.

Sintakse:


selftest - Sistēmas diagnostikas palaide

Palaidiet 7 diagnostikas pārbaudes, lai pārbaudītu sistēmas konfigurāciju.

Sintakse:

Veiktās diagnostikas:

  1. Versijas pārbaude

  2. Porta pieejamība (5000)

  3. Backend palaišana

  4. API savienojamības tests

  5. Sistēmas informācija un GPU noteikšana

  6. Denoiser modeļu pārbaude

  7. CUDA pieejamības pārbaude

circle-info

Noderīgi problēmu novēršanai: Pēc instalēšanas palaidiet selftest, lai pārbaudītu, vai sistēma ir konfigurēta pareizi, īpaši Linux/Jetson, kur var būt nepieciešama GPU un CUDA konfigurācijas pārbaude.


update - Pārbaudiet, vai ir pieejami atjauninājumi (tikai Linux)

Pārbaudiet un instalējiet CLI atjauninājumus Linux sistēmās.

Sintakse:

Opcija
Apraksts

--check

Vienīgi pārbaudīt atjauninājumus, neinstalēt

circle-info

Šī komanda ir pieejama tikai Linux. Windows sistēmās atjauninājumi tiek piegādāti ar instalētāja starpniecību.


Vispārējās opcijas

Šīs opcijas attiecas uz visām komandām:

Opcija
Tips
Noklusējums
Apraksts

--backend-exe

Celiņš

Automātiski noteikts

Celiņš uz aizmugures izpildāmo failu

--port

Vesels skaitlis

5000

Aizmugures API porta numurs

--restart

Karodziņš

-

Piespiedu atkārtota aizmugurējās programmas palaišana (izbeidz esošos procesus)

--version

Karodziņš

-

Parādīt versijas informāciju un iziet

--help

Karodziņš

-

Parādīt palīdzības informāciju un iziet

circle-info

Aizmugures automātiskā noteikšana: --backend-exe ceļš tiek automātiski noteikts atbilstoši platformai:

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

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

  • Linux (manuāli): /opt/mapir/chloros/backend/chloros-backend

Piemērs ar globālajām opcijām:

Windows:

Linux:


Apstrādes iestatījumu rokasgrāmata

Paralēlā apstrāde un dinamiskā aprēķinu pielāgošana

Chloros 1.1.0 ietver dinamisko aprēķinu pielāgošanu — apstrādes dzinējs automātiski atpazīst jūsu aparatūru un izvēlas optimālo stratēģiju:

Platforma
Stratēģija
Darbinieki
Pieslēgums
Piezīmes

Jetson Nano 8GB

GPU_SINGLE

1

tiled_gpu

Atmiņai efektīva, serializēta

Jetson Orin NX 16GB

GPU_PARALLEL

3

fused_gpu

Vienlaicīga GPU apstrāde

Galddators ar 8 GB GPU

GPU_SINGLE

3

tiled_gpu

Laba galddatora veiktspēja

Datoru ar 12 GB+ GPU

GPU_PARALLEL

3–4

fused_gpu

Optimāla datora veiktspēja

Tikai CPU sistēma

CPU_PARALLEL

kodoli - 1

cpu_fallback

GPU nav nepieciešams

circle-check

Debayer metodes

Metode
CLI Karodziņš
Kvalitāte
Ātrums
Licence

Standarta (ātra, vidēja kvalitāte)

--debayer standard

Laba

Ātra

Bezmaksas / Chloros+

Tekstūras apzināta (lēna, augstākā kvalitāte)

--debayer texture-aware

Augstākā

Lēna

Tikai Chloros+

Noklusējuma debayer metode ir Standarta.Tekstūras apzināšanās metode izmanto AI/ML trokšņu samazināšanas modeli, lai nodrošinātu augstāko izvades kvalitāti, taču tai ir nepieciešama Chloros+ licence un NVIDIA GPU.

Vignette korekcija

Funkcija: Korekcija attēla malu izgaismojuma samazināšanās (tumšāki stūri, kas bieži sastopami kameru attēlos).

  • Pēc noklusējuma ieslēgts - Lielākajai daļai lietotāju šo funkciju vajadzētu atstāt ieslēgtu

  • Lai atslēgtu, izmantojiet --no-vignette

circle-check

Atstarošanas kalibrēšana

Pārvērš neapstrādātos sensora rādījumus standartizētos atstarošanas procentos, izmantojot kalibrēšanas paneļus.

  • Pēc noklusējuma ieslēgts — nepieciešams veģetācijas analīzei

  • Attēlos nepieciešami kalibrēšanas mērķa paneļi

  • Lai atslēgtu, izmantojiet --no-reflectance

circle-info

Prasības: Lai nodrošinātu precīzu atstarojuma pārrēķinu, pārliecinieties, ka kalibrēšanas paneļi attēlos ir pareizi eksponēti un redzami.

PPK korekcijas

Funkcija: Piemēro pēcapstrādes kinemātiskās korekcijas, izmantojot DAQ-A-SD žurnāla datus, lai uzlabotu GPS precizitāti.

  • Pēc noklusējuma atspējots

  • Lai ieslēgtu, izmantojiet --ppk

  • Nepieciešami .daq faili projekta mapē no MAPIR DAQ-A-SD gaismas sensora.

Izvades formāti

Formāts
Bitu dziļums
Faila izmērs
Vispiemērotākais

TIFF (16 bitu)

16 bitu vesels skaitlis

Liels

ĢIS analīze, fotogrammetrija (ieteicams)

TIFF (32 bitu, procenti)

32 bitu peldošā komata

Ļoti liels

Zinātniskā analīze, pētniecība

PNG (8 bitu)

8 bitu vesels skaitlis

Vidējs

Vizuāla pārbaude, koplietošana tīmeklī

JPG (8 bitu)

8 bitu vesels skaitlis

Maz

Ātrā priekšskatīšana, saspiesta izvade

***

Automatizācija un skripti

PowerShell partiju apstrāde (Windows)

Automātiski apstrādājiet vairākas datu kopu mapes, izmantojot Windows:

Windows partijas skripts (Windows)

Vienkārša cilpa partijas apstrādei Windows:

Bash partiju apstrāde (Linux)

Apstrādājiet vairākas datu kopu mapes uz Linux:

Python automatizācijas skripts (Daudzplatformas)

Uzlabota automatizācija ar kļūdu apstrādi (darbojas ar Windows un Linux):


Apstrādes darba plūsma

Standarta darba plūsma

  1. Ievade: Mapes, kas satur RAW/JPG attēlu pārus

  2. Atklāšana: CLI automātiski skenē atbalstītos attēlu failus

  3. Apstrāde: Paralēlais režīms pielāgojas jūsu procesora kodoliem (Chloros+)

  4. Rezultāts: Izveido kameras modeļa apakšmapes ar apstrādātajiem attēliem

Rezultāta struktūras piemērs

Apstrādes laika aprēķini

Tipisks apstrādes laiks 100 attēliem (katrs 12 MP):

Platforma
Režīms
Aplēstais laiks
Piezīmes

Datoru 12 GB+ GPU

GPU_PARALLEL

5–10 min

Ātrākā opcija

Datoru 8 GB GPU

GPU_SINGLE

10–15 min

Laba veiktspēja

Jetson Orin NX 16 GB

GPU_PARALLEL

15–25 min

Malas aprēķini

Jetson Nano 8 GB

GPU_SINGLE

30–60 min

Ierobežota atmiņa

Tikai CPU

CPU_PARALLEL

20–40 min

Nav nepieciešams GPU

circle-info

Padoms par veiktspēju: Apstrādes laiks atšķiras atkarībā no attēlu skaita, izšķirtspējas, debayer metodes un aparatūras. Tekstūras apzinātais debayer aizņem ievērojami ilgāku laiku nekā standarta. Sīkāku informāciju skatiet sadaļā Dinamiskā aprēķinu pielāgošana.


Problēmu novēršana

CLI nav atrasts

Windows Kļūda:

Windows Risinājumi:

  1. Pārbaudiet instalācijas vietu:

  1. Ja nav PATH, izmantojiet pilnu ceļu:

  1. Pievienojiet PATH manuāli:

    • Atveriet Sistēmas īpašības → Vides mainīgie

    • Rediģējiet PATH mainīgo

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

    • Pārstartējiet termināli

Linux Kļūda:

Linux Risinājumi:

  1. Pārbaudiet instalāciju:

  1. Atjauniniet savu apvalku:

  1. Pārbaudiet atļaujas:


Backend neizdevās sāktKļūda:

Risinājumi:

  1. Pārbaudiet, vai backend jau darbojas (vispirms to aizveriet)

  2. Pārbaudiet, vai ugunsmūris to neblokē (Windows) vai pārbaudiet porta pieejamību (Linux: lsof -i :5000)

  3. Izmēģiniet citu portu:

  1. Piespiediet backend pārstartēšanu:

  1. Uz Linux pārbaudiet, vai backend izpildāmais fails pastāv:


Licences / autentifikācijas problēmasKļūda:

Risinājumi:

  1. Pārbaudiet, vai jums ir aktīvs Chloros+ abonements

  2. Piesakieties ar savām lietotājvārda un paroles datiem:

  1. Pārbaudiet licences statusu:

  1. Sazinieties ar atbalsta dienestu: info@mapir.camera


Risinājumi:

  1. Pārbaudiet, vai mapē ir atbalstītie formāti (.RAW, .TIF, .JPG)

  2. Pārbaudiet, vai mapes ceļš ir pareizs (ceļiem ar atstarpēm izmantojiet pēdiņas)

  3. Pārliecinieties, ka jums ir lasīšanas tiesības uz mapi

  4. Pārbaudiet, vai failu paplašinājumi ir pareizi


Apstrāde apstājas vai iesaldējasRisinājumi:

  1. Pārbaudiet pieejamo diska vietu (pārliecinieties, ka tā ir pietiekama izvadei)

  2. Aizveriet citas programmas, lai atbrīvotu atmiņu

  3. Samaziniet attēlu skaitu (apstrādājiet partijās)


Ports jau tiek izmantotsKļūda:

Risinājumi:

Windows:

Linux:


Bieži uzdotie jautājumi

J: Vai man ir nepieciešama licence CLI?

A:Jā! CLI prasa maksasChloros+ licenci.

  • ❌ Standarta (bezmaksas) plāns: CLI ir atspējots

  • ✅ Chloros+ (maksas) plāni: CLI ir pilnībā iespējots

Abonējieties: https://cloud.mapir.camera/pricingarrow-up-right


J: Vai es varu izmantot CLI serverī bez GUI?A: Jā! CLI darbojas pilnīgi bez grafiskās saskarnes. Tas ir galvenais lietošanas gadījums Linux.Windows serveris:

  • Windows Server 2016 vai jaunāka versija

  • Instalēta Visual C++ Redistributable

Linux serveris:

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

  • Instalējiet, izmantojot .deb paketi

Abas platformas:

  • Vismaz 8 GB RAM (ieteicams 16 GB)

  • Vienreizēja licences aktivizēšana: chloros-cli login user@example.com 'password'


J: Kur tiek saglabāti apstrādātie attēli?A:Pēc noklusējuma apstrādātie attēli tiek saglabātitajā pašā mapē, kurā atrodas ievades faili, kameras modeļa apakšmapēs (piem., Survey3N_RGN/).

Izmantojiet opciju -o, lai norādītu citu izvades mapi:


J: Vai varu apstrādāt vairākas mapes vienlaikus?A: Tieši ar vienu komandu nē, bet varat izmantot skriptus, lai apstrādātu mapes secīgi. Skatīt sadaļu Automatizācija un skripti.***

J: Kā saglabāt CLI izvadi žurnāla failā?PowerShell:

Batch:

Linux Bash:


J: Kas notiek, ja apstrādes laikā nospiežu Ctrl+C?A: CLI:

  1. Pārtrauks apstrādi pareizi

  2. Izslēgs backend

  3. Iziet ar kodu 130

Daļēji apstrādāti attēli var palikt izvades mapē.


J: Vai varu automatizēt CLI apstrādi?A: Protams! CLI ir paredzēts automatizācijai. Skatīt Automatizācija un skripti par PowerShell (Windows), Batch (Windows), Bash (Linux) un Python (vairāku platformu) piemērus.***

J: Kā pārbaudīt CLI versiju?A:

Rezultāts:


Palīdzības saņemšana

Palīdzība komandrindā

Skatīt palīdzības informāciju tieši CLI:

Atbalsta kanāli

Pilnīgi piemēri

1. piemērs: Pamata apstrāde

Apstrāde ar noklusējuma iestatījumiem (vignette, reflectance):

Windows:

Linux:


2. piemērs: Augstas kvalitātes zinātniskie rezultāti

32 bitu peldošā komata TIFF:

Windows:

Linux:


3. piemērs: Ātra priekšskatīšanas apstrāde

8 bitu PNG bez kalibrēšanas ātrai pārskatīšanai:

Windows:

Linux:


4. piemērs: Apstrāde ar PPK korekcijām

Piemērojiet PPK korekcijas ar atstarojumu:

Windows:

Linux:


5. piemērs: Pielāgota izvades vieta

Apstrādājiet citā vietā ar konkrētu formātu:

Windows:

Linux:


6. piemērs: Autentifikācijas darbplūsma

Pilnīga autentifikācijas darbplūsma (vienāda visās platformās):


7. piemērs: Daudzvalodu lietošana

Saskarnes valodas maiņa (vienāda visās platformās):

Last updated