Kit Pêşveçûna Nermalava Python
Manual Bikarhêner
Kit Pêşveçûna Nermalava Python
PCO ji we daxwaz dike ku hûn rêwerzên vê belgeyê bi baldarî bixwînin û bişopînin.
Ji bo her pirs an şîrove, ji kerema xwe di her kêliyê de bi me re têkilî daynin.
telefon: +49 (0) 9441 2005 50
faks: +49 (0) 9441 2005 20
Navnîşana postê: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Almanya
email: info@pco.de
web: www.pco.de
manuala bikarhêner pco.python 0.1.7
Kanûn 2021 hate berdan
©Copyright Excelitas PCO GmbH
Ev xebat di bin Lîsansa Navneteweyî ya Creative Commons Attribution-No Derivatives 4.0 de ye. Ber view kopiyek vê lîsansê, serdana http://creativecommons.org/licenses/by-nd/4.0/ an jî nameyekê bişînin Creative Commons, PO Box 1866, Çiyayê View, CA 94042, USA.
Giştî
Pakêta Python pco hemî fonksiyonên ji bo xebata bi kamerayên pco-yê yên ku li ser bingeha heyî têne çêkirin pêşkêşî dike pco.sdk. Hemî pirtûkxaneyên hevpar ên ji bo danûstendina bi kamerayê re û pêvajoyek wêneyê ya paşîn tê de hene.
- Bikaranîna çîna kamerayê hêsan e
- API-ya hêzdar ji bo pco.sdk
- Tomarkirina wêneyê û pêvajoyê bi pco.recorder
1.1 Sazkirin
Ji pypi saz bikin (pêşniyar kirin):
$ pip pco saz bike
1.2 Bikaranîna bingehîn
matplotlib.pyplot wekî plt têxe
import pco
bi pco.Camera() wek cam:
cam.record()
wêne, meta = cam.image()
plt.imshow(wêne, cmap='gewr')
plt.show()
1.3 Têketina Bûyer û Xeletiyê
Ji bo aktîvkirina derana têketinê, bi parametreya debuglevel= objekta Kamera biafirînin.
Asta debug dikare li yek ji van nirxan were danîn:
- 'off' Hemî derketinê asteng dike.
- 'error' Tenê peyamên çewtiyê nîşan dide.
- 'verbose' Hemî peyaman nîşan dide.
- 'extra verbose' Hemî peyam û nirxan nîşan dide.
Asta debugle ya xwerû 'off' e.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: OK.
The timest optionalamp= parametre a çalak dike tag di berhema çapkirî de. Nirxên gengaz ev in: 'on' û 'off'. Nirxa xwerû 'off' e.
pco.Camera(debuglevel='verbose', timestamp='ser')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: Baş e.
Belgekirina API
Dersa pco.Camera rêbazên jêrîn pêşkêşî dike:
- record() mînakek tomarkerek nû çêdike, mîheng dike û dest pê dike.
- stop() tomarkirina heyî disekine.
- close() kameraya çalak a heyî digire û çavkaniyên dagirkirî berdide.
- image() wêneyek ji tomarkerê wekî array numpy vedigerîne.
- images() hemî wêneyên tomarkirî ji tomarkerê wekî navnîşek rêzikên numpy vedigerîne.
- image_average() wêneya navîn vedigerîne. Ev wêne ji hemî wêneyên tomarkirî yên di tamponê de tê hesibandin.
- set_exposure_time() ji bo kamerayê dema pêşandanê destnîşan dike.
- wait_for_first_image() li benda yekem wêneya berdest a di bîra tomarker de ye.
Dersa pco.Camera guhêrbarek jêrîn heye:
- veavakirina
Dersa pco.Camera van tiştan hene:
- sdk gihandina rasterast ji hemî fonksiyonên bingehîn re pêşkêşî dike pco.sdk.
- Tomar gihandina rasterast ji hemî fonksiyonên bingehîn ên xêzkirinê re peyda dike pco.recorder.
2.1 Rêbaz
Ev beş hemî rêbazên ku ji hêla pola pco.Camera ve têne pêşkêş kirin diyar dike.
2.1.1 Qeyd bikin
Terîf Mînakek tomarkerek nû diafirîne, mîheng dike û dest pê dike. Tevahiya veavakirina kamerayê divê berî bangkirina tomar (). Fermana set_exposure_time() tenê îstîsna ye. Vê fonksiyonê ti bandorek li ser tiştê tomarker nake û di dema tomarkirinê de dikare were bang kirin.
Prototype qeyda def (xwe, hejmara_wêneyan=1, mod='rêzik'):
Parametre
| Nav | Terîf |
| hejmara_wêneyan | Hejmara wêneyên ku di ajokerê de hatine veqetandin destnîşan dike. RAM-a PC-ê nirxa herî zêde sînor dike. |
| awa | Di moda 'rêlê' de, ev fonksiyon di dema tomarkirinê de tê asteng kirin. Dema ku hejmara_wêneyan bigihîje tomarker bixweber disekine. Di moda 'sequence non blocking' de, ev fonksiyon ne-astengker e. Berî xwendina wêneyek pêdivî ye ku rewş were kontrol kirin. Ev mod ji bo xwendina wêneyan di dema tomarkirinê de tê bikaranîn, wek nimûne xêzkirin. Di moda 'tampon ring' de ev fonksiyon ne asteng e. Berî xwendina wêneyek pêdivî ye ku rewş were kontrol kirin. Dema ku hejmara_wêneyan bigihîje tomarker tomarkirinê nade sekinandin. Dema ku ev diqewime, wêneyên herî kevn têne nivîsandin. Di moda 'fifo' de, ev fonksiyon ne-asteng e. Berî xwendina wêneyek pêdivî ye ku rewş were kontrol kirin. Dema ku hejmara_wêneyên di fifoyê de bigihîje, wêneyên jêrîn têne avêtin heya ku wêne ji fifoyê werin xwendin. |
2.1.2 Raweste
Terîf Tomara heyî radiwestîne. Di moda 'ring buffer' û 'fifo' de, divê ev fonksiyon ji hêla bikarhêner ve were gazî kirin. Di moda 'rêzik' û 'rêveberiya ne astengker' de, dema ku hejmara_wêneyan bigihîje, ev fonksiyon bixweber tê gazî kirin.
Prototype def rawesta(xwe):
2.1.3 Girtin
Terîf Kameraya aktîfkirî digire û çavkaniyên astengkirî berdide. Berî ku serîlêdan biqede divê ev fonksiyon were bang kirin. Wekî din, çavkaniyên dagirkirî dimînin.
Prototype def nêzîk (xwe):
Ger tiştê kamerayê ji hêla daxuyaniya bi ve hatî çêkirin ve ev fonksiyon bixweber tê gotin. Bangek eşkere ji bo girtinê() êdî ne hewce ye.
bi pco.Camera() wek cam: # hin tiştan bikin
2.1.4 Wêne
Terîf Wêneyek ji tomarkerê vedigerîne. Cureyê sûretê numek e.ndarray. Ev array li gorî çareserî û ROI ya wêneyê ve girêdayî ye.
Prototype def wêne (xwe, wêne_hejmar = 0, roi = tune):
Parametre
| Nav | Terîf |
| image_numre | Hejmara wêneyê ku were xwendin diyar dike. Di moda 'rêzik' an 'rêbera ne astengker' de, îndeksa tomarker bi jimareya_image re li hev dike. Ger image_number li 0xFFFFFFFF were danîn, wêneya dawî ya tomarkirî tê kopî kirin. Ev dihêle ku meriv pêşekek zindî biafirîneview dema tomarkirinê. |
| roi | Herêma berjewendiyê destnîşan dike. Tenê ev devera wêneyê li nirxa vegerê tê kopî kirin. |
Example >>> cam.record(hejmara_wêneyan=1, moda='rêzik')
>>> wêne, meta = cam.image()
>>> cure(wêne) numpy.ndarray
>>> image.shape (2160, 2560)
>>> wêne, metadata = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 Wêne
Terîf Hemî wêneyên tomarkirî ji tomarkerê wekî navnîşek rêzikên numyayî vedigerîne.
Prototype wêneyên def(xwe, roi=Tu kes, bloksize=Tu kes):
Parametre
| Nav | Terîf |
| roi | Herêma berjewendiyê destnîşan dike. Tenê ev devera wêneyê li nirxa vegerê tê kopî kirin. |
| blocksize | Hejmara herî zêde ya wêneyên ku têne vegerandin diyar dike. Ev parametre tenê di moda 'fifo' de û di bin şert û mercên taybetî de bikêr e. |
Example >>> cam.record(hejmara_wêneyan=20, moda='rêzik')
>>> wêne, metadata = cam.images()
>>> len(wêne) 20
>>> ji bo wêneyê di wêneyan de:
…
print('Mean: {:7.2f} DN'.format(image.mean()))
…
Navîn: 2147.64 DN
Navîn: 2144.61 DN
…
>>> wêne = cam.images(roi=(1, 1, 300, 300))
>>> images[0].shape (300, 300)
2.1.6 Wêne_navîn
Terîf Wêneyê navîn vedigerîne. Ev wêne ji hemî wêneyên tomarkirî yên di tamponê de tê hesibandin.
Prototype def image_average(xwe, roi=Tu kes):
Parametre
| Nav | Terîf |
| roi | Herêma berjewendiyê diyar dike. Tenê ev devera wêneyê li nirxa vegerê tê kopî kirin. |
Example >>> cam.record(hejmara_wêneyan=100, moda='rêzik')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Set_exposure_time
Terîf Wextê xuyangkirina kamerayê destnîşan dike.
Prototype def set_exposure_time (xwe, dema xuyangkirinê):
Parametre
| Nav | Terîf |
| dema tûşbûnê | Pêdivî ye ku di yekîneya 'duyemîn' de wekî nirxa float an yekjimar were dayîn. Nirxên bingehîn ji bo fonksiyona sdk.set_delay_exposure_time(0, 'ms', dem, bingeha demê) dê bixweber bêne hesibandin. Demjimêra derengmayînê li ser 0 tête danîn. |
Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Wait_for_first_image
Terîf Li benda yekem wêneya berdest a di bîra tomarker de dimîne. Di moda tomarkirinê de 'sequence non blocking', 'ring tampon'. û 'fifo', tomara fonksiyonê() tavilê vedigere. Ji ber vê yekê, ev fonksiyon dikare were bikar anîn da ku li benda wêneyên ji kamerayê bisekinin berî ku bangî wêne (), wêne (), an wêne_navgîn ().
Prototype def wait_for_first_image(xwe):
2.2 Veavakirina Variable
Parametreyên kamerayê bi guheztina guhêrbar veavakirinê têne nûve kirin.
cam.configuration = {'dema xuyangkirinê': 10e-3,
'roi': (1, 1, 512, 512),
'demamp': 'ascii',
'rêjeya pixel': 100_000_000,
'teqandin': 'rêla otomatîk',
'bidestxistin': 'oto',
'metadata': 'li ser',
'binning': (1, 1)}
Beriya ku fonksiyona tomar() were gazîkirin, guhêrbar tenê dikare were guheztin. Ferhengeke bi jimareke diyarkirî ye. Ne hewce ye ku hemî hêmanên gengaz bêne diyar kirin. Ya jêrîn sampLe code tenê 'rêjeya pixelê' diguherîne û bandorê li hêmanên din ên veavakirinê nake.
bi pco.Camera() wek cam:
cam.configuration = {'rêjeya pixel': 286_000_000}
cam.record()
…
2.3 Objekt
Ev beş hemî tiştên ku ji hêla pola pco.Camera ve têne pêşkêş kirin diyar dike.
2.3.1 SDK
Tişta sdk destûrê dide ku rasterast bigihîje hemî fonksiyonên bingehîn ên pco.sdk.
>>> cam.sdk.get_temperature()
{'germahiya sensor': 7.0, 'germahiya kamerayê': 38.2, 'germahiya hêzê': 36.7}
Hemî nirxên vegera ji fonksiyonên sdk ferheng in. Ne hemî mîhengên kamerayê niha ji hêla pola Kamera ve têne vegirtin. Pêdivî ye ku mîhengên taybetî rasterast bi gazîkirina fonksiyona sdk-a têkildar were saz kirin.
2.3.2 Recorder
Objeya rec gihandina rasterast ji hemî fonksiyonên bingehîn ên ya pco.recorder. Ne hewce ye ku meriv rasterast rêgezek pola tomarker bang bike. Hemî fonksiyon bi tevahî rêbazên çîna Kamera ve têne vegirtin.
https://www.pco.de/applications/
| pco Ewropa +49 9441 2005 50 info@pco.de pco.de |
pco amerîka +1 866 678 4566 info@pco-tech.com pco-tech.com |
pco asya +65 6549 7054 info@pco-imaging.com pco-imaging.com |
pco çîn +86 512 67634643 info@pco.cn pco.cn |
Belge / Çavkanî
 |
EXCELITAS TECHNOLOGIES Kit Pêşveçûna Nermalava Python [pdf] Rêbernameya Bikarhêner Kit Pêşveçûna Nermalava Python, Kit Pêşveçûna Nermalavê, Kit Pêşveçûn, Kit |
