CLI : Γραμμή εντολών

Το **Chloros CLI** παρέχει ισχυρή πρόσβαση στη γραμμή εντολών στον κινητήρα επεξεργασίας εικόνων Chloros, επιτρέποντας την αυτοματοποίηση, τη δημιουργία σεναρίων και την λειτουργία χωρίς οθόνη για τις ροές εργασίας σας στον τομέα της απεικόνισης.

Βασικά χαρακτηριστικά

  • 🚀 Αυτοματοποίηση - Σενάρια μαζικής επεξεργασίας πολλαπλών συνόλων δεδομένων

  • 🔗 Ενσωμάτωση - Ενσωμάτωση σε υπάρχουσες ροές εργασίας και αγωγούς

  • 💻 Λειτουργία χωρίς οθόνη - Εκτέλεση χωρίς GUI

  • 🌍 Πολυγλωσσικό - Υποστήριξη 38 γλωσσών

  • Παράλληλη επεξεργασία - Δυναμική κλιμάκωση ανάλογα με την CPU σας (έως 16 παράλληλοι εργαζόμενοι)

Απαιτήσεις

Απαίτηση
Λεπτομέρειες

Λειτουργικό σύστημα

Windows 10/11 (64-bit)

Μνήμη

Ελάχιστη μνήμη RAM 8 GB (συνιστάται 16 GB)

Διαδίκτυο

Απαιτείται για την ενεργοποίηση της άδειας χρήσης

Χώρος στο δίσκο

Διαφέρει ανάλογα με το μέγεθος του έργου

circle-info

Απαιτήσεις άδειας χρήσης: Το CLI απαιτεί συνδρομή επί πληρωμή στο Chloros+. Τα βασικά (δωρεάν) πακέτα δεν έχουν πρόσβαση στο CLI. Επισκεφθείτε το https://cloud.mapir.camera/pricingarrow-up-right για αναβάθμιση.

Γρήγορη εκκίνηση

Εγκατάσταση

Το CLI περιλαμβάνεται αυτόματα στο πρόγραμμα εγκατάστασης Chloros:

  1. Κατεβάστε και εκτελέστε το Chloros Installer.exe

  2. Ολοκληρώστε τον οδηγό εγκατάστασης

  3. CLI εγκατεστημένο σε: C:\Program Files\Chloros\resources\cli\chloros-cli.exe

circle-info

Το πρόγραμμα εγκατάστασης προσθέτει αυτόματα το chloros-cli στο PATH του συστήματός σας. Επανεκκινήστε το τερματικό σας μετά την εγκατάσταση.

Πρώτη εγκατάσταση

Πριν χρησιμοποιήσετε το CLI, ενεργοποιήστε την άδεια χρήσης Chloros+:

Βασική χρήση

Επεξεργασία φακέλου με τις προεπιλεγμένες ρυθμίσεις:


Αναφορά εντολών

Γενική σύνταξη


Εντολές

process - Επεξεργασία εικόνων

Επεξεργασία εικόνων σε ένα φάκελο με βαθμονόμηση.

Σύνταξη:

Παράδειγμα:

Επιλογές εντολών επεξεργασίας

Επιλογή
Τύπος
Προεπιλογή
Περιγραφή

<input-folder>

Διαδρομή

Απαιτείται

Φάκελος που περιέχει εικόνες RAW/JPG πολλαπλού φάσματος

-o, --output

Διαδρομή

Ίδια με την είσοδο

Φάκελος εξόδου για επεξεργασμένες εικόνες

-n, --project-name

String

Αυτόματη δημιουργία

Προσαρμοσμένο όνομα έργου

--vignette

Σημαία

Ενεργοποιημένη

Ενεργοποίηση διόρθωσης βινιέτας

--no-vignette

Σημαία

-

Απενεργοποίηση διόρθωσης βινιέτας

--reflectance

Σημαία

Ενεργοποιημένη

Ενεργοποίηση βαθμονόμησης ανακλαστικότητας

--no-reflectance

Σημαία

-

