የEXCELITAS ቴክኖሎጅዎች Python ሶፍትዌር ልማት ኪት የተጠቃሚ መመሪያ

Python ሶፍትዌር ልማት ኪት
የተጠቃሚ መመሪያ

ይዘቶች መደበቅ

1 Python ሶፍትዌር ልማት ኪት

Python ሶፍትዌር ልማት ኪት

PCO በዚህ ሰነድ ውስጥ ያሉትን መመሪያዎች በጥንቃቄ እንዲያነቡ እና እንዲከተሉ ይጠይቅዎታል።
ለማንኛውም ጥያቄ ወይም አስተያየት እባክዎን በማንኛውም ጊዜ እኛን ለማነጋገር ነፃነት ይሰማዎ.
ስልክ: +49 (0) 9441 2005 50
ፋክስ፡ +49 (0) 9441 2005 20
የፖስታ አድራሻ፡ Excelitas PCO GmbH Donaupark 11 93309 Kelheim፣ ጀርመን
ኢሜይል፡- info@pco.de
web: www.pco.de
pco.python የተጠቃሚ መመሪያ 0.1.7
በታህሳስ 2021 ተለቋል
©የቅጂ መብት Excelitas PCO GmbH
ይህ ሥራ በCreative Commons Attribution-No Derivatives 4.0 International License ፍቃድ ተሰጥቶታል። ለ view የዚህ ፈቃድ ቅጂ, ይጎብኙ http://creativecommons.org/licenses/by-nd/4.0/ ወይም ለ Creative Commons, PO Box 1866, Mountain ደብዳቤ ይላኩ View, CA 94042, አሜሪካ.

አጠቃላይ

የ Python ፓኬጅ ፒኮ አሁን ባለው ሁኔታ ላይ ከተመሠረቱ ከፒኮ ካሜራዎች ጋር ለመስራት ሁሉንም ተግባራት ያቀርባል pco.sdk. ከካሜራ ጋር ለመግባባት ሁሉም የጋራ ቤተ-መጻሕፍት እና ቀጣይ የምስል ማቀነባበሪያዎች ተካትተዋል።

የካሜራ ክፍል ለመጠቀም ቀላል
ኃይለኛ ኤፒአይ ወደ pco.sdk

ምስል መቅዳት እና ማቀናበር በ pco. መቅጃ

1.1 መጫን
ከ pypi ጫን (የሚመከር)
$ pip ጫን pco
1.2 መሠረታዊ አጠቃቀም
matplotlib.pyplot እንደ plt አስመጣ
pco አስመጣ
በpco.Camera() እንደ ካሜራ፡-
cam.record()
ምስል፣ ሜታ = cam.image()
plt.imshow(ምስል፣ cmap='ግራጫ')
plt.ሾው()1.3 ክስተት እና ስህተት መግባት
የመግቢያ ውፅዓትን ለማግበር የካሜራውን ነገር በ debuglevel= parameter ይፍጠሩ።
የማረም ደረጃው ከሚከተሉት እሴቶች ወደ አንዱ ሊዋቀር ይችላል፡

'ጠፍቷል' ሁሉንም ውፅዓት ያሰናክላል።
'ስህተት' የስህተት መልዕክቶችን ብቻ ያሳያል።

'በቃል' ሁሉንም መልዕክቶች ያሳያል።
'ተጨማሪ ቃል' ሁሉንም መልዕክቶች እና እሴቶች ያሳያል።

