Python Software Development Kit
Manwal sa Gumagamit

Python Software Development Kit

Gihangyo ka sa PCO nga basahon og maayo ug sundon ang mga instruksyon niini nga dokumento.
Alang sa bisan unsang mga pangutana o komento, palihug ayaw pagduhaduha sa pagkontak kanamo bisan unsang orasa.
telepono: +49 (0) 9441 2005 50
fax: +49 (0) 9441 2005 20
adres sa koreyo: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germany
email: info@pco.de
web: www.pco.de
manwal sa paggamit sa pco.python 0.1.7
Gipagawas Disyembre 2021
©Copyright Excelitas PCO GmbH
Kini nga trabaho lisensyado ubos sa Creative Commons Attribution-No Derivatives 4.0 International License. Sa view usa ka kopya niini nga lisensya, bisitaha http://creativecommons.org/licenses/by-nd/4.0/ o magpadala ug sulat sa Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Heneral

Ang Python package pco nagtanyag sa tanan nga mga gimbuhaton alang sa pagtrabaho sa mga pco camera nga gibase sa kasamtangan pco.sdk. Ang tanan nga gipaambit nga mga librarya alang sa komunikasyon sa camera ug ang sunod nga pagproseso sa imahe gilakip.

• Sayon nga gamiton ang klase sa camera
• Gamhanan nga API sa pco.sdk
• Pagrekord ug pagproseso sa imahe gamit ang pco.recorder

1.1 Pag-instalar
Pag-instalar gikan sa pypi (girekomendar):
$ pip instalar pco
1.2 Batakang Paggamit
import matplotlib.pyplot isip plt
import pco
uban sa pco.Camera() isip cam:
cam.record()
hulagway, meta = cam.image()
plt.imshow(larawan, cmap='gray')
plt.show()1.3 Panghitabo ug Pag-log sa Sayop
Aron ma-activate ang logging output, paghimo sa Camera object gamit ang debuglevel= parameter.
Ang lebel sa debug mahimong itakda sa usa sa mosunod nga mga kantidad:

• 'off' Gi-disable ang tanan nga output.
• 'error' Nagpakita lamang sa mga mensahe sa sayop.
• 'verbose' Nagpakita sa tanang mensahe.
• 'extra verbose' Nagpakita sa tanang mensahe ug mithi.

Ang default debuglevel kay 'off'.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: OK.
Ang opsyonal nga orasamp= parametro gipalihok a tag sa giimprinta nga output. Ang posible nga mga kantidad mao ang: 'on' ug 'off'. Ang default value kay 'off'.
pco.Camera(debuglevel='verbose', timestamp= 'on')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: OK.

Dokumentasyon sa API

Ang klase sa pco.Camera nagtanyag sa mosunod nga mga pamaagi:

• record() nagmugna, nag-configure, ug nagsugod sa usa ka bag-ong kaso sa recorder.
• stop() mohunong sa kasamtangan nga pagrekord.
• close() nagsira sa kasamtangan nga aktibo nga kamera ug nagpagawas sa gi-okupar nga mga kapanguhaan.
• image() mibalik og hulagway gikan sa recorder isip numpy array.
• images() ibalik ang tanang narekord nga mga hulagway gikan sa recorder isip listahan sa numpy arrays.
• image_average() mibalik sa aberids nga hulagway. Kini nga hulagway gikalkulo gikan sa tanang narekord nga mga hulagway sa buffer.
• set_exposure_time() nagtakda sa oras sa exposure para sa camera.
• wait_for_first_image() naghulat sa unang anaa nga hulagway sa memorya sa recorder.

Ang klase sa pco.Camera adunay mosunod nga variable:

• configuration

Ang klase sa pco.Camera adunay mga musunud nga butang:

• Ang sdk nagtanyag direkta nga pag-access sa tanan nga nagpahiping mga gimbuhaton sa pco.sdk.
• Ang recorder nagtanyag direkta nga pag-access sa tanan nga nagpahiping mga gimbuhaton sa pco.recorder.

2.1 Pamaagi
Kini nga seksyon naghulagway sa tanang pamaagi nga gitanyag sa klase sa pco.Camera.
2.1.1 Rekord
Deskripsyon Naghimo, nag-configure, ug nagsugod sa usa ka bag-ong kaso sa recorder. Ang tibuok nga configuration sa camera kinahanglang itakda sa dili pa tawagan ang record(). Ang set_exposure_time() nga sugo mao lamang ang eksepsiyon. Kini nga function walay epekto sa recorder object ug mahimong tawagan sa panahon sa pagrekord.
Prototype def record(kaugalingon, numero_of_images=1, mode='sequence'):
Parameter

