CLI : Komentorivi

**Chloros CLI** tarjoaa tehokkaan komentorivipääsyn Chloros-kuvankäsittelymoottoriin, mikä mahdollistaa automaation, skriptien käytön ja headless-toiminnon kuvankäsittelytyönkulkuissasi.

Tärkeimmät ominaisuudet

  • 🚀 Automaatio – Useiden tietojoukkojen skriptien eräprosessointi

  • 🔗 Integraatio – Upotus olemassa oleviin työnkulkuihin ja putkistoihin

  • 💻 Headless-käyttö – Käyttö ilman graafista käyttöliittymää

  • 🌍 Monikielisyys – Tuki 38 kielelle

  • Rinnakkaiskäsittely – Skaalautuu dynaamisesti CPU:hun (jopa 16 rinnakkaista työntekijää)

Vaatimukset

Vaatimus
Tiedot

Käyttöjärjestelmä

Windows 10/11 (64-bittinen)

Muisti

Vähintään 8 Gt RAM-muistia (suositellaan 16 Gt)

Internet

Vaaditaan lisenssin aktivoimiseksi

Levytila

Vaihtelee projektin koon mukaan

circle-info

Lisenssivaatimus: CLI edellyttää maksullista Chloros+ -tilausta. Vakiomuotoisissa (ilmaisissa) paketeissa ei ole CLI-käyttöoikeutta. Käy osoitteessa https://cloud.mapir.camera/pricingarrow-up-right päivittääksesi paketin.

Pikaopas

Asennus

CLI sisältyy automaattisesti Chloros-asennusohjelmaan:

  1. Lataa ja suorita Chloros Installer.exe

  2. Suorita asennusohjeet loppuun

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

circle-info

Asennusohjelma lisää chloros-cli automaattisesti järjestelmän PATH-polkuun. Käynnistä päätelaite uudelleen asennuksen jälkeen.

Ensimmäinen asennus

Ennen kuin käytät CLI:ää, aktivoi Chloros+ -lisenssisi:

Peruskäyttö

Käsittele kansio oletusasetuksilla:


Komentojen viite

Yleinen syntaksi


Komennot

process - Käsittele kuvia

Käsittele kansion kuvat kalibroimalla.

Syntaksi:

Esimerkki:

Käsittelykomennon vaihtoehdot

Vaihtoehto
Tyyppi
Oletus
Kuvaus

<input-folder>

Polku

Vaaditaan

Kansio, joka sisältää RAW/JPG-monispektrikuvia

-o, --output

Polku

Sama kuin syöte

Käsiteltyjen kuvien tulostuskansio

-n, --project-name

Merkkijono

Automaattisesti luotu

Mukautettu projektin nimi

--vignette

Lippu

Käytössä

Ota vignettikorjaus käyttöön

--no-vignette

Lippu

-

Poista vignettikorjaus käytöstä

--reflectance

Lippu

Käytössä

Ota heijastavuuden kalibrointi käyttöön

--no-reflectance

Lippu

-

Poista heijastavuuden kalibrointi käytöstä

--ppk

Lippu

Pois käytöstä

Käytä PPK-korjauksia .daq-valosensorin tiedoista

--format

Valinta

TIFF (16-bittinen)

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

--min-target-size

Kokonaisluku

Auto

Kalibrointipaneelin tunnistuksen vähimmäiskohdekoko pikseleinä

--target-clustering

Kokonaisluku

Auto

Kohteiden ryhmittelyn kynnysarvo (0–100)

--exposure-pin-1

Merkkijono

Ei mitään

Lukitse kameramallin valotus (nasta 1)

--exposure-pin-2

Merkkijono

Ei mitään

Lukitse kameramallin valotus (nasta 2)

--recal-interval

Kokonaisluku

Auto

Uudelleenkalibrointiväli sekunteina

--timezone-offset

Kokonaisluku

0

Aikavyöhykkeen ero tunteina


login - Todennetaan tili

Kirjaudu sisään Chloros+ -tunnuksillasi, jotta CLI-käsittely voidaan ottaa käyttöön.

Syntaksi:

Esimerkki:

circle-info

Erikoismerkit: Käytä yksittäisiä lainausmerkkejä salasanojen ympärillä, jotka sisältävät merkkejä kuten $, ! tai välilyöntejä.

Tulos:

***

logout - Tyhjennä tunnistetiedot

Tyhjennä tallennetut tunnistetiedot ja kirjaudu ulos tililtäsi.

Syntaksi:

Esimerkki:

Tulos:

circle-info

