Pythoni tarkvaraarenduskomplekt
Kasutusjuhend

Pythoni tarkvaraarenduskomplekt

PCO palub teil selles dokumendis olevad juhised hoolikalt läbi lugeda ja järgida.
Küsimuste või kommentaaride korral võtke meiega igal ajal ühendust.
telefon: +49 (0) 9441 2005 50
faks: +49 (0) 9441 2005 20
postiaadress: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Saksamaa
email: info@pco.de
web: www.pco.de
pco.python kasutusjuhend 0.1.7
Välja antud detsembris 2021
©Autoriõigus Excelitas PCO GmbH
See teos on litsentsitud rahvusvahelise litsentsi Creative Commons Attribution-No Derivatives 4.0 alusel. To view selle litsentsi koopia, külastage http://creativecommons.org/licenses/by-nd/4.0/ või saatke kiri aadressile Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Kindral

Pythoni pakett pco pakub kõiki funktsioone pco kaameratega töötamiseks, mis põhinevad voolul pco.sdk. Kaasatud on kõik jagatud teegid kaameraga suhtlemiseks ja sellele järgnevaks pilditöötluseks.

• Lihtne kasutada kaameraklass
• Võimas API pco.sdk
• Pildi salvestamine ja töötlemine pco.recorder

1.1 Paigaldamine
Installige pypi-st (soovitatav):
$ pip installi PC
1.2 Põhikasutus
importige matplotlib.pyplot kui plt
import pco
pco.Camera() kaamerana:
cam.record()
pilt, meta = cam.image()
plt.imshow(image, cmap='grey')
plt.show()1.3 Sündmuste ja vigade logimine
Logiväljundi aktiveerimiseks loo kaamera objekt parameetriga debuglevel=.
Silumistasemeks saab määrata ühe järgmistest väärtustest.

• 'väljas' Keelab kogu väljundi.
• 'error' Näitab ainult veateateid.
• 'sõnaline' Näitab kõiki sõnumeid.
• 'Extra verbose' Näitab kõiki sõnumeid ja väärtusi.

Vaikimisi silumise tase on "väljas".
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: OK.
Valikuline aegamp= parameeter aktiveerib a tag trükitud väljundis. Võimalikud väärtused on: "on" ja "off". Vaikeväärtus on 'off'.
pco.Camera(debuglevel='verbose', timestamp='sees')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: OK.

API dokumentatsioon

Klass pco.Camera pakub järgmisi meetodeid:

• record() genereerib, konfigureerib ja käivitab uue salvesti eksemplari.
• stop() peatab käimasoleva salvestuse.
• close() sulgeb aktiivse kaamera ja vabastab hõivatud ressursid.
• image() tagastab pildi salvestajast numpy massiivina.
• images() tagastab kõik salvestist salvestatud pildid numpide massiivide loendina.
• image_average() tagastab keskmise pildi. See pilt arvutatakse kõigi puhvris salvestatud piltide põhjal.
• set_exposure_time() määrab kaamera säritusaja.
• wait_for_first_image() ootab esimest saadaolevat pilti salvesti mälus.

Klassil pco.Camera on järgmine muutuja:

• konfiguratsiooni

Klassil pco.Camera on järgmised objektid:

• sdk pakub otsest juurdepääsu kõigile selle aluseks olevatele funktsioonidele pco.sdk.
• salvesti pakub otsest juurdepääsu kõigile selle põhifunktsioonidele pco.recorder.

2.1 Meetodid
See jaotis kirjeldab kõiki pco.Camera klassi pakutavaid meetodeid.
2.1.1 Salvestus
Kirjeldus Loob, konfigureerib ja käivitab uue salvesti eksemplari. Enne record() kutsumist tuleb seadistada kogu kaamera konfiguratsioon. Käsk set_exposure_time() on ainus erand. See funktsioon ei mõjuta salvestaja objekti ja seda saab salvestamise ajal välja kutsuda.
Prototüüp def record(self, number_of_images=1, mode='sequence'):
Parameeter

