CLI : Komut Satırı

**Chloros CLI**, Chloros görüntü işleme motoruna güçlü bir komut satırı erişimi sağlayarak görüntüleme iş akışlarınız için otomasyon, komut dosyası oluşturma ve başsız çalışma imkanı sunar.

Temel Özellikler

  • 🚀 Otomasyon - Birden fazla veri kümesinin komut dosyası toplu işleme

  • 🔗 Entegrasyon - Mevcut iş akışlarına ve boru hatlarına gömme

  • 💻 Başsız Çalışma - GUI olmadan çalıştırma

  • 🌍 Çok Dilli - 38 dil desteği

  • Paralel İşleme - CPU'nuzla dinamik olarak ölçeklenir (16 adede kadar paralel işçi)

Gereksinimler

Gereksinim
Ayrıntılar

İşletim Sistemi

Windows 10/11 (64 bit)

Bellek

Minimum 8 GB RAM (16 GB önerilir)

İnternet

Lisans etkinleştirme için gereklidir

Disk Alanı

Proje boyutuna göre değişir

circle-info

Lisans Gereksinimi: CLI için ücretli Chloros+ aboneliği gerekir. Standart (ücretsiz) planlarda CLI erişimi yoktur. Yükseltmek için https://cloud.mapir.camera/pricingarrow-up-right adresini ziyaret edin.

Hızlı Başlangıç

Kurulum

CLI, Chloros yükleyicisine otomatik olarak dahildir:

  1. Chloros Yükleyici.exe'i indirin ve çalıştırın

  2. Kurulum sihirbazını tamamlayın

  3. CLI şuraya yüklenir: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-info

Yükleyici, chloros-cli'i sistem PATH'inize otomatik olarak ekler. Yüklemeden sonra terminalinizi yeniden başlatın.

İlk Kurulum

CLI'i kullanmadan önce, Chloros+ lisansınızı etkinleştirin:

Temel Kullanım

Varsayılan ayarlarla bir klasörü işleyin:


Komut Referansı

Genel Sözdizimi


Komutlar

process - Görüntüleri İşleme

Bir klasördeki görüntüleri kalibrasyonla işleyin.

Sözdizimi:

Örnek:

İşlem Komutu Seçenekleri

Seçenek
Tür
Varsayılan
Açıklama

<input-folder>

Yol

Gerekli

RAW/JPG multispektral görüntüleri içeren klasör

-o, --output

Yol

Girişle aynı

İşlenmiş görüntüler için çıktı klasörü

-n, --project-name

Dize

Otomatik olarak oluşturulur

Özel proje adı

--vignette

Bayrak

Etkin

Vinyet düzeltmesini etkinleştir

--no-vignette

Bayrak

-

Vinyet düzeltmesini devre dışı bırak

--reflectance

Bayrak

Etkin

Yansıma kalibrasyonunu etkinleştir

--no-reflectance

Bayrak

-

Yansıma kalibrasyonunu devre dışı bırak

--ppk

Bayrak

Devre dışı

.daq ışık sensörü verilerinden PPK düzeltmelerini uygula

--format

Seçim

TIFF (16 bit)

Çıktı biçimi: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)

--min-target-size

Tamsayı

Otomatik

Kalibrasyon paneli algılama için minimum hedef boyut (piksel)

--target-clustering

Tamsayı

Otomatik

Hedef kümeleme eşiği (0-100)

--exposure-pin-1

Dize

Yok

Kamera modeli için pozlamayı kilitle (Pin 1)

--exposure-pin-2

Dize

Yok

Kamera modeli için pozlamayı kilitle (Pin 2)

--recal-interval

Tamsayı

Otomatik

Yeniden kalibrasyon aralığı (saniye)

--timezone-offset

Tamsayı

0

Saat dilimi farkı (saat)


login - Hesabı Doğrulama

Chloros+ kimlik bilgilerinizi kullanarak oturum açın ve CLI işlemini etkinleştirin.

Sözdizimi:

Örnek:

circle-info

Özel Karakterler: $, ! gibi karakterler veya boşluklar içeren şifrelerin etrafına tek tırnak işareti koyun.

Çıktı:

***

logout - Kimlik Bilgilerini Temizle

Saklanan kimlik bilgilerini temizleyin ve hesabınızdan çıkış yapın.

Sözdizimi:

Örnek:

Çıktı:

circle-info

SDK Kullanıcıları: Python SDK ayrıca Python komut dosyalarında kimlik bilgilerini temizlemek için programlı bir logout() yöntemi sağlar. Ayrıntılar için Python SDK belgelerine bakın.


