CLI: Komandu rinda

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

Galvenās funkcijas

  • 🚀 Automatizācija - vairāku datu kopu skriptu partiju apstrāde

  • 🔗 Integrācija - iekļaušana esošajos darba plūsmās un cauruļvados

  • 💻 Bezgalvas darbība - darbināšana bez GUI

  • 🌍 Daudzvalodība - atbalsts 38 valodām

  • Paralēla apstrāde — dinamiski pielāgojas jūsu CPU (līdz 16 paralēliem darbiniekiem)

Prasības

Prasība
Detalizēta informācija

Operētājsistēma

Windows 10/11 (64 bitu)

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-info

Licences prasības: CLI ir nepieciešama maksas Chloros+ abonementa. Standarta (bezmaksas) plāniem nav piekļuves CLI. Apmeklējiet https://cloud.mapir.camera/pricingarrow-up-right, lai veiktu uzlabojumu.

Ātrs sākums

Instalēšana

CLI automātiski tiek iekļauts Chloros instalētājs:

  1. Lejupielādējiet un palaidiet Chloros instalētājs.exe

  2. Pabeidziet instalēšanas vedni

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

circle-info

Instalētājs automātiski pievieno chloros-cli jūsu sistēmas PATH. Pēc instalācijas pārstartējiet termināli.

Pirmā uzstādīšana

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

Pamata lietošana

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


Komandu atsauces

Vispārīgā sintakse


Komandas

process - attēlu apstrāde

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

Sintakse:

Piemērs:

Apstrādes komandu opcijas

Opcija
Tips
Noklusējums
Apraksts

<input-folder>

Celiņš

Nepieciešams

Mapīte, kas satur RAW/JPG multispektrālos attēlus

-o, --output

Celiņš

Tāds pats kā ievade

Izvades mapīte apstrādātajiem attēliem

-n, --project-name

String

Automātiski ģenerēts

Pielāgots projekta nosaukums

--vignette

Karodziņš

Iespējots

Iespējot vinjetes korekciju

--no-vignette

Karodziņš

-

Atcelt vinjetes korekciju

--reflectance

Karodziņš

Iespējots

Iespējot atstarojuma kalibrēšanu

--no-reflectance

Karodziņš

-

Atspējot atstarojuma kalibrēšanu

--ppk

Karodziņš

Atvienots

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)

--exposure-pin-1

String

Nav

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

--exposure-pin-2

String

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-info

Īpašie simboli: Lietojiet vienkāršās pēdiņas ap parolēm, kas satur simbolus, piemēram, $, ! vai atstarpes.

Rezultāts:

***

logout - Dzēst paroles

Dzēst saglabātās paroles 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

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

Sintakse:

Piemērs:

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

language — interfeisa valodas pārvaldība

Skatīt vai mainīt CLI interfeisa valodu.

Sintakse:

Piemēri:

Atbalstītās valodas (kopā 38)

Kods
Valoda
Vietējais nosaukums

en

Angļu valoda

English

es

Spāņu valoda

Español

pt

Portugāļu valoda

Português

fr

Franču valoda

Français

de

Vācu valoda

Deutsch

it

Itāļu valoda

Italiano

ja

Japāņu valoda

日本語

ko

Korejiešu valoda

한국어

zh

Ķīniešu valoda (vienkāršota)

简体中文

zh-TW

Ķīniešu valoda (tradicionālā)

繁體中文

ru

Krievu valoda

Русский

nl

Holandiešu valoda

Nederlands

ar

Arābu valoda

العربية

pl

Poļu valoda

Polski

tr

Turku valoda

Türkçe

hi

Hindi valoda

हिंदी

id

Indonēziešu valoda

Bahasa Indonesia

vi

vjetnamiešu valoda

Tiếng Việt

th

taju valoda

ไทย

sv

zviedru valoda

Svenska

da

dāņu valoda

Dansk

no

Norvēģu valoda

Norsk

fi

Somu valoda

Suomi

el

Grieķu valoda

Ελληνικά

cs

Čehu valoda

