EXCELITAS ټیکنالوژي د پایتون سافټویر پرمختیا کټ کارونکي لارښود

د پایتون سافټویر پرمختیا کټ
د کارن لارښود

منځپانګې پټول

1 د پایتون سافټویر پرمختیا کټ

د پایتون سافټویر پرمختیا کټ

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 International License لاندې جواز لري. ته view د دې جواز یوه کاپي، لیدنه وکړئ http://creativecommons.org/licenses/by-nd/4.0/ یا کریټیو کامنز ته یو لیک واستوئ، PO بکس 1866، ماونټین View، CA 94042، USA.

جنرال

د Python کڅوړه pco د pco کیمرې سره کار کولو لپاره ټولې دندې وړاندیز کوي چې د اوسني پراساس دي pco.sdk. د کیمرې سره د اړیکو لپاره ټول شریک شوي کتابتونونه او ورپسې د عکس پروسس کول شامل دي.

د کیمرې ټولګي کارول اسانه دي
ځواکمن API ته pco.sdk
د انځور ثبتول او پروسس کول pco.recorder

1.1 نصب کول
د pypi څخه نصب کړئ (سپارښتنه):
$ pip install pco
1.2 بنسټیز کارول
matplotlib.pyplot د plt په توګه وارد کړئ
pco وارد کړئ
د pco.Camera() سره د کامرې په توګه:
cam.record()
انځور، میټا = cam.image()
plt.imshow(انځور، cmap='خړ')
plt.show()1.3 د پیښې او خطا ننوتل
د ننوتلو محصول فعالولو لپاره، د کیمرې څیز د debuglevel= پیرامیټر سره جوړ کړئ.
د ډیبګ کچه د لاندې ارزښتونو څخه یوه ته ټاکل کیدی شي:

'بند' ټول محصول غیر فعالوي.
'غلطي' یوازې د خطا پیغامونه ښیې.
'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() د ریکارډر څخه یو انځور د numpy صف په توګه بیرته راګرځوي.
images() د ریکارډر څخه ټول ثبت شوي عکسونه د numpy صفونو لیست په توګه بیرته راګرځوي.

image_average() منځنی انځور راګرځوي. دا انځور په بفر کې د ټولو ثبت شویو انځورونو څخه حساب شوی.
set_exposure_time() د کیمرې لپاره د افشا کولو وخت ټاکي.
wait_for_first_image() په ریکارډر حافظه کې د لومړي موجود عکس لپاره انتظار کوي.

د pco.Camera ټولګي لاندې متغیر لري:

ترتیب

د pco.Camera ټولګي لاندې توکي لري:

sdk د ټولو اصلي دندو ته مستقیم لاسرسی وړاندیز کوي pco.sdk.
ریکارډر د ټولو اصلي دندو ته مستقیم لاسرسی وړاندیز کوي pco.recorder.

۲.۱ طریقې
دا برخه د pco.Camera ټولګي لخوا وړاندیز شوي ټول میتودونه بیانوي.
2.1.1 ریکارډ
تفصیل د نوي ریکارډر مثال رامینځته کوي ، تنظیموي او پیل کوي. د کیمرې ټول ترتیب باید د زنګ وهلو دمخه تنظیم شي (). د set_exposure_time() کمانډ یوازینی استثنا ده. دا فنکشن د ریکارډر څیز باندې هیڅ اغیزه نلري او د ثبت کولو پرمهال غږ کیدی شي.
پروټوټایپ def ریکارډ
پیرامیټر

نوم	تفصیل
د_عکسونو شمیر	په ډرایور کې د تخصیص شوي عکسونو شمیر ټاکي. د کمپیوټر RAM اعظمي ارزښت محدودوي.
حالت	په 'ترتیب' حالت کې، دا فعالیت د ریکارډ په جریان کې بندیږي. ریکارډر په اوتومات ډول ودریږي کله چې شمیر_of_images ته ورسیږي. په 'لاریون غیر بلاکینګ' حالت کې، دا فنکشن غیر بلاکینګ دی. وضعیت باید د عکس لوستلو دمخه وڅیړل شي. دا حالت د ثبت کولو پرمهال د عکسونو لوستلو لپاره کارول کیږي ، د بیلګې په توګه تمبیل. په 'رینګ بفر' حالت کې دا فنکشن غیر بلاک دی. وضعیت باید د عکس لوستلو دمخه وڅیړل شي. ریکارډر د ثبت کولو مخه نه نیسي کله چې د عکسونو شمیر ته ورسیږي. یوځل چې دا پیښ شي ، زاړه عکسونه له سره لیکل کیږي. په 'فیفو' حالت کې، دا فعالیت غیر بلاک دی. وضعیت باید د عکس لوستلو دمخه وڅیړل شي. کله چې په فیفو کې د انځورونو شمیره پای ته ورسیږي، لاندې انځورونه د فیفو څخه د لوستلو تر وخته پورې ښکته کیږي.

