TECHNOLEGAU EXCELITAS Llawlyfr Defnyddiwr Pecyn Datblygu Meddalwedd Python

Pecyn Datblygu Meddalwedd Python
Llawlyfr Defnyddiwr

Pecyn Datblygu Meddalwedd Python

Mae PCO yn gofyn ichi ddarllen a dilyn y cyfarwyddiadau yn y ddogfen hon yn ofalus.
Am unrhyw gwestiynau neu sylwadau, mae croeso i chi gysylltu â ni unrhyw bryd.
ffôn: +49 (0) 9441 2005 50
ffacs: +49 (0) 9441 2005 20
cyfeiriad post: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, yr Almaen
e-bost: gwybodaeth@pco.de
web: www.pco.de
llawlyfr defnyddiwr pco.python 0.1.7
Rhyddhawyd Rhagfyr 2021
©Hawlfraint Excelitas PCO GmbH
Mae'r gwaith hwn wedi'i drwyddedu o dan Drwydded Ryngwladol Creative Commons Attribution-No Derivatives 4.0. I view copi o'r drwydded hon, ymwelwch http://creativecommons.org/licenses/by-nd/4.0/ neu anfon llythyr i Creative Commons, PO Box 1866, Mountain View, CA 94042, UDA.

Cyffredinol

Mae'r pecyn Python pco yn cynnig yr holl swyddogaethau ar gyfer gweithio gyda chamerâu pco sy'n seiliedig ar y presennol pco.sdk. Mae'r holl lyfrgelloedd a rennir ar gyfer cyfathrebu â'r camera a phrosesu delweddau dilynol wedi'u cynnwys.

• Dosbarth camera hawdd ei ddefnyddio
• API pwerus i pco.sdk
• Recordio delwedd a phrosesu gyda pco.recordydd

1.1 Gosod
Gosod o pypi (argymhellir):
$pip gosod pco
1.2 Defnydd Sylfaenol
mewnforio matplotlib.pyplot fel plt
mewnforio pco
gyda pco.Camera() fel cam:
cam.record()
delwedd, meta = cam.image()
plt.imshow(delwedd, cmap = 'llwyd')
plt.show()1.3 Logio Digwyddiad a Gwallau
I actifadu'r allbwn logio, crëwch y gwrthrych Camera gyda'r paramedr debuglevel=.
Gellir gosod y lefel dadfygio i un o'r gwerthoedd canlynol:

• 'diffodd' Analluogi pob allbwn.
• 'error' Yn dangos negeseuon gwall yn unig.
• 'verbose' Yn dangos pob neges.
• 'extra verbose' Yn dangos yr holl negeseuon a gwerthoedd.

Y lefel dadfygio rhagosodedig yw 'diffodd'.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: Iawn.
Yr amserydd dewisolamp= paramedr yn actifadu a tag yn yr allbwn printiedig. Gwerthoedd posibl yw: 'ymlaen' ac 'i ffwrdd'. Y gwerth diofyn yw 'diffodd'.
pco.Camera(debuglevel='verbose', timestamp='on')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: Iawn.

Dogfennaeth API

Mae'r dosbarth pco.Camera yn cynnig y dulliau canlynol:

• record () yn cynhyrchu, yn ffurfweddu, ac yn cychwyn enghraifft recordydd newydd.
• stop () yn atal y recordiad cyfredol.
• cau () cau'r camera gweithredol presennol a rhyddhau'r adnoddau a feddiannir.
• image() yn dychwelyd delwedd o'r recordydd fel arae numpy.
• images() yn dychwelyd yr holl ddelweddau a recordiwyd o'r recordydd fel rhestr o araeau di-nod.
• image_average() yn dychwelyd y ddelwedd gyfartalog. Cyfrifir y ddelwedd hon o'r holl ddelweddau a gofnodwyd yn y byffer.
• set_exposure_time() yn gosod yr amser datguddio ar gyfer y camera.
• wait_for_first_image() yn aros am y ddelwedd gyntaf sydd ar gael yng nghof y recordydd.

Mae gan y dosbarth pco.Camera y newidyn canlynol:

• cyfluniad

Mae gan y dosbarth pco.Camera y gwrthrychau canlynol:

• sdk yn cynnig mynediad uniongyrchol i holl swyddogaethau sylfaenol y pco.sdk.
• recorder yn cynnig mynediad uniongyrchol i holl swyddogaethau sylfaenol y pco.recordydd.

2.1 Dulliau
Mae'r adran hon yn disgrifio'r holl ddulliau a gynigir gan y dosbarth pco.Camera.
2.1.1 Cofnod
Disgrifiad Yn creu, yn ffurfweddu ac yn cychwyn enghraifft recordydd newydd. Rhaid gosod cyfluniad cyfan y camera cyn galw cofnod (). Y gorchymyn set_exposure_time() yw'r unig eithriad. Nid yw'r swyddogaeth hon yn cael unrhyw effaith ar wrthrych y recordydd a gellir ei galw i fyny yn ystod y recordiad.
Prototeip cofnod def(hunan, number_of_images=1, modd= 'dilyniant'):
Paramedr