Ngalan	Deskripsyon
gidaghanon_sa_mga_larawan	Nagtakda sa gidaghanon sa mga hulagway nga gigahin sa drayber. Ang RAM sa PC naglimite sa maximum nga bili.
mode	Sa 'sequence' mode, kini nga function nag-ali sa panahon sa pagrekord. Awtomatikong mohunong ang recorder kung maabot ang numero_sa_mga_larawan. Sa 'sequence non blocking' mode, kini nga function dili blocking. Kinahanglang susihon ang kahimtang sa dili pa mobasa og hulagway. Kini nga mode gigamit sa pagbasa sa mga hulagway samtang nagrekord, eg thumbnail. Sa 'ring buffer' mode kini nga function dili maka-block. Kinahanglang susihon ang kahimtang sa dili pa mobasa og hulagway. Ang tigrekord dili mohunong sa pagrekord kung maabot ang numero_sa_mga_larawan. Sa higayon nga kini mahitabo, ang labing karaan nga mga hulagway ma-overwrite. Sa 'fifo' mode, kini nga function dili blocking. Kinahanglang susihon ang kahimtang sa dili pa mobasa og hulagway. Sa diha nga ang gidaghanon_sa_mga_larawan sa fifo maabot, ang mosunod nga mga hulagway ihulog hangtud nga ang mga hulagway mabasa gikan sa fifo.

2.1.2 Hunong
Deskripsyon Gipahunong ang kasamtangan nga pagrekord. Sa 'ring buffer' ug 'fifo' mode, kini nga function kinahanglan nga tawagan sa user. Sa 'sequence' ug 'sequence non blocking' mode, kini nga function awtomatik nga tawgon kung ang number_of_images maabot.
Prototype def stop(kaugalingon):
2.1.3 Duol
Deskripsyon Isira ang gi-aktibo nga camera ug ipagawas ang gibabagan nga mga kapanguhaan. Kinahanglang tawagan kini nga function sa dili pa matapos ang aplikasyon. Kung dili, ang mga kahinguhaan magpabilin nga okupar.
Prototype def close(kaugalingon):
Kini nga function awtomatik nga gitawag kung ang butang sa camera gihimo pinaagi sa pahayag nga adunay. Ang usa ka tin-aw nga tawag sa pagsira () dili na kinahanglan.
uban sa pco.Camera() isip cam: # pagbuhat ug mga butang
2.1.4 Hulagway
Deskripsyon Nagbalik og hulagway gikan sa recorder. Ang matang sa hulagway kay numpy.ndarray. Kini nga laray giporma depende sa resolusyon ug ROI sa imahe.
Prototype def nga hulagway(kaugalingon, image_number=0, roi=Wala):
Parameter

Ngalan	Deskripsyon
hulagway_numero	Gipiho ang numero sa imahe nga basahon. Sa 'sequence' o 'sequence non blocking' mode, ang recorder index motakdo sa image_number. Kung ang image_number gibutang sa 0xFFFFFFFF, ang katapusan nga narekord nga imahe gikopya. Kini nagtugot sa paghimo sa usa ka buhi nga preview samtang nagrekord.
roi	Nagtakda sa rehiyon sa interes. Kini nga rehiyon lamang sa imahe ang gikopya sa pagbalik nga kantidad.

Example >>> cam.record(number_of_images=1, mode='sequence')
>>> hulagway, meta = cam.image()
>>> type(image) numpy.ndarray
>>> image.shape (2160, 2560)
>>> hulagway, metadata = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 ka mga hulagway
Deskripsyon Ibalik ang tanang narekord nga mga hulagway gikan sa recorder isip listahan sa numpy arrays.
Prototype def nga mga hulagway(kaugalingon, roi=Wala, blocksize=Wala):
Parameter

Ngalan	Deskripsyon
roi	Nagtakda sa rehiyon sa interes. Kini nga rehiyon lamang sa imahe ang gikopya sa pagbalik nga kantidad.
gidak-on sa block	Gihubit ang labing kadaghan nga mga imahe nga gibalik. Kini nga parameter magamit lamang sa 'fifo' mode ug ubos sa espesyal nga mga kondisyon.

