EXCELITAS TECHNOLOGIES logotipoaEXCELITAS TECHNOLOGIES logotipoa 1Python Software Garapenerako Kita
Erabiltzailearen eskuliburuaEXCELITAS TECHNOLOGIES Python Software Garapenerako KitaEXCELITAS TECHNOLOGIES logotipoa 2

Python Software Garapenerako Kita

PCOk dokumentu honetako argibideak arretaz irakurtzeko eta jarraitzeko eskatzen dizu.
Edozein galdera edo iruzkinetarako, jar zaitez gurekin harremanetan edozein unetan.
telefonoa: +49 (0) 9441 2005 50
Faxa: +49 (0) 9441 2005 20
Posta helbidea: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Alemania
posta elektronikoa: info@pco.de
web: www.pco.de
pco.python erabiltzailearen eskuliburua 0.1.7
2021eko abenduan kaleratua
©Copyright Excelitas PCO GmbH
EXCELITAS TECHNOLOGIES Python Software Garapenerako Kita - ikonoa 1Lan hau Creative Commons Aitortu-Eratorririk gabe 4.0 Nazioarteko Lizentziapean dago. To view lizentzia honen kopia bat, bisitatu http://creativecommons.org/licenses/by-nd/4.0/ edo bidali gutun bat Creative Commons helbidera, PO Box 1866, Mountain View, CA 94042, AEB.

Orokorra

Python pakete pco-k unean oinarritzen diren pco kamerekin lan egiteko funtzio guztiak eskaintzen ditu pco.sdk. Kamerarekin komunikatzeko eta ondorengo irudiak prozesatzeko partekatutako liburutegi guztiak sartzen dira.

  • Kamera klasea erabiltzeko erraza
  • API indartsua pco.sdk
  • Irudiak grabatzea eta prozesatzearekin pco.grabagailua

1.1 Instalazioa
Instalatu pypi-tik (gomendatua):
$ pip install pco
1.2 Oinarrizko erabilera
inportatu matplotlib.pyplot plt gisa
inportatu pco
pco.Camera() kamera gisa:
cam.record()
irudia, meta = cam.image()
plt.imshow(irudia, cmap='grisa')
plt.show()EXCELITAS TECHNOLOGIES Python Software Garapenerako Kit - Oinarrizko Erabilera1.3 Gertaerak eta erroreen erregistroa
Erregistroko irteera aktibatzeko, sortu Kamera objektua debuglevel= parametroarekin.
Arazte-maila balio hauetako batean ezar daiteke:

  • 'off' Irteera guztiak desgaitzen ditu.
  • 'error' Errore-mezuak bakarrik erakusten ditu.
  • ' hitzezkoa ' Mezu guztiak erakusten ditu.
  • 'extra verbose' Mezu eta balio guztiak erakusten ditu.

Arazte-maila lehenetsia 'desaktibatuta' da.
pco.Camera(debuglevel='ahozkoa')