2.1.2 Stopiwch
Disgrifiad Yn stopio'r recordiad cyfredol. Yn y modd 'ring byffer' a 'fifo', rhaid i'r defnyddiwr alw'r swyddogaeth hon. Yn y modd 'dilyniant' a 'dilyniant di-rwystro', caiff y swyddogaeth hon ei galw'n awtomatig pan gyrhaeddir y nifer_of_images.
Prototeip stop def (hunan):
2.1.3 Cau
Disgrifiad Yn cau'r camera wedi'i actifadu ac yn rhyddhau'r adnoddau sydd wedi'u blocio. Rhaid galw'r swyddogaeth hon cyn terfynu'r cais. Fel arall, mae'r adnoddau'n parhau i gael eu defnyddio.
Prototeip def cau (hunan):
Gelwir y swyddogaeth hon yn awtomatig os yw gwrthrych y camera yn cael ei greu gan y datganiad gyda. Nid oes angen galwad benodol i gau() mwyach.
gyda pco.Camera() fel cam: # gwneud rhai pethau
2.1.4 Delwedd
Disgrifiad Yn dychwelyd delwedd o'r recordydd. Mae math y ddelwedd yn numpy.ndarray. Mae'r arae hon wedi'i siapio yn dibynnu ar gydraniad a ROI y ddelwedd.
Prototeip delwedd def(hunan, image_number=0, roi=Dim):
Paramedr

Example >>> cam.record(number_of_images=1, modd='dilyniant')
>>> delwedd, meta = cam.image()
>>> math (delwedd) numpy.ndarray
>>> delwedd.shape (2160, 2560)
>>> delwedd, metadata = cam.image(roi=(1, 1, 300, 300))
>>> delwedd.shape (300, 300)
2.1.5 Delweddau
Disgrifiad Yn dychwelyd yr holl ddelweddau a recordiwyd o'r recordydd fel rhestr o araeau di-nod.
Prototeip delweddau def(hunan, roi=Dim, blocksize=Dim):
Paramedr

Example >>> cam.record(number_of_images=20, modd='dilyniant')
>>> delweddau, metadata = cam.images()
>>> len (lluniau) 20
>>> ar gyfer delwedd mewn delweddau:
…
print('Cymedr: {:7.2f} DN'.format(image.mean()))
…
Cymedr: 2147.64 DN
Cymedr: 2144.61 DN
…
>>> delweddau = cam.images(roi=(1, 1, 300, 300))
>>> delweddau[0].siâp (300, 300)
2.1.6 Delwedd_cyfartaledd
Disgrifiad Yn dychwelyd y ddelwedd gyfartalog. Cyfrifir y ddelwedd hon o'r holl ddelweddau a gofnodwyd yn y byffer.
Prototeip def image_average(hunan, roi=Dim):
Paramedr

Example >>> cam.record(number_of_images=100, modd='dilyniant')
>>> cyf = cam.image_average()
>>> cyf = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Gosod_amser_amlygiad
Disgrifiad Yn gosod amser amlygiad y camera.
Prototeip def set_exposure_time(hunan, amlygiad_amser):
Paramedr

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Arhoswch_am_ddelwedd_cyntaf
Disgrifiad Yn aros am y ddelwedd gyntaf sydd ar gael yng nghof y recordydd. Yn y modd recorder 'dilyniant di-flocio', 'rhoi byffer'. a 'fifo', mae'r cofnod swyddogaeth() yn dychwelyd ar unwaith. Felly, gellir defnyddio'r swyddogaeth hon i aros am ddelweddau o'r camera cyn galw delwedd (), delweddau (), neu image_average ().
Prototeip def wait_for_first_image(self):
2.2 Ffurfweddiad Amrywiol
Mae paramedrau'r camera yn cael eu diweddaru trwy newid y newidyn cyfluniad.
cam.configuration = { 'amser amlygiad': 10e-3,
'roi': (1, 1, 512, 512),
'amseramp': 'ascii',
'cyfradd picsel': 100_000_000,
'sbardun': 'dilyniant awtomatig',
'caffael': 'auto',
'metadata': 'ymlaen',
'binio': (1, 1)}
Dim ond cyn i'r swyddogaeth cofnod() gael ei galw y gellir newid y newidyn. Mae'n eiriadur gyda nifer penodol o gofnodion. Nid oes angen nodi pob elfen bosibl. Mae'r sampmae le code ond yn newid y 'gyfradd picsel' ac nid yw'n effeithio ar unrhyw elfennau eraill o'r ffurfweddiad.
gyda pco.Camera() fel cam:
cam.configuration = { 'cyfradd picsel': 286_000_000}
cam.record()
…
2.3 Gwrthrychau
Mae'r adran hon yn disgrifio'r holl wrthrychau a gynigir gan y dosbarth pco.Camera.
2.3.1 SDK
Mae'r sdk gwrthrych yn caniatáu mynediad uniongyrchol i holl swyddogaethau sylfaenol y pco.sdk.
>>> cam.sdk.get_temperature()
{ 'tymheredd synhwyrydd': 7.0, 'tymheredd camera': 38.2, 'tymheredd pŵer': 36.7}
Geiriaduron yw'r holl werthoedd dychwelyd o swyddogaethau sdk. Nid yw pob gosodiad camera wedi'i gwmpasu gan y dosbarth Camera ar hyn o bryd. Mae'n rhaid gosod gosodiadau arbennig yn uniongyrchol trwy ffonio'r swyddogaeth sdk berthnasol.
2.3.2 Cofiadur
Mae'r gwrthrych rec yn cynnig mynediad uniongyrchol i holl swyddogaethau sylfaenol y pco.recordydd. Nid oes angen galw dull dosbarth recorder yn uniongyrchol. Mae'r holl swyddogaethau yn cael eu cwmpasu'n llawn gan ddulliau'r dosbarth Camera.

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