CLI: Komandų eilutė

**Chloros CLI** suteikia galingą komandinės eilutės prieigą prie Chloros vaizdų apdorojimo variklio, leidžiant automatizuoti, kurti scenarijus ir vykdyti be galvutės operacijas jūsų vaizdų apdorojimo darbo srautams.

Pagrindinės funkcijos

  • 🚀 Automatizavimas – scenarijų paketinis apdorojimas kelių duomenų rinkinių

  • 🔗 Integracija – įterpimas į esamus darbo srautus ir procesus

  • 💻 Veikimas be grafinės sąsajos – veikimas be GUI

  • 🌍 Daugiakalbė – 38 kalbų palaikymas

  • Lygiagretus apdorojimas – dinamiškai pritaikomas prie jūsų CPU (iki 16 lygiagrečių darbininkų)

Reikalavimai

Reikalavimas
Išsami informacija

Operacinė sistema

Windows 10/11 (64 bitai)

Atmintis

Mažiausiai 8 GB RAM (rekomenduojama 16 GB)

Internetas

Reikalingas licencijos aktyvavimui

Diskų erdvė

Priklauso nuo projekto dydžio

circle-info

Licencijos reikalavimas: CLI reikalauja mokamo Chloros+ prenumeratos. Standartiniai (nemokami) planai neturi CLI prieigos. Norėdami atnaujinti, apsilankykite https://cloud.mapir.camera/pricingarrow-up-right.

Greitasis pradžios vadovas

Įdiegimas

CLI automatiškai įtraukiamas į Chloros diegimo programą:

  1. Atsisiųskite ir paleiskite Chloros Installer.exe

  2. Užbaigite diegimo vedlio veiksmus

  3. CLI įdiegta į: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-info

Diegimo programa automatiškai įtraukia chloros-cli į jūsų sistemos PATH. Po diegimo iš naujo paleiskite terminalą.

Pirmasis nustatymas

Prieš naudodami CLI, aktyvuokite savo Chloros+ licenciją:

Pagrindinis naudojimas

Apdorokite aplanką su numatytaisiais nustatymais:


Komandų žinynas

Bendroji sintaksė


Komandos

process - Apdorokite vaizdus

Apdorokite aplanką su kalibravimu.

Sintaksė:

Pavyzdys:

Apdorojimo komandos parinktys

Parinktis
Tipas
Numatytasis
Aprašymas

<input-folder>

Kelias

Reikalingas

Aplankas, kuriame yra RAW/JPG daugiaspektriniai vaizdai

-o, --output

Kelias

Tas pats kaip įvesties

Apdorotų vaizdų išvesties aplankas

-n, --project-name

Stygos

Automatiškai sugeneruotas

Pasirinktinis projekto pavadinimas

--vignette

Žymė

Įjungta

Įjungti vinjetės korekciją

--no-vignette

Žymė

-

Išjungti vinjetės korekciją

--reflectance

Žymė

Įjungta

Įjungti atspindžio kalibravimą

--no-reflectance

Žymė

-

Išjungti atspindžio kalibravimą

--ppk

Žymė

Išjungta

Taikyti PPK korekcijas iš .daq šviesos jutiklio duomenų

--format

Pasirinkimas

TIFF (16 bitų)

Išvesties formatas: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)

--min-target-size

Sveikasis skaičius

Automatinis

Minimalus tikslinis dydis pikseliais kalibravimo skydelio aptikimui

--target-clustering

Sveikasis skaičius

Automatinis

Tikslinio klasterio riba (0–100)

--exposure-pin-1

Stygos

Nėra

Užrakinti ekspoziciją kameros modeliui (1 kontaktas)

--exposure-pin-2

Stygos

Nėra

Užrakinti ekspoziciją kameros modeliui (2 kontaktas)

--recal-interval

Sveikasis skaičius

Automatinis

Pakalibravimo intervalas sekundėmis

--timezone-offset

Sveikasis skaičius

0

Laiko juostos nuokrypis valandomis


login – Autentiškumo patvirtinimas

Prisijunkite naudodami savo Chloros+ prisijungimo duomenis, kad įgalintumėte CLI apdorojimą.

Sintaksė:

Pavyzdys:

circle-info

Specialieji simboliai: Naudokite viengubas kabutes aplink slaptažodžius, kuriuose yra simbolių, pvz., $, !, arba tarpai.

Rezultatas:

***

logout - Išvalyti prisijungimo duomenis

Išvalykite saugomus prisijungimo duomenis ir atsijunkite nuo savo paskyros.

Sintaksė:

Pavyzdys:

Rezultatas:

circle-info

SDK Vartotojai: Python SDK taip pat teikia programinį logout() metodą, skirtą išvalyti kredencialus Python scenarijuose. Išsamią informaciją rasite Python SDK dokumentacijoje.