status - Lisans Durumunu Kontrol Et

Mevcut lisans ve kimlik doğrulama durumunu görüntüler.

Sözdizimi:

Örnek:

Çıktı:


export-status - Dışa Aktarım İlerlemesini Kontrol Et

İşlem sırasında veya sonrasında Thread 4 dışa aktarım ilerlemesini izler.

Sözdizimi:

Örnek:

Kullanım Örneği: İşlem devam ederken bu komutu çağırarak dışa aktarım ilerlemesini kontrol edin.***

language - Arayüz Dilini Yönetme

CLI arayüz dilini görüntüleyin veya değiştirin.

Sözdizimi:

Örnekler:

Desteklenen Diller (Toplam 38)

Kod
Dil
Yerel Ad

en

İngilizce

İngilizce

es

İspanyolca

Español

pt

Portekizce

Português

fr

Fransızca

Français

de

Almanca

Deutsch

it

İtalyanca

Italiano

ja

Japonca

日本語

ko

Korece

한국어

zh

Çince (Basitleştirilmiş)

简体中文

zh-TW

Çince (Geleneksel)

繁體中文

ru

Rusça

Русский

nl

Felemenkçe

Nederlands

ar

Arapça

العربية

pl

Lehçe

Polski

tr

Türkçe

Türkçe

hi

Hintçe

हिंदी

id

Endonezyaca

Bahasa Indonesia

vi

Vietnamca

Tiếng Việt

th

Tayca

ไทย

sv

İsveççe

Svenska

da

Danca

Dansk

no

Norveççe

Norsk

fi

Fince

Suomi

el

Yunanca

Ελληνικά

cs

Çekçe

Čeština

hu

Macarca

Magyar

ro

Romence

Română

uk

Ukraynaca

Українська

pt-BR

Brezilya Portekizcesi

Português Brasileiro

zh-HK

Kantonca

粵語

ms

Malayca

Bahasa Melayu

sk

Slovakça

Slovenčina

bg

Bulgarca

Български

hr

Hırvatça

Hrvatski

lt

Litvanyaca

Lietuvių

lv

Letonca

Latviešu

et

Estonca

Eesti

sl

Slovence

Slovenščina

circle-info

Otomatik Kalıcılık: Dil tercihiniz ~/.chloros/cli_language.json dosyasına kaydedilir ve tüm oturumlar boyunca kalıcıdır.


set-project-folder - Varsayılan Proje Klasörünü Ayarla

Varsayılan proje klasörünün konumunu değiştirin (GUI ile paylaşılır).

Sözdizimi:

Örnek:


get-project-folder - Proje Klasörünü Göster

Geçerli varsayılan proje klasörü konumunu görüntüler.

Sözdizimi:

Örnek:

Çıktı:


reset-project-folder - Varsayılana Sıfırla

Proje klasörünü varsayılan konuma sıfırlar.

Sözdizimi:


Genel Seçenekler

Bu seçenekler tüm komutlar için geçerlidir:

Seçenek
Tür
Varsayılan
Açıklama

--backend-exe

Yol

Otomatik algılanan

Arka uç yürütülebilir dosyasının yolu

--port

Tamsayı

5000

Arka uç API bağlantı noktası numarası

--restart

Bayrak

-

Arka ucu yeniden başlat (mevcut işlemleri sonlandır)

--version

Bayrak

-

Sürüm bilgilerini göster ve çık

--help

Bayrak

-

Yardım bilgilerini göster ve çık

Global Seçeneklerle Örnek:


İşleme Ayarları Kılavuzu

Paralel İşleme

Chloros+ CLI otomatik olarak ölçeklendirirparalel işlemeyi bilgisayarınızın kapasitesine uyacak şekilde:Nasıl Çalışır:

  • CPU çekirdeklerinizi ve RAM'inizi algılar

  • İşçileri tahsis eder: 2× CPU çekirdeği (hiper iş parçacığı kullanır)

  • Maksimum: 16 paralel işçi (kararlılık için)Sistem Katmanları:

Sistem Türü
CPU
RAM
İşçiler
Performans

Üst Düzey

16+ çekirdek

32+ GB

16'ya kadar

Maksimum hız

Orta Sınıf

8-15 çekirdek

16-31 GB

8-16

Mükemmel hız

Düşük Sınıf

4-7 çekirdek

8-15 GB

4-8

İyi hız

circle-info

Otomatik Optimizasyon: CLI, sistem özelliklerinizi otomatik olarak algılar ve optimum paralel işlemeyi yapılandırır. Manuel yapılandırma gerekmez!

