EXCELITAS TECHNOLOGIES Python hugbúnaðarþróunarsett notendahandbók

Python hugbúnaðarþróunarsett
Notendahandbók

Innihald fela sig

1 Python hugbúnaðarþróunarsett

Python hugbúnaðarþróunarsett

PCO biður þig um að lesa vandlega og fylgja leiðbeiningunum í þessu skjali.
Fyrir allar spurningar eða athugasemdir skaltu ekki hika við að hafa samband við okkur hvenær sem er.
sími: +49 (0) 9441 2005 50
fax: +49 (0) 9441 2005 20
póstfang: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Þýskalandi
netfang: info@pco.de
web: www.pco.de
pco.python notendahandbók 0.1.7
Gefið út desember 2021
© Höfundarréttur Excelitas PCO GmbH
Þetta verk er með leyfi samkvæmt Creative Commons Attribution-No Derivatives 4.0 International License. Til view afrit af þessu leyfi, heimsækja http://creativecommons.org/licenses/by-nd/4.0/ eða sendu bréf til Creative Commons, Pósthólf 1866, Mountain View, CA 94042, Bandaríkjunum.

Almennt

Python pakkinn pco býður upp á allar aðgerðir til að vinna með pco myndavélar sem eru byggðar á straumnum pco.sdk. Öll sameiginleg bókasöfn fyrir samskipti við myndavélina og myndvinnslu í kjölfarið eru innifalin.

Auðvelt að nota myndavélanámskeið
Öflugur API til pco.sdk
Myndupptaka og vinnsla með pco.upptökutæki

1.1 Uppsetning
Settu upp frá pypi (mælt með):
$ pip setja upp pco
1.2 Grunnnotkun
flytja inn matplotlib.pyplot sem plt
innflutningur pco
með pco.Camera() sem myndavél:
cam.record()
mynd, meta = cam.image()
plt.imshow(image, cmap='gray')
plt.show()1.3 Atburða- og villuskráning
Til að virkja skráningarúttakið, búðu til myndavélarhlutinn með debuglevel= færibreytunni.
Villuleitarstigið er hægt að stilla á eitt af eftirfarandi gildum:

'off' Slökkva á allri úttak.
'villa' Sýnir aðeins villuboð.
'verbose' Sýnir öll skilaboð.
'extra orðrétt' Sýnir öll skilaboð og gildi.

Sjálfgefið villuleit er 'slökkt'.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: Í lagi.
Valfrjáls tímasetningamp= færibreyta virkjar a tag í prentuðu úttaki. Möguleg gildi eru: 'on' og 'off'. Sjálfgefið gildi er 'off'.
pco.Camera(debuglevel='verbose', tímamælingamp='á')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: OK.

API skjöl

Pco.Camera flokkurinn býður upp á eftirfarandi aðferðir:

record() býr til, stillir og byrjar nýtt upptökutilvik.
stop() stöðvar núverandi upptöku.
close() lokar núverandi virku myndavélinni og losar uppteknar auðlindir.

image() skilar mynd frá upptökutækinu sem numpy array.
images() skilar öllum teknum myndum úr upptökutækinu sem lista yfir numpy fylki.

image_average() skilar meðalmyndinni. Þessi mynd er reiknuð út frá öllum teknum myndum í biðminni.
set_exposure_time() stillir lýsingartíma myndavélarinnar.
wait_for_first_image() bíður eftir fyrstu tiltæku myndinni í minni upptökutækisins.

Pco.Camera flokkurinn hefur eftirfarandi breytu:

uppsetningu

Pco.Camera flokkurinn hefur eftirfarandi hluti:

sdk býður upp á beinan aðgang að öllum undirliggjandi aðgerðum pco.sdk.
upptökutæki býður upp á beinan aðgang að öllum undirliggjandi aðgerðum pco.upptökutæki.

