EXCELITAS TECHNOLOGIES Python سافٽ ويئر ڊولپمينٽ کٽ يوزر مينوئل

پٿون سافٽ ويئر ڊولپمينٽ کٽ
استعمال ڪندڙ دستي

مواد لڪائڻ

1 پٿون سافٽ ويئر ڊولپمينٽ کٽ

پٿون سافٽ ويئر ڊولپمينٽ کٽ

PCO توهان کي هن دستاويز ۾ ڏنل هدايتن کي غور سان پڙهڻ ۽ ان تي عمل ڪرڻ لاءِ چوندو آهي.
ڪنهن به سوال يا رايا لاء، مهرباني ڪري ڪنهن به وقت اسان سان رابطو ڪرڻ لاء آزاد محسوس.
ٽيليفون: + 49 (0) 9441 2005 50
فيڪس: +49 (0) 9441 2005 20
پوسٽل ايڊريس: Excelitas PCO GmbH Donaupark 11 93309 Kelheim، Germany
اي ميل: info@pco.de
web: www.pco.de
pco.python يوزر مينوئل 0.1.7
ريليز ٿيل ڊسمبر 2021
© ڪاپي رائيٽ Excelitas PCO GmbH
هي ڪم Creative Commons Attribution-No Derivatives 4.0 International License تحت لائسنس يافته آهي. جي طرف view هن لائسنس جي هڪ ڪاپي، دورو ڪريو http://creativecommons.org/licenses/by-nd/4.0/ يا Creative Commons ڏانهن خط موڪليو، PO Box 1866، Mountain View، CA 94042، USA.

جنرل

Python پيڪيج pco پيش ڪري ٿو سڀ ڪم ڪرڻ لاءِ پي سي او ڪيمرائون جيڪي موجوده تي ٻڌل آهن pco.sdk. ڪئميرا سان رابطي لاءِ سڀ شيئر ڪيل لائبريريون ۽ بعد ۾ تصويري پروسيسنگ شامل آهن.

ڪئميرا ڪلاس استعمال ڪرڻ آسان
طاقتور API ڏانهن pco.sdk
تصوير جي رڪارڊنگ ۽ پروسيسنگ سان pco.recorder

1.1 تنصيب
pypi کان انسٽال ڪريو (سفارش ٿيل):
$pip انسٽال pco
1.2 بنيادي استعمال
matplotlib.pyplot کي plt طور درآمد ڪريو
پي سي او درآمد ڪريو
pco.Camera() سان ڪئميرا جي طور تي:
cam.record()
تصوير، meta = cam.image()
plt.imshow(تصوير، cmap='گرين')
plt.show()1.3 واقعا ۽ غلطي لاگنگ
لاگنگ آئوٽ کي چالو ڪرڻ لاءِ، ڊيبگليول = پيراميٽر سان ڪيمرا اعتراض ٺاهيو.
ڊيبگ ليول ھيٺ ڏنل قدرن مان ھڪڙي کي سيٽ ڪري سگھجي ٿو:

'آف' سڀني آئوٽ کي بند ڪري ٿو.
'error' صرف نقص پيغام ڏيکاري ٿو.
'verbose' سڀ نياپا ڏيکاري ٿو.
'اضافي لفظ' ڏيکاري ٿو سڀ پيغام ۽ قدر.

ڊفالٽ ڊيبگليول 'بند' آهي.
pco.Camera(debuglevel='verbose')
...
[][sdk] get_camera_type: ٺيڪ.
اختياري وقتamp= پيرا ميٽر چالو ڪري ٿو a tag پرنٽ ٿيل آئوٽ ۾. ممڪن قدر آهن: 'آن' ۽ 'آف'. ڊفالٽ قدر 'بند' آهي.
pco.Camera(debuglevel='verbose'، timestamp= 'پر')
...
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: ٺيڪ.

API دستاويز

pco.Camera ڪلاس هيٺ ڏنل طريقا پيش ڪري ٿو:

رڪارڊ () ٺاهي ٿو، ترتيب ڏئي ٿو، ۽ نئين رڪارڊر مثال شروع ڪري ٿو.
stop() موجوده رڪارڊنگ کي روڪي ٿو.
بند ڪريو () موجوده فعال ڪئميرا کي بند ڪري ٿو ۽ قبضو ڪيل وسيلن کي جاري ڪري ٿو.

image() رڪارڊر مان ھڪڙي تصوير کي نمپي صف جي طور تي موٽائي ٿو.
images() رڪارڊر مان سڀئي رڪارڊ ٿيل تصويرون واپس ڪري ٿو نمپي صفن جي فهرست جي طور تي.

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'):
پيرا ميٽر