Debayer Yöntemleri

CLI, varsayılan ve önerilen debayer algoritması olarak Yüksek Kalite (Daha Hızlı)'yi kullanır:

Yöntem
Kalite
Hız
Açıklama

Yüksek Kalite (Daha Hızlı)

⭐⭐⭐⭐

⚡⚡⚡

Kenar algılama algoritması (varsayılan, önerilen)

Vinyet Düzeltme

Ne yapar: Görüntü kenarlarında ışık düşüşünü düzeltir (kamera görüntülerinde sık görülen daha koyu köşeler).

  • Varsayılan olarak etkindir - Çoğu kullanıcı bunu etkin tutmalıdır

  • Devre dışı bırakmak için --no-vignette kullanın

circle-info

Öneri: Çerçeve genelinde eşit parlaklık sağlamak için vinyet düzeltmeyi her zaman etkinleştirin.

Yansıma Kalibrasyonu

Kalibrasyon panelleri kullanarak ham sensör değerlerini standartlaştırılmış yansıma yüzdelerine dönüştürür.

  • Varsayılan olarak etkin - Bitki örtüsü analizi için gereklidir.

  • Görüntülerde kalibrasyon hedef panelleri gerektirir.

  • Devre dışı bırakmak için --no-reflectance kullanın.

circle-info

Gereksinimler: Doğru yansıma dönüşümü için kalibrasyon panellerinin görüntülerinizde düzgün bir şekilde pozlanmış ve görünür olduğundan emin olun.

PPK Düzeltmeleri

Ne yapar: GPS doğruluğunu artırmak için DAQ-A-SD günlük verilerini kullanarak Sonrası İşlenmiş Kinematik düzeltmeleri uygular.

  • Varsayılan olarak devre dışıdır

  • Etkinleştirmek için --ppk kullanın

  • MAPIR DAQ-A-SD ışık sensöründen proje klasöründeki .daq dosyaları gerekir.

Çıkış Biçimleri

Biçim
Bit Derinliği
Dosya Boyutu
En Uygun

TIFF (16 bit)

16 bit tamsayı

Büyük

GIS analizi, fotogrametri (önerilir)

TIFF (32 bit, Yüzde)

32 bit kayan nokta

Çok büyük

Bilimsel analiz, araştırma

PNG (8 bit)

8 bitlik tamsayı

Orta

Görsel inceleme, web paylaşımı

JPG (8 bit)

8 bitlik tamsayı

Küçük

Hızlı önizleme, sıkıştırılmış çıktı

***

Otomasyon ve Komut Dosyası Oluşturma

PowerShell Toplu İşleme

Birden fazla veri kümesi klasörünü otomatik olarak işleyin:

Windows Toplu İşleme Komut Dosyası

Toplu işleme için basit döngü:

Python Otomasyon Komut Dosyası

Hata işleme özelliğine sahip gelişmiş otomasyon:


İşleme İş Akışı

Standart İş Akışı

  1. Giriş: RAW/JPG görüntü çiftlerini içeren klasör

  2. Keşif: CLI desteklenen görüntü dosyalarını otomatik olarak tarar

  3. İşleme: Paralel mod CPU çekirdeklerinize göre ölçeklenir (Chloros+)

  4. Çıktı: İşlenmiş görüntülerle kamera modeli alt klasörleri oluşturur

Örnek Çıktı Yapısı

İşleme Süresi Tahminleri

100 görüntü (her biri 12 MP) için tipik işleme süreleri:

Mod
Süre
Donanım

Paralel Mod

5-10 dakika

i7/Ryzen 7, 16 GB RAM, SSD (16 çalışana kadar)

Paralel Mod

10-15 dakika

i5/Ryzen 5, 8 GB RAM, HDD (en fazla 8 işçi)

circle-info

Performans İpucu: İşlem süresi, görüntü sayısı, çözünürlük ve bilgisayar özelliklerine göre değişir.


Sorun Giderme

CLI Bulunamadı

Hata:

Çözümler:

  1. Kurulum konumunu doğrulayın:

  1. PATH'te yoksa tam yolu kullanın:

  1. PATH'e manuel olarak ekleyin:

    • Sistem Özellikleri → Ortam Değişkenleri'ni açın.

    • PATH değişkenini düzenleyin.

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

    • Terminali yeniden başlatın.


Arka Uç BaşlatılamadıHata:

Çözümler:

  1. Arka ucun zaten çalışıp çalışmadığını kontrol edin (önce kapatın).

  2. Windows Güvenlik Duvarı'nın engellemediğini kontrol edin.

  3. Farklı bir bağlantı noktası deneyin:

  1. Arka ucu zorla yeniden başlatın:


Lisans / Kimlik Doğrulama SorunlarıHata:

Çözümler:

  1. Etkin bir Chloros+ aboneliğiniz olduğunu doğrulayın

  2. Kimlik bilgilerinizle oturum açın:

  1. Lisans durumunu kontrol edin:

  1. Desteğe başvurun: info@mapir.camera


Görüntü BulunamadıHata:

Çözümler:

  1. Klasörün desteklenen formatları (.RAW, .TIF, .JPG) içerdiğini doğrulayın.

  2. Klasör yolunun doğru olduğunu kontrol edin (boşluk içeren yollar için tırnak işaretleri kullanın).

  3. Klasör için okuma izinlerine sahip olduğunuzdan emin olun.

  4. Dosya uzantılarının doğru olup olmadığını kontrol edin.


İşlem Duruyor veya TakılıyorÇözümler:

  1. Kullanılabilir disk alanını kontrol edin (çıktı için yeterli olduğundan emin olun).

  2. Belleği boşaltmak için diğer uygulamaları kapatın.

  3. Görüntü sayısını azaltın (toplu olarak işleyin).


Bağlantı Noktası Zaten KullanılıyorHata:

Çözüm:

Farklı bir bağlantı noktası belirtin:


SSS

S: CLI için lisans gerekir mi?

C:Evet! CLI için ücretliChloros+ lisansı gerekir.

  • ❌ Standart (ücretsiz) plan: CLI devre dışı

  • ✅ Chloros+ (ücretli) planlar: CLI tamamen etkinleştirilmiş

Abone olun: https://cloud.mapir.camera/pricingarrow-up-right


S: CLI'i GUI'siz bir sunucuda kullanabilir miyim?C: Evet! CLI tamamen başsız çalışır. Gereksinimler:

  • Windows Server 2016 veya üstü

  • Visual C++ Redistributable yüklü

  • Yeterli RAM (minimum 8 GB, önerilen 16 GB)

  • Herhangi bir makinede tek seferlik GUI lisans aktivasyonu


S: İşlenen görüntüler nereye kaydedilir?**C:**Varsayılan olarak, işlenen görüntüler kamera modeli alt klasörlerinde (ör. Survey3N_RGN/)girişle aynı klasöre kaydedilir.

Farklı bir çıktı klasörü belirtmek için -o seçeneğini kullanın:


S: Birden fazla klasörü aynı anda işleyebilir miyim?C: Tek bir komutla doğrudan yapamazsınız, ancak komut dosyası kullanarak klasörleri sırayla işleyebilirsiniz. Otomasyon ve Komut Dosyası bölümüne bakın.***

S: CLI çıktısını bir günlük dosyasına nasıl kaydedebilirim?PowerShell:

Toplu iş:


S: İşlem sırasında Ctrl+C tuşlarına basarsam ne olur?C: CLI şunları yapar:

  1. İşleme düzgün bir şekilde son verir

  2. Arka ucu kapatır

  3. 130 koduyla çıkar

Kısmen işlenmiş görüntüler çıktı klasöründe kalabilir.


S: CLI işlemesini otomatikleştirebilir miyim?C: Elbette! CLI otomasyon için tasarlanmıştır. PowerShell, Batch ve Python örnekleri için Otomasyon ve Komut Dosyası Oluşturma bölümüne bakın.***

S: CLI sürümünü nasıl kontrol edebilirim?C:

Çıktı:


Yardım Alma

Komut Satırı Yardımı

Yardım bilgilerini doğrudan CLI'te görüntüleyin:

Destek Kanalları

Tam Örnekler

Örnek 1: Temel İşleme

Varsayılan ayarlarla işleme (vinyet, yansıtma):


Örnek 2: Yüksek Kaliteli Bilimsel Çıktı

32 bit float TIFF:


Örnek 3: Hızlı Önizleme İşleme

Hızlı inceleme için kalibrasyon olmadan 8 bit PNG:


Örnek 4: PPK Düzeltmeli İşleme

Yansıtma ile PPK düzeltmeleri uygulayın:


Örnek 5: Özel Çıktı Konumu

Belirli bir formatla farklı sürücüye işleme:


Örnek 6: Kimlik Doğrulama İş Akışı

Kimlik doğrulama akışını tamamlayın:


Örnek 7: Çok Dilli Kullanım

Arayüz dilini değiştirin:

Last updated