SDK Käyttäjät: Python SDK tarjoaa myös ohjelmoitavan logout()-menetelmän tunnistetietojen tyhjentämiseen Python-skripteissä. Katso lisätietoja Python SDK-dokumentaatiosta.


status - Tarkista lisenssin tila

Näytä nykyinen lisenssi ja todennustila.

Syntaksi:

Esimerkki:

Tulos:


export-status - Tarkista viennin eteneminen

Seuraa Thread 4 -viennin etenemistä käsittelyn aikana tai sen jälkeen.

Syntaksi:

Esimerkki:

Käyttötapaus: Kutsu tämä komento käsittelyn aikana tarkistaaksesi viennin etenemisen.***

language - Hallitse käyttöliittymän kieltä

Tarkastele tai muuta CLI-käyttöliittymän kieltä.

Syntaksi:

Esimerkkejä:

Tuetut kielet (yhteensä 38)

Koodi
Kieli
Alkuperäinen nimi

en

Englanti

Englanti

es

Espanja

Español

pt

Portugali

Português

fr

Ranska

Français

de

Saksa

Deutsch

it

Italia

Italiano

ja

Japani

日本語

ko

Korea

한국어

zh

Kiina (yksinkertaistettu)

简体中文

zh-TW

Kiina (perinteinen)

繁體中文

ru

Venäjä

Русский

nl

Hollanti

Nederlands

ar

Arabia

العربية

pl

Puola

Polski

tr

Turkki

Türkçe

hi

Hindi

हिंदी

id

Indonesia

Bahasa Indonesia

vi

Vietnaminkielinen

Tiếng Việt

th

Thaimaalainen

ไทย

sv

Ruotsinkielinen

Svenska

da

Tanskalainen

Dansk

no

Norja

Norsk

fi

Suomi

Suomi

el

Kreikka

Ελληνικά

cs

Tšekki

Čeština

hu

Unkari

Magyar

ro

Romania

Română

uk

Ukraina

Українська

pt-BR

Brasilian portugali

Português Brasileiro

zh-HK

Kantoni

粵語

ms

Malaiji

Bahasa Melayu

sk

Slovakki

Slovenčina

bg

Bulgaria

Български

hr

Kroatia

Hrvatski

lt

Liettua

Lietuvių

lv

Latvia

Latviešu

et

virolaiset

Eesti

sl

sloveenit

Slovenščina

circle-info

Automaattinen pysyvyys: Kielivalintasi tallennetaan ~/.chloros/cli_language.json ja se säilyy kaikissa istunnoissa.


set-project-folder - Aseta oletusprojektikansio

Muuta oletusprojektikansion sijaintia (jaettu GUI:n kanssa).

Syntaksi:

Esimerkki:


get-project-folder - Näytä projektikansio

Näytä nykyisen oletusprojektikansion sijainti.

Syntaksi:

Esimerkki:

Tulos:


reset-project-folder - Palauta oletusasetukset

Palauta projektikansio oletuspaikkaan.

Syntaksi:


Yleiset asetukset

Nämä asetukset koskevat kaikkia komentoja:

Asetus
Tyyppi
Oletus
Kuvaus

--backend-exe

Polku

Automaattisesti tunnistettu

Polku taustaprosessin suoritustiedostoon

--port

Kokonaisluku

5000

Taustaprosessin API-portin numero

--restart

Lippu

-

Pakota taustaprosessin uudelleenkäynnistys (lopettaa olemassa olevat prosessit)

--version

Lippu

-

Näytä versiotiedot ja poistu

--help

Lippu

-

Näytä ohjetiedot ja poistu

Esimerkki globaaleista asetuksista:


Käsittelyasetusten opas

Rinnakkaiskäsittely

Chloros+ CLI skaalaa automaattisestirinnakkaiskäsittelyn tietokoneesi suorituskyvyn mukaan:Kuinka se toimii:

  • Tunnistaa CPU-ytimet ja RAM-muistin

  • Jakaa työt: 2× CPU-ytimet (käyttää hyperthreading-tekniikkaa)

  • Enintään: 16 rinnakkaista työtä (vakauden takaamiseksi)Järjestelmätasot:

Järjestelmätyyppi
CPU
RAM
Työt
Suorituskyky

Huippuluokka

16+ ydintä

32+ Gt

Jopa 16

Maksiminopeus

Keskitaso

8–15 ydintä

16–31 Gt

8–16

Erinomainen nopeus

Alataso

4–7 ydintä

8–15 Gt

4–8

Hyvä nopeus

circle-info

