Ikhithi yoPhuhliso lweSoftware yePython
Incwadi yokusebenzisa

Ikhithi yoPhuhliso lweSoftware yePython

I-PCO ikucela ukuba ufunde ngononophelo kwaye ulandele imiyalelo ekolu xwebhu.
Kuyo nayiphi na imibuzo okanye izimvo, nceda uzive ukhululekile ukuqhagamshelana nathi nangaliphi na ixesha.
umnxeba: +49 (0) 9441 2005 50
ifeksi: +49 (0) 9441 2005 20
idilesi yeposi: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germany
imeyile: info@pco.de
web: www.pco.de
pco.python incwadi yomsebenzisi 0.1.7
Ikhutshwe ngoDisemba 2021
©Copyright Excelitas PCO GmbH
Lo msebenzi unelayisensi phantsi kweCreative Commons Attribution-No Derivatives 4.0 International License. Ukuya view ikopi yale layisensi, ndwendwela http://creativecommons.org/licenses/by-nd/4.0/ okanye uthumele ileta kuCreative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Ngokubanzi

Iphakheji yePython pco inika yonke imisebenzi yokusebenza kunye neekhamera ze-pco ezisekelwe ngoku pco.sdk. Zonke iilayibrari ezabelwana ngazo zonxibelelwano kunye nekhamera kunye nokulungiswa komfanekiso olandelayo zibandakanyiwe.

• Kulula ukusebenzisa iklasi yekhamera
• Inamandla API ukuba pco.sdk
• Ukurekhodwa komfanekiso kunye nokusebenza nge pco.rekhoda

1.1 Ufakelo
Faka kwipypi (kuyacetyiswa):
$ pip ufake pco
1.2 Usetyenziso olusisiseko
ngenisa i-matplotlib.pyplot njenge-plt
ngenisa i-pco
nge pco.Camera() njenge cam:
cam.irekhodi()
umfanekiso, meta = cam.image()
plt.imshow(umfanekiso, cmap='ngwevu')
Plt.bonisa()1.3 Isiganeko kunye neempazamo zokuLogging
Ukuvula isiphumo sokuloga, yenza into yeKhamera nge-debuglevel= parameter.
Umphakamo wokulungisa ingxaki unokumiselwa kwelinye lala maxabiso alandelayo:

• 'cima' Ikhubaza zonke iziphumo.
• 'impazamo' Ibonisa kuphela imiyalezo yemposiso.
• 'verbose' Ubonisa yonke imiyalezo.
• 'i-verbose eyongezelelweyo' Ibonisa yonke imiyalezo kunye namaxabiso.

Inqanaba lolungiso lweempazamo 'licimile'.
pco.Camera(debuglevel='verbose')
…
[][sdk] fumana_uhlobo_lwekhamera: Kulungile.
Amaxesha okhethoamp= iparamitha iyasebenza a tag kwimveliso eprintiweyo. Amaxabiso anokubakho ngala: 'vula' kunye 'nocima'. Ixabiso elimiselweyo lithi 'cimile'.
pco.Ikhamera(debuglevel='verbose', amaxeshaamp='ku')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: Kulungile.

API Documentation

Iklasi ye-pco.Camera ibonelela ngezi ndlela zilandelayo:

• irekhodi () yenza, iqwalasele, kwaye iqale umzekelo omtsha wokurekhoda.
• stop() kumisa ushicilelo lwangoku.
• close() ivala ikhamera esebenzayo yangoku kwaye ikhuphe izixhobo ezisetyenziswayo.
• image() ibuyisela umfanekiso osuka kumshicileli njenge numpy uluhlu.
• imifanekiso () ibuyisela yonke imifanekiso erekhodiweyo kumshicileli njengoluhlu lwamanani angekhoyo.
• image_avareji () ibuyisela umfanekiso ophakathi. Lo mfanekiso ubalwa kuyo yonke imifanekiso erekhodiweyo kwibuffer.
• set_exposure_time() icwangcisa ixesha lokuvezwa kwekhamera.
• wait_for_first_image () ilinda umfanekiso wokuqala okhoyo kwimemori yoshicilelo.

I-pco.Iklasi yekhamera inoluhlu olulandelayo:

• uqwalaselo

Iklasi ye-pco.Camera inezi zinto zilandelayo:

• sdk inika ufikelelo oluthe ngqo kuyo yonke imisebenzi esisiseko ye pco.sdk.
• umshicileli unikezela ukufikelela ngokuthe ngqo kuyo yonke imisebenzi esisiseko ye pco.rekhoda.

2.1 Iindlela
Eli candelo lichaza zonke iindlela ezinikezelwa yiklasi ye-pco.Camera.
2.1.1 Ingxelo
Inkcazo Yenza, iqwalasele, kwaye iqalise umzekelo omtsha wokurekhoda. Lonke ubumbeko lwekhamera kufuneka lusetwe phambi kokufowuna irekhodi (). I-set_exposure_time() umyalelo kuphela kwemeko. Lo msebenzi awunayo impembelelo kwinto yokurekhoda kwaye unokubizwa ngexesha lokurekhoda.
Umzekelo def irekhodi(ukwakho, inani_le_imifanekiso=1, imo='ulandelelwano'):
Ipharamitha

