EXCELITAS TECHNOLOGIES పైథాన్ సాఫ్ట్‌వేర్ డెవలప్‌మెంట్ కిట్ యూజర్ మాన్యువల్

పైథాన్ సాఫ్ట్‌వేర్ డెవలప్‌మెంట్ కిట్
వినియోగదారు మాన్యువల్

పైథాన్ సాఫ్ట్‌వేర్ డెవలప్‌మెంట్ కిట్

PCO ఈ పత్రంలోని సూచనలను జాగ్రత్తగా చదవమని మరియు అనుసరించమని మిమ్మల్ని అడుగుతుంది.
ఏవైనా ప్రశ్నలు లేదా వ్యాఖ్యల కోసం, దయచేసి ఎప్పుడైనా మమ్మల్ని సంప్రదించడానికి సంకోచించకండి.
టెలిఫోన్: +49 (0) 9441 2005 50
ఫ్యాక్స్: +49 (0) 9441 2005 20
పోస్టల్ చిరునామా: Excelitas PCO GmbH డోనౌపార్క్ 11 93309 కెల్‌హీమ్, జర్మనీ
ఇమెయిల్: info@pco.de
web: www.pco.de
pco.python యూజర్ మాన్యువల్ 0.1.7
డిసెంబర్ 2021 విడుదలైంది
©కాపీరైట్ Excelitas PCO GmbH
ఈ పని క్రియేటివ్ కామన్స్ అట్రిబ్యూషన్-నో డెరివేటివ్స్ 4.0 ఇంటర్నేషనల్ లైసెన్స్ క్రింద లైసెన్స్ పొందింది. కు view ఈ లైసెన్స్ కాపీ, సందర్శించండి http://creativecommons.org/licenses/by-nd/4.0/ లేదా క్రియేటివ్ కామన్స్, PO బాక్స్ 1866, మౌంటైన్‌కి లేఖ పంపండి View, CA 94042, USA.

జనరల్

పైథాన్ ప్యాకేజీ pco కరెంట్‌పై ఆధారపడిన pco కెమెరాలతో పని చేయడానికి అన్ని ఫంక్షన్‌లను అందిస్తుంది pco.sdk. కెమెరాతో కమ్యూనికేషన్ మరియు తదుపరి ఇమేజ్ ప్రాసెసింగ్ కోసం అన్ని భాగస్వామ్య లైబ్రరీలు చేర్చబడ్డాయి.

• కెమెరా క్లాస్‌ని ఉపయోగించడం సులభం
• శక్తివంతమైన API pco.sdk
• చిత్రం రికార్డింగ్ మరియు ప్రాసెసింగ్ pco.recorder

1.1 సంస్థాపన
pypi నుండి ఇన్‌స్టాల్ చేయండి (సిఫార్సు చేయబడింది):
$ పిప్ ఇన్‌స్టాల్ pco
1.2 ప్రాథమిక వినియోగం
matplotlib.pyplot ని plt గా దిగుమతి చేసుకోండి
pco దిగుమతి
pco.Camera()తో కెమెరాగా:
cam.record()
చిత్రం, మెటా = cam.image()
plt.imshow(చిత్రం, cmap='గ్రే')
plt.show() ను చూపించు1.3 ఈవెంట్ మరియు ఎర్రర్ లాగింగ్
లాగింగ్ అవుట్‌పుట్‌ని సక్రియం చేయడానికి, debuglevel= పారామీటర్‌తో కెమెరా ఆబ్జెక్ట్‌ను సృష్టించండి.
డీబగ్ స్థాయిని కింది విలువల్లో ఒకదానికి సెట్ చేయవచ్చు:

• 'ఆఫ్' అన్ని అవుట్‌పుట్‌లను నిలిపివేస్తుంది.
• 'error' దోష సందేశాలను మాత్రమే చూపుతుంది.
• 'verbose' అన్ని సందేశాలను చూపుతుంది.
• 'అదనపు వెర్బోస్' అన్ని సందేశాలు మరియు విలువలను చూపుతుంది.

