Python Software Development Kit
User Manual
Python Software Development Kit
Hinihiling sa iyo ng PCO na maingat na basahin at sundin ang mga tagubilin sa dokumentong ito.
Para sa anumang mga katanungan o komento, mangyaring huwag mag-atubiling makipag-ugnay sa amin anumang oras.
telepono: +49 (0) 9441 2005 50
fax: +49 (0) 9441 2005 20
postal address: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germany
email: info@pco.de
web: www.pco.de
manwal ng gumagamit ng pco.python 0.1.7
Inilabas noong Disyembre 2021
©Copyright Excelitas PCO GmbH
Ang gawaing ito ay lisensyado sa ilalim ng Creative Commons Attribution-No Derivatives 4.0 International License. Upang view isang kopya ng lisensyang ito, bisitahin http://creativecommons.org/licenses/by-nd/4.0/ o magpadala ng liham sa Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
Heneral
Ang Python package pco ay nag-aalok ng lahat ng mga function para sa pagtatrabaho sa mga pco camera na batay sa kasalukuyang pco.sdk. Lahat ng mga shared library para sa komunikasyon sa camera at kasunod na pagpoproseso ng imahe ay kasama.
- Madaling gamitin ang klase ng camera
- Napakahusay na API sa pco.sdk
- Pagre-record at pagproseso ng larawan gamit ang pco.recorder
1.1 Pag-install
I-install mula sa pypi (inirerekomenda):
$ pip install pco
1.2 Pangunahing Paggamit
import matplotlib.pyplot bilang plt
import pco
na may pco.Camera() bilang cam:
cam.record()
larawan, meta = cam.image()
plt.imshow(larawan, cmap='gray')
plt.show()
1.3 Pag-log ng Kaganapan at Error
Para i-activate ang logging output, gawin ang Camera object gamit ang debuglevel= parameter.
Maaaring itakda ang antas ng debug sa isa sa mga sumusunod na halaga:
- 'off' Hindi pinapagana ang lahat ng output.
- 'error' Ipinapakita lamang ang mga mensahe ng error.
- 'verbose' Ipinapakita ang lahat ng mensahe.
- 'extra verbose' Ipinapakita ang lahat ng mensahe at value.
Ang default na debuglevel ay 'naka-off'.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: OK.
Ang opsyonal na orasamp= pinapagana ang parameter a tag sa nakalimbag na output. Ang mga posibleng value ay: 'on' at 'off'. Ang default na halaga ay 'naka-off'.
pco.Camera(debuglevel='verbose', timestamp= 'on')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: OK.
Dokumentasyon ng API
Ang klase ng pco.Camera ay nag-aalok ng mga sumusunod na pamamaraan:
- record() ay bumubuo, nagko-configure, at nagsisimula ng isang bagong instance ng recorder.
- stop() huminto sa kasalukuyang pag-record.
- isinasara ng close() ang kasalukuyang aktibong camera at inilalabas ang mga pinagkukunang mapagkukunan.
- image() ay nagbabalik ng isang imahe mula sa recorder bilang numpy array.
- images() ibinabalik ang lahat ng naitala na larawan mula sa recorder bilang isang listahan ng mga numpy array.
- Ibinabalik ng image_average() ang na-average na larawan. Ang larawang ito ay kinakalkula mula sa lahat ng naitalang larawan sa buffer.
- set_exposure_time() nagtatakda ng oras ng pagkakalantad para sa camera.
- wait_for_first_image() naghihintay para sa unang magagamit na imahe sa memorya ng recorder.
Ang klase ng pco.Camera ay may sumusunod na variable:
- pagsasaayos
Ang klase ng pco.Camera ay may mga sumusunod na bagay:
- Nag-aalok ang sdk ng direktang access sa lahat ng pinagbabatayan ng mga function ng pco.sdk.
- nag-aalok ang recorder ng direktang access sa lahat ng pinagbabatayan ng mga function ng pco.recorder.
2.1 Mga Paraan
Inilalarawan ng seksyong ito ang lahat ng pamamaraang inaalok ng klase ng pco.Camera.
2.1.1 Itala
Paglalarawan Gumagawa, nagko-configure, at nagsisimula ng bagong instance ng recorder. Dapat itakda ang buong configuration ng camera bago tumawag sa record(). Ang set_exposure_time() command ay ang tanging exception. Ang function na ito ay walang epekto sa recorder object at maaaring tawagan habang nagre-record.
Prototype def record(self, number_of_images=1, mode='sequence'):
Parameter
| Pangalan | Paglalarawan |
| number_of_images | Itinatakda ang bilang ng mga larawang inilalaan sa driver. Nililimitahan ng RAM ng PC ang pinakamataas na halaga. |
| mode | Sa 'sequence' mode, ang function na ito ay humaharang sa panahon ng record. Awtomatikong hihinto ang recorder kapag naabot ang number_of_images. Sa 'sequence non blocking' mode, ang function na ito ay non-blocking. Dapat suriin ang katayuan bago basahin ang isang larawan. Ginagamit ang mode na ito upang magbasa ng mga larawan habang nagre-record, hal thumbnail. Sa 'ring buffer' mode ang function na ito ay hindi nakaharang. Dapat suriin ang katayuan bago basahin ang isang larawan. Hindi ititigil ng recorder ang pagre-record kapag naabot na ang number_of_images. Kapag nangyari ito, ang mga pinakalumang larawan ay mapapatungan. Sa 'fifo' mode, ang function na ito ay hindi naka-block. Dapat suriin ang katayuan bago basahin ang isang larawan. Kapag naabot ang bilang_ng_mga_larawan sa fifo, ang mga sumusunod na larawan ay ibinabagsak hanggang sa mabasa ang mga larawan mula sa fifo. |
2.1.2 Itigil
Paglalarawan Ihihinto ang kasalukuyang pag-record. Sa 'ring buffer' at 'fifo' mode, ang function na ito ay dapat na tawagan ng user. Sa mode na 'sequence' at 'sequence non blocking', awtomatikong tatawagin ang function na ito kapag naabot ang number_of_images.
Prototype def stop(self):
2.1.3 Isara
Paglalarawan Isinasara ang naka-activate na camera at ilalabas ang mga naka-block na mapagkukunan. Dapat tawagan ang function na ito bago wakasan ang application. Kung hindi, ang mga mapagkukunan ay mananatiling abala.
Prototype def close(self):
Ang function na ito ay awtomatikong tinatawag kung ang camera object ay nilikha ng with statement. Ang isang tahasang tawag upang isara () ay hindi na kailangan.
na may pco.Camera() bilang cam: # gumawa ng ilang bagay
2.1.4 Larawan
Paglalarawan Nagbabalik ng larawan mula sa recorder. Ang uri ng larawan ay isang numpy.ndarray. Ang array na ito ay hugis depende sa resolution at ROI ng imahe.
Prototype def image(self, image_number=0, roi=None):
Parameter
| Pangalan | Paglalarawan |
| image_number | Tinutukoy ang bilang ng larawang babasahin. Sa 'sequence' o 'sequence non blocking' mode, ang recorder index ay tumutugma sa image_number. Kung ang image_number ay nakatakda sa 0xFFFFFFFF, ang huling naitalang larawan ay makokopya. Ito ay nagbibigay-daan upang lumikha ng isang live na preview habang nagre-record. |
| roi | Itinatakda ang rehiyon ng interes. Tanging ang rehiyong ito ng larawan ang kinokopya sa return value. |
Example >>> cam.record(number_of_images=1, mode='sequence')
>>> larawan, meta = cam.image()
>>> type(image) numpy.ndarray
>>> image.shape (2160, 2560)
>>> larawan, metadata = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 Mga Larawan
Paglalarawan Ibinabalik ang lahat ng naitalang larawan mula sa recorder bilang isang listahan ng mga numpy array.
Prototype def images(self, roi=Wala, blocksize=Wala):
Parameter
| Pangalan | Paglalarawan |
| roi | Itinatakda ang rehiyon ng interes. Tanging ang rehiyong ito ng larawan ang kinokopya sa return value. |
| blocksize | Tinutukoy ang maximum na bilang ng mga larawang ibinalik. Ang parameter na ito ay kapaki-pakinabang lamang sa 'fifo' mode at sa ilalim ng mga espesyal na kundisyon. |
Example >>> cam.record(number_of_images=20, mode='sequence')
>>> mga larawan, metadata = cam.images()
>>> len(mga larawan) 20
>>> para sa larawan sa mga larawan:
…
print('Mean: {:7.2f} DN'.format(image.mean()))
…
Ibig sabihin: 2147.64 DN
Ibig sabihin: 2144.61 DN
…
>>> mga larawan = cam.images(roi=(1, 1, 300, 300))
>>> mga larawan[0].hugis (300, 300)
2.1.6 Imahe_average
Paglalarawan Ibinabalik ang na-average na larawan. Ang larawang ito ay kinakalkula mula sa lahat ng naitalang larawan sa buffer.
Prototype def image_average(self, roi=None):
Parameter
| Pangalan | Paglalarawan |
| roi | Tinutukoy ang rehiyon ng interes. Tanging ang rehiyong ito ng larawan ang kinokopya sa return value. |
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
Paglalarawan Itinatakda ang oras ng pagkakalantad ng camera.
Prototype def set_exposure_time(self, exposure_time):
Parameter
| Pangalan | Paglalarawan |
| tagal ng pagkalantad | Dapat ibigay bilang float o integer value sa unit na 'second'. Awtomatikong kakalkulahin ang mga pinagbabatayan na halaga para sa function na sdk.set_delay_exposure_time(0, 'ms', time, timebase). Ang oras ng pagkaantala ay nakatakda sa 0. |
Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Wait_for_first_image
Paglalarawan Naghihintay para sa unang magagamit na imahe sa memorya ng recorder. Sa recorder mode 'sequence non blocking', 'ring buffer'. at 'fifo', ang function record() ay bumalik kaagad. Samakatuwid, ang function na ito ay maaaring gamitin upang maghintay para sa mga larawan mula sa camera bago tumawag sa image(), images(), o image_average().
Prototype def wait_for_first_image(self):
2.2 Variable Configuration
Ina-update ang mga parameter ng camera sa pamamagitan ng pagbabago sa variable ng configuration.
cam.configuration = {'oras ng pagkakalantad': 10e-3,
'roi': (1, 1, 512, 512),
'orasamp': 'ascii',
'rate ng pixel': 100_000_000,
'trigger': 'auto sequence',
'makuha': 'auto',
'metadata': 'on',
'binning': (1, 1)}
Ang variable ay maaari lamang baguhin bago tawagin ang record() function. Ito ay isang diksyunaryo na may tiyak na bilang ng mga entry. Hindi lahat ng posibleng elemento ay kailangang tukuyin. Ang mga sumusunod na sampBinabago lang ng code ang 'pixel rate' at hindi nakakaapekto sa anumang iba pang elemento ng configuration.
na may pco.Camera() bilang cam:
cam.configuration = {'rate ng pixel': 286_000_000}
cam.record()
…
2.3 Mga Bagay
Inilalarawan ng seksyong ito ang lahat ng bagay na inaalok ng klase ng pco.Camera.
2.3.1 SDK
Ang object sdk ay nagbibigay-daan sa direktang pag-access sa lahat ng pinagbabatayan ng mga function ng pco.sdk.
>>> cam.sdk.get_temperature()
{'sensor temperature': 7.0, 'camera temperature': 38.2, 'power temperature': 36.7}
Ang lahat ng mga return value mula sa sdk function ay mga diksyunaryo. Hindi lahat ng setting ng camera ay kasalukuyang sakop ng klase ng Camera. Ang mga espesyal na setting ay kailangang itakda nang direkta sa pamamagitan ng pagtawag sa kani-kanilang sdk function.
2.3.2 Tagapagtala
Nag-aalok ang object rec ng direktang pag-access sa lahat ng pinagbabatayan na function ng pco.recorder. Hindi kinakailangang direktang tumawag ng paraan ng klase ng recorder. Ang lahat ng mga function ay ganap na sakop ng mga pamamaraan ng klase ng 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 Mapagkukunan
 |
EXCELITAS TECHNOLOGIES Python Software Development Kit [pdf] User Manual Python Software Development Kit, Software Development Kit, Development Kit, Kit |