status – licencijos būsenos patikrinimas

Rodo dabartinę licenciją ir autentiškumo būseną.

Sintaksė:

Pavyzdys:

Rezultatas:


export-status – eksporto pažangos patikrinimas

Stebėti 4-ojo sriegio eksporto pažangą apdorojimo metu arba po jo.

Sintaksė:

Pavyzdys:

Naudojimo atvejis: Šią komandą vykdykite apdorojimo metu, kad patikrintumėte eksporto pažangą.***

language – sąsajos kalbos valdymas

Peržiūrėkite arba pakeiskite CLI sąsajos kalbą.

Sintaksė:

Pavyzdžiai:

Palaikomos kalbos (iš viso 38)

Kodas
Kalba
Gimtoji pavadinimas

en

Anglų

Anglų

es

Ispanų

Ispanų

pt

Portugalų

Portugalų

fr

Prancūzų

Français

de

Vokiečių

Deutsch

it

Italų

Italiano

ja

Japonų

日本語

ko

Korėjiečių

한국어

zh

Kinų (supaprastinta)

简体中文

zh-TW

Kinų (tradicinė)

繁體中文

ru

Rusų

Русский

nl

Olandų

Nederlands

ar

Arabų

العربية

pl

Lenkų

Polski

tr

Turkų

Türkçe

hi

Hindi

हिंदी

id

Indoneziečių

Bahasa Indonesia

vi

Vietnamo kalba

Tiếng Việt

th

Tailando kalba

ไทย

sv

Švedų kalba

Svenska

da

Danų kalba

Dansk

no

Norvegų

Norsk

fi

Suomų

Suomi

el

Graikų

Ελληνικά

cs

Čekų

Čeština

hu

Vengrų

Magyar

ro

Rumunų

Română

uk

Ukrainiečių

Українська

pt-BR

Brazilijos portugalų

Português Brasileiro

zh-HK

Kantono

粵語

ms

Malajų

Bahasa Melayu

sk

Slovakų

Slovenčina

bg

Bulgarų

Български

hr

Kroatų kalba

Hrvatski

lt

Lietuvių kalba

Lietuvių

lv

Latvų kalba

Latviešu

et

Estų

Eesti

sl

Slovėnų

Slovenščina

circle-info

Automatinis išsaugojimas: Jūsų kalbos pasirinkimas išsaugomas ~/.chloros/cli_language.json ir išlieka visose sesijose.


set-project-folder - Nustatyti numatytąjį projekto aplanką

Pakeisti numatytąjį projekto aplanko vietą (bendrai su GUI).

Sintaksė:

Pavyzdys:


get-project-folder – Rodyti projekto aplanką

Rodyti dabartinę numatytą projekto aplanko vietą.

Sintaksė:

Pavyzdys:

Rezultatas:


reset-project-folder – Atstatyti numatytąją vietą

Atstatyti numatytąją projekto aplanko vietą.

Sintaksė:


Bendrosios parinktys

Šios parinktys taikomos visoms komandoms:

Parinktis
Tipas
Numatytasis
Aprašymas

--backend-exe

Kelias

Automatiškai nustatytas

Kelias į pagrindinio kompiuterio vykdomąjį failą

--port

Sveikasis skaičius

5000

Pagrindinio kompiuterio API prievado numeris

--restart

Žymė

-

Priversti paleisti iš naujo backend (nutraukia esamus procesus)

--version

Žymė

-

Rodyti versijos informaciją ir uždaryti

--help

Žymė

-

Rodyti pagalbos informaciją ir uždaryti

Pavyzdys su bendrosiomis parinktimis:


Apdorojimo nustatymų vadovas

Lygiagretus apdorojimas

Chloros+ CLI automatiškai pritaikolygiagretų apdorojimą prie jūsų kompiuterio galimybių:Kaip tai veikia:

  • Nustato jūsų CPU branduolius ir RAM

  • Paskirsto darbininkus: 2× CPU branduoliai (naudoja hiperthreading)

  • Maksimalus skaičius: 16 lygiagrečių darbininkų (dėl stabilumo)Sistemos lygiai:

Sistemos tipas
CPU
RAM
Darbininkai
Našumas

Aukščiausios klasės

16+ branduoliai

32+ GB

Iki 16

Maksimalus greitis

Vidutinio lygio

8–15 branduolių

16–31 GB

8–16

Puikus greitis

Žemo lygio

4–7 branduolių

8–15 GB

4–8

Geras greitis

circle-info

Automatinis optimizavimas: CLI automatiškai nustato jūsų sistemos specifikacijas ir konfigūruoja optimalų lygiagretų apdorojimą. Nereikia jokio rankinio konfigūravimo!

