Python Software Development Kit
User Manual

Python Software Development Kit

PCO inokukumbira kuti uverenge nekunyatsotevera mirairo iri mugwaro iri.
Kune chero mibvunzo kana mhinduro, ndapota inzwa wakasununguka kutibata nesu chero nguva.
runhare: +49 (0) 9441 2005 50
fakisi: +49 (0) 9441 2005 20
kero yetsamba: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germany
email: info@pco.de
web: www.pco.de
pco.python user manual 0.1.7
Yakaburitswa muna Zvita 2021
©Copyright Excelitas PCO GmbH
Iri basa rine rezinesi pasi peCreative Commons Attribution-No Derivatives 4.0 International License. To view kopi yerezinesi iri, shanya http://creativecommons.org/licenses/by-nd/4.0/ kana kutumira tsamba kuCreative Commons, PO Box 1866, Mountain View, CA 94042, USA.

General

Iyo Python package pco inopa mabasa ese ekushanda nemakomera kamera anoenderana neazvino pco.sdk. Maraibhurari ese akagovaniswa ekutaurirana nekamera uye inotevera gadziriso yemifananidzo inosanganisirwa.

• Easy kushandisa kamera kirasi
• Powerful API to pco.sdk
• Kurekodha mufananidzo uye kugadzirisa ne pco.recorder

1.1 Kuiswa
Isa kubva kupypi (inokurudzirwa):
$ pip kuisa pco
1.2 Basic Kushandisa
import matplotlib.pyplot as plt
import pco
ne pco.Camera() secam:
cam.record()
mufananidzo, meta = cam.image()
plt.imshow(mufananidzo, cmap='grey')
Plt.show()1.3 Chiitiko uye Chikanganiso Kupinda
Kuti uvhure kuburitsa matanda, gadzira chinhu cheKamera chine debuglevel = parameter.
Iyo debug level inogona kusetwa kune imwe yeanotevera kukosha:

• 'off' Inodzima zvese zvinobuda.
• 'Error' Inongoratidza mameseji ekukanganisa.
• 'verbose' Inoratidza mameseji ese.
• 'extra verbose' Inoratidza mameseji ese uye kukosha.

Iyo default debuglevel ndeye 'off'.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: OK.
Nguva dzekusarudzaamp= parameter inomutsa a tag mune zvakadhindwa zvabuda. Zvingangove zvakakosha ndezvi: 'on' uye 'off'. Iko kukosha kweiyo 'off'.
pco.Kamera(debuglevel='verbose', timestamp='pa')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: OK.

API Documentation

Iyo pco.Camera kirasi inopa nzira dzinotevera:

• rekodhi () inogadzira, inogadzirisa, uye inotanga chiitiko chitsva chekurekodha.
• stop() inomisa kurekodha kwazvino.
• close () inovhara ikozvino inoshanda kamera uye inoburitsa zviwanikwa zvakagarwa.
• image () inodzorera mufananidzo kubva kune rekodhi se numpy array.
• images() inodzosa mifananidzo yese yakarekodhwa kubva kune rekodha serunyorwa rwe numpy arrays.
• image_average() inodzosa mufananidzo wakaenzana. Uyu mufananidzo unoverengerwa kubva kune ese akarekodhwa mifananidzo mubuffer.
• set_exposure_time() inoseta nguva yekuratidzwa kwekamera.
• wait_for_first_image () inomirira mufananidzo wekutanga unowanikwa mune rekodhi ndangariro.

Iyo pco.Camera kirasi ine zvinotevera shanduko:

• configuration

Iyo pco.Camera kirasi ine zvinotevera zvinhu:

• sdk inopa mukana wakananga kune ese ari pasi pemabasa eiyo pco.sdk.
• rekodha inopa mukana wakananga kune ese ari pasi pemabasa eiyo pco.recorder.

2.1 Nzira
Ichi chikamu chinotsanangura nzira dzese dzinopihwa neiyo pco.Camera kirasi.
2.1.1 Record
Tsanangudzo Inogadzira, inogadzirisa, uye inotanga chiitiko chitsva chekurekodha. Iyo yese gadziriso yekamera inofanirwa kusetwa isati yafona rekodhi (). Iyo set_exposure_time() command ndiyo yega inosarudzika. Iri basa harina mhedzisiro pane rekodha chinhu uye rinogona kushevedzwa panguva yekurekodha.
Prototype def rekodhi(pachako, nhamba_ye_images=1, modhi='kutevedzana'):
Parameter

