Ikhithi Yokuthuthukisa Isoftware yePython
Imaniwali yosebenzisayo
Ikhithi Yokuthuthukisa Isoftware yePython
I-PCO ikucela ukuthi ufunde ngokucophelela futhi ulandele imiyalo kulo mbhalo.
Uma unemibuzo noma ukuphawula, sicela ukhululeke ukuxhumana nathi nganoma yisiphi isikhathi.
ngocingo: +49 (0) 9441 2005 50
ifeksi: +49 (0) 9441 2005 20
ikheli leposi: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germany
i-imeyili: info@pco.de
web: www.pco.de
pco.python user manual 0.1.7
Ikhishwe ngo-December 2021
©Copyright Excelitas PCO GmbH
Lo msebenzi unikezwe ilayisense ngaphansi kwe-Creative Commons Attribution-No Derivatives 4.0 International License. Kuya view ikhophi yale layisensi, vakashela http://creativecommons.org/licenses/by-nd/4.0/ noma uthumele incwadi ku-Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
Okujwayelekile
Iphakethe le-Python pco linikeza yonke imisebenzi yokusebenza namakhamera we-pco asekelwe okwamanje pco.sdk. Wonke amalabhulali okwabelwana ngawo okuxhumana nekhamera kanye nokucutshungulwa kwesithombe okulandelayo kufakiwe.
- Kulula ukusebenzisa ikilasi lekhamera
- Powerful API to pco.sdk
- Ukuqoshwa kwesithombe nokucubungula nge pco.rekhoda
1.1 Ukufakwa
Faka ku-pypi (kunconyiwe):
$ pip faka i-pco
1.2 Ukusetshenziswa Okuyisisekelo
ngenisa i-matplotlib.pyplot njenge-plt
ngenisa pco
nge-pco.Ikhamera() njengekhamera:
i-cam.record()
isithombe, imeta = cam.image()
plt.imshow(isithombe, cmap='grey')
i-plt.show()
1.3 Umcimbi kanye Nephutha Lokungena
Ukuze wenze kusebenze okuphumayo kokungena, dala into Yekhamera ngepharamitha ye-debuglevel=.
Izinga lokususa iphutha lingasethwa libe yinye yamanani alandelayo:
- 'cisha' Ikhubaza konke okukhiphayo.
- 'iphutha' Ibonisa imilayezo yamaphutha kuphela.
- 'verbose' Ibonisa yonke imilayezo.
- 'i-verbose eyengeziwe' Ibonisa yonke imilayezo namanani.
I-debuglevel ezenzakalelayo 'ivaliwe'.
pco.Ikhamera(debuglevel='verbose')
…
[][sdk] get_camera_type: Kulungile.
Isikhathi ongasikhethaamp= ipharamitha iyasebenza a tag kokuphumayo okuphrintiwe. Amanani angenzeka yilawa: 'vula' futhi 'cisha'. Inani elizenzakalelayo 'livaliwe'.
pco.Ikhamera(debuglevel='verbose', timestamp='ku')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: Kulungile.
API Documentation
Ikilasi le-pco.Camera linikeza izindlela ezilandelayo:
- record() ikhiqiza, ilungise, futhi iqale isenzakalo esisha sokuqopha.
- stop() imisa ukurekhoda kwamanje.
- close() ivala ikhamera esebenzayo yamanje futhi ikhiphe izinsiza ezisetshenzisiwe.
- image() ibuyisela isithombe esivela kusirekhoda njengohlelo oluncane.
- images() ibuyisela zonke izithombe ezirekhodiwe kusuka kusirekhodi njengohlu lwamalungu afanayo angama-numpy.
- image_average() ibuyisela isithombe esimaphakathi. Lesi sithombe sibalwa kuzo zonke izithombe ezirekhodiwe kubhafa.
- set_exposure_time() isetha isikhathi sokuchayeka sekhamera.
- wait_for_first_image() ilinda isithombe sokuqala esitholakalayo kumemori yesirekhodi.
Isigaba se-pco.Camera sinokuhlukahluka okulandelayo:
- ukumisa
Isigaba se-pco.Camera sinezinto ezilandelayo:
- I-sdk inikeza ukufinyelela okuqondile kuyo yonke imisebenzi eyisisekelo ye- pco.sdk.
- irekhoda inikeza ukufinyelela okuqondile kuyo yonke imisebenzi eyisisekelo ye pco.rekhoda.
2.1 Izindlela
Lesi sigaba sichaza zonke izindlela ezinikezwa iklasi le-pco.Camera.
2.1.1 Irekhodi
Incazelo Idala, ilungiselele, futhi iqale isenzakalo esisha sokurekhoda. Konke ukucushwa kwekhamera kufanele kusethwe ngaphambi kokushaya irekhodi(). Umyalo we-set_exposure_time() uwukuphela kwento ehlukile. Lo msebenzi awunamthelela entweni yokurekhoda futhi ungabizwa ngesikhathi sokurekhoda.
I-Prototype def record(self, number_of_images=1, mode='sequence'):
Ipharamitha
| Igama | Incazelo |
| inombolo_yezithombe | Isetha inombolo yezithombe ezinikezwe umshayeli. I-RAM ye-PC ikhawulela inani eliphezulu. |
| imodi | Kumodi 'yokulandelana', lo msebenzi uyavimba ngesikhathi sokurekhoda. Irekhoda iyama ngokuzenzakalelayo lapho inombolo_yezithombe ifinyelelwa. Kumodi 'yokulandelana okungavimbeli', lo msebenzi awuvimbeli. Isimo kufanele sihlolwe ngaphambi kokufunda isithombe. Le modi isetshenziselwa ukufunda izithombe ngenkathi urekhodwa, isb isithonjana. Kumodi 'yebhafa' lo msebenzi awuvimbeli. Isimo kufanele sihlolwe ngaphambi kokufunda isithombe. Isirekhoda asikumisi ukurekhoda lapho inombolo_yezithombe_zifinyelelwa. Uma lokhu sekwenzekile, izithombe ezindala kakhulu zibhalwa phezu. Kumodi ye-'fifo', lo msebenzi awuvimbeli. Isimo kufanele sihlolwe ngaphambi kokufunda isithombe. Uma inombolo_yezithombe_kwi-fifo ifinyelelwa, izithombe ezilandelayo ziyehliswa kuze kube yilapho izithombe zifundwa ku-fifo. |
2.1.2 Yima
Incazelo Imisa ukurekhoda kwamanje. Kumodi ye-'ring buffer' kanye ne-'fifo', lo msebenzi kufanele ubizwe ngumsebenzisi. Kumodi 'yokulandelana' kanye 'nokulandelana okungavimbeli', lo msebenzi ubizwa ngokuzenzakalelayo lapho inombolo_of_images ifinyelelwa.
I-Prototype def stop(self):
2.1.3 Vala
Incazelo Ivala ikhamera ecushiwe futhi idedele izinsiza ezivinjiwe. Lo msebenzi kumele ubizwe ngaphambi kokuthi isicelo siqedwe. Uma kungenjalo, izinsiza zihlala zisetshenziswa.
I-Prototype def close(self):
Lolu hlelo lubizwa nge-othomathikhi uma into yekhamera yakhiwe ngesitatimende. Ucingo olusobala lokuvala() alusadingeki.
nge-pco.Ikhamera() njengekhamera: # yenza izinto ezithile
2.1.4 Isithombe
Incazelo Ibuyisela isithombe esivela kusirekhoda. Uhlobo lwesithombe luyi-numpy.ndarray. Lawa malungu afanayo alondolozwe kuye ngokulungiswa kanye ne-ROI yesithombe.
I-Prototype def image(uqobo, image_number=0, roi=None):
Ipharamitha
| Igama | Incazelo |
| inombolo_yesithombe | Icacisa inombolo yesithombe okufanele sifundwe. Kumodi 'yokulandelana' noma 'yokulandelana okungavimbeli', inkomba yesirekhodi ifana ne-image_number. Uma image_number isethwe ukuze ithi 0xFFFFFFFF, isithombe sokugcina esirekhodiwe siyakopishwa. Lokhu kuvumela ukudala i-pre bukhomaview ngenkathi uqopha. |
| royi | Isetha indawo onentshisekelo kuyo. Yilesi sifunda sesithombe kuphela esikopishelwe kunani lokubuyisela. |
Example >>> cam.record(inombolo_yezithombe=1, imodi='ukulandelana')
>>> isithombe, imeta = cam.image()
>>> thayipha(isithombe) numpy.ndarray
>>> image.shape (2160, 2560)
>>> isithombe, imethadatha = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 Izithombe
Incazelo Ibuyisela zonke izithombe ezirekhodiwe kusukela kusirekhodi njengohlu lwamalungu afanayo angama-numpy.
I-Prototype def izithombe(self, roi=None, blocksize=None):
Ipharamitha
| Igama | Incazelo |
| royi | Isetha indawo onentshisekelo kuyo. Yilesi sifunda sesithombe kuphela esikopishelwe kunani lokubuyisela. |
| blocksize | Ichaza inani eliphezulu lezithombe ezibuyiswayo. Le parameter iwusizo kuphela kumodi ye-'fifo' nangaphansi kwezimo ezikhethekile. |
Example >>> cam.record(inombolo_yezithombe=20, imodi='ukulandelana')
>>> izithombe, imethadatha = cam.images()
>>> len(izithombe) 20
>>> ngesithombe ezithombeni:
…
phrinta('Okushiwo: {:7.2f} DN'.format(image.mean()))
…
Incazelo: 2147.64 DN
Incazelo: 2144.61 DN
…
>>> izithombe = cam.images(roi=(1, 1, 300, 300))
>>> izithombe[0].shape (300, 300)
2.1.6 Isithombe_isilinganiso
Incazelo Ibuyisela isithombe esimaphakathi. Lesi sithombe sibalwa kuzo zonke izithombe ezirekhodiwe kubhafa.
I-Prototype def image_average(self, roi=None):
Ipharamitha
| Igama | Incazelo |
| royi | Ichaza indawo onentshisekelo kuyo. Yilesi sifunda sesithombe kuphela esikopishelwe kunani lokubuyisela. |
Example >>> cam.record(inombolo_yezithombe=100, imodi='ukulandelana')
>>> isilinganiso = cam.image_average()
>>> isilinganiso = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Setha_isikhathi_sokuchayeka
Incazelo Isetha isikhathi sokuchayeka sekhamera.
I-Prototype def set_exposure_time(self, exposure_time):
Ipharamitha
| Igama | Incazelo |
| isikhathi sokuchayeka | Kufanele inikezwe njenge-float noma inani eliphelele kuyunithi 'yesibili'. Amanani ayisisekelo omsebenzi sdk.set_delay_exposure_time(0, 'ms', isikhathi, isisekelo sesikhathi) azobalwa ngokuzenzakalelayo. Isikhathi sokulibaziseka sisethelwe ku-0. |
Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Linda_isithombe_sokuqala
Incazelo Ilinda isithombe sokuqala esitholakalayo kumemori yokurekhoda. Kumodi yokurekhoda 'landelana ngokungavimbeli', 'ibhafa yokukhala'. futhi 'fifo', irekhodi lomsebenzi () libuya ngokushesha. Ngakho-ke, lo msebenzi ungasetshenziswa ukulinda izithombe ezivela kukhamera ngaphambi kokubiza isithombe(), izithombe(), noma image_average().
I-Prototype def wait_for_first_image(uqobo lwakho):
2.2 Ukucushwa Okuguquguqukayo
Amapharamitha ekhamera abuyekezwa ngokushintsha okuguquguqukayo kokucushwa.
cam.configuration = {'isikhathi sokuchayeka': 10e-3,
'i-roi': (1, 1, 512, 512),
'isikhathiamp': 'ascii',
'isilinganiso se-pixel': 100_000_000,
'trigger': 'ukulandelana okuzenzakalelayo',
'zuza': 'auto',
'imethadatha': 'ivuliwe',
'ukubopha': (1, 1)}
Okuguquguqukayo kungashintshwa kuphela ngaphambi kokuthi kubizwe umsebenzi werekhodi(). Isichazamazwi esinenani elithile lokufakiwe. Akuwona wonke ama-elementi okungenzeka adinga ukucaciswa. Okulandelayo sampI-le code ishintsha kuphela 'izinga le-pixel' futhi ayithinti noma yiziphi ezinye izici zokucushwa.
nge-pco.Ikhamera() njengekhamera:
cam.configuration = {'isilinganiso sephikseli': 286_000_000}
i-cam.record()
…
2.3 Izinto
Lesi sigaba sichaza zonke izinto ezinikezwa iklasi le-pco.Camera.
2.3.1 I-SDK
Into sdk ivumela ukufinyelela okuqondile kuyo yonke imisebenzi eyisisekelo ye pco.sdk.
>>> cam.sdk.get_temperature()
{'izinga lokushisa lenzwa': 7.0, 'izinga lokushisa lekhamera': 38.2, 'izinga lokushisa lamandla': 36.7}
Wonke amanani abuyayo avela kumisebenzi ye-sdk ayizichazamazwi. Akuwona wonke amasethingi ekhamera okwamanje ambozwa ikilasi Lekhamera. Izilungiselelo ezikhethekile kufanele zisethwe ngokuqondile ngokushayela umsebenzi we-sdk ofanele.
2.3.2 Umqophi
I-otho rec inikeza ukufinyelela okuqondile kuyo yonke imisebenzi eyisisekelo ye pco.rekhoda. Akudingekile ukubiza indlela yekilasi lerekhoda ngokuqondile. Yonke imisebenzi imbozwe ngokugcwele izindlela zekilasi Lekhamera.
https://www.pco.de/applications/
| pco e-Europe +49 9441 2005 50 info@pco.de pco.de |
pco america +1 866 678 4566 info@pco-tech.com pco-tech.com |
pco asia +65 6549 7054 info@pco-imaging.com pco-imaging.com |
pco china +86 512 67634643 info@pco.cn pco.cn |
Amadokhumenti / Izinsiza
 |
I-EXCELITAS TECHNOLOGIES Python Software Development Kit [pdf] Imaniwali yosebenzisayo Ikhithi Yokuthuthukisa Isofthiwe ye-Python, Ikhithi Yokuthuthukisa Isofthiwe, Ikhithi Yokuthuthukisa, Ikhithi |