[[][sdk] get_camera_type: Ados.
Aukerako denboraamp= parametroak a aktibatzen du tag inprimatutako irteeran. Balio posibleak hauek dira: 'on' eta 'off'. Balio lehenetsia 'desaktibatuta' da.
pco.Camera(debuglevel='ahozkoa', aldizamp='on')

[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: Ados.

API dokumentazioa

pco.Camera klaseak metodo hauek eskaintzen ditu:

  • record() grabagailu-instantzia berri bat sortu, konfiguratu eta abiarazten du.
  • stop() uneko grabazioa geldiarazten du.
  • close() uneko kamera aktiboa ixten du eta okupatutako baliabideak askatzen ditu.
  • image() grabagailutik irudi bat itzultzen du numpy array gisa.
  • images() grabagailutik grabatutako irudi guztiak zenbakizko matrizeen zerrenda gisa itzultzen ditu.
  • image_average() batez besteko irudia itzultzen du. Irudi hau bufferean grabatutako irudi guztietatik kalkulatzen da.
  • set_exposure_time() kameraren esposizio-denbora ezartzen du.
  • wait_for_first_image() grabagailuaren memorian eskuragarri dagoen lehen irudiaren zain dago.

pco.Camera klaseak aldagai hau du:

  • konfigurazioa

pco.Camera klaseak objektu hauek ditu:

  • sdk-k azpiko funtzio guztietarako sarbide zuzena eskaintzen du pco.sdk.
  • grabagailuaren azpiko funtzio guztietarako sarbide zuzena eskaintzen du pco.grabagailua.

2.1 Metodoak
Atal honek pco.Camera klaseak eskaintzen dituen metodo guztiak deskribatzen ditu.
2.1.1 Erregistroa
Deskribapena Grabagailuaren instantzia berri bat sortu, konfiguratu eta abiarazten du. Kameraren konfigurazio osoa ezarri behar da record(era) deitu aurretik. set_exposure_time() komandoa da salbuespen bakarra. Funtzio honek ez du eraginik grabagailuaren objektuan eta grabazioan zehar dei daiteke.
Prototipoa def record(norbera, irudi_kopurua=1, modua='sekuentzia'):
Parametroa

Izena Deskribapena
irudi_kopurua Gidatzailean esleitutako irudi kopurua ezartzen du. PCaren RAMak gehienezko balioa mugatzen du.
modua 'Sekuentzia' moduan, funtzio hau blokeatzen ari da grabatzean. Grabagailua automatikoki gelditzen da irudi_kopurura iristen denean. 'Sekuentzia ez blokeatzeko' moduan, funtzio hau ez da blokeatzen. Irudi bat irakurri aurretik egoera egiaztatu behar da. Modu hau grabatzen ari diren bitartean irudiak irakurtzeko erabiltzen da, adibidez, miniatura.
Eraztun-buffer moduan funtzio hau ez da blokeatzen. Irudi bat irakurri aurretik egoera egiaztatu behar da. Grabagailuak ez du grabaketa gelditzen irudi_kopurura iristen denean. Hori gertatzen denean, irudi zaharrenak gainidazten dira.
'Fifo' moduan, funtzio hau ez da blokeatzen. Irudi bat irakurri aurretik egoera egiaztatu behar da. Fifoan_irudi_kopurura iristen denean, hurrengo irudiak botatzen dira fifotik irudiak irakurri arte.

2.1.2 Gelditu
Deskribapena Uneko grabazioa geldiarazten du. 'Ring buffer' eta 'fifo' moduan, funtzio hau erabiltzaileak deitu behar du. 'Sekuentzia' eta 'Sekuentzia ez blokeatzeko' moduan, funtzio hau automatikoki deitzen da irudi_kopurura iristen denean.
Prototipoa def stop(auto):
2.1.3 Itxi
Deskribapena Aktibatutako kamera ixten du eta blokeatutako baliabideak askatzen ditu. Funtzio hau aplikazioa amaitu baino lehen deitu behar da. Bestela, baliabideak okupatuta geratzen dira.
Prototipoa def close(self):
Funtzio hau automatikoki deitzen da kameraren objektua with adierazpenak sortzen badu. Jada ez da beharrezkoa itxi() dei esplizitua.
pco.Camera() kamera gisa: # egin gauza batzuk
2.1.4 Irudia
Deskribapena Grabagailutik irudi bat itzultzen du. Irudiaren mota numpy.ndarray bat da. Array hau irudiaren bereizmenaren eta ROIaren arabera moldatzen da.
Prototipoa def irudia (norberaren burua, irudi_zenbakia=0, roi=Inor ez):
Parametroa

Izena Deskribapena
irudi_zenbakia Irakurri beharreko irudiaren zenbakia zehazten du. 'Sekuentzia' edo 'sekuentzia ez blokeatzeko' moduan, grabagailuaren indizea irudi_zenbakiarekin bat dator. Irudi_zenbakia 0xFFFFFFFF gisa ezartzen bada, grabatutako azken irudia kopiatzen da. Honek zuzeneko pre-a sortzeko aukera ematen duview grabatzean.
roi Intereseko eskualdea ezartzen du. Irudiaren eskualde hau bakarrik kopiatzen da itzulerako baliora.

Example >>> cam.record(irudi_kopurua=1, modua='sekuentzia')
>>> irudia, meta = cam.image()
>>> type(image) numpy.ndarray
>>> irudia.forma (2160, 2560)
>>> irudia, metadatuak = cam.image(roi=(1, 1, 300, 300))
>>> irudia.forma (300, 300)
2.1.5 Irudiak
Deskribapena Grabagailutik grabatutako irudi guztiak zenbakizko matrizeen zerrenda gisa itzultzen ditu.
Prototipoa def irudiak (self, roi=None, blocksize=None):
Parametroa

Izena Deskribapena
roi Intereseko eskualdea ezartzen du. Irudiaren eskualde hau bakarrik kopiatzen da itzulerako baliora.
bloke-tamaina Itzulitako irudi kopuru maximoa zehazten du. Parametro hau 'fifo' moduan eta baldintza berezietan baino ez da erabilgarria.

Example >>> cam.record(irudi_kopurua=20, modua='sekuentzia')
>>> irudiak, metadatuak = cam.images()
>>> len(irudiak) 20
>>> irudietako irudietarako:

inprimatu('Esan nahi: {:7.2f} DN'.format(image.mean()))

Batez bestekoa: 2147.64 DN
Batez bestekoa: 2144.61 DN

>>> irudiak = cam.images(roi=(1, 1, 300, 300))
>>> irudiak[0].forma (300, 300)
2.1.6 Irudia_batez bestekoa
Deskribapena Batez besteko irudia ematen du. Irudi hau bufferean grabatutako irudi guztietatik kalkulatzen da.
Prototipoa def irudia_batez bestekoa(norberaren burua, roi=Inor ez):
Parametroa

Izena Deskribapena
roi Intereseko eskualdea zehazten du. Irudiaren eskualde hau bakarrik kopiatzen da itzulerako baliora.

Example >>> cam.record(irudi_kopurua=100, modua='sekuentzia')
>>> bataz bestekoa = cam.image_average()
>>> bataz bestekoa = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Ezarri_esposizio_denbora
Deskribapena Kameraren esposizio-denbora ezartzen du.
Prototipoa def set_exposure_time(auto, esposizio_denbora):
Parametroa

Izena Deskribapena
esposizio-denbora "segundo" unitatean balio flotatzaile edo oso gisa eman behar da. sdk.set_delay_exposure_time(0, 'ms', time, timebase) funtzioaren azpiko balioak automatikoki kalkulatuko dira. Atzerapen-denbora 0-n ezarri da.

Example >>> cam.set_exposure_time (0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Lehen_irudiaren_itxaron
Deskribapena Grabagailuaren memorian eskuragarri dagoen lehen irudiaren zain dago. Grabagailu moduan 'sekuentzia ez blokeatzen', 'ring buffer'. eta 'fifo', funtzio record() berehala itzultzen da. Hori dela eta, funtzio hau kamerako irudien zain egoteko erabil daiteke image(), images() edo image_average() deitu aurretik.
Prototipoa def wait_for_first_image(norberaren burua):
2.2 Aldagaien konfigurazioa
Kameraren parametroak konfigurazio aldagaia aldatuz eguneratzen dira.
cam.configuration = {'esposizio-denbora': 10e-3,
'roi': (1, 1, 512, 512),
'denboraamp': 'ascii',
'pixel-tasa': 100_000_000,
'trigger': 'sekuentzia automatikoa',
'eskuratu': 'automatikoki',
'metadatuak': 'aktibatuta',
'binning': (1, 1)}
Record() funtzioa deitu baino lehen alda daiteke aldagaia. Sarrera kopuru jakin bat duen hiztegia da. Ez dira posible diren elementu guztiak zehaztu behar. Hurrengo sampLe-kodeak 'pixel-tasa' soilik aldatzen du eta ez du konfigurazioko beste elementurik eragiten.
pco.Camera() kamera gisa:
cam.configuration = {'pixel-tasa': 286_000_000}
cam.record()

2.3 objektu
Atal honek pco.Camera klaseak eskaintzen dituen objektu guztiak deskribatzen ditu.
2.3.1 SDK
Objektu SDK-k zuzeneko sarbidea ahalbidetzen du azpiko funtzio guztietara pco.sdk.
>>> cam.sdk.get_temperature()
{'sentsorearen tenperatura': 7.0, 'kameraren tenperatura': 38.2, 'potentzia tenperatura': 36.7}
SDk funtzioen itzulera-balio guztiak hiztegiak dira. Momentu honetan kameraren ezarpen guztiak ez ditu Kamera klaseak estaltzen. Ezarpen bereziak zuzenean ezarri behar dira dagokion sdk funtziora deituz.
2.3.2 Grabagailua
Rec objektuak zuzeneko sarbidea eskaintzen du azpiko funtzio guztietarako pco.grabagailua. Ez da beharrezkoa grabagailu klase metodo bati zuzenean deitzea. Funtzio guztiak Kamera klaseko metodoek guztiz estaltzen dituzte.

EXCELITAS TECHNOLOGIES Python Software Garapenerako Kit - QR cotehttps://www.pco.de/applications/

pco europa
+49 9441 2005 50
info@pco.de
pco.de
pco Amerika
+1 866 678 4566
info@pco-tech.com
pco-tech.com
pco asia
+65 6549 7054
info@pco-imaging.com
pco-imaging.com
pco txina
+86 512 67634643
info@pco.cn
pco.cn

EXCELITAS TECHNOLOGIES logotipoaEXCELITAS TECHNOLOGIES logotipoa 1

Dokumentuak / Baliabideak

EXCELITAS TECHNOLOGIES Python Software Garapenerako Kita [pdfErabiltzailearen eskuliburua
Python Software Garapen Kit, Software Garapen Kit, Garapen Kit, Kit

Erreferentziak

Utzi iruzkin bat

Zure helbide elektronikoa ez da argitaratuko. Beharrezko eremuak markatuta daude *