Python Software Development Kit
User Manual
Python Software Development Kit
PCO сизден бул документтеги нускамаларды кунт коюп окуп чыгууну суранат.
Бардык суроолор же комментарийлер үчүн, каалаган убакта биз менен байланышуудан тартынба.
телефон: +49 (0) 9441 2005 50
факс: +49 (0) 9441 2005 20
почта дареги: Excelitas PCO GmbH Donaupark 11 93309 Келхайм, Германия
электрондук почта: info@pco.de
web: www.pco.de
pco.python колдонуучу колдонмосу 0.1.7
2021-жылдын декабрында чыгарылган
©Copyright 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 агымга негизделген PC камералары менен иштөө үчүн бардык функцияларды сунуштайт pco.sdk. Камера менен байланышуу жана андан кийинки сүрөттөрдү иштетүү үчүн бардык жалпы китепканалар камтылган.
- Камера классын колдонуу оңой
- Күчтүү API үчүн pco.sdk
- Сүрөттү жаздыруу жана иштетүү pco.recorder
1.1 Орнотуу
pypiден орнотуу (сунушталат):
$ pip орнотуу pco
1.2 Негизги колдонуу
matplotlib.pyplot файлын plt катары импорттоо
импорт PC
pco.Camera() менен камера катары:
cam.record()
сүрөт, мета = cam.image()
plt.imshow(сүрөт, cmap='боз')
plt.show()
1.3 Окуяларды жана каталарды каттоо
Каттоо чыгарууну активдештирүү үчүн, debuglevel= параметри менен Камера объектисин түзүңүз.
Мүчүлүштүктөрдү оңдоо деңгээли төмөнкү маанилердин бирине коюлушу мүмкүн:
- 'off' Бардык чыгарууну өчүрөт.
- 'ката' Ката билдирүүлөрүн гана көрсөтөт.
- 'verbose' Бардык билдирүүлөрдү көрсөтөт.
- 'Extra Verbose' Бардык билдирүүлөрдү жана баалуулуктарды көрсөтөт.
Демейки мүчүлүштүктөрдү оңдоо деңгээли "өчүрүү".
pco.Camera(debuglevel='толук')
…
[][sdk] get_camera_type: макул.
Кошумча убакытamp= параметр активдештирет a tag басып чыгарууда. Мүмкүн болгон маанилер: 'on' жана 'off'. Демейки маани "өчүрүү" болуп саналат.
pco.Camera(debuglevel='толук', убакытamp='он')
…
[2019-11-25 15:54:15.317855 / 0.016 с] [][sdk] get_camera_type: OK.
API документациясы
pco.Camera классы төмөнкү ыкмаларды сунуш кылат:
- record() жаңы жазгыч инстанциясын түзөт, конфигурациялайт жана баштайт.
- stop() учурдагы жазууну токтотот.
- close() учурдагы активдүү камераны жаап, ээлеген ресурстарды бошотот.
- image() жазгычтан сүрөттү numpy массив катары кайтарат.
- 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 Жазуу
Description Жаңы жазгыч инстанциясын түзөт, конфигурациялайт жана баштайт. Record() чалуудан мурун бүт камера конфигурациясын орнотуу керек. set_exposure_time() буйругу бир гана өзгөчөлүк болуп саналат. Бул функция жазгыч объектиге эч кандай таасир этпейт жана аны жаздыруу учурунда чакырса болот.
Прототип def рекорд (өзү, сүрөттөрдүн_саны = 1, режим = 'ырааттуулук'):
Параметр
| аты | Description |
| сүрөттөрдүн_саны | Драйверде бөлүнгөн сүрөттөрдүн санын белгилейт. ЖКнын оперативдик эс тутуму максималдуу маанини чектейт. |
| режими | "Издик" режиминде бул функция жазуу учурунда бөгөттөлөт. Сүрөттөрдүн_санына жеткенде жазгыч автоматтык түрдө токтойт. "Бөгөттөлбөйт" режиминде бул функция бөгөттөлбөйт. Сүрөттү окуудан мурун абалды текшерүү керек. Бул режим жазуу учурунда сүрөттөрдү окуу үчүн колдонулат, мисалы, эскиз. "шакек буфер" режиминде бул функция бөгөттөлбөйт. Сүрөттү окуудан мурун абалды текшерүү керек. Диктофон сүрөттүн_санына жеткенде жазууну токтотпойт. Бул болгондон кийин, эң эски сүрөттөрдүн үстүнө жазылат. "fifo" режиминде бул функция бөгөттөлбөйт. Сүрөттү окуудан мурун абалды текшерүү керек. Fifoдогу сүрөттөрдүн_санына жеткенде, төмөнкү сүрөттөр fifoдон сүрөттөр окулганга чейин түшүрүлөт. |
2.1.2 Токто
Description Учурдагы жазууну токтотот. 'Ring buffer' жана 'fifo' режиминде бул функцияны колдонуучу чакырышы керек. 'Sequence' жана 'sequence non blocking' режиминде, бул функция сүрөттөрдүн_санына жеткенде автоматтык түрдө чакырылат.
Прототип Def stop(self):
2.1.3 Жабуу
Description Жандырылган камераны жаап, бөгөттөлгөн ресурстарды бошотот. Бул функция колдонмо токтотулганга чейин чакырылышы керек. Болбосо, ресурстар ээлеп кала берет.
Прототип def close(self):
Камера объектиси with оператору тарабынан түзүлсө, бул функция автоматтык түрдө чакырылат. Close() үчүн ачык чакыруу мындан ары зарыл эмес.
pco.Camera() менен cam катары: # кээ бир нерселерди жасаңыз
2.1.4 Сүрөт
Description Жазгычтан сүрөттү кайтарат. Сүрөттүн түрү numpy.ndarray болуп саналат. Бул массив сүрөттүн чечилишине жана ROIине жараша калыптанат.
Прототип def сүрөтү(өзү, сүрөт_саны = 0, roi = Эч бири):
Параметр
| аты | Description |
| сүрөт_саны | Окула турган сүрөттүн санын белгилейт. 'Sequence' же 'Sequence non blocking' режиминде жазгыч индекси image_number менен дал келет. Эгерде image_number 0xFFFFFFFF деп коюлса, акыркы жазылган сүрөт көчүрүлөт. Бул жандуу алдын ала түзүүгө мүмкүндүк беретview жазып жатканда. |
| roi | Кызыккан аймакты белгилейт. Кайтаруучу мааниге сүрөттүн бул аймагы гана көчүрүлөт. |
Example >>> cam.record(сүрөттөрдүн_саны=1, режим='ырааттуулук')
>>> сүрөт, мета = cam.image()
>>> type(сүрөт) numpy.ndarray
>>> image.shape (2160, 2560)
>>> сүрөт, метадайындар = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 XNUMX сүрөттөр
Description Жазгычтан бардык жазылган сүрөттөрдү сансыз массивдердин тизмеси катары кайтарат.
Прототип def images(өзүнчө, roi=Жок, blocksize=Жок):
Параметр
| аты | Description |
| roi | Кызыккан аймакты белгилейт. Кайтаруучу мааниге сүрөттүн бул аймагы гана көчүрүлөт. |
| блок өлчөмү | Кайтарылган сүрөттөрдүн максималдуу санын аныктайт. Бул параметр "fifo" режиминде жана өзгөчө шарттарда гана пайдалуу. |
Example >>> cam.record(сүрөттөрдүн_саны=20, режим='ырааттуулук')
>>> сүрөттөр, метадайындар = cam.images()
>>> len(сүрөттөр) 20
>>> сүрөттөрдөгү сүрөт үчүн:
…
print('Орточо: {:7.2f} DN'.format(сүрөт. мааниси()))
…
Орточо: 2147.64 DN
Орточо: 2144.61 DN
…
>>> сүрөттөр = cam.images(roi=(1, 1, 300, 300))
>>> сүрөттөр[0].форма (300, 300)
2.1.6 Сүрөт_орточо
Description Орточо алынган сүрөттү кайтарат. Бул сүрөт буфердеги бардык жазылган сүрөттөрдөн эсептелет.
Прототип def image_average(self, roi=Эч бири):
Параметр
| аты | Description |
| roi | Кызыккан аймакты аныктайт. Кайтаруучу мааниге сүрөттүн бул аймагы гана көчүрүлөт. |
Example >>> cam.record(сүрөттөрдүн_саны=100, режим='ырааттуулук')
>>> ort = cam.image_average()
>>> ort = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Экспозициянын_убакытын коюу
Description Камеранын экспозиция убактысын орнотот.
Прототип def set_exposure_time(өзү, экспозиция_убакыты):
Параметр
| аты | Description |
| таасир этүү убактысы | "Секунд" бирдигинде калкыма же бүтүн сан катары берилиши керек. sdk.set_delay_exposure_time(0, 'ms', убакыт, убакыт базасы) функциясынын негизги маанилери автоматтык түрдө эсептелинет. Кечигүү убактысы 0гө коюлган. |
Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Биринчи_сүрөттү_күтүү
Description Жазгычтын эстутумунда биринчи жеткиликтүү сүрөттү күтөт. Жазгыч режиминде "ырааттуулук бөгөттөлбөйт", "шакек буфери". жана 'fifo' болсо, record() функциясы дароо кайтып келет. Ошондуктан, бул функцияны image(), images() же image_average() чакырганга чейин камерадан сүрөттөрдү күтүү үчүн колдонсо болот.
Прототип Def wait_for_first_image(self):
2.2 Variable Configuration
Камера параметрлери конфигурация өзгөрмөсүн өзгөртүү менен жаңыртылып турат.
cam.configuration = {'экспозиция убактысы': 10e-3,
'roi': (1, 1, 512, 512),
'timeestamp': 'ascii',
'пиксел ылдамдыгы': 100_000_000,
'триггер': 'автоматтык ырааттуулук',
'acquire': 'auto',
'металымат': 'күйгүзүлгөн',
'binning': (1, 1)}
Өзгөрмөлөрдү record() функциясы чакырылганга чейин гана өзгөртүүгө болот. Бул белгилүү бир сандагы жазуулардан турган сөздүк. Мүмкүн болгон бардык элементтерди көрсөтүү зарыл эмес. Төмөнкү сample коду "пиксел ылдамдыгын" гана өзгөртөт жана конфигурациянын башка элементтерине таасир этпейт.
pco.Camera() менен камера катары:
cam.configuration = {'пиксел ылдамдыгы': 286_000_000}
cam.record()
…
2.3 XNUMX объект
Бул бөлүм 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 Europe +49 9441 2005 50 info@pco.de pco.de |
pco america +1 866 678 4566 info@pco-tech.com pco-tech.com |
пко Азия +65 6549 7054 info@pco-imaging.com pco-imaging.com |
pco кытай +86 512 67634643 info@pco.cn pco.cn |
Документтер / Ресурстар
 |
EXCELITAS TECHNOLOGIES Python Software Development Kit [pdf] Колдонуучунун колдонмосу Python программалык камсыздоону иштеп чыгуу комплекти, программалык камсыздоону иштеп чыгуу комплекти, иштеп чыгуу комплекти, комплект |