Igama	Inkcazo
inani_lemifanekiso	Icwangcisa inani lemifanekiso eyabelwe umqhubi. I-RAM yePC inciphisa ixabiso eliphezulu.
indlela	Kwimo 'yolandelelwano', lo msebenzi uvala ngexesha lerekhodi. Umshicileli uyayeka ngokuzenzekelayo xa inani_le_imifanekiso lifikelelwe. Kwimo 'yolandelelwano olungathinteliyo', lo msebenzi awuvaleli. Ubume kufuneka buhlolwe phambi kokuba kufundwe umfanekiso. Le mo isetyenziselwa ukufunda imifanekiso ngelixa urekhoda, umz. i-thumbnail. Kwimo ye 'ring buffer' lo msebenzi awuvaleli. Ubume kufuneka buhlolwe phambi kokuba kufundwe umfanekiso. Umshicileli akayeki ushicilelo xa inani_le_imifanekiso lifikelelwe. Xa oku kusenzeka, eyona mifanekiso midala ibhalwa ngaphezulu. Kwimo ye 'fifo', lo msebenzi awuvaleli. Ubume kufuneka buhlolwe phambi kokuba kufundwe umfanekiso. Xa inani_le_imifanekiso kwi-fifo lifikelelwe, le mifanekiso ilandelayo iyalahlwa de imifanekiso ifundwe kwififo.

2.1.2 Yima
Inkcazo Imisa ushicilelo lwangoku. Kwi-'ring buffer' kunye ne'fifo' mode, lo msebenzi kufuneka ubizwe ngumsebenzisi. Kwimo 'yolandelelwano' kunye 'nolandelelwano olungathinteliyo', lo msebenzi ubizwa ngokuzenzekelayo xa inani_le_imifanekiso lifikelelwe.
Umzekelo def stop(self):
2.1.3 Vala
Inkcazo Ivala ikhamera evuliwe kwaye ikhuphe oovimba abavaliweyo. Lo msebenzi kufuneka ubizwe phambi kokuba isicelo sipheliswe. Ngaphandle koko, izibonelelo zihlala zihlala.
Umzekelo def close(self):
Lo msebenzi ubizwa ngokuzenzekelayo ukuba into yekhamera yenziwe ngengxelo. Umnxeba ocacileyo wokuvala () awuseyomfuneko.
nge pco.Camera() njenge cam: # yenza ezinye izinto
2.1.4 Umfanekiso
Inkcazo Ibuyisela umfanekiso osuka kumshicileli. Uhlobo lomfanekiso yinumpy.ndarray. Olu luhlu luyilwe ngokuxhomekeke kwisisombululo kunye ne-ROI yomfanekiso.
Umzekelo umfanekiso we-def(ubuqu, umfanekiso_inombolo=0, roi=Akukho):
Ipharamitha

Igama	Inkcazo
umfanekiso_inombolo	Ixela inani lomfanekiso oza kufundwa. Kwimo 'yolandelelwano' okanye 'ulandelelwano olungathinteliyo', isalathisi soshicilelo sihambelana nomfanekiso_inani. Ukuba umfanekiso_inani umiselwe ku-0xFFFFFFFF, umfanekiso wokugqibela orekhodiweyo uyakotshwa. Oku kuvumela ukwenza i-pre liveview ngelixa urekhoda.
royi	Iseta ummandla womdla. Kuphela lo mmandla womfanekiso ukhutshelwe kwixabiso lokubuyisela.

Example >>> cam.record(inombolo_of_images=1, indlela='ulandelelwano')
>>> umfanekiso, meta = cam.image ()
>>> uhlobo (umfanekiso) numpy.ndarray
>>> image.shape (2160, 2560)
>>> umfanekiso, imetadata = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 Imifanekiso
Inkcazo Ibuyisela yonke imifanekiso erekhodiweyo evela kumshicileli njengoluhlu lwamanani angekhoyo.
Umzekelo def imifanekiso(self, roi=Akukho, blocksize=Akukho):
Ipharamitha

Igama	Inkcazo
royi	Iseta ummandla womdla. Kuphela lo mmandla womfanekiso ukhutshelwe kwixabiso lokubuyisela.
ibhlokhi	Ichaza elona nani liphezulu lemifanekiso ebuyisiweyo. Le parameter iluncedo kuphela kwimo ye 'fifo' naphantsi kweemeko ezizodwa.

