Kit Pangwangunan Software Python
Manual pamaké

Kit Pangwangunan Software Python

PCO miwarang anjeun maca taliti tur turutan parentah dina dokumen ieu.
Pikeun patalékan atanapi komentar, mangga ngarasa Luncat ngahubungan kami iraha wae.
telepon: +49 (0) 9441 2005 50
fax: +49 (0) 9441 2005 20
alamat pos: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Jérman
email: info@pco.de
web: www.pco.de
manual pamaké pco.python 0.1.7
Dileupaskeun Désémber 2021
©Hak Cipta Excelitas PCO GmbH
Karya ieu dilisensikeun ku Creative Commons Attribution-No Derivatives 4.0 International License. Ka view salinan lisénsi ieu, nganjang http://creativecommons.org/licenses/by-nd/4.0/ atawa ngirim surat ka Creative Commons, PO Box 1866, Gunung View, CA 94042, AS.

Umum

Paket Python pco nawarkeun sagala fungsi pikeun gawé bareng kaméra pco nu dumasar kana ayeuna pco.sdk. Sadaya perpustakaan anu dibagikeun pikeun komunikasi sareng kaméra sareng pamrosésan gambar salajengna kalebet.

• Gampang ngagunakeun kelas kaméra
• API kuat pikeun pco.sdk
• Ngarekam gambar jeung ngolah kalawan pco.recorder

1.1 Pamasangan
Pasang tina pypi (disarankeun):
$ pip install pco
1.2 Pamakéan Dasar
impor matplotlib.pyplot sakumaha plt
impor pco
kalawan pco.Camera () salaku cam:
cam.record()
gambar, meta = cam.image()
plt.imshow(gambar, cmap='abu')
plt.show()1.3 Kajadian jeung Kasalahan Logging
Pikeun ngaktipkeun kaluaran logging, jieun obyék Kamera kalayan parameter debuglevel=.
Tingkat debug tiasa disetel ka salah sahiji nilai ieu:

• 'pareum' Nonaktipkeun sadaya kaluaran.
• 'kasalahan' Témbongkeun ukur talatah kasalahan.
• 'verbose' Némbongkeun sakabéh pesen.
• 'ekstra verbose' Némbongkeun sakabéh pesen jeung nilai.

Debuglevel standar nyaéta 'pareum'.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: OKÉ.
Waktos pilihanamp= parameter aktip a tag dina kaluaran dicitak. Nilai anu mungkin nyaéta: 'on' sareng 'off'. Nilai standar nyaéta 'pareum'.
pco.Camera(debuglevel='verbose', timestamp= 'dina')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: OKÉ.

Dokuméntasi API

Kelas pco.Camera nawiskeun metodeu ieu:

• record () dibangkitkeun, ngonpigurasikeun, tur dimimitian hiji conto recorder anyar.
• eureun () ngeureunkeun rékaman ayeuna.
• nutup () nutup kaméra aktip ayeuna sarta ngaleupaskeun ressources nempatan.
• gambar () mulih hiji gambar ti recorder sakumaha Asép Sunandar Sunarya numpy.
• gambar () mulih kabeh gambar dirékam ti recorder salaku daptar arrays numpy.
• image_average () mulih gambar averaged. Gambar ieu diitung tina sadaya gambar anu dirékam dina panyangga.
• set_exposure_time () Nyetél waktos paparan pikeun kaméra.
• wait_for_first_image () ngantosan gambar sadia munggaran dina mémori recorder.

Kelas pco.Camera ngagaduhan variabel ieu:

• konfigurasi

Kelas pco.Camera ngagaduhan objék ieu:

• sdk nawarkeun wasa langsung ka sadaya fungsi dasar tina pco.sdk.
• recorder nawarkeun wasa langsung ka sadaya fungsi dasar tina pco.recorder.