Απενεργοποίηση βαθμονόμησης ανακλαστικότητας

--ppk

Σημαία

Απενεργοποιημένη

Εφαρμογή διορθώσεων PPK από δεδομένα αισθητήρα φωτός .daq

--format

Επιλογή

TIFF (16-bit)

Μορφή εξόδου: TIFF (16-bit), TIFF (32-bit, Percent), PNG (8-bit), JPG (8-bit)

--min-target-size

Ακέραιος

Αυτόματο

Ελάχιστο μέγεθος στόχου σε εικονοστοιχεία για την ανίχνευση του πίνακα βαθμονόμησης

--target-clustering

Ακέραιος

Αυτόματο

Όριο ομαδοποίησης στόχων (0-100)

--exposure-pin-1

String

Κανένα

Κλείδωμα έκθεσης για μοντέλο κάμερας (Pin 1)

--exposure-pin-2

String

Κανένα

Κλείδωμα έκθεσης για μοντέλο κάμερας (Pin 2)

--recal-interval

Ακέραιος

Αυτόματο

Διάστημα επαναβαθμονόμησης σε δευτερόλεπτα

--timezone-offset

Ακέραιος

0

Διαφορά ζώνης ώρας σε ώρες


login - Έλεγχος ταυτότητας λογαριασμού

Συνδεθείτε με τα διαπιστευτήριά σας Chloros+ για να ενεργοποιήσετε την επεξεργασία CLI.

Σύνταξη:

Παράδειγμα:

circle-info

Ειδικοί χαρακτήρες: Χρησιμοποιήστε απλά εισαγωγικά γύρω από κωδικούς πρόσβασης που περιέχουν χαρακτήρες όπως $, ! ή κενά.

Έξοδος:

***

logout - Διαγραφή διαπιστευτηρίων

Διαγράψτε τα αποθηκευμένα διαπιστευτήρια και αποσυνδεθείτε από τον λογαριασμό σας.

Σύνταξη:

Παράδειγμα:

Έξοδος:

circle-info

Χρήστες SDK: Το Python SDK παρέχει επίσης μια προγραμματισμένη μέθοδο logout() για την εκκαθάριση διαπιστευτηρίων εντός των σεναρίων Python. Για λεπτομέρειες, ανατρέξτε στην τεκμηρίωση Python SDK.


status - Έλεγχος κατάστασης άδειας χρήσης

Εμφάνιση της τρέχουσας άδειας χρήσης και της κατάστασης ελέγχου ταυτότητας.

Σύνταξη:

Παράδειγμα:

Έξοδος:


export-status - Έλεγχος προόδου εξαγωγής

Παρακολούθηση της προόδου εξαγωγής του νήματος 4 κατά τη διάρκεια ή μετά την επεξεργασία.

Σύνταξη:

Παράδειγμα:

Περίπτωση χρήσης: Καλέστε αυτήν την εντολή κατά τη διάρκεια της επεξεργασίας για να ελέγξετε την πρόοδο της εξαγωγής.***

language - Διαχείριση γλώσσας διεπαφής

Προβολή ή αλλαγή της γλώσσας διεπαφής CLI.

Σύνταξη:

Παραδείγματα:

Υποστηριζόμενες γλώσσες (38 συνολικά)

Κωδικός
Γλώσσα
Εγγενής ονομασία

en

Αγγλικά

Αγγλικά

es

Ισπανικά

Español

pt

Πορτογαλικά

Português

fr

Γαλλικά

Français

de

Γερμανικά

Deutsch

it

Ιταλικά

Italiano

ja

Ιαπωνικά

日本語

ko

Κορεατικά

한국어

zh

Κινέζικα (απλοποιημένα)

简体中文

zh-TW

Κινέζικα (παραδοσιακά)

繁體中文

ru

Ρωσικά

Русский

nl

Ολλανδικά

Nederlands

ar

Αραβικά

العربية

pl

Πολωνικά

Polski

tr

Τουρκικά

Türkçe

hi

Χίντι

हिंदी

id

Ινδονησιακά

Bahasa Indonesia

vi

