EXCELITAS TECHNOLOGIES Python Software Development Kit User Manual

පයිතන් මෘදුකාංග සංවර්ධන කට්ටලය
පරිශීලක අත්පොත

අන්තර්ගතය සඟවන්න

1 පයිතන් මෘදුකාංග සංවර්ධන කට්ටලය

පයිතන් මෘදුකාංග සංවර්ධන කට්ටලය

PCO මෙම ලේඛනයේ ඇති උපදෙස් හොඳින් කියවා අනුගමනය කරන ලෙස ඔබෙන් ඉල්ලා සිටී.
ඕනෑම ප්‍රශ්න හෝ අදහස් සඳහා, කරුණාකර ඕනෑම වේලාවක අප හා සම්බන්ධ වීමට නිදහස් වන්න.
දුරකථන: +49 (0) 9441 2005 50
ෆැක්ස්: +49 (0) 9441 2005 20
තැපැල් ලිපිනය: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germany
ඊමේල්: info@pco.de
web: www.pco.de
pco.python පරිශීලක අත්පොත 0.1.7
2021 දෙසැම්බර් නිකුත් කරන ලදී
©ප්‍රකාශන හිමිකම Excelitas PCO GmbH
මෙම කාර්යය Creative Commons Attribution-No Derivatives 4.0 International බලපත්‍රය යටතේ බලපත්‍ර ලබා ඇත. දක්වා view මෙම බලපත්‍රයේ පිටපතක්, පිවිසෙන්න http://creativecommons.org/licenses/by-nd/4.0/ නැතහොත් Creative Commons, PO Box 1866, Mountain වෙත ලිපියක් යවන්න View, CA 94042, USA.

ජෙනරාල්

Python පැකේජය pco ධාරාව මත පදනම් වූ pco කැමරා සමඟ වැඩ කිරීම සඳහා සියලුම කාර්යයන් සපයයි pco.sdk. කැමරාව සමඟ සන්නිවේදනය සහ පසුව රූප සැකසීම සඳහා සියලුම හවුල් පුස්තකාල ඇතුළත් වේ.

භාවිතා කිරීමට පහසු කැමරා පන්තිය
බලවත් API වෙත pco.sdk
සමඟ රූප පටිගත කිරීම සහ සැකසීම pco.recorder