Nimi	Kirjeldus
piltide_arv	Määrab draiveris eraldatud piltide arvu. Arvuti RAM piirab maksimaalset väärtust.
režiimis	Jadarežiimis blokeerib see funktsioon salvestamise ajal. Salvesti seiskub automaatselt, kui piltide_arv on saavutatud. Režiimis "Sequence non blocking" on see funktsioon mitteblokeeriv. Enne pildi lugemist tuleb olekut kontrollida. Seda režiimi kasutatakse piltide (nt pisipiltide) lugemiseks salvestamise ajal. "Helisemispuhvri" režiimis on see funktsioon mitteblokeeriv. Enne pildi lugemist tuleb olekut kontrollida. Salvesti ei peata salvestamist, kui piltide_arv on saavutatud. Kui see juhtub, kirjutatakse vanimad pildid üle. 'fifo' režiimis on see funktsioon mitteblokeeriv. Enne pildi lugemist tuleb olekut kontrollida. Kui fifos piltide_arv on saavutatud, jäetakse järgmised pildid maha, kuni fifost pilte loetakse.

2.1.2 Peatus
Kirjeldus Peatab käimasoleva salvestuse. Režiimis "Helin puhver" ja "fifo" peab selle funktsiooni kutsuma kasutaja. Režiimis "Sequence" ja "Sequence non blocking" kutsutakse see funktsioon automaatselt välja, kui piltide_arv on saavutatud.
Prototüüp def stop (ise):
2.1.3 Sulgege
Kirjeldus Sulgeb aktiveeritud kaamera ja vabastab blokeeritud ressursid. See funktsioon tuleb enne rakenduse sulgemist välja kutsuda. Vastasel juhul jäävad ressursid hõivatuks.
Prototüüp def close (ise):
Seda funktsiooni kutsutakse automaatselt välja, kui kaameraobjekt on loodud käsuga with. Selgesõnaline sulgemiskutse () pole enam vajalik.
koos pco.Camera() kaamerana: # tee asju
2.1.4 Pilt
Kirjeldus Tagastab pildi salvestist. Kujutise tüüp on numpy.ndarray. See massiiv on kujundatud sõltuvalt pildi eraldusvõimest ja ROI-st.
Prototüüp def image(self, image_number=0, roi=None):
Parameeter

Nimi	Kirjeldus
pildi_number	Määrab loetava pildi numbri. Režiimis 'Sequence' või 'Sequence non blocking' kattub salvesti indeks pildi_numbriga. Kui pildi_number on seatud väärtusele 0xFFFFFFFF, kopeeritakse viimane salvestatud pilt. See võimaldab luua otseülekandeview salvestamise ajal.
roi	Määrab huvipakkuva piirkonna. Tagastusväärtuseks kopeeritakse ainult see pildi piirkond.

Example >>> cam.record(piltide_arv=1, mode='sequence')
>>> pilt, meta = cam.image()
>>> tüüp(pilt) numpy.ndarray
>>> image.shape (2160, 2560)
>>> pilt, metaandmed = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 XNUMX pilti
Kirjeldus Tagastab kõik diktofonist salvestatud pildid umbsete massiivide loendina.
Prototüüp def images (self, roi=puudub, blocksize=puudub):
Parameeter

Nimi	Kirjeldus
roi	Määrab huvipakkuva piirkonna. Tagastusväärtuseks kopeeritakse ainult see pildi piirkond.
ploki suurus	Määrab tagastatavate piltide maksimaalse arvu. See parameeter on kasulik ainult 'fifo' režiimis ja eritingimustel.

