مجموعة أدوات تطوير برامج Python
دليل المستخدم

مجموعة أدوات تطوير برامج Python

يطلب منك PCO قراءة واتباع التعليمات الواردة في هذا المستند بعناية.
لأية أسئلة أو تعليقات، لا تتردد في الاتصال بنا في أي وقت.
رقم الهاتف: +49 (0) 9441 2005 50
الفاكس: +49 (0) 9441 2005 20
العنوان البريدي: Excelitas PCO GmbH Donaupark 11 93309 Kelheim، ألمانيا
بريد إلكتروني: info@pco.de
web: www.pco.de
دليل مستخدم pco.python 0.1.7
تم إصداره في ديسمبر 2021
© حقوق الطبع والنشر لشركة Excelitas PCO GmbH
هذا العمل مرخص بموجب الرخصة الدولية Creative Commons Attribution-No Derivatives 4.0. ل view نسخة من هذا الترخيص، قم بزيارة http://creativecommons.org/licenses/by-nd/4.0/ أو أرسل خطابًا إلى Creative Commons، PO Box 1866، Mountain View، CA 94042، الولايات المتحدة الأمريكية.

عام

توفر حزمة Python pco جميع الوظائف للعمل مع كاميرات pco التي تعتمد على التيار pco.sdk. يتم تضمين جميع المكتبات المشتركة للتواصل مع الكاميرا ومعالجة الصور اللاحقة.

• فئة الكاميرا سهلة الاستخدام
• واجهة برمجة التطبيقات القوية ل pco.sdk
• تسجيل ومعالجة الصور باستخدام pco.recorder

1.1 التثبيت
التثبيت من pypi (مستحسن):
$ نقطة تثبيت PCO
1.2 الاستخدام الأساسي
استيراد matplotlib.pyplot كـ plt
استيراد pco
باستخدام pco.Camera() ككاميرا:
تسجيل الكاميرا ()
الصورة التعريفية = cam.image()
plt.imshow(image, cmap='gray')
plt.show()1.3 تسجيل الأحداث والأخطاء
لتنشيط إخراج التسجيل، قم بإنشاء كائن الكاميرا باستخدام المعلمة debuglevel=.
يمكن تعيين مستوى التصحيح على إحدى القيم التالية:

• "إيقاف" تعطيل كافة المخرجات.
• "خطأ" يعرض رسائل الخطأ فقط.
• "مطول" يظهر كافة الرسائل.
• "مطول إضافي" يعرض كافة الرسائل والقيم.

مستوى التصحيح الافتراضي هو "إيقاف".
pco.Camera(debuglevel='مطول')
…
[][sdk] get_camera_type: حسنًا.
التوقيت الاختياريamp= تنشيط المعلمة أ tag في الإخراج المطبوع. القيم المحتملة هي: "تشغيل" و"إيقاف". القيمة الافتراضية هي "إيقاف".
pco.Camera(debuglevel='verbose', timestamp='على')
…
[2019-11-25 15:54:15.317855 / 0.016 ث] [][sdk] get_camera_type: حسنًا.

توثيق واجهة برمجة التطبيقات

تقدم فئة pco.Camera الطرق التالية:

• يقوم السجل () بإنشاء وتكوين وتشغيل مثيل مسجل جديد.
• stop() يوقف التسجيل الحالي.
• Close() يغلق الكاميرا النشطة الحالية ويحرر الموارد المشغولة.
• تقوم image() بإرجاع صورة من المُسجل كمصفوفة numpy.
• تقوم الصور () بإرجاع جميع الصور المسجلة من المُسجل كقائمة من المصفوفات العددية.
• تقوم image_average() بإرجاع الصورة المتوسطة. يتم حساب هذه الصورة من جميع الصور المسجلة في المخزن المؤقت.
• set_exposure_time() يضبط وقت التعرض للكاميرا.
• ينتظر wait_for_first_image() أول صورة متاحة في ذاكرة المسجل.

تحتوي فئة pco.Camera على المتغير التالي:

• إعدادات

تحتوي فئة pco.Camera على الكائنات التالية:

• يوفر sdk الوصول المباشر إلى جميع الوظائف الأساسية للملف pco.sdk.
• يوفر المسجل إمكانية الوصول المباشر إلى جميع الوظائف الأساسية للملف pco.recorder.

2.1 الطرق
يصف هذا القسم جميع الطرق التي تقدمها فئة pco.Camera.
2.1.1 سجل
وصف يقوم بإنشاء مثيل مسجل جديد وتكوينه وبدء تشغيله. يجب ضبط تكوين الكاميرا بالكامل قبل استدعاء السجل (). الأمر set_exposure_time() هو الاستثناء الوحيد. ليس لهذه الوظيفة أي تأثير على كائن المسجل ويمكن استدعاؤها أثناء التسجيل.
النموذج الأولي سجل Def (self، number_of_images=1، mode='sequence'):
المعلمة