2.1 Aðferðir
Þessi hluti lýsir öllum aðferðum sem pco.Camera flokkurinn býður upp á.
2.1.1 Skrá
Lýsing Býr til, stillir og ræsir nýtt upptökutilvik. Stilla verður alla myndavélaruppsetninguna áður en hringt er í record(). Skipunin set_exposure_time() er eina undantekningin. Þessi aðgerð hefur engin áhrif á hlut upptökutækisins og hægt er að kalla hana fram meðan á upptöku stendur.
Frumgerð def record(self, number_of_images=1, mode='sequence'):
Parameter

Nafn	Lýsing
fjöldi_mynda	Stillir fjölda mynda sem úthlutað er í bílstjóranum. Vinnsluminni í tölvunni takmarkar hámarksgildið.
ham	Í „röð“ ham er þessi aðgerð að loka á meðan á upptöku stendur. Upptökutækið stöðvast sjálfkrafa þegar fjölda_mynda er náð. Í „sequence non blocking“ ham er þessi aðgerð ólokandi. Athuga þarf stöðuna áður en mynd er lesin. Þessi stilling er notuð til að lesa myndir meðan á upptöku stendur, td smámynd. Í „hringbuffer“ ham er þessi aðgerð ekki læst. Athuga þarf stöðuna áður en mynd er lesin. Upptökutæki stöðvar ekki upptökuna þegar fjölda_mynda er náð. Þegar þetta gerist er elstu myndirnar skrifaðar yfir. Í „fifo“ ham er þessi aðgerð ekki læst. Athuga þarf stöðuna áður en mynd er lesin. Þegar fjölda_mynda í fifo er náð eru eftirfarandi myndir sleppt þar til myndir eru lesnar úr fifo.

2.1.2 Hættu
Lýsing Stöðvar núverandi upptöku. Í „ring buffer“ og „fifo“ ham verður notandinn að kalla þessa aðgerð. Í stillingum „sequence“ og „sequence non blocking“ er þessi aðgerð sjálfkrafa kölluð upp þegar fjölda_mynda er náð.
Frumgerð def stop (sjálf):
2.1.3 Lokaðu
Lýsing Lokar virku myndavélinni og losar lokuðu tilföngin. Kalla verður á þessa aðgerð áður en forritinu er hætt. Annars eru auðlindirnar uppteknar.
Frumgerð def loka(sjálf):
Þessi aðgerð er kölluð sjálfkrafa ef myndavélarhluturinn er búinn til með setningunni with. Skýrt kall til að loka() er ekki lengur nauðsynlegt.
með pco.Camera() sem myndavél: # gerðu eitthvað
2.1.4 Mynd
Lýsing Skilar mynd frá upptökutækinu. Tegund myndarinnar er numpy.ndarray. Þetta fylki er mótað eftir upplausn og arðsemi myndarinnar.
Frumgerð def image(sjálf, myndnúmer=0, arðsemi=Ekkert):
Parameter

Nafn	Lýsing
myndnúmer	Tilgreinir númer myndarinnar sem á að lesa. Í stillingu „sequence“ eða „sequence non blocking“, passar upptökuvísitalan við myndnúmerið. Ef image_number er stillt á 0xFFFFFFFF er síðasta upptaka myndin afrituð. Þetta gerir kleift að búa til lifandi forview meðan á upptöku stendur.
roi	Stillir áhugasvæðið. Aðeins þetta svæði myndarinnar er afritað í skilgildið.

Example >>> cam.record(number_of_images=1, mode='röð')
>>> mynd, meta = cam.image()
>>> sláðu inn (mynd) numpy.ndarray
>>> image.shape (2160, 2560)
>>> mynd, lýsigögn = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 Myndir
Lýsing Skilar öllum teknum myndum úr upptökutækinu sem lista yfir numpy fylki.
Frumgerð def myndir (sjálf, roi=Engin, blokkstærð=Engin):
Parameter

Nafn	Lýsing
roi	Stillir áhugasvæðið. Aðeins þetta svæði myndarinnar er afritað í skilgildið.
blokkastærð	Skilgreinir hámarksfjölda mynda sem er skilað. Þessi færibreyta er aðeins gagnleg í „fifo“ ham og við sérstakar aðstæður.