Example >>> cam.record(piltide_arv=20, mode='sequence')
>>> pildid, metaandmed = cam.images()
>>> len(pildid) 20
>>> piltide puhul:
…
print('Mean: {:7.2f} DN'.format(image.mean()))
…
Keskmine: 2147.64 DN
Keskmine: 2144.61 DN
…
>>> pildid = cam.images(roi=(1, 1, 300, 300))
>>> images[0].shape (300, 300)
2.1.6 Pildi_keskmine
Kirjeldus Tagastab keskmistatud pildi. See pilt arvutatakse kõigi puhvris salvestatud piltide põhjal.
Prototüüp def image_average(self, roi=None):
Parameeter

Nimi	Kirjeldus
roi	Määratleb huvipakkuva piirkonna. Tagastusväärtuseks kopeeritakse ainult see pildi piirkond.

Example >>> cam.record(piltide_arv=100, mode='sequence')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Set_exposure_time
Kirjeldus Määrab kaamera säriaja.
Prototüüp def set_exposure_time(self,exposure_time):
Parameeter

Nimi	Kirjeldus
kokkupuute aeg	Tuleb anda ujuv- või täisarvuna ühikus "sekund". Funktsiooni sdk.set_delay_exposure_time(0, 'ms', time, timebase) aluseks olevad väärtused arvutatakse automaatselt. Viivitusaeg on seatud 0-le.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Oodake_esimest_pilti
Kirjeldus Ootab esimest saadaolevat pilti salvesti mälus. Salvestusrežiimis 'järjestus ei blokeeri', 'helina puhver'. ja 'fifo', tagastab funktsioon record() kohe. Seetõttu saab seda funktsiooni kasutada kaamerast piltide ootamiseks, enne kui kutsute välja parameetrid image(), images() või image_average().
Prototüüp def wait_for_first_image(self):
2.2 Muutuja konfiguratsioon
Kaamera parameetreid värskendatakse konfiguratsioonimuutuja muutmisega.
cam.configuration = {'säriaeg': 10e-3,
"roi": (1, 1, 512, 512),
'timestamp': 'ascii',
'pikslite määr': 100_000_000,
'trigger': 'automaatne järjestus',
'acquire': 'auto',
'metadata': 'sees',
'binning': (1, 1)}
Muutujat saab muuta ainult enne funktsiooni record() kutsumist. See on teatud arvu kirjetega sõnastik. Kõiki võimalikke elemente pole vaja täpsustada. Järgmised sample kood muudab ainult 'pikslite kiirust' ega mõjuta muid konfiguratsiooni elemente.
pco.Camera() kaamerana:
cam.configuration = {'pikslite sagedus': 286_000_000}
cam.record()
…
2.3 objektid
See jaotis kirjeldab kõiki pco.Camera klassi pakutavaid objekte.
2.3.1 SDK
Objekt sdk võimaldab otsejuurdepääsu kõikidele põhifunktsioonidele pco.sdk.
>>> cam.sdk.get_temperature()
{'anduri temperatuur': 7.0, 'kaamera temperatuur': 38.2, 'võimsuse temperatuur': 36.7}
Kõik sdk funktsioonide tagastusväärtused on sõnastikud. Kaamera klass ei hõlma praegu kõiki kaamera sätteid. Erisätted tuleb määrata otse vastava sdk funktsiooni kutsumisega.
2.3.2 Salvesti
Objekti rec pakub otsest juurdepääsu kõikidele põhifunktsioonidele pco.recorder. Salvesti klassi meetodit pole vaja otse välja kutsuda. Kõik funktsioonid on täielikult kaetud kaameraklassi meetoditega.

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

pco euroopa +49 9441 2005 50 info@pco.de pco.de

pco ameerika +1 866 678 4566 info@pco-tech.com pco-tech.com

pco Aasia +65 6549 7054 info@pco-imaging.com pco-imaging.com

pco Hiina +86 512 67634643 info@pco.cn pco.cn

Dokumendid / Ressursid

EXCELITAS TECHNOLOGIES Pythoni tarkvaraarenduskomplekt [pdfKasutusjuhend Pythoni tarkvaraarenduskomplekt, tarkvaraarenduskomplekt, arenduskomplekt, komplekt

Viited

• Kasutusjuhend