Debayer metodai

CLI naudoja Aukštą kokybę (greičiau) kaip numatytąjį ir rekomenduojamą debayer algoritmą:

Metodas
Kokybė
Greitis
Aprašymas

Aukšta kokybė (greičiau)

⭐⭐⭐⭐

⚡⚡⚡

Kraštų atpažinimo algoritmas (numatyta, rekomenduojama)

Vignette korekcija

Ką daro: Koreguoja šviesos silpimą vaizdo kraštuose (tamsesni kampai, dažni kameros vaizduose).

  • Įjungta pagal numatytuosius nustatymus – dauguma vartotojų turėtų palikti šią funkciją įjungtą

  • Norėdami išjungti, naudokite --no-vignette

circle-info

Rekomendacija: visada įjunkite vinjetės korekciją, kad užtikrintumėte vienodą ryškumą visame kadre.

Atspindžio kalibravimas

Naudojant kalibravimo skydelius, konvertuoja neapdorotus jutiklio vertes į standartizuotus atspindžio procentus.

  • Įjungta pagal numatytuosius nustatymus – būtina augmenijos analizei.

  • Reikia kalibravimo tikslinių plokščių vaizduose.

  • Norėdami išjungti, naudokite --no-reflectance.

circle-info

Reikalavimai: užtikrinkite, kad kalibravimo plokštės būtų tinkamai eksponuotos ir matomos jūsų vaizduose, kad atspindžio konversija būtų tiksli.

PPK korekcijos

Ką daro: taiko post-processed kinematic korekcijas, naudojant DAQ-A-SD žurnalo duomenis, siekiant pagerinti GPS tikslumą.

  • Pagal numatytuosius nustatymus išjungta

  • Norėdami įjungti, naudokite --ppk

  • Reikalingi .daq failai projekto aplanke iš MAPIR DAQ-A-SD šviesos jutiklio.

Išvesties formatai

Formatas
Bitų gylis
Failo dydis
Tinkamiausias

TIFF (16 bitų)

16 bitų sveikasis skaičius

Didelis

GIS analizė, fotogrametrija (rekomenduojama)

TIFF (32 bitai, procentai)

32 bitų plūduriuojantis

Labai didelis

Mokslinė analizė, tyrimai

PNG (8 bitai)

8 bitų sveikasis skaičius

Vidutinis

Vizualinis patikrinimas, dalijimasis internete

JPG (8 bitai)

8 bitų sveikasis skaičius

Mažas

Greitas peržiūrėjimas, suspaustas išvesties failas

***

Automatizavimas ir scenarijų kūrimas

PowerShell paketinis apdorojimas

Automatinis kelių duomenų rinkinių aplankų apdorojimas:

Windows paketinis scenarijus

Paprastas ciklas paketinio apdorojimo:

Python automatizavimo scenarijus

Išplėstinis automatizavimas su klaidų tvarkymu:


Apdorojimo darbo eiga

Standartinė darbo eiga

  1. Įvestis: aplankas, kuriame yra RAW/JPG vaizdų poros

  2. Atrandimas: CLI automatiškai nuskaito palaikomus vaizdo failus

  3. Apdorojimas: Lygiagretusis režimas pritaikomas prie jūsų CPU branduolių (Chloros+)

  4. Išvestis: Sukuria fotoaparato modelio pakatalogius su apdorotais vaizdais

Pavyzdinė išvesties struktūra

Apdorojimo trukmės įvertinimai

Tipinė 100 vaizdų (kiekvienas 12 MP) apdorojimo trukmė:

Režimas
Laikas
Techninė įranga

Lygiagretus režimas

5–10 min.

i7/Ryzen 7, 16 GB RAM, SSD (iki 16 darbuotojų)

Lygiagretus režimas

10–15 min.

i5/Ryzen 5, 8 GB RAM, HDD (iki 8 darbuotojų)

circle-info

Naudingas patarimas: apdorojimo laikas priklauso nuo vaizdų skaičiaus, skiriamosios gebos ir kompiuterio specifikacijų.


Trikčių šalinimas

CLI nerastas

Klaida:

Sprendimai:

  1. Patikrinkite įdiegimo vietą:

  1. Jei nėra PATH, naudokite pilną kelią:

  1. Rankiniu būdu pridėkite į PATH:

    • Atidarykite „Sistemos savybės“ → „Aplinkos kintamieji“

    • Redaguokite PATH kintamąjį

    • Pridėkite: C:\Program Files\Chloros\resources\cli

    • Paleiskite terminalą iš naujo.


Nepavyko paleisti užpakalinės daliesKlaida:

Sprendimai:

  1. Patikrinkite, ar užpakalinė dalis jau veikia (pirmiausia ją uždarykite).

  2. Patikrinkite, ar Windows ugniasienė neblokuoja.

  3. Išbandykite kitą prievadą:

  1. Priversti paleisti backend:


Licencijos / autentiškumo problemosKlaida:

Sprendimai:

  1. Patikrinkite, ar turite aktyvų Chloros+ prenumeratą.

  2. Prisijunkite naudodami savo prisijungimo duomenis:

  1. Patikrinkite licencijos būseną:

  1. Susisiekite su pagalbos tarnyba: info@mapir.camera


Nėra rastų vaizdųKlaida:

Sprendimai:

  1. Patikrinkite, ar aplanke yra palaikomi formatai (.RAW, .TIF, .JPG).

  2. Patikrinkite, ar aplanko kelias yra teisingas (keliuose su tarpais naudokite kabutes).

  3. Įsitikinkite, kad turite teisę skaityti aplanką.

  4. Patikrinkite, ar failų plėtiniai yra teisingi.


Apdorojimas sustoja arba užstringaSprendimai:

  1. Patikrinkite laisvą disko vietą (įsitikinkite, kad jos pakanka išvesties failams).

  2. Uždarykite kitas programas, kad atlaisvintumėte atmintį.

  3. Sumažinkite vaizdų skaičių (apdorokite partijomis).


Prieiga jau naudojamaKlaida:

Sprendimas:

Nurodykite kitą prievadą:


DUK

K: Ar man reikia licencijos CLI?

Atsakymas:Taip! CLI reikalauja mokamosChloros+ licencijos.

  • ❌ Standartinis (nemokamas) planas: CLI išjungtas

  • ✅ Chloros+ (mokami) planai: CLI visiškai įjungtas

Prenumeruokite: https://cloud.mapir.camera/pricingarrow-up-right


K: Ar galiu naudoti CLI serveryje be GUI?A: Taip! CLI veikia visiškai be grafinės sąsajos. Reikalavimai:

  • Windows Server 2016 arba naujesnė versija

  • Įdiegta Visual C++ Redistributable

  • Pakankamai RAM (mažiausiai 8 GB, rekomenduojama 16 GB)

  • Vienkartinė GUI licencijos aktyvacija bet kuriame kompiuteryje


K: Kur saugomi apdoroti vaizdai?A:Pagal numatytuosius nustatymus apdoroti vaizdai saugomitame pačiame aplanke kaip ir įvesties vaizdai, kameros modelio pakatalogiuose (pvz., Survey3N_RGN/).

Naudokite -o parinktį, kad nurodytumėte kitą išvesties aplanką:


K: Ar galiu apdoroti kelis aplankus vienu metu?A: Ne tiesiogiai vienu komandomis, bet galite naudoti scenarijus, kad apdorotumėte aplankus paeiliui. Žr. skyrių Automatizavimas ir scenarijai.***

K: Kaip išsaugoti CLI išvestį į žurnalo failą?PowerShell:

Paketas:


K: Kas atsitiks, jei apdorojimo metu paspausiu Ctrl+C?A: CLI:

  1. Gražiai sustabdys apdorojimą

  2. Išjungs užpakalinę sistemą

  3. Uždarys su kodu 130

Iš dalies apdoroti vaizdai gali likti išvesties aplanke.


K: Ar galiu automatizuoti CLI apdorojimą?A: Žinoma! CLI yra sukurtas automatizavimui. Žr. Automatizavimas ir scenarijų kūrimas dėl PowerShell, Batch ir Python pavyzdžių.***

K: Kaip patikrinti CLI versiją?A:

Rezultatas:


Pagalba

Komandinės eilutės pagalba

Pagalbos informaciją galite peržiūrėti tiesiogiai CLI:

Pagalbos kanalai

Išsamūs pavyzdžiai

1 pavyzdys: pagrindinis apdorojimas

Apdorojimas naudojant numatytuosius nustatymus (vinjetė, atspindys):


2 pavyzdys: aukštos kokybės moksliniai rezultatai

32 bitų plūduriuojantis TIFF:


3 pavyzdys: greitas peržiūros apdorojimas

8 bitų PNG be kalibravimo greitam peržiūrėjimui:


4 pavyzdys: PPK koreguotas apdorojimas

Taikykite PPK korekcijas su atspindžiu:


5 pavyzdys: Pasirinktinė išvesties vieta

Apdorokite į kitą diską su konkrečiu formatu:


6 pavyzdys: Autentiškumo patvirtinimo darbo eiga

Užbaigti autentiškumo patvirtinimo eigą:


7 pavyzdys: Daugiakalbė naudojimo galimybė

Pakeisti sąsajos kalbą:

Last updated