Example >>> cam.record(number_of_images=20, mode='röð')
>>> myndir, lýsigögn = cam.images()
>>> len(myndir) 20
>>> fyrir mynd í myndum:
…
print('Mean: {:7.2f} DN'.format(image.mean()))
…
Meðaltal: 2147.64 DN
Meðaltal: 2144.61 DN
…
>>> myndir = cam.images(roi=(1, 1, 300, 300))
>>> myndir[0].shape (300, 300)
2.1.6 Image_meðaltal
Lýsing Skilar meðaltalsmynd. Þessi mynd er reiknuð út frá öllum teknum myndum í biðminni.
Frumgerð def image_average(sjálf, arðsemi=Ekkert):
Parameter

Nafn	Lýsing
roi	Skilgreinir áhugasvæðið. Aðeins þetta svæði myndarinnar er afritað í skilgildið.

Example >>> cam.record(number_of_images=100, mode='röð')
>>> avg = cam.image_average()
>>> meðaltal = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Stilltur_útsetningartími
Lýsing Stillir lýsingartíma myndavélarinnar.
Frumgerð def set_exposure_time(sjálf, exposure_time):
Parameter

Nafn	Lýsing
smitunartími	Verður að gefa upp sem fljótandi eða heiltölugildi í einingunni „sekúndu“. Undirliggjandi gildi fyrir fallið sdk.set_delay_exposure_time(0, 'ms', time, timebase) verða reiknuð sjálfkrafa. Seinkunartíminn er stilltur á 0.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Bíddu_eftir_fyrstu_mynd
Lýsing Bíður eftir fyrstu tiltæku myndinni í minni upptökutækisins. Í upptökuham 'sequence non blocking', 'ring buffer'. og 'fifo', aðgerðin record() skilar strax. Þess vegna er hægt að nota þessa aðgerð til að bíða eftir myndum úr myndavélinni áður en hringt er í image(), images() eða image_average().
Frumgerð def wait_for_first_image(sjálf):
2.2 Breytileg stilling
Færibreytur myndavélarinnar eru uppfærðar með því að breyta stillingarbreytunni.
cam.configuration = {'útsetningartími': 10e-3,
'roi': (1, 1, 512, 512),
'timestamp': 'ascii',
'pixel rate': 100_000_000,
'trigger': 'sjálfvirk röð',
'acquire': 'auto',
'metadata': 'on',
'binning': (1, 1)}
Aðeins er hægt að breyta breytunni áður en aðgerðin record() er kölluð. Það er orðabók með ákveðinn fjölda færslur. Ekki þarf að tilgreina alla mögulega þætti. Eftirfarandi sampkóðinn breytir aðeins 'pixlahraða' og hefur ekki áhrif á aðra þætti stillingarinnar.
með pco.Camera() sem myndavél:
cam.configuration = {'pixel rate': 286_000_000}
cam.record()
…
2.3 hlutir
Þessi hluti lýsir öllum hlutum sem pco.Camera flokkurinn býður upp á.
2.3.1 SDK
Hluturinn sdk leyfir beinan aðgang að öllum undirliggjandi aðgerðum pco.sdk.
>>> cam.sdk.get_temperature()
{'hiti skynjara': 7.0, 'hitastig myndavélar': 38.2, 'aflhiti': 36.7}
Öll skilgildi frá sdk föllum eru orðabækur. Ekki eru allar myndavélastillingar sem stendur undir myndavélaflokknum. Sérstakar stillingar verða að stilla beint með því að hringja í viðkomandi sdk aðgerð.
2.3.2 Upptökutæki
Object rec býður upp á beinan aðgang að öllum undirliggjandi aðgerðum pco.upptökutæki. Það er ekki nauðsynlegt að kalla upptökuflokksaðferð beint. Allar aðgerðir falla að fullu undir aðferðum myndavélaflokksins.