Example >>> cam.record(number_of_images=20, mode='sequence')
>>> mga hulagway, metadata = cam.images()
>>> len(mga hulagway) 20
>>> para sa hulagway sa mga hulagway:
…
print('Mean: {:7.2f} DN'.format(image.mean()))
…
Kahulugan: 2147.64 DN
Kahulugan: 2144.61 DN
…
>>> mga hulagway = cam.images(roi=(1, 1, 300, 300))
>>> mga hulagway[0].porma (300, 300)
2.1.6 Imahe_aberids
Deskripsyon Ibalik ang aberids nga hulagway. Kini nga hulagway gikalkulo gikan sa tanang narekord nga mga hulagway sa buffer.
Prototype def image_average(kaugalingon, roi=Wala):
Parameter

Ngalan	Deskripsyon
roi	Gihubit ang rehiyon sa interes. Kini nga rehiyon lamang sa imahe ang gikopya sa pagbalik nga kantidad.

Example >>> cam.record(number_of_images=100, mode='sequence')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Set_exposure_time
Deskripsyon Nagtakda sa oras sa pagkaladlad sa camera.
Prototype def set_exposure_time(kaugalingon, exposure_time):
Parameter

Ngalan	Deskripsyon
oras sa pagka-ekspos	Kinahanglang ihatag isip float o integer value sa unit nga 'second'. Ang nagpahiping mga kantidad alang sa function sdk.set_delay_exposure_time(0, 'ms', oras, timebase) awtomatikong kalkulado. Ang oras sa paglangan gitakda sa 0.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Maghulat_alang_unang_larawan
Deskripsyon Maghulat alang sa una nga magamit nga imahe sa memorya sa recorder. Sa recorder mode 'sequence non blocking', 'ring buffer'. ug 'fifo', ang function record() mobalik dayon. Busa, kini nga function mahimong gamiton sa paghulat alang sa mga hulagway gikan sa camera sa dili pa motawag og image(), images(), o image_average().
Prototype def wait_for_first_image(self):
2.2 Variable Configuration
Ang mga parameter sa camera gi-update pinaagi sa pagbag-o sa variable sa pag-configure.
cam.configuration = {'oras sa exposure': 10e-3,
'roi': (1, 1, 512, 512),
'panahonamp': 'ascii',
'pixel rate': 100_000_000,
'trigger': 'auto sequence',
'pagkuha': 'awto',
'metadata': 'on',
'binning': (1, 1)}
Ang variable mahimo lamang usbon sa dili pa ang record() function tawgon. Kini usa ka diksyonaryo nga adunay usa ka piho nga gidaghanon sa mga entri. Dili tanan nga posible nga mga elemento kinahanglan nga espesipiko. Ang mosunod nga sampAng code nagbag-o lang sa 'pixel rate' ug dili makaapekto sa bisan unsang ubang elemento sa configuration.
uban sa pco.Camera() isip cam:
cam.configuration = {'pixel rate': 286_000_000}
cam.record()
…
2.3 ka mga butang
Kini nga seksyon naghulagway sa tanang butang nga gitanyag sa klase sa pco.Camera.
2.3.1 SDK
Ang butang sdk nagtugot sa direktang pag-access sa tanan nga nagpahiping mga gimbuhaton sa pco.sdk.
>>> cam.sdk.get_temperature()
{'sensor temperature': 7.0, 'camera temperature': 38.2, 'power temperature': 36.7}
Ang tanan nga mga kantidad sa pagbalik gikan sa sdk function mga diksyonaryo. Dili tanan nga mga setting sa camera karon nasakup sa klase sa Camera. Ang mga espesyal nga setting kinahanglan nga itakda direkta pinaagi sa pagtawag sa tagsa-tagsa nga sdk function.
2.3.2 Recorder
Ang object rec nagtanyag direkta nga pag-access sa tanan nga nagpahiping mga gimbuhaton sa pco.recorder. Dili kinahanglan nga direktang tawagan ang pamaagi sa klase sa recorder. Ang tanan nga mga gimbuhaton hingpit nga nasakup sa mga pamaagi sa klase sa Camera.

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 asya +65 6549 7054 info@pco-imaging.com pco-imaging.com

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

Mga Dokumento / Mga Kapanguhaan

EXCELITAS TECHNOLOGIES Python Software Development Kit [pdf] Manwal sa Gumagamit Python Software Development Kit, Software Development Kit, Development Kit, Kit

Mga pakisayran

• Manwal sa Gumagamit