2.1 Métode
bagian ieu ngajelaskeun sakabeh métode ditawarkeun ku kelas pco.Camera.
2.1.1 Rékam
Katerangan Nyiptakeun, ngonpigurasikeun, sareng ngamimitian conto perékam énggal. Sakabéh konfigurasi kaméra kudu diatur saméméh nelepon catetan (). Paréntah set_exposure_time () nyaéta hiji-hijina iwal. Pungsi ieu teu boga pangaruh dina obyék recorder sarta bisa disebut nepi salila ngarekam.
Prototipe catetan def (diri, jumlah_gambar = 1, mode = 'runtuyan'):
Parameter

Ngaran	Katerangan
jumlah_gambar	Nyetél jumlah gambar anu dialokasikeun dina supir. RAM tina PC ngawatesan nilai maksimum.
modus	Dina modeu 'runtuyan', pungsi ieu ngahalangan salila rékaman. Recorder eureun otomatis lamun number_of_images geus ngahontal. Dina modeu 'urutan non blocking', fungsi ieu non-blocking. Status kudu dipariksa saméméh maca hiji gambar. Modeu ieu dianggo pikeun maca gambar nalika ngarékam, contona, gambar leutik. Dina modeu 'ring panyangga' fungsi ieu non blocking. Status kudu dipariksa saméméh maca hiji gambar. Recorder henteu ngeureunkeun ngarékam nalika jumlah_gambarna ngahontal. Sakali ieu kajadian, gambar pangkolotna bakal overwritten. Dina modeu 'fifo', fungsi ieu non-blocking. Status kudu dipariksa saméméh maca hiji gambar. Nalika jumlah_gambar dina fifo ngahontal, gambar di handap ieu turun dugi gambar dibaca tina fifo.

2.1.2 Eureun
Katerangan Ngeureunkeun rékaman ayeuna. Dina modeu 'ring panyangga' sarta 'fifo', fungsi ieu kudu disebut ku pamaké. Dina modeu 'runtuyan' jeung 'runtuyan non blocking', fungsi ieu otomatis disebut up nalika number_of_images geus ngahontal.
Prototipe def eureun (diri):
2.1.3 Tutup
Katerangan Nutup kaméra anu diaktipkeun sareng ngaleupaskeun sumber daya anu diblokir. Pungsi ieu kedah disauran sateuacan aplikasina dileungitkeun. Upami teu kitu, sumberdaya tetep dijajah.
Prototipe def nutup (diri):
Pungsi ieu disebut otomatis lamun obyék kaméra dijieun ku pernyataan kalawan. Telepon eksplisit pikeun nutup () geus euweuh perlu.
kalawan pco.Camera () sakumaha Cam: # ngalakukeun sababaraha barang
2.1.4 Gambar
Katerangan Mulih hiji gambar ti recorder nu. Jinis gambar mangrupa numpy.ndarray. Asép Sunandar Sunarya ieu bentukna gumantung kana resolusi sareng ROI gambar.
Prototipe gambar def(diri, angka_gambar=0, roi=Euweuh):
Parameter

Ngaran	Katerangan
gambar_number	Nangtukeun jumlah gambar anu bakal dibaca. Dina modeu 'urutan' atawa 'urutan non blocking', indéks recorder cocog image_number. Lamun image_number disetel ka 0xFFFFFFFF, gambar dirékam panungtungan bakal disalin. Ieu ngamungkinkeun pikeun nyieun pre liveview bari ngarekam.
roi	Nyetél wewengkon dipikaresep. Ngan wewengkon gambar ieu disalin kana nilai balik.

Example >>> cam.record(jumlah_gambar=1, mode='runtuyan')
>>> gambar, meta = cam.image()
>>> tipe(gambar) numpy.ndarray
>>> image.shape (2160, 2560)
>>> gambar, metadata = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 Gambar
Katerangan Mulih sadaya gambar anu dirékam tina parékam salaku daptar susunan numpy.
Prototipe gambar def (diri, roi = Euweuh, ukuran blok = Euweuh):
Parameter

Ngaran	Katerangan
roi	Nyetél wewengkon dipikaresep. Ngan wewengkon gambar ieu disalin kana nilai balik.
ukuran blok	Nangtukeun jumlah maksimum gambar nu balik. Parameter ieu ngan ukur kapaké dina modeu 'fifo' sareng dina kaayaan khusus.