اسم	وصف
number_of_images	يضبط عدد الصور المخصصة في برنامج التشغيل. تحدد ذاكرة الوصول العشوائي للكمبيوتر الشخصي الحد الأقصى للقيمة.
وضع	في وضع "التسلسل"، يتم حظر هذه الوظيفة أثناء التسجيل. يتوقف المُسجل تلقائيًا عند الوصول إلى عدد الصور. في وضع "التسلسل غير المحظور"، تكون هذه الوظيفة غير محظورة. يجب التحقق من الحالة قبل قراءة الصورة. يستخدم هذا الوضع لقراءة الصور أثناء التسجيل، على سبيل المثال الصورة المصغرة. في وضع "المخزن المؤقت الدائري"، لا تكون هذه الوظيفة محظورة. يجب التحقق من الحالة قبل قراءة الصورة. لا يقوم المُسجل بإيقاف التسجيل عند الوصول إلى عدد الصور. وبمجرد حدوث ذلك، تتم الكتابة فوق الصور الأقدم. في وضع "fifo"، تكون هذه الوظيفة غير محظورة. يجب التحقق من الحالة قبل قراءة الصورة. عند الوصول إلى number_of_images في fifo، يتم إسقاط الصور التالية حتى تتم قراءة الصور من fifo.

2.1.2 توقف
وصف يوقف التسجيل الحالي. في وضع "ring buffer" و"fifo"، يجب على المستخدم استدعاء هذه الوظيفة. في وضع "التسلسل" و"التسلسل غير المحظور"، يتم استدعاء هذه الوظيفة تلقائيًا عند الوصول إلى عدد الصور.
النموذج الأولي توقف ديف (النفس):
2.1.3 إغلاق
وصف يغلق الكاميرا النشطة ويحرر الموارد المحظورة. يجب استدعاء هذه الوظيفة قبل إنهاء التطبيق. وبخلاف ذلك، تظل الموارد مشغولة.
النموذج الأولي إغلاق بالتأكيد (النفس):
يتم استدعاء هذه الوظيفة تلقائيًا إذا تم إنشاء كائن الكاميرا بواسطة عبارة with. لم تعد الدعوة الصريحة للإغلاق () ضرورية.
باستخدام pco.Camera() ككاميرا: # قم ببعض الأشياء
2.1.4 الصورة
وصف إرجاع صورة من المسجل. نوع الصورة هو numpy.ndarray. يتم تشكيل هذه المصفوفة اعتمادًا على دقة الصورة وعائد استثمارها.
النموذج الأولي تعريف الصورة (self، image_number=0، roi=None):
المعلمة

اسم	وصف
رقم الصورة	يحدد رقم الصورة المراد قراءتها. في وضع "التسلسل" أو "التسلسل غير المحظور"، يتطابق فهرس المُسجل مع رقم_الصورة. إذا تم ضبط image_number على 0xFFFFFFFF، فسيتم نسخ آخر صورة مسجلة. هذا يسمح بإنشاء عرض مباشر مسبقًاview أثناء التسجيل.
ملكي	يحدد المنطقة محل الاهتمام. يتم نسخ هذه المنطقة من الصورة فقط إلى القيمة المرجعة.

Example >>> cam.record(number_of_images=1, mode='sequence')
>>> الصورة، التعريف = cam.image()
>>> اكتب (صورة) numpy.ndarray
>>> شكل الصورة (2160، 2560)
>>> الصورة، البيانات الوصفية = cam.image(roi=(1, 1, 300, 300))
>>> شكل الصورة (300، 300)
2.1.5 الصور
وصف يقوم بإرجاع جميع الصور المسجلة من المُسجل كقائمة من المصفوفات العددية.
النموذج الأولي تعريف الصور (self، roi=None، blocksize=None):
المعلمة

اسم	وصف
ملكي	يحدد المنطقة محل الاهتمام. يتم نسخ هذه المنطقة من الصورة فقط إلى القيمة المرجعة.
حجم الكتلة	يحدد الحد الأقصى لعدد الصور التي يتم إرجاعها. هذه المعلمة مفيدة فقط في وضع "fifo" وفي ظل ظروف خاصة.