డిఫాల్ట్ డీబగ్లెవల్ 'ఆఫ్'.
pco.Camera(డీబగ్ లెవెల్='వెర్బోస్')
…
[][sdk] get_camera_type: సరే.
ఐచ్ఛిక సమయంamp= పారామితి a యాక్టివేట్ చేస్తుంది tag ప్రింటెడ్ అవుట్‌పుట్‌లో. సాధ్యమయ్యే విలువలు: 'ఆన్' మరియు 'ఆఫ్'. డిఫాల్ట్ విలువ 'ఆఫ్'.
pco.Camera(డీబగ్ లెవెల్='వెర్బోస్', టైమ్‌స్ట్amp='ఆన్')
…
[2019-11-25 15:54:15.317855 / 0.016 సె] [][sdk] get_camera_type: సరే.

API డాక్యుమెంటేషన్

pco.Camera తరగతి క్రింది పద్ధతులను అందిస్తుంది:

• record() కొత్త రికార్డర్ ఉదాహరణను ఉత్పత్తి చేస్తుంది, కాన్ఫిగర్ చేస్తుంది మరియు ప్రారంభిస్తుంది.
• stop() ప్రస్తుత రికార్డింగ్‌ను ఆపివేస్తుంది.
• close() ప్రస్తుత క్రియాశీల కెమెరాను మూసివేస్తుంది మరియు ఆక్రమిత వనరులను విడుదల చేస్తుంది.
• image() రికార్డర్ నుండి ఒక చిత్రాన్ని నంపీ అర్రేగా అందిస్తుంది.
• images() రికార్డర్ నుండి రికార్డ్ చేయబడిన అన్ని చిత్రాలను నంపీ శ్రేణుల జాబితాగా అందిస్తుంది.
• 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() కమాండ్ మాత్రమే మినహాయింపు. ఈ ఫంక్షన్ రికార్డర్ వస్తువుపై ఎటువంటి ప్రభావం చూపదు మరియు రికార్డింగ్ సమయంలో కాల్ చేయవచ్చు.
నమూనా డెఫ్ రికార్డ్(self, number_of_images=1, mode='sequence'):
పరామితి

2.1.2 ఆపు
వివరణ ప్రస్తుత రికార్డింగ్‌ను ఆపివేస్తుంది. 'రింగ్ బఫర్' మరియు 'ఫిఫో' మోడ్‌లో, ఈ ఫంక్షన్ తప్పనిసరిగా వినియోగదారు ద్వారా కాల్ చేయబడాలి. 'సీక్వెన్స్' మరియు 'సీక్వెన్స్ నాన్ బ్లాకింగ్' మోడ్‌లో, number_of_imagesకి చేరుకున్నప్పుడు ఈ ఫంక్షన్ స్వయంచాలకంగా కాల్ చేయబడుతుంది.
నమూనా డెఫ్ స్టాప్ (స్వీయ):
2.1.3 మూసివేయి
వివరణ యాక్టివేట్ చేయబడిన కెమెరాను మూసివేస్తుంది మరియు బ్లాక్ చేయబడిన వనరులను విడుదల చేస్తుంది. అప్లికేషన్ ముగించబడటానికి ముందు ఈ ఫంక్షన్ తప్పనిసరిగా కాల్ చేయబడాలి. లేకపోతే, వనరులు ఆక్రమించబడి ఉంటాయి.
నమూనా డెఫ్ క్లోజ్ (స్వీయ):
కెమెరా ఆబ్జెక్ట్ విత్ స్టేట్‌మెంట్ ద్వారా సృష్టించబడినట్లయితే ఈ ఫంక్షన్ స్వయంచాలకంగా పిలువబడుతుంది. మూసివేయడానికి స్పష్టమైన కాల్ () అవసరం లేదు.
pco.Camera()తో క్యామ్‌గా: # కొన్ని అంశాలను చేయండి
2.1.4 చిత్రం
వివరణ రికార్డర్ నుండి చిత్రాన్ని అందిస్తుంది. చిత్రం రకం numpy.ndarray. చిత్రం యొక్క రిజల్యూషన్ మరియు ROI ఆధారంగా ఈ శ్రేణి ఆకారంలో ఉంటుంది.
నమూనా డెఫ్ ఇమేజ్(స్వీయ, image_number=0, roi=ఏదీ కాదు):
పరామితి

