CLI: سطر الأوامر

يوفر **Chloros CLI** وصولاً قويًا عبر سطر الأوامر إلى محرك معالجة الصور Chloros، مما يتيح الأتمتة والبرمجة النصية والتشغيل بدون شاشة لعمليات سير عمل التصوير لديك.

الميزات الرئيسية

  • 🚀 الأتمتة - معالجة دفعية برمجية لعدة مجموعات بيانات

  • 🔗 التكامل - دمج في سير العمل والخطوط الإنتاجية الحالية

  • 💻 التشغيل بدون واجهة - التشغيل بدون واجهة المستخدم الرسومية

  • 🌍 متعدد اللغات - دعم 38 لغة

  • المعالجة المتوازية - يتكيف ديناميكيًا مع وحدة المعالجة المركزية (CPU) (حتى 16 عاملًا متوازيًا)

المتطلبات

المتطلبات
التفاصيل

نظام التشغيل

Windows 10/11 (64 بت)

الذاكرة

8 جيجابايت من ذاكرة الوصول العشوائي (RAM) كحد أدنى (يوصى بـ 16 جيجابايت)

الإنترنت

مطلوب لتفعيل الترخيص

مساحة القرص

تختلف حسب حجم المشروع

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

سلسلة

يتم إنشاؤها تلقائيًا

اسم مشروع مخصص

--vignette

علامة

ممكّن

تمكين تصحيح التظليل

--no-vignette

علامة

-

تعطيل تصحيح التظليل

--reflectance

علامة

ممكّن

تمكين معايرة الانعكاس

--no-reflectance

علامة

-

تعطيل معايرة الانعكاس

--ppk

علامة

معطل

تطبيق تصحيحات PPK من بيانات مستشعر الضوء .daq

--format

اختيار

TIFF (16 بت)

تنسيق الإخراج: TIFF (16-bit)، TIFF (32-bit, Percent)، PNG (8-bit)، JPG (8-bit)

--min-target-size

عدد صحيح

تلقائي

الحد الأدنى لحجم الهدف بالبكسل لاكتشاف لوحة المعايرة

--target-clustering

عدد صحيح

تلقائي

عتبة تجميع الهدف (0-100)

--exposure-pin-1

سلسلة

لا شيء

قفل التعرض لطراز الكاميرا (السن 1)

--exposure-pin-2

سلسلة

لا شيء