Βιετναμέζικα

Tiếng Việt

th

Ταϊλανδικά

ไทย

sv

Σουηδικά

Svenska

da

Δανικά

Dansk

no

Νορβηγικά

Norsk

fi

Φινλανδικά

Suomi

el

Ελληνικά

Ελληνικά

cs

Τσεχικά

Čeština

hu

Ουγγρικά

Magyar

ro

Ρουμανικά

Română

uk

Ουκρανικά

Українська

pt-BR

Βραζιλιάνικα πορτογαλικά

Português Brasileiro

zh-HK

Καντονέζικα

粵語

ms

Μαλαισιανά

Bahasa Melayu

sk

Σλοβακικά

Slovenčina

bg

Βουλγαρικά

Български

hr

Κροατικά

Hrvatski

lt

Λιθουανικά

Lietuvių

lv

Λετονικά

Latviešu

et

Εσθονικά

Eesti

sl

Σλοβενικά

Slovenščina

circle-info

Αυτόματη διατήρηση: Η προτίμηση γλώσσας αποθηκεύεται στο ~/.chloros/cli_language.json και διατηρείται σε όλες τις συνεδρίες.


set-project-folder - Ορισμός προεπιλεγμένου φακέλου έργου

Αλλάξτε την προεπιλεγμένη θέση του φακέλου έργου (κοινή με το GUI).

Σύνταξη:

Παράδειγμα:


get-project-folder - Εμφάνιση φακέλου έργου

Εμφάνιση της τρέχουσας προεπιλεγμένης θέσης του φακέλου έργου.

Σύνταξη:

Παράδειγμα:

Έξοδος:


reset-project-folder - Επαναφορά στην προεπιλογή

Επαναφορά του φακέλου έργου στην προεπιλεγμένη θέση.

Σύνταξη:


Παγκόσμιες επιλογές

Αυτές οι επιλογές ισχύουν για όλες τις εντολές:

Επιλογή
Τύπος
Προεπιλογή
Περιγραφή

--backend-exe

Διαδρομή

Αυτόματη ανίχνευση

Διαδρομή προς το εκτελέσιμο αρχείο του backend

--port

Ακέραιος αριθμός

5000

Αριθμός θύρας του backend API

--restart

Σημαία

-

Αναγκαστική επανεκκίνηση του backend (τερματίζει τις υπάρχουσες διεργασίες)

--version

Σημαία

-

Εμφάνιση πληροφοριών έκδοσης και έξοδος

--help

Σημαία

-

Εμφάνιση πληροφοριών βοήθειας και έξοδος

Παράδειγμα με καθολικές επιλογές:


Οδηγός ρυθμίσεων επεξεργασίας

Παράλληλη επεξεργασία

Chloros+ CLI αυτοματοποιημένη κλιμάκωσητης παράλληλης επεξεργασίας ανάλογα με τις δυνατότητες του υπολογιστή σας:Πώς λειτουργεί:

  • Ανιχνεύει τους πυρήνες της CPU και τη μνήμη RAM

  • Κατανομή εργαζομένων: 2× πυρήνες CPU (χρησιμοποιεί hyperthreading)

  • Μέγιστο: 16 παράλληλοι εργαζόμενοι (για σταθερότητα)Επίπεδα συστήματος:

Τύπος συστήματος
CPU
RAM
Εργαζόμενοι
Απόδοση

Υψηλής απόδοσης

16+ πυρήνες

32+ GB

Έως 16

Μέγιστη ταχύτητα

Μεσαίας κατηγορίας

8-15 πυρήνες

16-31 GB

8-16

Εξαιρετική ταχύτητα

Χαμηλής κατηγορίας

4-7 πυρήνες

8-15 GB

4-8

Καλή ταχύτητα

circle-info

Αυτόματη βελτιστοποίηση: Το CLI ανιχνεύει αυτόματα τις προδιαγραφές του συστήματός σας και διαμορφώνει τη βέλτιστη παράλληλη επεξεργασία. Δεν απαιτείται χειροκίνητη διαμόρφωση!

