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. Камертай харилцах, зураг боловсруулахад зориулагдсан бүх хуваалцсан сангууд багтсан болно.
- Ашиглахад хялбар камерын ангилал
- Хүчирхэг 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= параметртэй Camera объектыг үүсгэнэ үү.
Дибаг хийх түвшинг дараах утгуудын аль нэгэнд тохируулж болно.
- 'off' Бүх гаралтыг идэвхгүй болгоно.
- 'error' Зөвхөн алдааны мэдэгдлийг харуулдаг.
- 'дэлгэрэнгүй' Бүх мессежийг харуулна.
- 'нэмэлт дэлгэрэнгүй' Бүх мессеж, утгыг харуулна.
Анхдагч дибаг хийх түвшин нь "унтраах" байна.
pco.Camera(debuglevel='дэлгэрэнгүй')
…
[][sdk] камерын_төрөл: OK.
Сонголт хийх хугацааamp= параметр идэвхжүүлнэ a tag хэвлэсэн гаралтад. Боломжит утгууд нь: 'on' and 'off'. Өгөгдмөл утга нь 'off' байна.
pco.Camera(debuglevel='дэлгэрэнгүй', цаг хугацааamp='on')
…
[2019-11-25 15:54:15.317855 / 0.016 сек] [][sdk] камерын_төрөл: OK.
API баримтжуулалт
pco.Camera анги нь дараах аргуудыг санал болгодог.
- record() нь шинэ бичигчийн жишээг үүсгэж, тохируулж, эхлүүлдэг.
- stop() нь одоогийн бичлэгийг зогсооно.
- close() нь одоогийн идэвхтэй камерыг хааж, эзлэгдсэн нөөцийг чөлөөлдөг.
- image() нь бичигчээс numpy массив хэлбэрээр дүрсийг буцаана.
- images() нь бичигчээс бичигдсэн бүх зургийг 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 Бичлэг хийх
Тодорхойлолт Шинэ бичлэгийн инстанц үүсгэж, тохируулж, эхлүүлнэ. Record() руу залгахаас өмнө камерын тохиргоог бүхэлд нь тохируулах ёстой. set_exposure_time() команд нь цорын ганц үл хамаарах зүйл юм. Энэ функц нь бичлэгийн объектод ямар ч нөлөө үзүүлэхгүй бөгөөд бичлэг хийх явцад дуудаж болно.
Прототип def бичлэг(өөрөө, зургийн_тоо=1, горим='дараалал'):
Параметр
| Нэр | Тодорхойлолт |
| зургийн_тоо | Драйверт хуваарилагдсан зургийн тоог тохируулна. Компьютерийн RAM нь хамгийн их утгыг хязгаарладаг. |
| горим | "Дараалсан" горимд энэ функц бичлэг хийх явцад хаагдана. Зургийн_тоо хүрэхэд бичигч автоматаар зогсдог. "Блоклохгүй дараалал" горимд энэ функц блоклохгүй. Зургийг уншихаас өмнө статусыг шалгах ёстой. Энэ горимыг бичлэг хийх явцад зураг уншихад ашигладаг, жишээ нь өнгөц зураг. "Бөгж буфер" горимд энэ функцийг хориглодоггүй. Зургийг уншихаас өмнө статусыг шалгах ёстой. Зургийн_тоо хүрэх үед бичигч бичлэгийг зогсоодоггүй. Нэгэнт ийм зүйл тохиолдвол хамгийн эртний зургуудыг дарж бичнэ. 'fifo' горимд энэ функцийг хориглодоггүй. Зургийг уншихаас өмнө статусыг шалгах ёстой. Fifo дахь зургийн_тоо хүрэхэд дараах зургуудыг fifo-ээс унших хүртэл буулгана. |
2.1.2 Зогс
Тодорхойлолт Одоогийн бичлэгийг зогсооно. 'Ring buffer' болон 'fifo' горимд энэ функцийг хэрэглэгч дуудах ёстой. "Дараалга" ба "дараалалгүй блоклох" горимд зургийн_тоо хүрэх үед энэ функц автоматаар дуудагдана.
Прототип Def stop(өөрөө):
2.1.3 Хаах
Тодорхойлолт Идэвхжүүлсэн камерыг хааж, хаагдсан нөөцийг чөлөөлнө. Энэ функцийг програмыг зогсоохоос өмнө дуудах ёстой. Үгүй бол нөөц нь эзлэгдсэн хэвээр үлдэнэ.
Прототип def close(өөрөө):
Камерын объектыг with хэллэгээр үүсгэсэн тохиолдолд энэ функц автоматаар дуудагдана. Хаах() гэсэн тодорхой дуудлага шаардлагагүй болсон.
pco.Camera()-г cam хэлбэрээр ашиглан: # зарим зүйл хий
2.1.4 Зураг
Тодорхойлолт Дуу хураагчаас зургийг буцаана. Зургийн төрөл нь numpy.ndarray юм. Энэ массив нь зургийн нягтрал болон ROI зэргээс хамаарч хэлбэртэй байна.
Прототип def зураг(өөрийгөө, зургийн_тоо=0, roi=байхгүй):
Параметр
| Нэр | Тодорхойлолт |
| зургийн_тоо | Унших зургийн дугаарыг зааж өгнө. "Дараалга" эсвэл "дараалалгүй блоклох" горимд бичигчийн индекс нь зургийн_тоотой таарч байна. Хэрэв зургийн_тоог 0xFFFFFFFF гэж тохируулсан бол хамгийн сүүлд бичигдсэн зургийг хуулна. Энэ нь амьд урьдчилан үүсгэх боломжийг олгодогview бичлэг хийх үед. |
| roi | Сонирхсон бүс нутгийг тохируулна. Зөвхөн зургийн энэ хэсгийг буцаах утга руу хуулна. |
Example >>> cam.record(зургийн_тоо=1, горим='дараалал')
>>> зураг, мета = cam.image()
>>> төрөл(зураг) numpy.ndarray
>>> зураг.хэлбэр (2160, 2560)
>>> зураг, мета өгөгдөл = cam.image(roi=(1, 1, 300, 300))
>>> зураг.хэлбэр (300, 300)
2.1.5 Зураг
Тодорхойлолт Бичигчээс бүх бүртгэгдсэн зургийг тоон массивуудын жагсаалт болгон буцаана.
Прототип def images(self, roi=байхгүй, blocksize=байхгүй):
Параметр
| Нэр | Тодорхойлолт |
| roi | Сонирхсон бүс нутгийг тохируулна. Зөвхөн зургийн энэ хэсгийг буцаах утга руу хуулна. |
| блок хэмжээ | Буцах зургийн дээд хэмжээг тодорхойлно. Энэ параметр нь зөвхөн "fifo" горимд, онцгой нөхцөлд л хэрэгтэй. |
Example >>> cam.record(зургийн_тоо=20, горим='дараалал')
>>> зураг, мета өгөгдөл = cam.images()
>>> len(зураг) 20
>>> зураг дээрх зургийн хувьд:
…
хэвлэх('Дунд: {:7.2f} DN'.формат(зураг. утга()))
…
Дундаж: 2147.64 DN
Дундаж: 2144.61 DN
…
>>> зураг = cam.images(roi=(1, 1, 300, 300))
>>> зураг[0].хэлбэр (300, 300)
2.1.6 Зургийн_дундаж
Тодорхойлолт Дундаж авсан зургийг буцаана. Энэ зургийг буферт бүртгэгдсэн бүх зургаас тооцно.
Прототип def image_average(self, roi=Байхгүй):
Параметр
| Нэр | Тодорхойлолт |
| roi | Сонирхсон бүс нутгийг тодорхойлдог. Зөвхөн зургийн энэ хэсгийг буцаах утга руу хуулна. |
Example >>> cam.record(зургийн_тоо=100, горим='дараалал')
>>> дундаж = cam.image_average()
>>> дундаж = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Өртөх_хугацааг тохируулах
Тодорхойлолт Камерын өртөх хугацааг тохируулна.
Прототип def тогтоосон_ өртөх_хугацаа(өөртөө, өртөх_хугацаа):
Параметр
| Нэр | Тодорхойлолт |
| халдвар авах хугацаа | 'Second' нэгжид хөвөх буюу бүхэл тоогоор өгөгдсөн байх ёстой. sdk.set_delay_exposure_time(0, 'ms', time, timebase) функцийн үндсэн утгуудыг автоматаар тооцох болно. Саатуулах хугацааг 0 болгож тохируулсан. |
Example >>> камер.тогтоосон_өрчлөх_цаг (0.001)
>>> cam.тогтоосон_өрчлөх_цаг (1e-3)
2.1.8 Эхний зургийг хүлээнэ үү
Тодорхойлолт Дуу хураагчийн санах ойд байгаа анхны зургийг хүлээнэ. Бичлэгийн горимд "хаалтгүй дараалал", "цагираг буфер". болон 'fifo' бол бичлэг() функц нэн даруй буцаж ирнэ. Тиймээс энэ функцийг image(), images(), эсвэл image_average() гэж дуудахаас өмнө камераас авсан зургийг хүлээхэд ашиглаж болно.
Прототип def эхний_зургийг_хүлээх(өөрийгөө):
2.2 Хувьсагчийн тохиргоо
Камерын параметрүүдийг тохиргооны хувьсагчийг өөрчилснөөр шинэчлэгддэг.
cam.configuration = {'өртөх хугацаа': 10e-3,
'roi': (1, 1, 512, 512),
'хамгийн их цагamp': 'ascii',
'пикселийн хурд': 100_000_000,
'триггер': 'автомат дараалал',
'acquire': 'авто',
'мета өгөгдөл': 'on',
'binning': (1, 1)}
Хувьсагчийг зөвхөн record() функц дуудагдахаас өмнө өөрчлөх боломжтой. Энэ нь тодорхой тооны оруулгатай толь бичиг юм. Бүх боломжит элементүүдийг зааж өгөх шаардлагагүй. Дараахь с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 Дуу хураагуур
Объект rec нь бүх үндсэн функцүүдэд шууд хандах боломжийг олгодог pco.recorder. Бичигч ангийн аргыг шууд дуудах шаардлагагүй. Камерын ангийн аргуудад бүх функцууд бүрэн хамрагдсан.
https://www.pco.de/applications/
| pco Европ +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 Python програм хангамж хөгжүүлэх хэрэгсэл [pdf] Хэрэглэгчийн гарын авлага Python програм хангамж хөгжүүлэх хэрэгсэл, програм хангамж хөгжүүлэх хэрэгсэл, хөгжүүлэлтийн хэрэгсэл, хэрэгсэл |