قفل التعرض لطراز الكاميرا (السن 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

الإنجليزية

English

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 - تعيين مجلد المشروع الافتراضي

تغيير موقع مجلد المشروع الافتراضي (المشترك مع واجهة المستخدم الرسومية).

الصيغة:

مثال:


get-project-folder - إظهار مجلد المشروع

عرض موقع مجلد المشروع الافتراضي الحالي.

الصيغة:

مثال:

الناتج:


reset-project-folder - إعادة التعيين إلى الإعدادات الافتراضية

إعادة تعيين مجلد المشروع إلى الموقع الافتراضي.

الصيغة:


الخيارات العامة

تنطبق هذه الخيارات على جميع الأوامر:

الخيار
النوع
الافتراضي
الوصف

--backend-exe

المسار

يتم الكشف عنه تلقائيًا

المسار إلى الملف التنفيذي للخلفية

--port

عدد صحيح

5000

رقم منفذ API للخلفية

--restart

علامة

-

إجبار الخلفية على إعادة التشغيل (إنهاء العمليات الحالية)

--version

علامة

-

عرض معلومات الإصدار والخروج

--help

علامة

-

عرض معلومات المساعدة والخروج

مثال مع الخيارات العامة:


دليل إعدادات المعالجة

المعالجة المتوازية

Chloros+ CLI يقوم تلقائيًا بتحجيمالمعالجة المتوازية لتتناسب مع قدرات جهاز الكمبيوتر الخاص بك:كيفية العمل:

  • يكتشف نوى وحدة المعالجة المركزية (CPU) وذاكرة الوصول العشوائي (RAM)

  • يخصص العمال: 2× نوى وحدة المعالجة المركزية (CPU) (يستخدم تقنية hyperthreading)

  • الحد الأقصى: 16 عاملًا متوازيًا (لضمان الاستقرار)مستويات النظام:

نوع النظام
وحدة المعالجة المركزية (CPU)
ذاكرة الوصول العشوائي (RAM)
العمال
الأداء

متطور

16+ نواة

32+ جيجابايت

حتى 16

سرعة قصوى

متوسط

8-15 نواة

16-31 جيجابايت

8-16

سرعة ممتازة

منخفض

4-7 نواة

8-15 جيجابايت

4-8

سرعة جيدة

circle-info

التحسين التلقائي: يقوم CLI تلقائيًا باكتشاف مواصفات نظامك وتكوين المعالجة المتوازية المثلى. لا حاجة إلى التكوين اليدوي!

طرق إزالة التباين

يستخدم CLI جودة عالية (أسرع) كخوارزمية إزالة التباين الافتراضية والموصى بها:

الطريقة
الجودة
السرعة
الوصف

جودة عالية (أسرع)

⭐⭐⭐⭐

⚡⚡⚡

خوارزمية حساسة للحواف (افتراضية، موصى بها)

تصحيح التظليل

وظيفته: تصحيح انخفاض الإضاءة عند حواف الصورة (الزوايا الداكنة الشائعة في صور الكاميرا).

  • ممكّن افتراضيًا - يجب على معظم المستخدمين إبقاء هذه الميزة ممكّنة

  • استخدم --no-vignette لتعطيلها

circle-info

التوصية: قم دائمًا بتمكين تصحيح التظليل لضمان سطوع موحد عبر الإطار.

معايرة الانعكاس

تحول قيم المستشعر الأولية إلى نسب انعكاس قياسية باستخدام لوحات المعايرة.

  • ممكّن بشكل افتراضي - ضروري لتحليل الغطاء النباتي

  • يتطلب لوحات هدف المعايرة في الصور

  • استخدم --no-reflectance للتعطيل

circle-info

المتطلبات: تأكد من أن لوحات المعايرة معرضة بشكل صحيح ومرئية في صورك من أجل تحويل انعكاس دقيق.

تصحيحات PPK

ماذا يفعل: يطبق تصحيحات حركية معالجة لاحقًا باستخدام بيانات سجل DAQ-A-SD لتحسين دقة GPS.

  • معطل افتراضيًا

  • استخدم --ppk للتفعيل

  • يتطلب ملفات .daq في مجلد المشروع من مستشعر الضوء MAPIR DAQ-A-SD.

تنسيقات الإخراج

التنسيق
عمق البت
حجم الملف
الأفضل لـ

TIFF (16 بت)

عدد صحيح 16 بت

كبير

تحليل GIS، التصوير المساحي (موصى به)

TIFF (32 بت، نسبة مئوية)

32 بت عائم

كبير جدًا

تحليل علمي، بحث

PNG (8 بت)

عدد صحيح 8 بت

متوسط

الفحص البصري، مشاركة الويب

JPG (8 بت)

عدد صحيح 8 بت

صغير

معاينة سريعة، إخراج مضغوط

***

الأتمتة والبرمجة النصية

معالجة دفعية PowerShell

معالجة عدة مجلدات من مجموعات البيانات تلقائيًا:

Windows البرنامج النصي الدفعي

حلقة بسيطة للمعالجة الدفعية:

Python برنامج نصي للأتمتة

أتمتة متقدمة مع معالجة الأخطاء:


سير عمل المعالجة

سير العمل القياسي

  1. الإدخال: مجلد يحتوي على أزواج صور RAW/JPG

  2. الاكتشاف: يقوم CLI بالمسح التلقائي للملفات الصورية المدعومة

  3. المعالجة: يتكيف الوضع المتوازي مع نوى وحدة المعالجة المركزية (Chloros+)

  4. الإخراج: ينشئ مجلدات فرعية لطراز الكاميرا مع الصور المعالجة

مثال على هيكل الإخراج

تقديرات وقت المعالجة

أوقات المعالجة النموذجية لـ 100 صورة (12 ميجابكسل لكل منها):

الوضع
الوقت
الأجهزة

الوضع المتوازي

5-10 دقائق

i7/Ryzen 7، ذاكرة وصول عشوائي (RAM) سعة 16 جيجابايت، SSD (حتى 16 عامل)

الوضع المتوازي

10-15 دقيقة

i5/Ryzen 5، ذاكرة وصول عشوائي (RAM) سعة 8 جيجابايت، محرك أقراص ثابتة (HDD) (حتى 8 عمال)

circle-info

نصيحة لتحسين الأداء: يختلف وقت المعالجة بناءً على عدد الصور ودقتها ومواصفات الكمبيوتر.


استكشاف الأخطاء وإصلاحها

CLI غير موجود

الخطأ:

الحلول:

  1. تحقق من موقع التثبيت:

  1. استخدم المسار الكامل إذا لم يكن موجودًا في PATH:

  1. أضف إلى PATH يدويًا:

    • افتح خصائص النظام → متغيرات البيئة

    • قم بتحرير متغير PATH

    • أضف: C:\Program Files\Chloros\resources\cli

    • أعد تشغيل المحطة الطرفية


فشل بدء تشغيل الخلفيةالخطأ:

الحلول:

  1. تحقق مما إذا كانت الخلفية قيد التشغيل بالفعل (أغلقها أولاً)

  2. تحقق من أن جدار الحماية Windows لا يقوم بحظر

  3. جرب منفذًا مختلفًا:

  1. فرض إعادة تشغيل الخلفية:


مشكلات الترخيص/المصادقةالخطأ:

الحلول:

  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 جيجابايت كحد أدنى، 16 جيجابايت موصى بها)

  • تنشيط ترخيص واجهة المستخدم الرسومية (GUI) لمرة واحدة على أي جهاز