Μέθοδοι Debayer

Το CLI χρησιμοποιεί Υψηλή ποιότητα (ταχύτερη) ως προεπιλεγμένο και συνιστώμενο αλγόριθμο debayer:

Μέθοδος
Ποιότητα
Ταχύτητα
Περιγραφή

Υψηλή ποιότητα (ταχύτερη)

⭐⭐⭐⭐

⚡⚡⚡

Αλγόριθμος ευαισθησίας στις άκρες (προεπιλεγμένος, συνιστώμενος)

Διόρθωση βινιέτας

Τι κάνει: Διορθώνει την πτώση του φωτός στις άκρες της εικόνας (σκούρες γωνίες που είναι συνηθισμένες στις εικόνες της κάμερας).

  • Ενεργοποιημένη από προεπιλογή - Οι περισσότεροι χρήστες θα πρέπει να την διατηρήσουν ενεργοποιημένη

  • Χρησιμοποιήστε --no-vignette για να την απενεργοποιήσετε

circle-info

Σύσταση: Ενεργοποιείτε πάντα τη διόρθωση βινιέτας για να εξασφαλίσετε ομοιόμορφη φωτεινότητα σε όλο το κάδρο.

Βαθμονόμηση ανακλαστικότητας

Μετατρέπει τις ακατέργαστες τιμές του αισθητήρα σε τυποποιημένα ποσοστά ανακλαστικότητας χρησιμοποιώντας πάνελ βαθμονόμησης.

  • Ενεργοποιημένο από προεπιλογή - Απαραίτητο για την ανάλυση της βλάστησης.

  • Απαιτεί πάνελ στόχων βαθμονόμησης στις εικόνες.

  • Χρησιμοποιήστε το --no-reflectance για να το απενεργοποιήσετε.

circle-info

Απαιτήσεις: Βεβαιωθείτε ότι τα πάνελ βαθμονόμησης είναι σωστά εκτεθειμένα και ορατά στις εικόνες σας για ακριβή μετατροπή της ανακλαστικότητας.

Διορθώσεις PPK

Τι κάνει: Εφαρμόζει διορθώσεις μετα-επεξεργασμένης κινηματικής χρησιμοποιώντας δεδομένα καταγραφής DAQ-A-SD για βελτιωμένη ακρίβεια GPS.

  • Απενεργοποιημένο από προεπιλογή

  • Χρησιμοποιήστε το --ppk για να το ενεργοποιήσετε

  • Απαιτεί αρχεία .daq στο φάκελο του έργου από τον αισθητήρα φωτός MAPIR DAQ-A-SD.

Μορφές εξόδου

Μορφή
Βάθος bit
Μέγεθος αρχείου
Κατάλληλο για

TIFF (16-bit)

16-bit ακέραιος

Μεγάλο

Ανάλυση GIS, φωτογραμμετρία (συνιστάται)

TIFF (32-bit, Ποσοστό)

32-bit float

Πολύ μεγάλος

Επιστημονική ανάλυση, έρευνα

PNG (8-bit)

8-bit ακέραιος

Μεσαίο

Οπτική επιθεώρηση, κοινή χρήση στο διαδίκτυο

JPG (8-bit)

8-bit ακέραιος

Μικρό

Γρήγορη προεπισκόπηση, συμπιεσμένη έξοδος

***

Αυτοματοποίηση και δημιουργία σεναρίων

Μαζική επεξεργασία PowerShell

Αυτόματη επεξεργασία πολλαπλών φακέλων δεδομένων:

Windows Σενάριο μαζικής επεξεργασίας

Απλός βρόχος για μαζική επεξεργασία:

Python Σενάριο αυτοματοποίησης

Προηγμένη αυτοματοποίηση με διαχείριση σφαλμάτων:


Ροή εργασίας επεξεργασίας