Example >>> cam.record(jumlah_gambar=20, mode='runtuyan')
>>> gambar, metadata = cam.images()
>>> len(gambar) 20
>>> pikeun gambar dina gambar:
…
print ('Hartina: {: 7.2f} DN'.format(gambar.mean()))
…
Hartosna: 2147.64 DN
Hartosna: 2144.61 DN
…
>>> gambar = cam.images(roi=(1, 1, 300, 300))
>>> gambar[0].bentuk (300, 300)
2.1.6 Gambar_rata
Katerangan Mulihkeun gambar rata-rata. Gambar ieu diitung tina sadaya gambar anu dirékam dina panyangga.
Prototipe def image_average(self, roi=Euweuh):
Parameter

Ngaran	Katerangan
roi	Nangtukeun wewengkon dipikaresep. Ngan wewengkon gambar ieu disalin kana nilai balik.

Example >>> cam.record(jumlah_gambar=100, mode='runtuyan')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Set_exposure_time
Katerangan Nyetél waktos paparan kaméra.
Prototipe def set_exposure_time (diri, exposure_time):
Parameter

Ngaran	Katerangan
waktos kakeunaan	Kedah dipasihkeun salaku nilai ngambang atanapi integer dina unit 'detik'. Nilai dasar pikeun fungsi sdk.set_delay_exposure_time (0, 'ms', waktu, timebase) bakal diitung otomatis. Waktu reureuh disetel ka 0.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Wait_for_first_image
Katerangan Ngadagoan gambar munggaran sadia dina mémori recorder. Dina modeu recorder 'runtuyan non blocking', 'ring panyangga'. jeung 'fifo', rékaman fungsi () mulih geuwat. Ku alatan éta, fungsi ieu bisa dipaké pikeun ngadagoan gambar ti kaméra saméméh nelepon gambar (), gambar (), atanapi image_average ().
Prototipe def wait_for_first_image(self):
2.2 Konfigurasi Variabel
Parameter kaméra diropéa ku cara ngarobah variabel konfigurasi.
cam.configuration = { 'waktu paparan': 10e-3,
'roi': (1, 1, 512, 512),
'waktosamp': 'ascii',
'Laju piksel': 100_000_000,
'pemicu': 'urutan otomatis',
'meunang': 'otomatis',
'metadata': 'on',
'binning': (1, 1)}
Variabel ngan bisa dirobah saméméh fungsi catetan () disebut. Éta mangrupikeun kamus anu gaduh sababaraha éntri. Henteu sakabéh elemen mungkin perlu dieusian. Di handap ieu sampkode le ngan ngarobah 'rate piksel' sarta henteu mangaruhan sagala elemen séjén konfigurasi nu.
kalawan pco.Camera () salaku cam:
cam.configuration = {'rate pixel': 286_000_000}
cam.record()
…
2.3 Objék
bagian ieu ngajelaskeun sakabeh objék ditawarkeun ku kelas pco.Camera.
2.3.1 SDK
Objek sdk ngamungkinkeun aksés langsung ka sadaya fungsi dasar tina pco.sdk.
>>> cam.sdk.get_temperature()
{ 'suhu sensor': 7.0, 'suhu kaméra': 38.2, 'suhu kakuatan': 36.7}
Sadaya nilai mulang tina fungsi sdk mangrupikeun kamus. Henteu sakabéh setélan kaméra ayeuna katutupan ku kelas Kamera. Setelan husus kudu disetel langsung ku nelepon fungsi sdk masing-masing.
2.3.2 Rékam
Obyék rec nawarkeun wasa langsung ka sadaya fungsi dasar tina pco.recorder. Teu perlu nelepon metoda kelas recorder langsung. Sadaya fungsi katutupan ku metodeu kelas kaméra.

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

pco Éropa +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 cina +86 512 67634643 info@pco.cn pco.cn

Dokumén / Sumberdaya

EXCELITAS TECHNOLOGIES Python Software Development Kit [pdf] Manual pamaké Kit Pangwangunan Software Python, Kit Pangwangunan Software, Kit Pangwangunan, Kit

Rujukan

• Manual pamaké