Kit Fampandrosoana Software Python
User Manual
Kit Fampandrosoana Software Python
Ny PCO dia mangataka anao hamaky tsara sy hanaraka ny toromarika ato amin'ity antontan-taratasy ity.
Raha misy fanontaniana na fanehoan-kevitra dia aza misalasala mifandray aminay amin'ny fotoana rehetra.
telefaonina: +49 (0) 9441 2005 50
fax: +49 (0) 9441 2005 20
Adiresy paositra: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Alemaina
mailaka: info@pco.de
web: www.pco.de
pco.python mpampiasa boky 0.1.7
Navoaka tamin'ny Desambra 2021
©Copyright Excelitas PCO GmbH
Ity asa ity dia nahazo alalana avy amin'ny Creative Commons Attribution-No Derivatives 4.0 International License. ny view dika mitovy amin'ity lisansa ity, tsidiho http://creativecommons.org/licenses/by-nd/4.0/ na mandefasa taratasy any amin'ny Creative Commons, PO Box 1866, Mountain View, CA 94042, Etazonia.
General
Ny fonosana Python pco dia manolotra ny fiasa rehetra amin'ny fiasana amin'ny fakantsary pco izay mifototra amin'ny ankehitriny pco.sdk. Ny trano famakiam-boky iombonana rehetra ho an'ny fifandraisana amin'ny fakantsary sy ny fanodinana sary manaraka dia tafiditra ao.
- Kilasy fakan-tsary mora ampiasaina
- API matanjaka amin'ny pco.sdk
- Fandraketana sy fanodinana sary miaraka amin'ny pco.recorder
1.1 Fametrahana
Mametraka avy amin'ny pypi (azo ampiasaina):
$ pip mametraka pco
1.2 Fampiasana fototra
import matplotlib.pyplot ho plt
import pco
miaraka amin'ny pco.Camera() ho cam:
cam.record()
sary, meta = cam.image()
plt.imshow(sary, cmap='gray')
plt.show()
1.3 Hetsika sy hadisoana fanoratana
Raha te hampavitrika ny vokatra logging dia mamorona ny Camera object miaraka amin'ny debuglevel= parameter.
Ny haavon'ny debug dia azo apetraka amin'ny iray amin'ireto sanda manaraka ireto:
- 'off' Manakana ny vokatra rehetra.
- 'error' Tsy mampiseho afa-tsy hafatra diso.
- 'verbose' Mampiseho ny hafatra rehetra.
- 'extra verbose' Mampiseho ny hafatra sy ny soatoavina rehetra.
Ny debuglevel default dia 'off'.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: OK.
Ny ora azo ataoamp= paramètre activé a tag amin'ny vokatra vita pirinty. Ny sanda mety dia: 'on' sy 'off'. Ny sanda mahazatra dia 'efa'.
pco.Camera(debuglevel='verbose', timesamp= 'on')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] karazana_kamera: OK.
API Documentation
Ny kilasy pco.Camera dia manolotra ireto fomba manaraka ireto:
- record() dia mamorona, manitsy, ary manomboka trangan-drakitra vaovao.
- stop() dia manakana ny firaketana amin'izao fotoana izao.
- close() dia manidy ny fakan-tsary mavitrika amin'izao fotoana izao ary mamoaka ireo loharanon-karena voabodo.
- image() dia mamerina sary avy amin'ny mpitam-boky ho numpy array.
- images() dia mamerina ny sary rehetra voarakitra avy amin'ny mpitam-boky ho lisitry ny array numpy.
- image_average() dia mamerina ny sary antonony. Ity sary ity dia kajy avy amin'ny sary rehetra voarakitra ao amin'ny buffer.
- set_exposure_time() dia mametraka ny fotoana fampitana ny fakantsary.
- wait_for_first_image() miandry ny sary misy voalohany ao amin'ny fitadidiana mpitam-peo.
Ny kilasy pco.Camera dia manana ny fari-piainana manaraka:
- fanahafana
Ny kilasin'ny pco.Camera dia manana ireto zavatra manaraka ireto:
- sdk dia manolotra fidirana mivantana amin'ireo fiasa fototra rehetra an'ny pco.sdk.
- Recorder dia manome fidirana mivantana amin'ny asa fototra rehetra an'ny pco.recorder.
2.1 Fomba
Ity fizarana ity dia mamaritra ny fomba rehetra atolotry ny kilasy pco.Camera.
2.1.1 Firaketana
Description Mamorona, manamboatra, ary manomboka trangan-drakitra vaovao. Ny fakan-tsary manontolo dia tsy maintsy apetraka alohan'ny hiantsoana record(). Ny baiko set_exposure_time() no tokana. Ity fiasa ity dia tsy misy fiantraikany amin'ny zavatra mpitatitra ary azo antsoina mandritra ny fandraisam-peo.
nitranga fahiny def record(tena, isa_sary=1, mode='sequence'):
fikirana
| Anarana | Description |
| isa_sary | Mametraka ny isan'ny sary natokana ho an'ny mpamily. Ny RAM an'ny PC dia mametra ny sanda ambony indrindra. |
| fomba | Amin'ny fomba 'sequence', ity fiasa ity dia manakana mandritra ny firaketana. Mijanona ho azy ny mpitam-peo rehefa tratra ny isan'ny_sary. Amin'ny fomba 'sequence non blocking', ity fiasa ity dia tsy manakana. Tsy maintsy jerena ny sata alohan'ny hamakiana sary. Ity fomba ity dia ampiasaina hamakiana sary mandritra ny fandraisam-peo, ohatra, thumbnail. Amin'ny fomba 'ring buffer' dia tsy manakana ity asa ity. Tsy maintsy jerena ny sata alohan'ny hamakiana sary. Tsy mitsahatra ny firaketana an-tsoratra rehefa tratra ny isan'ny_sary. Rehefa mitranga izany, dia voasolo ny sary tranainy indrindra. Amin'ny fomba 'fifo', ity fiasa ity dia tsy manakana. Tsy maintsy jerena ny sata alohan'ny hamakiana sary. Rehefa tratra ny isan'ny_sary ao amin'ny fifo dia arotsaka ireto sary manaraka ireto mandra-pamakiana sary avy amin'ny fifo. |
2.1.2 Mijanona
Description Atsaharo ny fandraisam-peo ankehitriny. Amin'ny mode 'ring buffer' sy 'fifo', ity fiasa ity dia tsy maintsy antsoin'ny mpampiasa. Amin'ny fomba 'sequence' sy 'sequence non blocking', ity asa ity dia antsoina ho azy rehefa tratra ny isan'ny_sary.
nitranga fahiny def mijanona (tena):
2.1.3 Akatona
Description Manakatona ny fakan-tsary mavitrika ary mamoaka ireo loharano voasakana. Ity asa ity dia tsy maintsy antsoina alohan'ny hamaranana ny fampiharana. Raha tsy izany, ny loharanon-karena dia mijanona ho voabodo.
nitranga fahiny def akaiky (tena):
Antsoina ho azy ity asa ity raha noforonin'ny fanambarana miaraka ny zavatra fakan-tsary. Tsy ilaina intsony ny antso mazava hanakatona().
miaraka amin'ny pco.Camera() ho cam: # manaova zavatra
2.1.4 Sary
Description Mamerina sary avy amin'ny mpitam-peo. Ny karazana sary dia numpy.ndarray. Ity array ity dia miendrika arakaraka ny famahana sy ny ROI amin'ny sary.
nitranga fahiny def sary(tena, sary_number=0, roi=Tsy misy):
fikirana
| Anarana | Description |
| laharan_sary | Manondro ny isan'ny sary hovakiana. Amin'ny fomba 'sequence' na 'sequence non blocking' dia mifanandrify amin'ny image_number ny tondron'ny mpitam-peo. Raha apetraka amin'ny 0xFFFFFFFF ny image_number dia adika ny sary voarakitra farany. Izany dia ahafahanao mamorona pre-mivantanaview mandritra ny firaketana. |
| roy | Mametraka ny faritra mahaliana. Io faritry ny sary io ihany no adika amin'ny sanda miverina. |
Example >>> cam.record(number_of_images=1, mode='sequence')
>>> sary, meta = cam.image()
>>> type(image) numpy.ndarray
>>> image.shape (2160, 2560)
>>> sary, metadata = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 Sary
Description Mamerina ny sary voarakitra rehetra avy amin'ny mpitam-boky ho lisitry ny laharan-kira.
nitranga fahiny def sary (tena, roi=Tsy misy, blocksize=Tsy misy):
fikirana
| Anarana | Description |
| roy | Mametraka ny faritra mahaliana. Io faritry ny sary io ihany no adika amin'ny sanda miverina. |
| haben'ny sakana | Mamaritra ny isa ambony indrindra amin'ny sary averina. Ity mari-pamantarana ity dia ilaina amin'ny fomba 'fifo' ary ao anatin'ny fepetra manokana. |
Example >>> cam.record(number_of_images=20, mode='sequence')
>>> sary, metadata = cam.images()
>>> len(sary) 20
>>> ho an'ny sary amin'ny sary:
…
print('Mean: {:7.2f} DN'.format(image.mean()))
…
Halavany: 2147.64 DN
Halavany: 2144.61 DN
…
>>> sary = cam.images(roi=(1, 1, 300, 300))
>>> sary[0].endrika (300, 300)
2.1.6 Sary_salan'isa
Description Mamerina ny sary antonony. Ity sary ity dia kajy avy amin'ny sary rehetra voarakitra ao amin'ny buffer.
nitranga fahiny def image_average(self, roi=Tsy misy):
fikirana
| Anarana | Description |
| roy | Mamaritra ny faritra mahaliana. Io faritry ny sary io ihany no adika amin'ny sanda miverina. |
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
Description Mametraka ny fotoana fampirantiana ny fakantsary.
nitranga fahiny def set_exposure_time(self, exposure_time):
fikirana
| Anarana | Description |
| faharetan'ny fifampikasohana | Tsy maintsy omena sanda mitsingevana na integer ao amin'ny singa 'faharoa'. Ny soatoavina fototra ho an'ny asa sdk.set_delay_exposure_time(0, 'ms', fotoana, timebase) dia hokajiana ho azy. Apetraka amin'ny 0 ny fotoana fanemorana. |
Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 Miandrasa_sary_voalohany
Description Miandry ny sary misy voalohany ao amin'ny fitadidiana mpitam-peo. Amin'ny fomba firaketana 'sequence non blocking', 'ring buffer'. ary 'fifo', miverina avy hatrany ny rakitra () asa. Noho izany, ity fiasa ity dia azo ampiasaina hiandry sary avy amin'ny fakantsary alohan'ny hiantsoana sary (), sary (), na image_average ().
nitranga fahiny def wait_for_first_image(self):
2.2 Configuration Variable
Havaozina ny masontsivana fakan-tsary amin'ny alalan'ny fanovana ny fari-pandaminana.
cam.configuration = {'fotoana mipoitra': 10e-3,
'roi': (1, 1, 512, 512),
'fotoanaamp': 'ascii',
'Taham-pixel': 100_000_000,
'trigger': 'fitsipika mandeha ho azy',
'acquire': 'auto',
'metadata': 'on',
'fandrobana': (1, 1)}
Ny variable dia tsy azo ovaina afa-tsy alohan'ny hiantsoana ny asa firaketana (). Rakibolana misy isa maromaro izy io. Tsy ny singa rehetra azo atao dia mila voafaritra. Ireto manaraka ireto sample code ihany no manova ny 'taham-pixel' ary tsy misy fiantraikany amin'ny singa hafa amin'ny fanitsiana.
miaraka amin'ny pco.Camera() ho cam:
cam.configuration = {'hadim-pixel': 286_000_000}
cam.record()
…
2.3 zavatra
Ity fizarana ity dia mamaritra ny zavatra rehetra atolotry ny kilasy pco.Camera.
2.3.1 SDK
Ny object sdk dia mamela ny fidirana mivantana amin'ireo fiasa fototra rehetra an'ny pco.sdk.
>>> cam.sdk.get_temperature()
{'temperature sensor': 7.0, 'maripan'ny fakan-tsary': 38.2, 'maripan'ny herin'aratra': 36.7}
Diksionera avokoa ny sanda miverina avy amin'ny asan'ny sdk. Tsy ny firafitry ny fakan-tsary rehetra no voasaron'ny kilasy Camera amin'izao fotoana izao. Ny toe-javatra manokana dia tsy maintsy apetraka mivantana amin'ny fiantsoana ny fiasan'ny sdk tsirairay avy.
2.3.2 Mpanoratra
Ny object rec dia manome fidirana mivantana amin'ny fiasa fototra rehetra an'ny pco.recorder. Tsy ilaina ny miantso mivantana ny fomba kilasy recorder. Ny fiasa rehetra dia voarakotry ny fomban'ny kilasy Camera.
https://www.pco.de/applications/
| pco europe +49 9441 2005 50 info@pco.de pco.de |
pco amerika +1 866 678 4566 info@pco-tech.com pco-tech.com |
pco azia +65 6549 7054 info@pco-imaging.com pco-imaging.com |
pco sinoa +86 512 67634643 info@pco.cn pco.cn |
Documents / Loharano
 |
EXCELITAS TECHNOLOGIES Kit Fampandrosoana Software Python [pdf] Boky Torolàlana Kitapom-pampandrosoana rindrambaiko Python, Kitapom-pampandrosoana rindrambaiko, Kitapom-pampandrosoana, Kit |
