EXCELITAS TECHNOLOGIES Eke Ọgba Ọgba Ọgba Ọdụ Ọdụm

Ngwa ngwa mmepe Python
Akwụkwọ ntuziaka onye ọrụ

ọdịnaya zoo

1 Ngwa ngwa mmepe Python

2 Izugbe

3 Akwụkwọ API

4 Akwụkwọ / akụrụngwa

4.1 Ntụaka

5 Ozi ndị metụtara

Ngwa ngwa mmepe Python

PCO na-arịọ gị ka ị jiri nlezianya gụọ ma soro ntuziaka dị n'akwụkwọ a.
Maka ajụjụ ma ọ bụ nkọwa ọ bụla, biko nweere onwe gị ịkpọtụrụ anyị n'oge ọ bụla.
ekwentị: +49 (0) 9441 2005 50
faksị: +49 (0) 9441 2005 20
adreesị ozi-e: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germany
email: info@pco.de
web: www.pco.de
akwụkwọ ntuziaka onye ọrụ pco.python 0.1.7
Ewepụtara Disemba 2021
©Copyright Excelitas PCO GmbH
Enyere ikike ọrụ a n'okpuru Creative Commons Attribution-No Deivatives 4.0 International License. Iji view otu akwụkwọ ikike a, gaa http://creativecommons.org/licenses/by-nd/4.0/ ma ọ bụ zipu akwụkwọ ozi na Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Izugbe

Ihe ngwugwu Python pco na-enye ọrụ niile maka ịrụ ọrụ na igwefoto pco dabere na nke dị ugbu a pco.sdk. Agụnyere ọba akwụkwọ niile ekekọrịtara maka nkwurịta okwu na igwefoto yana nhazi onyonyo na-esote.

Ọ dị mfe iji klas igwefoto
API dị ike ka pco.sdk
Edekọ ihe onyonyo na nhazi ya pco. ndekọ

1.1 Ntinye
Wụnye site na pypi (akwadoro):
$ pip tinye pco
1.2 Isi ojiji
mbubata matplotlib.pyplot ka plt
mbubata pco
ya na pco.Camera() dị ka cam:
cam.record ()
onyonyo, meta = cam.image()
plt.imshow(onyinyo, cmap='isi awọ')
plt.show()1.3 Ihe omume na ndenye mperi
Iji mee ka mmepụta ndekọ rụọ ọrụ, mepụta ihe igwefoto site na iji debuglevel= parameter.
Enwere ike ịtọ ọkwa nzipu ka ọ bụrụ otu n'ime ụkpụrụ ndị a:

'gbanyụọ' na-ewepụ mmepụta niile.
'Emehie' Na-egosi naanị ozi mperi.
'verbose' Na-egosi ozi niile.
'extra verbose' Na-egosi ozi na ụkpụrụ niile.

Debuglevel ndabara bụ 'gbanyụọ'.
pco.Camera(debuglevel='verbose')
…
[[sdk] nweta_camera_ụdị: OK.
Oge nhọrọamp= paramita na-arụ ọrụ a tag na mmepụta e biri ebi. Ụkpụrụ nwere ike ịbụ: 'gbanwuo' na 'gbanyụọ'. Uru ndabara bụ 'gbanyụọ'.
pco.Camera(debuglevel='verbose', ogeamp='na')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] nweta_camera_type: OK.

Akwụkwọ API

Klas pco.Camera na-enye ụzọ ndị a:

record() na-ewepụta, hazie ma malite ihe ndekọ ndekọ ọhụrụ.
stop() na-akwụsị ndekọ ugbu a.
close() na-emechi igwefoto nọ n'ọrụ ugbu a wee wepụta akụrụngwa ejiri.

image() weghachi onyonyo sitere na onye na-edekọ ihe dị ka ọnụọgụ ọnụọgụ.
onyoonyo() na-eweghachi onyonyo niile edekọrọ site na ndekọ ndekọ dịka ndepụta ọnụọgụgụ.

image_average() na-eweghachi onyonyo agbakwunyere. A na-agbakọ onyonyo a site na onyonyo niile edere na nchekwa.
set_exposure_time() na-ewepụta oge ikpughe maka igwefoto.
wait_for_first_image() na-echere onyonyo izizi dị na ebe nchekwa ndekọ.

Klas pco.Camera nwere mgbanwe ndị a:

nhazi

Klas pco.Camera nwere ihe ndị a:

sdk na-enye ohere ozugbo na ọrụ niile dị n'okpuru pco.sdk.
ihe ndekọ na-enye ohere ozugbo na ọrụ niile dị n'okpuru pco. ndekọ.