Τυπική ροή εργασίας

  1. Εισαγωγή: Φάκελος που περιέχει ζεύγη εικόνων RAW/JPG

  2. Ανακάλυψη: Το CLI σαρώνει αυτόματα τα υποστηριζόμενα αρχεία εικόνων

  3. Επεξεργασία: Η παράλληλη λειτουργία προσαρμόζεται στους πυρήνες της CPU σας (Chloros+)

  4. Έξοδος: Δημιουργεί υποφακέλους μοντέλων κάμερας με επεξεργασμένες εικόνες

Παράδειγμα δομής εξόδου

Εκτιμήσεις χρόνου επεξεργασίας

Τυπικοί χρόνοι επεξεργασίας για 100 εικόνες (12MP η καθεμία):

Λειτουργία
Χρόνος
Υλικό

Παράλληλη λειτουργία

5-10 λεπτά

i7/Ryzen 7, 16 GB RAM, SSD (έως 16 εργαζόμενοι)

Παράλληλη λειτουργία

10-15 λεπτά

i5/Ryzen 5, 8 GB RAM, HDD (έως 8 εργαζόμενοι)

circle-info

Συμβουλή απόδοσης: Ο χρόνος επεξεργασίας ποικίλλει ανάλογα με τον αριθμό των εικόνων, την ανάλυση και τις προδιαγραφές του υπολογιστή.


Αντιμετώπιση προβλημάτων

CLI Δεν βρέθηκε

Σφάλμα:

Λύσεις:

  1. Επαληθεύστε τη θέση εγκατάστασης:

  1. Χρησιμοποιήστε την πλήρη διαδρομή εάν δεν βρίσκεται στο PATH:

  1. Προσθέστε στο PATH χειροκίνητα:

    • Ανοίξτε τις Ιδιότητες συστήματος → Μεταβλητές περιβάλλοντος

    • Επεξεργαστείτε τη μεταβλητή PATH

    • Προσθέστε: C:\Program Files\Chloros\resources\cli

    • Επανεκκινήστε το τερματικό


Αποτυχία εκκίνησης του backendΣφάλμα:

Λύσεις:

  1. Ελέγξτε αν το backend εκτελείται ήδη (κλείστε το πρώτα)

  2. Ελέγξτε ότι το Windows Firewall δεν το μπλοκάρει

  3. Δοκιμάστε διαφορετική θύρα:

  1. Αναγκάστε την επανεκκίνηση του backend:


Προβλήματα άδειας χρήσης/αυθεντικοποίησηςΣφάλμα:

Λύσεις:

  1. Βεβαιωθείτε ότι έχετε ενεργή συνδρομή Chloros+.

  2. Συνδεθείτε με τα διαπιστευτήριά σας:

  1. Ελέγξτε την κατάσταση της άδειας χρήσης:

  1. Επικοινωνήστε με την υποστήριξη: info@mapir.camera


Δεν βρέθηκαν εικόνεςΣφάλμα:

Λύσεις:

  1. Βεβαιωθείτε ότι ο φάκελος περιέχει υποστηριζόμενες μορφές (.RAW, .TIF, .JPG)

  2. Ελέγξτε ότι η διαδρομή του φακέλου είναι σωστή (χρησιμοποιήστε εισαγωγικά για διαδρομές με κενά)

  3. Βεβαιωθείτε ότι έχετε δικαιώματα ανάγνωσης για το φάκελο.

  4. Ελέγξτε ότι οι επεκτάσεις αρχείων είναι σωστές.


Η επεξεργασία σταματά ή κολλάειΛύσεις:

  1. Ελέγξτε τον διαθέσιμο χώρο στο δίσκο (βεβαιωθείτε ότι είναι αρκετός για την έξοδο).

  2. Κλείστε άλλες εφαρμογές για να ελευθερώσετε μνήμη.

  3. Μειώστε τον αριθμό των εικόνων (επεξεργαστείτε τις σε παρτίδες).


Η θύρα χρησιμοποιείται ήδηΣφάλμα:

Λύση:

Καθορίστε μια διαφορετική θύρα:


Συχνές ερωτήσεις

Ε: Χρειάζομαι άδεια για το CLI;