2.1.2 ودروئ
تفصیل اوسنی ثبت کول ودروي. په 'رینګ بفر' او 'فیفو' حالت کې، دا فنکشن باید د کارونکي لخوا وغوښتل شي. په 'ترتیب' او 'لاریون غیر بلاک کولو' حالت کې، دا فنکشن په اوتومات ډول ویل کیږي کله چې شمیر_of_images ته ورسیږي.
پروټوټایپ def stop(ځان):
2.1.3 تړل
تفصیل فعاله کیمره بندوي او بلاک شوي سرچینې خوشې کوي. دا فنکشن باید مخکې له دې چې غوښتنلیک پای ته ورسیږي زنګ ووهل شي. که نه نو، سرچینې نیول کیږي.
پروټوټایپ def بند (ځان):
دا فنکشن په اتوماتيک ډول ویل کیږي که چیرې د کیمرې څیز د بیان سره رامینځته شوی وي. د بندولو لپاره واضح زنګ () نور اړین ندي.
د pco.Camera() سره د کامرې په توګه: # یو څه شیان وکړئ
2.1.4 انځور
تفصیل د ریکارډر څخه یو عکس بیرته راګرځوي. د انځور ډول یو numpy.ndarray دی. دا صف د عکس ریزولوشن او ROI پورې اړه لري.
پروټوټایپ def انځور (ځان، د انځور_ شمیره = 0، roi = هیڅ نه):
پیرامیټر

نوم	تفصیل
د انځور_شمېره	د لوستلو لپاره د عکس شمیر مشخص کوي. په 'ترتیب' یا 'لاریون غیر بلاکینګ' حالت کې، د ریکارډر شاخص د عکس نمبر سره سمون لري. که د عکس نمبر 0xFFFFFFFF ته ټاکل شوی وي، وروستی ثبت شوی انځور کاپي شوی. دا تاسو ته اجازه درکوي چې یو ژوندی پری جوړ کړئview د ثبتولو پرمهال.
roi	د علاقې وړ سیمه ټاکي. د عکس یوازې دا سیمه د بیرته ستنیدو ارزښت ته کاپي شوې.

Example >>> cam.record(number_of_images=1, mode='sequence')
>>> انځور، میټا = cam.image()
>>> ډول(انځور) numpy.ndarray
>>> image.shape (2160, 2560)
>>> انځور، میټاډاټا = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 انځورونه
تفصیل له ریکارډر څخه ټول ثبت شوي عکسونه د نمپسي صفونو لیست په توګه بیرته راګرځوي.
پروټوټایپ def انځورونه (ځان، roi = هیڅ نه، د بلاکسیز = هیڅ نه):
پیرامیټر

نوم	تفصیل
roi	د علاقې وړ سیمه ټاکي. د عکس یوازې دا سیمه د بیرته ستنیدو ارزښت ته کاپي شوې.
د بلاک اندازه	د عکسونو اعظمي شمیر تعریفوي چې بیرته راستانه شوي. دا پیرامیټر یوازې په 'فیفو' حالت کې او د ځانګړو شرایطو لاندې ګټور دی.

Example >>> cam.record(number_of_images=20, mode='sequence')
>>> انځورونه، میټاډاټا = 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 (ځان، roi = هیڅ نه):
پیرامیټر

نوم	تفصیل
roi	د علاقې وړ سیمه تعریفوي. د عکس یوازې دا سیمه د بیرته ستنیدو ارزښت ته کاپي شوې.

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
تفصیل د کیمرې د افشا کولو وخت ټاکي.
پروټوټایپ def 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'، د فعالیت ریکارډ() سمدلاسه بیرته راګرځي. له همدې امله ، دا فنکشن د عکس () ، عکسونو () ، یا image_average () زنګ وهلو دمخه د کیمرې څخه عکسونو ته انتظار کولو لپاره کارول کیدی شي.
پروټوټایپ def wait_for_first_image(ځان):
2.2 متغیر ترتیب
د کیمرې پیرامیټونه د ترتیب متغیر بدلولو سره تازه کیږي.
cam.configuration = {'د ښکاره کولو وخت': 10e-3,
'روی': (۱، ۱، ۵۱۲، ۵۱۲)
وختamp': 'ascii',
د پکسل نرخ: 100_000_000,
'trigger': 'خودکار ترتیب',
'acquire': 'خودکار',
'metadata': 'پر',
'بننګ': (1، 1)}
متغیر یوازې د ریکارډ () فنکشن ویل کیدو دمخه بدلیدلی شي. دا یو قاموس دی چې د یو ټاکلي شمیر ننوتلو سره. ټول ممکنه عناصر باید مشخص نه شي. لاندې sample کوډ یوازې د 'پکسل نرخ' بدلوي او د ترتیب نور عناصر اغیزه نه کوي.
د 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 ریکارډر
اعتراض rec د ټولو اصلي دندو ته مستقیم لاسرسی وړاندیز کوي pco.recorder. دا اړینه نده چې مستقیم د ریکارډر ټولګي میتود ته زنګ ووهئ. ټولې دندې په بشپړ ډول د کیمرې ټولګي میتودونو لخوا پوښل شوي.