1.1 ස්ථාපනය
pypi වෙතින් ස්ථාපනය කරන්න (නිර්දේශිත):
$ pip ස්ථාපනය pco
1.2 මූලික භාවිතය
matplotlib.pyplot plt ලෙස ආයාත කරන්න
pco ආනයනය කරන්න
pco.Camera() කැමරාව ලෙස:
cam.record()
රූපය, මෙටා = cam.image()
plt.imshow(රූපය, cmap='අළු')
plt.show() (1.3 සිදුවීම් සහ දෝෂ ලොග් කිරීම
ලොග් ප්‍රතිදානය සක්‍රිය කිරීමට, debuglevel= පරාමිතිය සමඟ කැමරා වස්තුව සාදන්න.
නිදොස් කිරීමේ මට්ටම පහත අගයන්ගෙන් එකකට සැකසිය හැක:

'අක්‍රිය' සියලු ප්‍රතිදානය අක්‍රීය කරයි.
'error' පෙන්වන්නේ දෝෂ පණිවිඩ පමණි.
'verbose' සියලුම පණිවිඩ පෙන්වයි.
'extra verbose' සියලුම පණිවිඩ සහ අගයන් පෙන්වයි.

පෙරනිමි නිදොස් මට්ටම 'අක්‍රිය' වේ.
pco.Camera(debuglevel='verbose')
…
[][sdk] get_camera_type: හරි.
විකල්ප වේලාවamp= පරාමිතිය සක්රිය කරයි a tag මුද්‍රිත ප්‍රතිදානයේ. විය හැකි අගයන් වන්නේ: 'on' සහ 'off'. පෙරනිමි අගය 'අක්‍රිය' වේ.
pco.Camera(debuglevel='verbose', timestamp='on')
…
[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: හරි.

API ලේඛනගත කිරීම

pco.Camera පන්තිය පහත ක්‍රම ඉදිරිපත් කරයි:

record() නව පටිගත කිරීමේ අවස්ථාවක් උත්පාදනය කරයි, වින්‍යාස කරයි, සහ ආරම්භ කරයි.
stop() වත්මන් පටිගත කිරීම නවත්වයි.
close() වත්මන් සක්‍රිය කැමරාව වසා දමා වාඩිලාගෙන සිටින සම්පත් නිදහස් කරයි.
image() රෙකෝඩරයෙන් රූපයක් numpy array ලෙස ලබා දෙයි.
images() රෙකෝඩරයෙන් පටිගත කරන ලද සියලුම පින්තූර numpy arrays ලැයිස්තුවක් ලෙස ලබා දෙයි.
image_average() සාමාන්‍ය රූපය ලබා දෙයි. මෙම රූපය බෆරයේ සියලුම වාර්තාගත පින්තූර වලින් ගණනය කෙරේ.
set_exposure_time() කැමරාව සඳහා නිරාවරණ කාලය සකසයි.
wait_for_first_image() රෙකෝඩර මතකයේ ඇති පළමු රූපය එනතෙක් බලා සිටී.

pco.Camera පන්තියට පහත විචල්‍ය ඇත:

වින්යාසය

pco.Camera පන්තියට පහත වස්තූන් ඇත:

sdk හි සියලුම යටින් පවතින කාර්යයන් සඳහා සෘජු ප්‍රවේශය ලබා දෙයි pco.sdk.
රෙකෝඩරය මඟින් සියලුම යටින් පවතින කාර්යයන් සඳහා සෘජු ප්‍රවේශය ලබා දේ pco.recorder.

2.1 ක්‍රම
මෙම කොටස pco.Camera පන්තිය විසින් පිරිනමනු ලබන සියලුම ක්‍රම විස්තර කරයි.
2.1.1 වාර්තාව
විස්තරය නව පටිගත කිරීමේ අවස්ථාවක් නිර්මාණය කිරීම, වින්‍යාස කිරීම සහ ආරම්භ කිරීම. වාර්තාව() ඇමතීමට පෙර සම්පූර්ණ කැමරා වින්‍යාසය සැකසිය යුතුය. set_exposure_time() විධානය එකම ව්‍යතිරේකයයි. මෙම ශ්‍රිතය රෙකෝඩර වස්තුවට කිසිදු බලපෑමක් නොකරන අතර පටිගත කිරීමේදී එය කැඳවිය හැක.
මූලාකෘතිය def වාර්තාව (ස්වයං, number_of_images=1, mode='sequence'):
පරාමිතිය

නම	විස්තරය
පින්තූර_අංක	ධාවකයේ වෙන් කර ඇති පින්තූර ගණන සකසයි. පරිගණකයේ RAM උපරිම අගය සීමා කරයි.
මාදිලිය	'අනුපිළිවෙල' මාදිලියේදී, මෙම කාර්යය වාර්තා කිරීමේදී අවහිර වේ. අංක_of_images වෙත ළඟා වූ විට රෙකෝඩරය ස්වයංක්‍රීයව නතර වේ. 'අනුක්‍රමය අවහිර නොවන' මාදිලියේ, මෙම ශ්‍රිතය අවහිර නොවන වේ. පින්තූරයක් කියවීමට පෙර තත්වය පරීක්ෂා කළ යුතුය. මෙම මාදිලිය පටිගත කිරීමේදී පින්තූර කියවීමට භාවිතා කරයි, උදා සිඟිති රූ. 'ring buffer' මාදිලියේ මෙම කාර්යය අවහිර නොවේ. පින්තූරයක් කියවීමට පෙර තත්වය පරීක්ෂා කළ යුතුය. අංක_of_images වෙත ළඟා වූ විට රෙකෝඩරය පටිගත කිරීම නවත්වන්නේ නැත. මෙය සිදු වූ පසු, පැරණිතම රූප නැවත ලියනු ලැබේ. 'fifo' මාදිලියේදී, මෙම කාර්යය අවහිර නොකරයි. පින්තූරයක් කියවීමට පෙර තත්වය පරීක්ෂා කළ යුතුය. fifo හි ඇති_රූප_සංඛ්‍යාවට ළඟා වූ විට, fifo වෙතින් රූප කියවන තෙක් පහත රූප පහත වැටේ.

2.1.2 නවත්වන්න
විස්තරය වත්මන් පටිගත කිරීම නවත්වයි. 'ring buffer' සහ 'fifo' මාදිලියේදී, මෙම ශ්‍රිතය පරිශීලකයා විසින් ඇමතිය යුතුය. 'sequence' සහ 'sequence non blocking' මාදිලියේදී, number_of_images වෙත ළඟා වූ විට මෙම ශ්‍රිතය ස්වයංක්‍රීයව කැඳවනු ලැබේ.
මූලාකෘතිය def නැවතුම (ස්වයං):
2.1.3 වසන්න
විස්තරය සක්‍රිය කැමරාව වසා අවහිර කළ සම්පත් මුදාහරියි. යෙදුම අවසන් වීමට පෙර මෙම කාර්යය කැඳවිය යුතුය. එසේ නොමැති නම්, සම්පත් රැඳී පවතී.
මූලාකෘතිය සමීප (ස්වයං):
ප්‍රකාශය සමඟ කැමරා වස්තුව නිර්මාණය කරන්නේ නම් මෙම ශ්‍රිතය ස්වයංක්‍රීයව හැඳින්වේ. () වසා දැමීමට පැහැදිලි ඇමතුමක් තවදුරටත් අවශ්‍ය නොවේ.
pco.Camera() කැමරාව ලෙස: # සමහර දේවල් කරන්න
2.1.4 රූපය
විස්තරය රෙකෝඩරයෙන් රූපයක් ලබා දෙයි. රූපයේ වර්ගය numpy.ndarray වේ. මෙම අරාව රූපයේ විභේදනය සහ ROI මත පදනම්ව හැඩගස්වා ඇත.
මූලාකෘතිය def image(self, image_number=0, roi=None):
පරාමිතිය

නම	විස්තරය
රූප_අංකය	කියවිය යුතු රූපයේ අංකය සඳහන් කරයි. 'අනුක්‍රමය' හෝ 'අනුක්‍රමය අවහිර නොවන' ආකාරයෙන්, පටිගත කිරීමේ දර්ශකය image_number සමඟ ගැලපේ. image_number 0xFFFFFFFF ලෙස සකසා ඇත්නම්, අවසන් වරට පටිගත කළ රූපය පිටපත් කරනු ලැබේ. මෙය සජීවී පෙර නිර්මාණය කිරීමට ඉඩ සලසයිview පටිගත කිරීමේදී.
රෝයි	උනන්දුවක් දක්වන කලාපය සකසයි. රූපයේ මෙම කලාපය පමණක් ආපසු ලැබෙන අගයට පිටපත් කර ඇත.

Example >>> cam.record(number_of_images=1, mode='sequence')
>>> රූපය, meta = cam.image()
>>> (රූපය) numpy.ndarray ටයිප් කරන්න
>>> image.shape (2160, 2560)
>>> රූපය, පාරදත්ත = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
රූප 2.1.5ක්
විස්තරය රෙකෝඩරයෙන් පටිගත කරන ලද සියලුම පින්තූර numpy array ලැයිස්තුවක් ලෙස ලබා දෙයි.
මූලාකෘතිය def images(self, roi=None, blocksize=None):
පරාමිතිය

නම	විස්තරය
රෝයි	උනන්දුවක් දක්වන කලාපය සකසයි. රූපයේ මෙම කලාපය පමණක් ආපසු ලැබෙන අගයට පිටපත් කර ඇත.
බ්ලොක්සයිස් කරන්න	ආපසු ලැබෙන උපරිම පින්තූර ගණන නිර්වචනය කරයි. මෙම පරාමිතිය ප්‍රයෝජනවත් වන්නේ 'fifo' මාදිලියේ සහ විශේෂ තත්ව යටතේ පමණි.

Example >>> cam.record(number_of_images=20, mode='sequence')
>>> පින්තූර, පාරදත්ත = cam.images()
>>> ලෙන් (පින්තූර) 20
>>> පින්තූරවල රූපය සඳහා:
…
මුද්‍රණය ('මධ්‍යන්‍ය: {:7.2f} DN'.format(image.mean()))
…
මධ්යන්ය: 2147.64 DN
මධ්යන්ය: 2144.61 DN
…
>>> පින්තූර = cam.images(roi=(1, 1, 300, 300))
>>> පින්තූර[0].හැඩය (300, 300)
2.1.6 Image_average
විස්තරය සාමාන්‍ය රූපය ලබා දෙයි. මෙම රූපය බෆරයේ සියලුම වාර්තාගත පින්තූර වලින් ගණනය කෙරේ.
මූලාකෘතිය def image_average(self, roi=None):
පරාමිතිය

නම	විස්තරය
රෝයි	උනන්දුවක් දක්වන කලාපය නිර්වචනය කරයි. රූපයේ මෙම කලාපය පමණක් ආපසු ලැබෙන අගයට පිටපත් කර ඇත.

Example >>> cam.record(number_of_images=100, mode='sequence')
>>> සාමාන්‍යය = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 නිරාවරණ_කාල සකසන්න
විස්තරය කැමරාවේ නිරාවරණ කාලය සකසයි.
මූලාකෘතිය def set_exposure_time(self, exposure_time):
පරාමිතිය

නම	විස්තරය
නිරාවරණ කාලය	'දෙවන' ඒකකයේ float හෝ integer අගය ලෙස දිය යුතුය. sdk.set_delay_exposure_time(0, 'ms', time, timebase) ශ්‍රිතය සඳහා පාදක අගයන් ස්වයංක්‍රීයව ගණනය කෙරේ. ප්‍රමාද කාලය 0 ලෙස සකසා ඇත.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 පළමු_රූපය සඳහා_රැඳී සිටින්න
විස්තරය රෙකෝඩර මතකයේ ඇති පළමු රූපය සඳහා රැඳී සිටින්න. රෙකෝඩර ප්‍රකාරයේදී 'අනුපිළිවෙල අවහිර නොවන', 'මුදු බෆරය'. සහ 'fifo', ශ්‍රිත වාර්තාව() වහාම ලබා දෙයි. එමනිසා, මෙම ශ්‍රිතය image(), images(), or image_average() ඇමතීමට පෙර කැමරාවෙන් රූප එනතෙක් බලා සිටීමට භාවිතා කළ හැක.
මූලාකෘතිය def wait_for_first_image(self):
2.2 විචල්‍ය වින්‍යාසය
වින්‍යාස විචල්‍යය වෙනස් කිරීමෙන් කැමරා පරාමිතීන් යාවත්කාලීන වේ.
cam.configuration = {'නිරාවරණ කාලය': 10e-3,
'roi': (1, 1, 512, 512),
'කාලයamp': 'ascii',
'පික්සල් අනුපාතය': 100_000_000,
'trigger': 'ස්වයං අනුපිළිවෙල',
'අත්පත් කරගන්න': 'ස්වයං',
'පාර-දත්ත': 'on',
'බඳින': (1, 1)}
විචල්‍යය වෙනස් කළ හැක්කේ වාර්තා() ශ්‍රිතය කැඳවීමට පෙර පමණි. එය නිශ්චිත ඇතුළත් කිරීම් සංඛ්‍යාවක් සහිත ශබ්දකෝෂයකි. හැකි සෑම අංගයක්ම සඳහන් කිරීම අවශ්ය නොවේ. පහත දැක්වෙන එස්ample කේතය 'පික්සල් අනුපාතය' පමණක් වෙනස් කරන අතර වින්‍යාසයේ වෙනත් කිසිදු අංගයකට බලපාන්නේ නැත.
pco.Camera() කැමරාව ලෙස:
cam.configuration = {'පික්සල් අනුපාතය': 286_000_000}
cam.record()
…
වස්තු 2.3
මෙම කොටස pco.Camera පන්තිය විසින් පිරිනමනු ලබන සියලුම වස්තු විස්තර කරයි.
2.3.1 SDK
වස්තුව sdk මඟින් සියලුම යටින් පවතින කාර්යයන් වෙත සෘජු ප්‍රවේශය ලබා දේ pco.sdk.
>>> cam.sdk.get_temperature()
{'සංවේදක උෂ්ණත්වය': 7.0, 'කැමරා උෂ්ණත්වය': 38.2, 'බල උෂ්ණත්වය': 36.7}
sdk ශ්‍රිත වලින් ලැබෙන සියලුම ප්‍රතිලාභ අගයන් ශබ්දකෝෂ වේ. සියලුම කැමරා සැකසුම් දැනට කැමරා පන්තියෙන් ආවරණය නොවේ. අදාළ sdk ශ්‍රිතය ඇමතීමෙන් විශේෂ සැකසුම් සෘජුවම සැකසිය යුතුය.
2.3.2 රෙකෝඩරය
වස්තුවේ rec හි සියලුම යටින් පවතින කාර්යයන් සඳහා සෘජු ප්‍රවේශය ලබා දෙයි pco.recorder. රෙකෝඩර් පන්තියේ ක්රමයක් කෙලින්ම ඇමතීමට අවශ්ය නොවේ. සියලුම කාර්යයන් කැමරා පන්තියේ ක්‍රම මගින් සම්පූර්ණයෙන්ම ආවරණය කර ඇත.