Automaattinen optimointi: CLI tunnistaa automaattisesti järjestelmän tekniset tiedot ja määrittää optimaalisen rinnakkaisprosessoinnin. Manuaalista määritystä ei tarvita!

Debayer-menetelmät

CLI käyttää oletusarvoisesti ja suositeltuna debayer-algoritmina High Quality (Faster) -menetelmää:

Menetelmä
Laatu
Nopeus
Kuvaus

Korkea laatu (nopeampi)

⭐⭐⭐⭐

⚡⚡⚡

Reunat tunnistava algoritmi (oletus, suositeltu)

Vignette-korjaus

Toiminto: Korjaa valon heikkenemisen kuvan reunoilla (kamerakuvissa yleiset tummemmat kulmat).

  • Oletuksena käytössä - Useimpien käyttäjien tulisi pitää tämä käytössä

  • Poista käytöstä --no-vignette:llä

circle-info

Suositus: Ota vignettikorjaus aina käyttöön, jotta kuvan kirkkauden tasaisuus varmistetaan.

Heijastavuuskalibrointi

Muuntaa raakakuvausanturin arvot standardoiduiksi heijastavuusprosenttiarvoiksi kalibrointipaneelien avulla.

  • Oletusarvoisesti käytössä – välttämätön kasvillisuuden analysoinnille.

  • Vaatii kalibrointikohdepaneelit kuvissa.

  • Poista käytöstä --no-reflectance:llä.

circle-info

Vaatimukset: Varmista, että kalibrointipaneelit ovat oikein valaistuja ja näkyvissä kuvissasi, jotta heijastavuuden muunnos on tarkka.

PPK-korjaukset

Toiminto: Soveltaa jälkikäsiteltyjä kinemaattisia korjauksia DAQ-A-SD-lokitietojen avulla GPS-tarkkuuden parantamiseksi.

  • Oletuksena pois käytöstä

  • Käytä --ppk:ää ottaaksesi käyttöön

  • Vaatii .daq-tiedostot projektikansiosta MAPIR DAQ-A-SD-valosensorista.

Tulostusmuodot

Muoto
Bittisyvyys
Tiedostokoko
Sopii parhaiten

TIFF (16-bittinen)

16-bittinen kokonaisluku

Suuri

GIS-analyysi, fotogrammetria (suositeltava)

TIFF (32-bittinen, prosentti)

32-bittinen liukuluku

Erittäin suuri

Tieteellinen analyysi, tutkimus

PNG (8-bittinen)

8-bittinen kokonaisluku

Keskikokoinen

Silmämääräinen tarkastus, verkkopohjainen jakaminen

JPG (8-bittinen)

8-bittinen kokonaisluku

Pieni

Nopea esikatselu, pakattu tulostus

***

Automaatio ja skriptit

PowerShell-eräprosessointi

Useiden tietojoukkojen kansioiden automaattinen käsittely:

Windows-eräskripti

Yksinkertainen silmukka eräprosessointia varten:

Python Automaatioskripti

Edistynyt automaatio virheiden käsittelyllä:


Käsittelytyönkulku

Vakiotyönkulku

  1. Syöttö: Kansio, joka sisältää RAW/JPG-kuvapareja

  2. Haku: CLI etsii automaattisesti tuettuja kuvatiedostoja

  3. Käsittely: Rinnakkaistila skaalautuu CPU-ytimien mukaan (Chloros+)

  4. Tuloste: Luo kameramallin alikansiot käsitellyillä kuvilla

Esimerkki tulostorakenteesta

Arvioitu käsittelyaika

Tyypillinen käsittelyaika 100 kuvalle (kukin 12 MP):

Tila
Aika
Laitteisto

Rinnakkaistila

5–10 min

i7/Ryzen 7, 16 Gt RAM-muistia, SSD (enintään 16 työntekijää)

Rinnakkaistila

10–15 min

i5/Ryzen 5, 8 Gt RAM-muistia, HDD (enintään 8 työntekijää)

circle-info

Suorituskykyvinkki: Käsittelyaika vaihtelee kuvien lukumäärän, tarkkuuden ja tietokoneen ominaisuuksien mukaan.


Vianmääritys

CLI ei löydy

Virhe:

Ratkaisut:

  1. Tarkista asennuksen sijainti:

  1. Käytä koko polkua, jos se ei ole PATH-polussa:

  1. Lisää PATH-polkuun manuaalisesti:

    • Avaa Järjestelmän ominaisuudet → Ympäristömuuttujat

    • Muokkaa PATH-muuttujaa

    • Lisää: C:\Program Files\Chloros\resources\cli

    • Käynnistä terminaali uudelleen