Example >>> cam.record(number_of_images=1, mode='sequence')
>>> చిత్రం, మెటా = cam.image()
>>> టైప్(చిత్రం) numpy.ndarray
>>> image.shape (2160, 2560)
>>> చిత్రం, మెటాడేటా = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 చిత్రాలు
వివరణ రికార్డర్ నుండి రికార్డ్ చేయబడిన అన్ని చిత్రాలను నంపీ శ్రేణుల జాబితాగా చూపుతుంది.
నమూనా డెఫ్ ఇమేజ్‌లు(స్వీయ, roi=ఏదీ కాదు, బ్లాక్‌సైజ్=ఏదీ కాదు):
పరామితి

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 ఇమేజ్_సగటు
వివరణ సగటు చిత్రాన్ని చూపుతుంది. ఈ చిత్రం బఫర్‌లో రికార్డ్ చేయబడిన అన్ని చిత్రాల నుండి లెక్కించబడుతుంది.
నమూనా def image_average(self, roi=ఏదీ కాదు):
పరామితి

Example >>> cam.record(number_of_images=100, mode='sequence')
>>> సగటు = cam.image_average()
>>> సగటు = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 సెట్_ఎక్స్‌పోజర్_టైమ్
వివరణ కెమెరా ఎక్స్‌పోజర్ సమయాన్ని సెట్ చేస్తుంది.
నమూనా def set_exposure_time(self, exposure_time):
పరామితి

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 వెయిట్_ఫర్_ఫస్ట్_ఇమేజ్
వివరణ రికార్డర్ మెమరీలో అందుబాటులో ఉన్న మొదటి చిత్రం కోసం వేచి ఉంది. రికార్డర్ మోడ్‌లో 'సీక్వెన్స్ నాన్ బ్లాకింగ్', 'రింగ్ బఫర్'. మరియు 'fifo', ఫంక్షన్ రికార్డ్() వెంటనే తిరిగి వస్తుంది. అందువల్ల, ఇమేజ్(), ఇమేజ్‌లు(), లేదా ఇమేజ్_యావరేజ్()కి కాల్ చేయడానికి ముందు కెమెరా నుండి చిత్రాల కోసం వేచి ఉండటానికి ఈ ఫంక్షన్ ఉపయోగించవచ్చు.
నమూనా def wait_for_first_image(self):
2.2 వేరియబుల్ కాన్ఫిగరేషన్
కాన్ఫిగరేషన్ వేరియబుల్‌ని మార్చడం ద్వారా కెమెరా పారామీటర్‌లు నవీకరించబడతాయి.
cam.configuration = {'ఎక్స్‌పోజర్ టైమ్': 10e-3,
'roi': (1, 1, 512, 512),
'సమయంamp': 'ascii',
'పిక్సెల్ రేటు': 100_000_000,
'ట్రిగ్గర్': 'ఆటో సీక్వెన్స్',
'పొందండి': 'ఆటో',
'మెటాడేటా': 'ఆన్',
'బిన్నింగ్': (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. రికార్డర్ క్లాస్ పద్ధతిని నేరుగా కాల్ చేయవలసిన అవసరం లేదు. అన్ని విధులు కెమెరా క్లాస్ యొక్క పద్ధతుల ద్వారా పూర్తిగా కవర్ చేయబడతాయి.

https://www.pco.de/applications/