Α:Ναι! Το CLI απαιτεί μια πληρωμένηάδεια Chloros+.

  • ❌ Πρότυπο (δωρεάν) πρόγραμμα: CLI απενεργοποιημένο

  • ✅ Πακέτα Chloros+ (επί πληρωμή): Το CLI είναι πλήρως ενεργοποιημένο

Εγγραφείτε στο: https://cloud.mapir.camera/pricingarrow-up-right


Ε: Μπορώ να χρησιμοποιήσω το CLI σε έναν διακομιστή χωρίς GUI;Α: Ναι! Το CLI λειτουργεί εντελώς χωρίς οθόνη. Απαιτήσεις:

  • Windows Server 2016 ή νεότερη έκδοση

  • Εγκατεστημένο Visual C++ Redistributable

  • Επαρκής μνήμη RAM (ελάχιστο 8 GB, συνιστάται 16 GB)

  • Εφάπαξ ενεργοποίηση άδειας GUI σε οποιονδήποτε υπολογιστή


Ε: Πού αποθηκεύονται οι επεξεργασμένες εικόνες;Α:Από προεπιλογή, οι επεξεργασμένες εικόνες αποθηκεύονται στονίδιο φάκελο με την είσοδο σε υποφακέλους μοντέλων κάμερας (π.χ. Survey3N_RGN/).

Χρησιμοποιήστε την επιλογή -o για να καθορίσετε διαφορετικό φάκελο εξόδου:


Ε: Μπορώ να επεξεργαστώ πολλούς φακέλους ταυτόχρονα;Α: Όχι απευθείας με μία εντολή, αλλά μπορείτε να χρησιμοποιήσετε σενάρια για να επεξεργαστείτε τους φακέλους διαδοχικά. Ανατρέξτε στην ενότητα Αυτοματοποίηση και σενάρια.***

Ε: Πώς μπορώ να αποθηκεύσω την έξοδο CLI σε ένα αρχείο καταγραφής;PowerShell:

Μαζική επεξεργασία:


Ε: Τι συμβαίνει αν πατήσω Ctrl+C κατά τη διάρκεια της επεξεργασίας;Α: Το CLI θα:

  1. Σταματήσει την επεξεργασία ομαλά

  2. Κλείσει το backend

  3. Κλείσει με κωδικό 130

Εικόνες που έχουν υποστεί μερική επεξεργασία ενδέχεται να παραμείνουν στον φάκελο εξόδου.


Ε: Μπορώ να αυτοματοποιήσω την επεξεργασία του CLI;Α: Φυσικά! Το CLI έχει σχεδιαστεί για αυτοματοποίηση. Δείτε Αυτοματοποίηση & Σενάρια για παραδείγματα PowerShell, Batch και Python.***

Ε: Πώς μπορώ να ελέγξω την έκδοση CLI;Α:

Έξοδος:


Λήψη βοήθειας

Βοήθεια γραμμής εντολών

Δείτε τις πληροφορίες βοήθειας απευθείας στο CLI:

Κανάλια υποστήριξης

Πλήρη παραδείγματα

Παράδειγμα 1: Βασική επεξεργασία

Επεξεργασία με προεπιλεγμένες ρυθμίσεις (βινιέτα, ανακλαστικότητα):


Παράδειγμα 2: Επιστημονικά αποτελέσματα υψηλής ποιότητας

32-bit float TIFF:


Παράδειγμα 3: Γρήγορη επεξεργασία προεπισκόπησης

8-bit PNG χωρίς βαθμονόμηση για γρήγορη ανασκόπηση:


Παράδειγμα 4: Επεξεργασία με διόρθωση PPK

Εφαρμογή διορθώσεων PPK με ανακλαστικότητα:


Παράδειγμα 5: Προσαρμοσμένη θέση εξόδου

Επεξεργασία σε διαφορετικό δίσκο με συγκεκριμένη μορφή:


Παράδειγμα 6: Ροή εργασίας πιστοποίησης

Ολοκλήρωση ροής πιστοποίησης:


Παράδειγμα 7: Χρήση πολλαπλών γλωσσών

Αλλαγή γλώσσας διεπαφής:

Last updated