Zita	Tsanangudzo
nhamba_ye_mifananidzo	Inoisa nhamba yemifananidzo yakagoverwa mumutyairi. Iyo RAM yePC inodzika iyo yakanyanya kukosha.
mode	Mu 'sequence' modhi, basa iri riri kuvharira panguva yekurekodha. Rekodha inomira yega kana nhamba_ye_images yasvikwa. Mu 'sequence non blocking' modhi, basa iri harivharidzi. Chimiro chinofanira kutariswa usati waverenga mufananidzo. Iyi modhi inoshandiswa kuverenga mifananidzo paunenge uchirekodha, semuenzaniso thumbnail. Mu 'ring buffer' mode basa iri harivharidziki. Chimiro chinofanira kutariswa usati waverenga mufananidzo. Rekodha haimise kurekodha kana nhamba_ye_images yasvikwa. Kana izvi zvaitika, mifananidzo yekare inonyorwa pamusoro. Mune 'fifo' modhi, basa iri harivharidziki. Chimiro chinofanira kutariswa usati waverenga mufananidzo. Kana nhamba_ye_images mufifo yasvikwa, mifananidzo inotevera inodonhedzwa kusvikira mifananidzo yaverengwa kubva kufifo.

2.1.2 Mira
Tsanangudzo Inomisa kurekodhwa kwazvino. Mu'ring buffer' uye 'fifo' modhi, basa iri rinofanirwa kudaidzwa nemushandisi. Mu 'sequence' uye 'sequence non blocking' modhi, basa iri rinodaidzwa otomatiki kana nhamba_ye_images yasvikwa.
Prototype def stop(self):
2.1.3 Vhara
Tsanangudzo Inovhara kamera yakavhurwa uye inoburitsa zvakavharika zviwanikwa. Iri basa rinofanirwa kudanwa application isati yamiswa. Zvikasadaro, zviwanikwa zvinoramba zvakabatikana.
Prototype def close(self):
Iri basa rinodaidzwa otomatiki kana chinhu chekamera chikagadzirwa neine chirevo. Kufona kwakajeka kuvhara () hakuchadiwi.
ne pco.Camera() secam: # ita zvimwe zvinhu
2.1.4 Mufananidzo
Tsanangudzo Inodzosa mufananidzo kubva kune rekodha. Mhando yemufananidzo ndeye numpy.ndarray. Iyi array yakaumbwa zvichienderana nekugadziriswa uye ROI yemufananidzo.
Prototype def mufananidzo(pachako, mufananidzo_nhamba=0, roi=Hapana):
Parameter

Zita	Tsanangudzo
mufananidzo_nhamba	Inotsanangura nhamba yemufananidzo uchaverengwa. Mu'kutevedzana' kana 'kutevedzana kusavharira' modhi, iyo rekodhi index inoenderana nemufananidzo_nhamba. Kana image_number ikaiswa kuti 0xFFFFFFFF, mufananidzo wekupedzisira wakarekodhwa unokopwa. Izvi zvinobvumira kugadzira live preview tichirekodha.
roi	Inoisa nzvimbo yaunofarira. Iyi chete nharaunda yemufananidzo inokopwa kune iyo yekudzoka kukosha.

Example >>> cam.record(nhamba_ye_images=1, modhi='kutevedzana')
>>> mufananidzo, meta = cam.image()
>>> type(mufananidzo) numpy.ndarray
>>> image.shape (2160, 2560)
>>> mufananidzo, metadata = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 Mifananidzo
Tsanangudzo Inodzosa mifananidzo yese yakarekodhwa kubva kune rekodha serunyorwa rwe numpy arrays.
Prototype def mifananidzo (yega, roi = Hapana, blocksize = Hapana):
Parameter

Zita	Tsanangudzo
roi	Inoisa nzvimbo yaunofarira. Iyi chete nharaunda yemufananidzo inokopwa kune iyo yekudzoka kukosha.
blocksize	Inotsanangura huwandu hwehuwandu hwemifananidzo inodzorerwa. Iyi parameter inongobatsira mu 'fifo' modhi uye pasi pemamiriro akakosha.