Čeština

hu

Ungāru valoda

Magyar

ro

Rumāņu valoda

Română

uk

Ukraiņu valoda

Українська

pt-BR

Brazīlijas portugāļu valoda

Português Brasileiro

zh-HK

Kantoniešu valoda

粵語

ms

Malajiešu valoda

Bahasa Melayu

sk

Slovāku valoda

Slovenčina

bg

Bulgāru valoda

Български

hr

Horvātu valoda

Hrvatski

lt

Lietuviešu valoda

Lietuvių

lv

Latviešu valoda

Latviešu

et

Igaunijas valoda

Eesti

sl

Slovēņu valoda

Slovenščina

circle-info

Automātiska saglabāšana: Jūsu valodas izvēle tiek saglabāta ~/.chloros/cli_language.json un saglabājas visās sesijās.


set-project-folder - Iestatīt noklusējuma projekta mapi

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

Sintakse:

Piemērs:


get-project-folder - Rādīt projekta mapes atrašanās vietu

Rā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

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

Sintakse:


Globālās opcijas

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

Opcija
Tips
Noklusējums
Apraksts

--backend-exe

Celiņš

Automātiski noteikts

Celiņš uz backend izpildāmo failu

--port

Vesels skaitlis

5000

Backend API porta numurs

--restart

Karodziņš

-

Piespiedu atkārtota backend palaišana (izbeidz esošos procesus)

--version

Karodziņš

-

Parāda versijas informāciju un iziet

--help

Karodziņš

-

Parāda palīdzības informāciju un iziet

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


Apstrādes iestatījumu rokasgrāmata

Paralēlā apstrāde

Chloros+ CLI automātiski mēroparalēlo apstrādi, lai tā atbilstu jūsu datora iespējām:Kā tas darbojas:

  • Atklāj jūsu CPU kodolus un RAM

  • Piešķir darba vienības: 2× CPU kodoli (izmanto hipervadu)

  • Maksimums: 16 paralēlas darba vienības (stabilitātes nodrošināšanai)Sistēmas līmeņi:

Sistēmas tips
CPU
RAM
Darba vienības
Veiktspēja

Augstākā klase

16+ kodoli

32+ GB

Līdz 16

Maksimālais ātrums

Vidējais līmenis

8-15 kodoli

16-31 GB

8-16

Lielisks ātrums

Zems līmenis

4-7 kodoli

8-15 GB

4-8

Labs ātrums

circle-info

Automātiska optimizācija: CLI automātiski atpazīst jūsu sistēmas specifikācijas un konfigurē optimālu paralēlo apstrādi. Nav nepieciešama manuāla konfigurācija!

Debayer metodes

CLI izmanto Augsta kvalitāte (ātrāka) kā noklusējuma un ieteicamo debayer algoritmu:

Metode
Kvalitāte
Ātrums
Apraksts

Augsta kvalitāte (ātrāka)

⭐⭐⭐⭐

⚡⚡⚡

Malas atpazīšanas algoritms (noklusējuma, ieteicams)

Vignette korekcija

Funkcija: Koriģē gaismas zudumu attēla malās (tumšāki stūri, kas bieži sastopami kameru attēlos).

  • Iespējots pēc noklusējuma — lielākajai daļai lietotāju šī funkcija ir jāatstāj iespējota

  • Lai atspējotu, izmantojiet --no-vignette

circle-info

Ieteikums: vienmēr ieslēdziet vinjetes korekciju, lai nodrošinātu vienādu spilgtumu visā kadrā.

Reflektances kalibrēšana

Pārvērš neapstrādātas sensora vērtības standartizētās reflektances procentos, izmantojot kalibrēšanas paneļus.

  • Iespējots pēc noklusējuma — nepieciešams veģetācijas analīzei.

  • Nepieciešami kalibrēšanas mērķa paneļi attēlos.

  • Lai atspēkotu, izmantojiet --no-reflectance.

circle-info

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

PPK korekcijas

Funkcijas: 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 aktivizētu, 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
Vislabāk piemērots