نالو	وصف
تصويرن جو تعداد	ڊرائيور ۾ مختص ڪيل تصويرن جو تعداد مقرر ڪري ٿو. پي سي جي رام وڌ کان وڌ قيمت کي محدود ڪري ٿي.
موڊ	'ترتيب' موڊ ۾، هي فنڪشن رڪارڊ دوران روڪي رهيو آهي. رڪارڊر خود بخود بند ٿي ويندو آهي جڏهن نمبر_of_images پهچي ويندو آهي. 'sequence non blocking' موڊ ۾، هي فنڪشن غير بلاڪنگ آهي. تصوير پڙهڻ کان اڳ اسٽيٽس چيڪ ڪيو وڃي. ھي موڊ استعمال ڪيو ويندو آھي تصويرن کي پڙھڻ لاءِ رڪارڊنگ دوران، مثال طور تھمب نيل. 'رنگ بفر' موڊ ۾ هي فنڪشن غير بلاڪنگ آهي. تصوير پڙهڻ کان اڳ اسٽيٽس چيڪ ڪيو وڃي. رڪارڊر رڪارڊنگ بند نه ڪندو آهي جڏهن نمبر_of_images تائين پهچي ويندو آهي. هڪ دفعو اهو ٿئي ٿو، پراڻيون تصويرون ختم ٿي وينديون آهن. 'فيفو' موڊ ۾، هي فنڪشن غير بلاڪنگ آهي. تصوير پڙهڻ کان اڳ اسٽيٽس چيڪ ڪيو وڃي. جڏهن فيفو ۾ نمبر_of_images پهچي ويندو آهي، هيٺيون تصويرون ڪڍيون وينديون آهن جيستائين تصويرون فيفو مان پڙهيا وڃن.

2.1.2 روڪيو
وصف موجوده رڪارڊنگ کي روڪي ٿو. 'رنگ بفر' ۽ 'فيفو' موڊ ۾، هن فنڪشن کي استعمال ڪندڙ کي سڏيو وڃي ٿو. 'sequence' ۽ 'sequence non blocking' موڊ ۾، هي فنڪشن پاڻمرادو سڏبو آهي جڏهن نمبر_of_images تي پهچي وڃي.
پروٽوٽائپ def اسٽاپ (خود):
2.1.3 بند ڪريو
وصف چالو ڪئميرا کي بند ڪري ٿو ۽ بلاڪ ڪيل وسيلن کي جاري ڪري ٿو. ايپليڪيشن کي ختم ٿيڻ کان پهريان هن فنڪشن کي سڏيو وڃي. ٻي صورت ۾، وسيلن تي قبضو رهندو.
پروٽوٽائپ def بند (خود):
اهو فنڪشن خودڪار طور تي سڏيو ويندو آهي جيڪڏهن ڪئميرا اعتراض سان بيان سان ٺهيل آهي. بند ڪرڻ لاءِ واضح ڪال () هاڻي ضروري ناهي.
pco.Camera() سان ڪئميرا جي طور تي: # ڪجھ شيون ڪريو
2.1.4 تصوير
وصف رڪارڊر مان هڪ تصوير موٽائي ٿو. تصوير جو قسم آھي numpy.ndarray. هي صف ٺهيل آهي تصوير جي قرارداد ۽ ROI تي منحصر آهي.
پروٽوٽائپ def تصوير (خود، تصوير_نمبر = 0، روئي = ڪو به نه):
پيرا ميٽر

نالو	وصف
تصوير_نمبر	پڙھڻ لاءِ تصوير جو تعداد بيان ڪري ٿو. 'sequence' يا 'sequence non blocking' موڊ ۾، رڪارڊر انڊيڪس تصوير_نمبر سان ملي ٿو. جيڪڏهن تصوير_نمبر 0xFFFFFFFF تي سيٽ ڪيو ويو آهي، آخري رڪارڊ ٿيل تصوير ڪاپي ڪئي وئي آهي. هي هڪ لائيو پري ٺاهڻ جي اجازت ڏئي ٿوview رڪارڊنگ دوران.
روئي	دلچسپي جي علائقي کي ترتيب ڏئي ٿو. صرف تصوير جو هي علائقو واپسي جي قيمت تي نقل ڪيو ويو آهي.

Example >>> cam.record(number_of_images=1, mode='sequence')
>>> تصوير، meta = cam.image()
>>> قسم (تصوير) numpy.ndarray
>>> image.shape (2160, 2560)
>>> تصوير، metadata = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 تصويرون
وصف رڪارڊر مان سڀئي رڪارڊ ٿيل تصويرون واپس ڪري ٿو نمپي صفن جي فهرست جي طور تي.
پروٽوٽائپ def تصويرون (خود، روئي = ڪو به نه، بلاڪ سائز = ڪو به نه):
پيرا ميٽر