Example >>> cam.record(nhamba_ye_images=20, modhi='kutevedzana')
>>> mifananidzo, metadata = cam.images()
>>> len(mifananidzo) 20
>>> yemufananidzo mumifananidzo:
…
dhinda('Zvinoreva: {:7.2f} DN'.format(image.mean()))
…
Zvinoreva: 2147.64 DN
Zvinoreva: 2144.61 DN
…
>>> mifananidzo = cam.images(roi=(1, 1, 300, 300))
>>> mifananidzo[0].shape (300, 300)
2.1.6 mufananidzo_avhareji
Tsanangudzo Inodzosa mufananidzo wakaenzana. Uyu mufananidzo unoverengerwa kubva kune ese akarekodhwa mifananidzo mubuffer.
Prototype def image_average(self, roi=Hapana):
Parameter

Zita	Tsanangudzo
roi	Inotsanangura nharaunda yekufarira. Iyi chete nharaunda yemufananidzo inokopwa kune iyo yekudzoka kukosha.

Example >>> cam.record(nhamba_ye_images=100, modhi='kutevedzana')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Set_exposure_nguva
Tsanangudzo Inoseta nguva yekuratidzwa kwekamera.
Prototype def set_exposure_time(self, exposure_time):
Parameter

Zita	Tsanangudzo
nguva yekusadzivirirwa	Inofanirwa kupihwa seyayangarara kana kukosha zvachose muyuniti 'yechipiri'. Izvo zvakakosha zvebasa sdk.set_delay_exposure_time(0, 'ms', nguva, timebase) zvichaverengerwa zvoga. Nguva yekunonoka yakaiswa ku0.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Mirira_mufananidzo_wokutanga
Tsanangudzo Inomirira mufananidzo wekutanga unowanikwa mune rekodhi ndangariro. Mune rekodhi modhi 'kutevedzana kusavharira', 'ring buffer'. uye 'fifo', basa rekodhi () rinodzoka pakarepo. Naizvozvo, basa iri rinogona kushandiswa kumirira mifananidzo kubva kamera usati wafonera mufananidzo (), mifananidzo (), kana image_average ().
Prototype def wait_for_first_image(iwe):
2.2 Variable Configuration
Iyo kamera paramita inovandudzwa nekuchinja shanduko yekumisikidza.
cam.configuration = {'nguva yekuratidzwa': 10e-3,
'roi': (1, 1, 512, 512),
'nguvaamp': 'ascii',
'pixel rate': 100_000_000,
'trigger': 'auto sequence',
'kuwana': 'auto',
'metadata': 'pa',
'kuisa': (1, 1)}
Musiyano unogona kushandurwa chete rekodhi () basa risati ranzi. Iduramazwi rine nhamba yakati yezvinyorwa. Hazvisi zvese zvinogoneka zvinofanirwa kutsanangurwa. Inotevera sample kodhi inongoshandura iyo 'pixel chiyero' uye haina kukanganisa chero zvimwe zvinhu zvekugadzirisa.
ne pco.Camera() secam:
cam.configuration = {'pixel rate': 286_000_000}
cam.record()
…
2.3 Zvishandiso
Ichi chikamu chinotsanangura zvinhu zvese zvinopihwa neiyo pco.Camera kirasi.
2.3.1 SDK
Iyo chinhu sdk inobvumira kuwana kwakananga kune ese ari pasi pemabasa eiyo pco.sdk.
>>> cam.sdk.get_temperature()
{'sensor tembiricha': 7.0, 'tembiricha yekamera': 38.2, 'tembiricha yemagetsi': 36.7}
Ese madzoro akakosha kubva kusdk mabasa maduramazwi. Haasi ese magadzirirwo ekhamera parizvino akafukidzwa nekirasi yeKamera. Akakosha marongero anofanirwa kusetwa zvakananga nekufonera iyo yakafanira sdk basa.
2.3.2 Recorder
Chinhu rec chinopa mukana wakananga kune ese ari pasi pemabasa eiyo pco.recorder. Hazvina kudikanwa kudaidza nzira yekurekodha kirasi zvakananga. Mabasa ese akafukidzwa zvizere nenzira dzekirasi yeKamera.

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

pco 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

Zvinyorwa / Zvishandiso

EXCELITAS TECHNOLOGIES Python Software Development Kit [pdf] User Manual Python Software Development Kit, Software Development Kit, Development Kit, Kit

References

• User Manual