2.1 Ụzọ
Akụkụ a na-akọwa ụzọ niile nke klas pco.Camera na-enye.
2.1.1 Dekọọ
Nkọwa Na-emepụta, hazie ma malite ihe ndekọ ndekọ ọhụrụ. A ga-edozirịrị nhazi igwefoto niile tupu ịkpọ ndekọ(). Iwu set_exposure_time() bụ naanị ewepụrụ. Ọrụ a enweghị mmetụta na ihe ndekọ ma enwere ike ịkpọ ya n'oge ndekọ.
Prototype def ndekọ (onwe, number_of_images=1, mode='usoro'):
Oke

Aha	Nkọwa
ọnụọgụ_oyiyi	Na-ahazi ọnụọgụ onyonyo ekenyela na onye ọkwọ ụgbọ ala. RAM nke PC na-amachi oke uru.
ọnọdụ	Na ọnọdụ 'usoro', ọrụ a na-egbochi n'oge ndekọ. Onye na-edekọ ihe na-akwụsị na-akpaghị aka mgbe ruru ọnụọgụ_of_images. N'ụdị 'usoro anaghị egbochi', ọrụ a anaghị egbochi. A ghaghị ịlele ọkwa ahụ tupu ịgụọ onyonyo. A na-eji ọnọdụ a gụọ onyonyo mgbe a na-edekọ, dịka thumbnail. Na ọnọdụ 'mgbanaka mgbanaka' ọrụ a anaghị egbochi ya. A ghaghị ịlele ọkwa ahụ tupu ịgụọ onyonyo. Ihe ndekọ anaghị akwụsị ndekọ ahụ mgbe ruru ọnụọgụ_of_images. Ozugbo nke a mere, a na-edegharị foto ndị kacha ochie. Na ọnọdụ 'fifo', ọrụ a anaghị egbochi ya. A ghaghị ịlele ọkwa ahụ tupu ịgụọ onyonyo. Mgbe ọnụọgụ_of_images dị na fifo ruru, a ga-atụba onyonyo ndị a ruo mgbe agụpụtara onyonyo na fifo.

2.1.2 Kwụsị
Nkọwa Kwụsị ndekọ ugbu a. Na 'mgbanaka mgbanaka' na ọnọdụ 'fifo', onye ọrụ ga-enwerịrị ike ịkpọ ọrụ a. N'usoro 'usoro' na 'usoro enweghị mgbochi' mode, a na-akpọ ọrụ a na-akpaghị aka mgbe erutere nọmba_of_images.
Prototype nkwụsị nkwụsị (onwe):
2.1.3 Mechie
Nkọwa Na-emechi igwefoto agbanyere ma wepụta akụrụngwa akpọchiri. A ghaghị ịkpọ ọrụ a tupu akwụsị ngwa ahụ. Ma ọ bụghị ya, akụ na-anọgide na-ejigide.
Prototype def nso(onwe):
A na-akpọ ọrụ a na-akpaghị aka ma ọ bụrụ na ejiri nkwupụta mepụta ihe igwefoto. Oku doro anya imechi() adịkwaghị mkpa.
ya na pco.Camera() dị ka cam: # mee ụfọdụ ihe
2.1.4 Foto
Nkọwa Weghachite onyonyo site na ndekọ ndekọ. Ụdị onyonyo a bụ numpy.ndarray. A na-eme usoro a dabere na mkpebi na ROI nke onyonyo a.
Prototype foto def (onwe, image_number=0, roi=Ọ dịghị):
Oke

Aha	Nkọwa
foto_nọmba	Na-akọwapụta ọnụọgụ onyonyo a ga-agụ. N'usoro 'usoro' ma ọ bụ 'usoro anaghị egbochi', ndekọ ndekọ dakọtara na image_number. Ọ bụrụ na edobere image_number ka ọ bụrụ 0xFFFFFFFF, a na-eṅomi foto ikpeazụ edere. Nke a na-enye ohere ịmepụta ndụ tupuview mgbe ị na-edekọ.
roi	Na-esetịpụ mpaghara mmasị. Naanị mpaghara onyonyo a ka e depụtaghachiri na uru nloghachi.

Example >>> cam.record (nọmba_of_images=1, ọnọdụ = 'usoro')
>>> onyonyo, meta = cam.image()
>>> ụdị (onyinyo) numpy.ndarray
>>> oyiyi. ọdịdị (2160, 2560)
>>> onyonyo, metadata = cam.image (roi= (1, 1, 300, 300))
>>> oyiyi. ọdịdị (300, 300)
Foto 2.1.5
Nkọwa weghachite onyonyo niile edekọtara site na ndekọ ndekọ dị ka ndepụta ọnụọgụgụ.
Prototype onyogho def(onwe, roi=Onweghi, blocksize=Onweghi):
Oke