س: أين يتم حفظ الصور المعالجة؟ج:بشكل افتراضي، يتم حفظ الصور المعالجة فينفس المجلد الذي تم إدخالها فيه في مجلدات فرعية لطراز الكاميرا (على سبيل المثال، Survey3N_RGN/).

استخدم خيار -o لتحديد مجلد إخراج مختلف:


س: هل يمكنني معالجة عدة مجلدات في وقت واحد؟ج: ليس مباشرة في أمر واحد، ولكن يمكنك استخدام البرمجة النصية لمعالجة المجلدات بالتسلسل. راجع قسم الأتمتة والبرمجة النصية.***

س: كيف أحفظ مخرجات CLI في ملف سجل؟PowerShell:

الدُفعة:


س: ماذا يحدث إذا ضغطت على Ctrl+C أثناء المعالجة؟ج: سيقوم CLI بما يلي:

  1. إيقاف المعالجة بشكل سلس

  2. إيقاف تشغيل الخلفية

  3. الخروج برمز 130

قد تظل الصور المعالجة جزئيًا في مجلد الإخراج.


س: هل يمكنني أتمتة معالجة CLI؟ج: بالطبع! تم تصميم CLI للأتمتة. انظر الأتمتة والبرمجة النصية للحصول على أمثلة PowerShell و Batch و Python.***

س: كيف يمكنني التحقق من إصدار CLI؟ج:

الإخراج:


الحصول على المساعدة

مساعدة سطر الأوامر

اعرض معلومات المساعدة مباشرة في CLI:

قنوات الدعم

أمثلة كاملة

المثال 1: المعالجة الأساسية

المعالجة باستخدام الإعدادات الافتراضية (التظليل، الانعكاس):


المثال 2: مخرجات علمية عالية الجودة

32 بت عائم TIFF:


المثال 3: معالجة المعاينة السريعة

8 بت PNG بدون معايرة للمراجعة السريعة:


المثال 4: معالجة مصححة بواسطة PPK

تطبيق تصحيحات PPK مع الانعكاس:


المثال 5: موقع إخراج مخصص

معالجة إلى محرك أقراص مختلف بتنسيق محدد:


المثال 6: سير عمل المصادقة

إكمال سير عمل المصادقة:


المثال 7: الاستخدام متعدد اللغات

تغيير لغة الواجهة:

Last updated