TIFF (16 bitu)

16 bitu vesels skaitlis

Liels

ĢIS analīze, fotogrammetrija (ieteicams)

TIFF (32 bitu, procenti)

32 bitu peldošais

Ļoti liels

Zinātniskā analīze, pētījumi

PNG (8 bitu)

8 bitu vesels skaitlis

Vidējs

Vizuāla pārbaude, tīmekļa koplietošana

JPG (8 bitu)

8 bitu vesels skaitlis

Mazs

Ātrs priekšskatījums, saspiesta izvade

***

Automatizācija un skripti

PowerShell partiju apstrāde

Vairāku datu kopu mapju automātiska apstrāde:

Windows partiju skripts

Vienkārša cilpa partiju apstrādei:

Python automatizācijas skripts

Uzlabota automatizācija ar kļūdu apstrādi:


Apstrādes darba plūsma

Standarta darba plūsma

  1. Ievade: Mapīte, 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. Izvade: Izveido kameras modeļa apakšmapes ar apstrādātiem attēliem

Izvades struktūras piemērs

Aplēstais apstrādes laiks

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

Režīms
Laiks
Aparatūra

Paralēlais režīms

5–10 min

i7/Ryzen 7, 16 GB RAM, SSD (līdz 16 darbiniekiem)

Paralēlais režīms

10–15 min

i5/Ryzen 5, 8 GB RAM, HDD (līdz 8 darbiniekiem)

circle-info

Veiktspējas padoms: Apstrādes laiks atšķiras atkarībā no attēlu skaita, izšķirtspējas un datora specifikācijām.


Problēmu novēršana

CLI nav atrasts

Kļūda:

Risinājumi:

  1. Pārbaudiet instalācijas vietu:

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

  1. Manuāli pievienojiet PATH:

    • 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


Backend neizdevās sāktKļūda:

Risinājumi:

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

  2. Pārbaudiet, vai Windows ugunsmūris to neblokē

  3. Izmēģiniet citu portu:

  1. Piespiediet backend atkārtotu palaišanu:


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

Risinājumi:

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

  2. Piesakieties ar savām autentifikācijas ziņām:

  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 atļaujas mapē

  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ājums:

Norādiet citu portu:


Bieži uzdotie jautājumi

J: Vai man ir nepieciešama licence CLI?

A:Jā! CLI ir nepieciešama maksasChloros+ licence.

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

  • ✅ Chloros+ (maksas) plāni: CLI 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 galvas. Prasības:

  • Windows Server 2016 vai jaunāka versija

  • Visual C++ Redistributable instalēta

  • Pietiekama RAM (vismaz 8 GB, ieteicams 16 GB)

  • Vienreizēja GUI licences aktivizēšana jebkurā datorā


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ā ievadīti, kameras modeļa apakšmapēs (piemēram, Survey3N_RGN/).

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


J: Vai varu apstrādāt vairākas mapes vienlaikus?A: Ne tieši ar vienu komandu, bet varat izmantot skriptu, lai apstrādātu mapes secīgi. Skatīt sadaļu Automātika un skripti.***

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

Partija:


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

  1. Pārtrauks apstrādi

  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 Automation & Scripting par PowerShell, Batch un Python piemēriem.***

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

Rezultāts:


Palīdzības saņemšana

Komandrindas palīdzība

Palīdzības informāciju var apskatīt tieši CLI:

Atbalsta kanāli

Pilnīgi piemēri

1. piemērs: Pamata apstrāde

Apstrāde ar noklusējuma iestatījumiem (vinjete, atstarošanās):


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

32 bitu peldošā komata TIFF:


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

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


4. piemērs: PPK koriģēta apstrāde

Piemēro PPK korekcijas ar atstarojumu:


5. piemērs: Pielāgota izvades atrašanās vieta

Apstrādā uz citu disku ar konkrētu formātu:


6. piemērs: autentifikācijas darba plūsma

Pilnīga autentifikācijas plūsma:


7. piemērs: daudzvalodu lietošana

Mainiet saskarnes valodu:

Last updated