ነባሪው ማረም 'ጠፍቷል' ነው።
pco.Camera(debuglevel='verbose')
…
[[sdk] የካሜራ_አይነት ያግኙ፡ እሺ።
የአማራጭ ጊዜamp= መለኪያ ያንቀሳቅሰዋል ሀ tag በታተመ ውፅዓት. ሊሆኑ የሚችሉ እሴቶች፡ 'በርቷል' እና 'ጠፍተዋል' ናቸው። ነባሪው ዋጋ 'ጠፍቷል' ነው።
pco.Camera(debuglevel='verbose'፣timestamp='ላይ')
…
[2019-11-25 15:54:15.317855 / 0.016 ዎች] [][sdk] የካሜራ_አይነት ያግኙ፡ እሺ።

የኤፒአይ ሰነድ

የ pco.Camera ክፍል የሚከተሉትን ዘዴዎች ያቀርባል:

record() ያመነጫል፣ ያዋቅራል እና አዲስ መቅጃ ምሳሌ ይጀምራል።
stop() የአሁኑን ቀረጻ ያቆማል።

ቅርብ () የአሁኑን ንቁ ካሜራ ይዘጋዋል እና የተያዙትን ሀብቶች ይለቀቃል።
ምስል() ከመዝጋቢው ላይ እንደ ቁጥር ድርድር ይመልሳል።

ምስሎች() ሁሉንም የተቀረጹ ምስሎች ከመዝጋቢው እንደ የቁጥር ድርድሮች ዝርዝር ይመልሳል።
image_average() አማካዩን ምስል ይመልሳል። ይህ ምስል በመጠባበቂያው ውስጥ ካሉት ምስሎች ሁሉ ይሰላል።

set_exposure_time() የካሜራውን የተጋላጭነት ጊዜ ያዘጋጃል።
wait_for_first_image() በመቅረጫ ማህደረ ትውስታ ውስጥ የመጀመሪያውን የሚገኝ ምስል ይጠብቃል።

የ pco.Camera ክፍል የሚከተለው ተለዋዋጭ አለው፡-

ማዋቀር

የ pco.Camera ክፍል የሚከተሉት ነገሮች አሉት፡

sdk የሁሉም መሰረታዊ ተግባራት ቀጥተኛ መዳረሻን ይሰጣል pco.sdk.

መቅረጫ ወደ ሁሉም መሰረታዊ ተግባራት ቀጥተኛ መዳረሻን ይሰጣል pco. መቅጃ.

2.1 ዘዴዎች
ይህ ክፍል በ pco.Camera ክፍል የቀረቡትን ሁሉንም ዘዴዎች ይገልጻል።
2.1.1 መዝገብ
መግለጫ አዲስ መቅጃ ምሳሌ ይፈጥራል፣ ያዋቅራል እና ይጀምራል። ሪኮርድ() ከመደወልዎ በፊት የካሜራው ውቅር በሙሉ መዘጋጀት አለበት። የ set_exposure_time() ትዕዛዝ ብቸኛው ልዩነት ነው። ይህ ተግባር በመዝጋቢው ነገር ላይ ምንም ተጽእኖ የለውም እና በሚቀዳበት ጊዜ ሊጠራ ይችላል.
ፕሮቶታይፕ ዲፍ መዝገብ(ራስ፣ ቁጥር_of_images=1፣ ሁነታ='ተከታታይ')፡
መለኪያ

ስም	መግለጫ
የምስሎች_ቁጥር	በአሽከርካሪው ውስጥ የተመደቡትን ምስሎች ብዛት ያዘጋጃል። የፒሲው RAM ከፍተኛውን ዋጋ ይገድባል.
ሁነታ	በ'ተከታታይ' ሁነታ፣ ይህ ተግባር በመዝገብ ጊዜ እየታገደ ነው። የምስሎች_ቁጥር ሲደርስ መቅጃው በራስ ሰር ይቆማል። በ 'sequence non blocking' ሁነታ፣ ይህ ተግባር የማይታገድ ነው። ምስል ከማንበብዎ በፊት ሁኔታው መፈተሽ አለበት። ይህ ሁነታ በሚቀረጽበት ጊዜ ምስሎችን ለማንበብ ይጠቅማል ለምሳሌ ድንክዬ። በ'ቀለበት ቋት' ሁነታ ይህ ተግባር አይከለከልም። ምስል ከማንበብዎ በፊት ሁኔታው መፈተሽ አለበት። የምስሎች_ቁጥር ሲደርስ መቅጃውን አያቆምም። አንዴ ይህ ከተከሰተ፣ በጣም የቆዩ ምስሎች ተፅፈዋል። በ'fifo' ሁነታ፣ ይህ ተግባር የማይታገድ ነው። ምስል ከማንበብዎ በፊት ሁኔታው መፈተሽ አለበት። በፊፎ ውስጥ ያሉት የምስሎች_ብዛት ሲደርስ፣ ምስሎች ከፊፎ እስኪነበቡ ድረስ የሚከተሉት ምስሎች ይጣላሉ።

2.1.2 አቁም
መግለጫ የአሁኑን ቀረጻ ያቆማል። በ'ring buffer' እና 'fifo' mode ውስጥ ይህ ተግባር በተጠቃሚው መጠራት አለበት። በ'sequence' and 'sequence non blocking' ሁነታ፣ የምስሎች_ቁጥር ሲደርሱ ይህ ተግባር በራስ-ሰር ይጠራል።
ፕሮቶታይፕ መከላከያ ማቆም (ራስ):
2.1.3 ዝጋ
መግለጫ የነቃውን ካሜራ ይዘጋውና የታገዱትን ምንጮች ይለቀቃል። ይህ ተግባር ማመልከቻው ከመቋረጡ በፊት መጠራት አለበት። አለበለዚያ ሀብቱ እንደተያዘ ይቆያል.
ፕሮቶታይፕ መዝጋት (ራስ):
የካሜራው ነገር በመግለጫው ከተፈጠረ ይህ ተግባር በራስ-ሰር ይጠራል። ለመዝጋት() ግልጽ ጥሪ ከአሁን በኋላ አያስፈልግም።
በ pco.Camera() እንደ ካሜራ፡ # አንዳንድ ነገሮችን ያድርጉ
2.1.4 ምስል
መግለጫ ከቀረጻው ምስል ይመልሳል። የምስሉ አይነት numpy.ndarray ነው። ይህ ድርድር በምስሉ ጥራት እና ROI ላይ በመመስረት የተቀረፀ ነው።
ፕሮቶታይፕ def ምስል(ራስ፣ image_number=0፣ roi=ምንም)፡
መለኪያ

ስም	መግለጫ
የምስል ቁጥር	የሚነበበው የምስሉን ቁጥር ይገልጻል። በ'sequence' or 'sequence non blocking' ሁነታ፣ የመቅጃው ኢንዴክስ ከምስሉ_ቁጥሩ ጋር ይዛመዳል። የምስል ቁጥር ወደ 0xFFFFFFFF ከተዋቀረ የመጨረሻው የተቀዳው ምስል ይገለበጣል። ይህ የቀጥታ ቅድመ ሁኔታን ለመፍጠር ያስችላልview በሚቀዳበት ጊዜ.
ሮይ	የፍላጎት ክልልን ያዘጋጃል። ይህ የምስሉ ክልል ብቻ ወደ መመለሻ ዋጋው ይገለበጣል።

Example >>> cam.record(ቁጥር_of_images=1፣ ሁነታ='ተከታታይ')
>>> ምስል፣ ሜታ = cam.image()
>>> አይነት (ምስል) numpy.ndarray
>>> ምስል. ቅርፅ (2160, 2560)
>>> ምስል፣ ሜታዳታ = cam.image(roi=(1፣ 1፣ 300፣ 300))
>>> ምስል. ቅርፅ (300, 300)
2.1.5 ምስሎች
መግለጫ ሁሉንም የተቀረጹ ምስሎች ከመቅጃው እንደ የቁጥር ድርድሮች ዝርዝር ይመልሳል።
ፕሮቶታይፕ def ምስሎች(ራስ፣ roi= የለም፣ blocksize=ምንም)
መለኪያ

ስም	መግለጫ
ሮይ	የፍላጎት ክልልን ያዘጋጃል። ይህ የምስሉ ክልል ብቻ ወደ መመለሻ ዋጋው ይገለበጣል።
አግድ	የሚመለሱትን ከፍተኛውን የምስሎች ብዛት ይገልጻል። ይህ ግቤት በ'fifo' mode እና በልዩ ሁኔታዎች ውስጥ ብቻ ጠቃሚ ነው።

Example >>> cam.record(ቁጥር_of_images=20፣ ሁነታ='ተከታታይ')
>>> ምስሎች፣ ሜታዳታዎች = cam.images()
>>> ሌን (ምስሎች) 20
>>> በምስሎች ላይ ላለው ምስል፡-
…
አትም
…
አማካኝ፡ 2147.64 ዲ.ኤን
አማካኝ፡ 2144.61 ዲ.ኤን
…
>>> ምስሎች = cam.images(roi=(1, 1, 300, 300))
>>> ምስሎች[0] ቅርጽ (300, 300)
2.1.6 ምስል_አማካይ
መግለጫ አማካዩን ምስል ይመልሳል። ይህ ምስል በመጠባበቂያው ውስጥ ካሉት ምስሎች ሁሉ ይሰላል።
ፕሮቶታይፕ def image_average(ራስ፣ roi= የለም):
መለኪያ

ስም	መግለጫ
ሮይ	የፍላጎት ክልልን ይገልጻል። ይህ የምስሉ ክልል ብቻ ወደ መመለሻ ዋጋው ይገለበጣል።

Example >>> cam.record(ቁጥር_of_images=100፣ ሁነታ='ተከታታይ')
>>> አማካኝ = cam.image_አማካይ()
>>> አማካኝ = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 የተጋላጭነት_ጊዜን አዘጋጅ
መግለጫ የካሜራውን የተጋላጭነት ጊዜ ያዘጋጃል።
ፕሮቶታይፕ def set_exposure_time(ራስ፣ የተጋላጭነት_ጊዜ)
መለኪያ

ስም	መግለጫ
የተጋላጭነት ጊዜ	በክፍል 'ሰከንድ' ውስጥ እንደ ተንሳፋፊ ወይም ኢንቲጀር ዋጋ መሰጠት አለበት። የተግባሩ 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_የመጀመሪያውን_ምስል_ይጠብቅ
መግለጫ በመቅረጫ ማህደረ ትውስታ ውስጥ የመጀመሪያውን የሚገኝ ምስል ይጠብቃል። በመቅረጫ ሁነታ 'ተከታታይ የማይታገድ'፣ 'ring buffer'። እና 'fifo'፣ የተግባር መዝገብ() ወዲያውኑ ይመለሳል። ስለዚህ፣ ይህ ተግባር ምስል()፣ ምስሎች()፣ ወይም image_average() ከመደወልዎ በፊት ምስሎችን ከካሜራ ለመጠበቅ ሊያገለግል ይችላል።
ፕሮቶታይፕ የመጀመሪያውን_ምስል(እራስን) መጠበቅ፡-
2.2 ተለዋዋጭ ውቅር
የካሜራ መመዘኛዎች የአወቃቀሩን ተለዋዋጭ በመለወጥ ተዘምነዋል.
cam.configuration = {'የተጋላጭነት ጊዜ'፡ 10e-3፣
'ሮይ'፡ (1፣ 1፣ 512፣ 512)፣
'ጊዜamp': 'አስኪ',
'ፒክስል መጠን'፡ 100_000_000፣
'ቀስቃሽ': 'ራስ-ሰር ቅደም ተከተል',
'ማግኘት': 'ራስ',
'ሜታዳታ': 'በርቷል',
'ማጣመር': (1, 1)}
ተለዋዋጭ መቀየር የሚቻለው የመዝገቡ() ተግባር ከመጠራቱ በፊት ብቻ ነው። የተወሰነ ቁጥር ያለው መዝገበ ቃላት ነው። ሁሉም ሊሆኑ የሚችሉ አካላት መገለጽ አያስፈልጋቸውም። የሚከተሉት sample code 'የፒክሰል ፍጥነቱን' ብቻ ይቀይራል እና ሌሎች የውቅረት ክፍሎችን አይነካም።
በpco.Camera() እንደ ካሜራ፡-
cam.configuration = {'ፒክስል መጠን'፡ 286_000_000}
cam.record()
…
2.3 እቃዎች
ይህ ክፍል በpco.Camera ክፍል የቀረቡትን ሁሉንም ነገሮች ይገልጻል።
2.3.1 ኤስዲኬ
የነገር sdk ወደ ሁሉም መሰረታዊ ተግባራት ቀጥተኛ መዳረሻ ይፈቅዳል pco.sdk.
>>> cam.sdk.get_temperature()
{'የዳሳሽ ሙቀት'፡ 7.0፣ 'የካሜራ ሙቀት'፡ 38.2፣ 'የኃይል ሙቀት'፡ 36.7}
ሁሉም የመመለሻ ዋጋዎች ከ sdk ተግባራት መዝገበ-ቃላት ናቸው። ሁሉም የካሜራ መቼቶች በአሁኑ ጊዜ በካሜራ ክፍል የተሸፈኑ አይደሉም። የሚመለከተውን sdk ተግባር በመደወል ልዩ ቅንጅቶች በቀጥታ መዘጋጀት አለባቸው።
2.3.2 መቅጃ
የነገር rec የሁሉም መሰረታዊ ተግባራት ቀጥተኛ መዳረሻን ይሰጣል pco. መቅጃ. የመቅጃ ክፍል ዘዴን በቀጥታ መጥራት አስፈላጊ አይደለም. ሁሉም ተግባራት በካሜራ ክፍል ዘዴዎች ሙሉ በሙሉ የተሸፈኑ ናቸው.