Example >>> cam.record(number_of_images=20, mode='sequence')
>>> الصور والبيانات الوصفية = cam.images()
>>> لين (الصور) 20
>>> للصورة في الصور:
…
طباعة ('المتوسط: {:7.2f} DN'.format(image.mean()))
…
يعني: 2147.64 DN
يعني: 2144.61 DN
…
>>> الصور = cam.images(roi=(1, 1, 300, 300))
>>> الصور[0].الشكل (300، 300)
2.1.6 متوسط ​​الصورة
وصف إرجاع الصورة المتوسطة. يتم حساب هذه الصورة من جميع الصور المسجلة في المخزن المؤقت.
النموذج الأولي تعريف image_average(self, roi=None):
المعلمة

اسم	وصف
ملكي	يحدد المنطقة ذات الاهتمام. يتم نسخ هذه المنطقة من الصورة فقط إلى القيمة المرجعة.

Example >>> cam.record(number_of_images=100, mode='sequence')
>>> المتوسط ​​= cam.image_average()
>>> المتوسط ​​= cam.image_average(roi=(1, 1, 300, 300))
2.1.7 ضبط_وقت_التعرض
وصف يضبط وقت التعرض للكاميرا.
النموذج الأولي تعريف set_exposure_time (الذات، وقت التعرض):
المعلمة

اسم	وصف
وقت التعرض	يجب أن تعطى كقيمة عائمة أو عدد صحيح في الوحدة "الثانية". سيتم حساب القيم الأساسية للوظيفة sdk.set_delay_exposure_time(0, 'ms', time, timebase) تلقائيًا. يتم ضبط وقت التأخير على 0.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 انتظر_الصورة_الأولى
وصف ينتظر أول صورة متاحة في ذاكرة المسجل. في وضع المسجل "التسلسل غير محظور"، "المخزن المؤقت للحلقة". و'fifo'، تُرجع الدالة Record()‎ على الفور. لذلك، يمكن استخدام هذه الوظيفة لانتظار الصور من الكاميرا قبل استدعاء الصورة () أو الصور () أو image_average ().
النموذج الأولي def wait_for_first_image(self):
2.2 التكوين المتغير
يتم تحديث معلمات الكاميرا عن طريق تغيير متغير التكوين.
cam.configuration = {'وقت التعرض': 10e-3،
'عائد الاستثمار': (1، 1، 512، 512)،
"التوقيتamp': 'أسكي'،
"معدل البكسل": 100_000_000،
"المشغل": "التسلسل التلقائي"،
"اكتساب": "تلقائي"،
"البيانات الوصفية": "تشغيل"،
'binning': (1، 1)}
لا يمكن تغيير المتغير إلا قبل استدعاء الدالة السجل (). إنه قاموس يحتوي على عدد معين من الإدخالات. ليس من الضروري تحديد جميع العناصر الممكنة. ما يليampيغير الكود le فقط "معدل البكسل" ولا يؤثر على أي عناصر أخرى في التكوين.
باستخدام pco.Camera() ككاميرا:
cam.configuration = {'معدل البكسل': 286_000_000}
تسجيل الكاميرا ()
…
2.3 الأشياء
يصف هذا القسم جميع الكائنات التي تقدمها فئة pco.Camera.
2.3.1 مجموعة أدوات تطوير برمجيات
يسمح كائن sdk بالوصول المباشر إلى جميع الوظائف الأساسية للكائن pco.sdk.
>>> cam.sdk.get_temperature()
{'درجة حرارة المستشعر': 7.0، 'درجة حرارة الكاميرا': 38.2، 'درجة حرارة الطاقة': 36.7}
جميع قيم الإرجاع من وظائف sdk هي قواميس. لا تتم تغطية كافة إعدادات الكاميرا حاليًا بواسطة فئة الكاميرا. يجب ضبط الإعدادات الخاصة مباشرة عن طريق استدعاء وظيفة sdk المعنية.
مسجل 2.3.2
يوفر كائن تسجيل الوصول المباشر إلى كافة الوظائف الأساسية لل pco.recorder. ليس من الضروري استدعاء أسلوب فئة المسجل مباشرة. تتم تغطية جميع الوظائف بالكامل من خلال أساليب فئة الكاميرا.

https://www.pco.de/applications/

أوروبا بي سي أو +49 9441 2005 50 info@pco.de pco.de

pco أمريكا +1 866 678 4566 info@pco-tech.com pco-tech.com

pco آسيا +65 6549 7054 info@pco-imaging.com pco-imaging.com

pco الصين +86 512 67634643 info@pco.cn pco.cn

المستندات / الموارد

مجموعة أدوات تطوير برمجيات بايثون من EXCELITAS TECHNOLOGIES [بي دي اف] دليل المستخدم مجموعة أدوات تطوير برمجيات بايثون، مجموعة أدوات تطوير البرمجيات، مجموعة أدوات التطوير، مجموعة أدوات

مراجع

• دليل المستخدم