نالو	وصف
روئي	دلچسپي جي علائقي کي ترتيب ڏئي ٿو. صرف تصوير جو هي علائقو واپسي جي قيمت تي نقل ڪيو ويو آهي.
بلاڪ سائيز	تصويرن جو وڌ ۾ وڌ تعداد بيان ڪري ٿو جيڪي واپس ڪيا ويا آھن. هي پيٽرول صرف 'فيفو' موڊ ۾ ۽ خاص حالتن ۾ مفيد آهي.

Example >>> cam.record(number_of_images=20, mode='sequence')
>>> تصويرون، metadatas = cam.images()
>>> لين (تصويرون) 20
>>> تصويرن ۾ تصوير لاءِ:
...
پرنٽ ('مطلب: {:7.2f} DN'. فارميٽ(image.mean()))
...
مطلب: 2147.64 DN
مطلب: 2144.61 DN
...
>>> تصويرون = cam.images(roi=(1, 1, 300, 300))
>>> تصويرون[0] شڪل (300, 300)
2.1.6 تصويري_اوسط
وصف سراسري تصوير ڏي ٿو. هي تصوير بفر ۾ سڀني رڪارڊ ٿيل تصويرن مان ڳڻيو ويندو آهي.
پروٽوٽائپ def image_average (خود، روئي = ڪو به نه):
پيرا ميٽر

نالو	وصف
روئي	دلچسپي جي علائقي کي بيان ڪري ٿو. صرف تصوير جو هي علائقو واپسي جي قيمت تي نقل ڪيو ويو آهي.

Example >>> cam.record(number_of_images=100, mode='sequence')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Set_exposure_time
وصف ڪئميرا جي نمائش جو وقت مقرر ڪري ٿو.
پروٽوٽائپ def set_exposure_time (پاڻ، 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 Wait_for_first_image
وصف رڪارڊر ميموري ۾ پهرين دستياب تصوير جو انتظار ڪري ٿو. رڪارڊر موڊ ۾ 'sequence non blocking'، 'ring buffer'. ۽ 'fifo'، فنڪشن رڪارڊ () فوري طور تي واپس اچي ٿو. تنهن ڪري، هي فنڪشن استعمال ڪري سگهجي ٿو ڪئميرا کان تصويرن جو انتظار ڪرڻ لاءِ ڪال ڪرڻ کان اڳ image(), images(), or image_average().
پروٽوٽائپ def wait_for_first_image(self):
2.2 متغير ترتيب
ڪيمرا پيٽرولر کي ترتيب ڏيڻ واري تبديلي کي تبديل ڪندي اپڊيٽ ڪيو ويو آهي.
cam.configuration = {'نمائش جو وقت': 10e-3,
'روئي': (1، 1، 512، 512)
'وقتamp': 'ascii',
'پکسل جي شرح': 100_000_000,
'trigger': 'خودڪار ترتيب',
'acquire': 'خودڪار',
'metadata': 'on',
'بننگ': (1، 1)}
متغير صرف رڪارڊ () فنڪشن کي سڏڻ کان اڳ تبديل ڪري سگھجي ٿو. اهو هڪ ڊڪشنري آهي جنهن ۾ هڪ خاص نمبر شامل آهن. سڀني ممڪن عناصر کي بيان ڪرڻ جي ضرورت ناهي. هيٺيون ايسample ڪوڊ صرف 'پکسل جي شرح' کي تبديل ڪري ٿو ۽ ترتيب جي ٻين عناصر کي متاثر نٿو ڪري.
pco.Camera() سان ڪئميرا جي طور تي:
cam.configuration = {'پکسل ريٽ': 286_000_000}
cam.record()
...
2.3 شيون
هي سيڪشن pco.Camera ڪلاس پاران پيش ڪيل سڀني شين کي بيان ڪري ٿو.
2.3.1 SDK
اعتراض sdk جي سڀني بنيادي ڪمن تائين سڌو رسائي جي اجازت ڏئي ٿي pco.sdk.
>>> cam.sdk.get_temperature()
{'سينسر جي درجه حرارت': 7.0، 'ڪئميرا جي درجه حرارت': 38.2، 'پاور گرمي پد': 36.7}
sdk افعال مان سڀئي واپسي قدر لغات آھن. نه سڀئي ڪئميرا سيٽنگون في الحال ڪئميرا ڪلاس سان ڍڪيل آهن. خاص سيٽنگون سڌو سنئون لاڳاپيل sdk فنڪشن کي ڪال ڪندي سيٽ ڪرڻ گهرجن.
2.3.2 رڪارڊر
اعتراض ريڪ جي سڀني بنيادي ڪمن تائين سڌو رسائي پيش ڪري ٿو pco.recorder. اهو ضروري ناهي ته هڪ رڪارڊر ڪلاس جو طريقو سڌو سنئون. سڀئي ڪم مڪمل طور تي ڪئميرا ڪلاس جي طريقن سان ڍڪيل آهن.