Example >>> cam.record(inombolo_of_images=20, indlela='ulandelelwano')
>>> imifanekiso, metadata = cam.images()
>>> len(imifanekiso) 20
>>> yemifanekiso kwimifanekiso:
…
print('Ithetha: {:7.2f} DN'.format(image.mean()))
…
Intsingiselo: 2147.64 DN
Intsingiselo: 2144.61 DN
…
>>> imifanekiso = cam.images(roi=(1, 1, 300, 300))
>>> imifanekiso[0].imilo (300, 300)
2.1.6 Umfanekiso_umndilili
Inkcazo Ibuyisela umfanekiso ophakathi. Lo mfanekiso ubalwa kuyo yonke imifanekiso erekhodiweyo kwibuffer.
Umzekelo def image_avareji(self, roi=Akukho):
Ipharamitha

Igama	Inkcazo
royi	Ichaza ummandla womdla. Kuphela lo mmandla womfanekiso ukhutshelwe kwixabiso lokubuyisela.

Example >>> cam.record(inombolo_of_images=100, indlela='ulandelelwano')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Seta_ixesha_lokutyhileka
Inkcazo Iseta ixesha lokuvezwa kwekhamera.
Umzekelo def set_exposure_time(self, exposure_time):
Ipharamitha

Igama	Inkcazo
ixesha lokungakhuseleki	Kufuneka inikwe njenge float okanye ixabiso elipheleleyo kwiyunithi 'yesibini'. Amaxabiso asezantsi omsebenzi sdk.set_delay_exposure_time(0, 'ms', ixesha, isiseko sexesha) ziya kubalwa ngokuzenzekelayo. Ixesha lokulibaziseka limiselwe ku-0.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Linda_umfanekiso_wokuqala
Inkcazo Ilinda umfanekiso wokuqala okhoyo kwimemori yesishicileli. Kwimo yoshicilelo 'ulandelelwano aluthinteli', 'i-ring buffer'. kunye ne 'fifo', umsebenzi werekhodi() ubuyela ngoko nangoko. Ngoko ke, lo msebenzi unokusetyenziselwa ukulinda imifanekiso esuka kwikhamera ngaphambi kokufowuna umfanekiso (), imifanekiso (), okanye umfanekiso_ ophakathi ().
Umzekelo def wait_for_first_image(self):
2.2 Ulungelelwaniso oluguquguqukayo
Iiparamitha zekhamera zihlaziywa ngokutshintsha ukuguquguquka koqwalaselo.
cam.configuration = {'ixesha lokuvezwa': 10e-3,
'roi': (1, 1, 512, 512),
'amaxeshaamp': 'ascii',
'umlinganiselo wepixel': 100_000_000,
'trigger': 'ulandelelwano oluzenzekelayo',
'fumana': 'auto',
'imetadata': 'ivuliwe',
'ibhini': (1, 1)}
Utshintsho lunokutshintshwa kuphela phambi kokuba irekhodi() umsebenzi ubizwe. Sisichazi-magama esinenani elithile lamangeniso. Ayizizo zonke izinto ezinokubakho ekufuneka zixelwe. Oku kulandelayo sampikhowudi itshintsha kuphela 'ireyithi yepixel' kwaye ayichaphazeli naziphi na ezinye izinto zoqwalaselo.
nge pco.Camera() njenge cam:
cam.configuration = {'ireyithi yepixel': 286_000_000}
cam.irekhodi()
…
2.3 izinto
Eli candelo lichaza zonke izinto ezinikezelwa yiklasi ye-pco.Camera.
2.3.1 SDK
Into sdk ivumela ufikelelo oluthe ngqo kuyo yonke imisebenzi esisiseko ye pco.sdk.
>>> cam.sdk.get_temperature()
{'iqondo lobushushu lenzwa': 7.0, 'ubushushu bekhamera': 38.2, 'iqondo lobushushu lamandla': 36.7}
Onke amaxabiso embuyekezo ukusuka kwimisebenzi yesdk zizichazi-magama. Ayizizo zonke iisetingi zekhamera okwangoku ezifakwe kwiklasi yeKhamera. Iisetingi ezikhethekileyo kufuneka zisetwe ngokuthe ngqo ngokufowunela umsebenzi we-sdk.
2.3.2 Umshicileli
Into rec inika ufikelelo oluthe ngqo kuyo yonke imisebenzi esisiseko ye pco.rekhoda. Akuyomfuneko ukubiza indlela yeklasi yokurekhoda ngokuthe ngqo. Yonke imisebenzi igutyungelwe ngokupheleleyo ziindlela zeklasi yeKhamera.

https://www.pco.de/applications/

pco yaseYurophu +49 9441 2005 50 info@pco.de pco.de

PCo eMelika +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 ulwazi@pco.cn pco.cn

Amaxwebhu / Izibonelelo

EXCELITAS TECHNOLOGIES Python Software Development Kit [pdf] Incwadi yokusebenzisa Ikhithi yoPhuhliso lweSoftware yePython, iKit yoPhuhliso lweSoftware, iKhiti yoPhuhliso, iKhiti

Iimbekiselo

• Incwadi yokusebenzisa