Backend-palvelun käynnistys epäonnistuiVirhe:

Ratkaisut:

  1. Tarkista, onko backend-palvelu jo käynnissä (sulje se ensin)

  2. Tarkista, ettei Windows palomuuri estä sitä

  3. Kokeile eri porttia:

  1. Pakota backend käynnistymään uudelleen:


Lisenssi-/todennusongelmatVirhe:

Ratkaisut:

  1. Varmista, että sinulla on voimassa oleva Chloros+ -tilaus.

  2. Kirjaudu sisään tunnuksillasi:

  1. Tarkista lisenssin tila:

  1. Ota yhteyttä tukeen: info@mapir.camera


Kuvia ei löytynytVirhe:

Ratkaisut:

  1. Varmista, että kansio sisältää tuettuja tiedostomuotoja (.RAW, .TIF, .JPG).

  2. Tarkista, että kansion polku on oikea (käytä lainausmerkkejä poluissa, joissa on välilyöntejä).

  3. Varmista, että sinulla on kansion lukuoikeudet.

  4. Tarkista, että tiedostotunnisteet ovat oikein.


Käsittely pysähtyy tai jumittuuRatkaisut:

  1. Tarkista käytettävissä oleva levytila (varmista, että sitä on riittävästi tulostusta varten).

  2. Sulje muut sovellukset vapauttaaksesi muistia.

  3. Vähennä kuvien määrää (käsittele ne erissä).


Portti jo käytössäVirhe:

Ratkaisu:

Määritä toinen portti:


UKK

K: Tarvitsenko lisenssin CLI:lle?

V:Kyllä! CLI vaatii maksullisenChloros+ -lisenssin.

  • ❌ Standard (ilmainen) -paketti: CLI pois käytöstä

  • ✅ Chloros+ (maksulliset) paketit: CLI täysin käytössä

Tilaa osoitteesta: https://cloud.mapir.camera/pricingarrow-up-right


K: Voinko käyttää CLI:ää palvelimella, jossa ei ole graafista käyttöliittymää?V: Kyllä! CLI toimii täysin ilman graafista käyttöliittymää. Vaatimukset:

  • Windows Server 2016 tai uudempi

  • Visual C++ Redistributable asennettuna

  • Riittävä RAM-muisti (vähintään 8 Gt, suositellaan 16 Gt)

  • Kertaluonteinen GUI-lisenssin aktivointi millä tahansa koneella


K: Mihin käsitellyt kuvat tallennetaan?V:Oletuksena käsitellyt kuvat tallennetaansamaan kansioon kuin syötöt kameramallin alikansioihin (esim. Survey3N_RGN/).

Käytä -o-vaihtoehtoa määrittääksesi toisen tulostuskansion:


K: Voinko käsitellä useita kansioita kerralla?V: Ei suoraan yhdellä komennolla, mutta voit käyttää skriptejä kansioiden käsittelyyn peräkkäin. Katso kohta Automaatio ja skriptit.***

K: Kuinka tallennan CLI-tuloksen lokitiedostoon?PowerShell:

Batch:


K: Mitä tapahtuu, jos painan Ctrl+C käsittelyn aikana?V: CLI:

  1. Lopettaa käsittelyn siististi

  2. Sammuta taustaprosessin

  3. Poistu koodilla 130

Osittain käsitellyt kuvat voivat jäädä tulostuskansioon.


K: Voinko automatisoida CLI-käsittelyn?V: Totta kai! CLI on suunniteltu automatisointia varten. Katso Automaatio ja skriptit PowerShell-, Batch- ja Python-esimerkkejä varten.***

K: Miten tarkistan CLI-version?V:

Tulos:


Ohjeen saaminen

Komentorivin ohje

Tarkastele ohjeita suoraan CLI:ssa:

Tukikanavat

Täydelliset esimerkit

Esimerkki 1: Peruskäsittely

Käsittely oletusasetuksilla (vignette, heijastavuus):


Esimerkki 2: Korkealaatuinen tieteellinen tulos

32-bittinen float TIFF:


Esimerkki 3: Nopea esikatselukäsittely

8-bittinen PNG ilman kalibrointia nopeaa tarkastelua varten:


Esimerkki 4: PPK-korjattu käsittely

PPK-korjausten soveltaminen heijastavuudella:


Esimerkki 5: Mukautettu tulostuspaikka

Käsittely eri asemalle tietyssä muodossa:


Esimerkki 6: Todentamisen työnkulku

Suorita todentamisen työnkulku loppuun:


Esimerkki 7: Monikielinen käyttö

Vaihda käyttöliittymän kieli:

Last updated