Aha	Nkọwa
roi	Na-esetịpụ mpaghara mmasị. Naanị mpaghara onyonyo a ka e depụtaghachiri na uru nloghachi.
blocksize	Na-akọwapụta ọnụọgụ onyonyo eweghachitere kacha. Oke a bara uru naanị na ọnọdụ 'fifo' yana n'okpuru ọnọdụ pụrụ iche.

Example >>> cam.record (nọmba_of_images=20, ọnọdụ = 'usoro')
>>> onyonyo, metadata = cam.images()
>>> oghere (onyinyo) 20
>>> maka onyonyo dị na foto:
…
ebipụta ('Pụtara: {:7.2f} DN'.format(image.mean()))
…
Aha: 2147.64DN
Aha: 2144.61DN
…
>>> onyonyo = cam.images (roi= (1, 1, 300, 300))
>>> onyonyo[0].ụdị (300, 300)
2.1.6 Foto_nkezi
Nkọwa Na-eweghachi onyonyo nke nkezi. A na-agbakọ onyonyo a site na onyonyo niile edere na nchekwa.
Prototype def image_average (onwe, roi = Ọ dịghị):
Oke

Aha	Nkọwa
roi	Na-akọwa mpaghara mmasị. Naanị mpaghara onyonyo a ka e depụtaghachiri na uru nloghachi.

Example >>> cam.record (nọmba_of_images=100, ọnọdụ = 'usoro')
>>> nkezi = cam.image_average()
>>> nkezi = cam.image_average (roi= (1, 1, 300, 300))
2.1.7 Tọọ_exposure_oge
Nkọwa Na-edozi oge mkpughe nke igwefoto.
Prototype def set_exposure_time (onwe, ikpughe_oge):
Oke

Aha	Nkọwa
oge mkpughepu	Ekwesịrị inye ya dị ka uru ise n'elu mmiri ma ọ bụ integer na nkeji 'second'. A ga-agbakọ ụkpụrụ dị n'okpuru maka ọrụ sdk.set_delay_exposure_time(0, 'ms', time, timebase) na-akpaghị aka. Adobere oge igbu oge ka ọ bụrụ 0.

Example >>> cam.set_exposure_time (0.001)
>>> cam.set_exposure_time (1e-3)
2.1.8 Chere_ihe oyiyi_mbụ
Nkọwa Na-echere onyonyo izizi dị na ebe nchekwa ndekọ. N'ụdị ndekọ 'usoro enweghị mgbochi', 'ihe nchekwa mgbanaka'. na 'fifo', ndekọ ọrụ () na-alaghachi ozugbo. Ya mere, enwere ike iji ọrụ a chere onyonyo sitere na igwefoto tupu ịkpọọ onyonyo (), onyonyo (), ma ọ bụ image_average ().
Prototype def wait_for_first_image(onwe):
2.2 Nhazi mgbanwe
A na-emelite parampat igwefoto site na ịgbanwe mgbanwe nhazi.
cam.configuration = {'oge ngosi': 10e-3,
'roi': (1, 1, 512, 512),
'ogeamp': 'ascii',
'ọnụego pixel': 100_000_000,
'trigger': 'usoro akpaaka',
'nweta': 'auto',
'metadata': 'na',
'ịkọba': (1, 1)}
Enwere ike gbanwee mgbanwe ahụ naanị tupu akpọọ ọrụ ndekọ (). Ọ bụ akwụkwọ ọkọwa okwu nwere ụfọdụ ndenye. Ọ bụghị ihe niile nwere ike ime ka ekwesịrị ịkọwapụta. Ndị na-esonụ sample koodu na-agbanwe naanị 'pixel rate' na anaghị emetụta ihe ọ bụla ọzọ nke nhazi.
ya na pco.Camera() dị ka cam:
cam.configuration = {'ọnụego pixel': 286_000_000}
cam.record ()
…
2.3 Ihe
Akụkụ a na-akọwa ihe niile klas pco. Igwefoto na-enye.
2.3.1 SDK
Ihe sdk na-enye ohere ịnweta ọrụ niile dị n'okpuru pco.sdk.
>>> cam.sdk.get_temperature()
{'ihe mmetụta okpomọkụ': 7.0, 'igwefoto okpomọkụ': 38.2, 'ike okpomọkụ': 36.7}
Ụkpụrụ nloghachi niile sitere na ọrụ sdk bụ akwụkwọ ọkọwa okwu. Ọ bụghị ntọala igwefoto niile ka klas igwefoto kpuchiri ugbu a. Ekwesịrị ịtọ ntọala pụrụ iche ozugbo site na ịkpọ ọrụ sdk dị iche iche.
2.3.2 ndekọ
Ihe rec na-enye ohere ozugbo na ọrụ niile dị n'okpuru pco. ndekọ. Ọ dịghị mkpa ịkpọ usoro klas ndekọ ozugbo. Usoro klas igwefoto kpuchie ọrụ niile.