VICON Tracker Python API

ዝርዝሮች

• የምርት ስም፡- Vicon Tracker Python API
• ተኳኋኝነት መከታተያ 4.0
• የሚደገፉ የፓይዘን ስሪቶች፡- 2.7 እና Python 3

የምርት አጠቃቀም መመሪያዎች

Tracker API ን ጫን

መከታተያ ኤፒአይን በፓይዘን ለመጠቀም እነዚህን ደረጃዎች ይከተሉ፡

1. ተኳኋኝነትን ለማረጋገጥ የ Python ሥሪቱን ያረጋግጡ።
2. ፓይዘንን ከኦፊሴላዊው በማውረድ ይጫኑት። webጣቢያ እና ተገቢውን ስሪት መምረጥ.
3. ከተጠቀሰው አቃፊ የ Tracker Python ሞጁሉን ያግኙ እና ይጫኑት።

የ Python ሥሪትን ያረጋግጡ

1. የትእዛዝ ጥያቄን ይክፈቱ።
2. 'py' ብለው ይተይቡ እና አስገባን ይጫኑ።
3. Python ካልተጫነ የመጫኛ መመሪያዎችን ይመልከቱ።

Pythonን ጫን

1. ወደ ሂድ የ Python ኦፊሴላዊ webጣቢያ.
2. በመጫን ጊዜ python.exe ወደ PATH ማከልን በማረጋገጥ Pythonን ያውርዱ እና ይጫኑ።

የ Tracker Python Moduleን ይጫኑ፡-

1. መጫኑን ያግኙ files በተጠቀሰው አቃፊ ውስጥ.
2. በማዋቀርዎ ላይ በመመስረት የመጫኛ ዘዴን ይምረጡ።

ባችውን በማሄድ የፓይዘን ሞጁሉን ይጫኑ File:

1. ወደ Python መጫኛ አቃፊ ይሂዱ፡ C: Program FilesViconTracker4.xSDKPython
2. የመጫን ሂደቱን ለመጀመር 'install_tracker_api.bat' ላይ ሁለቴ ጠቅ ያድርጉ።

ተዘውትረው የሚጠየቁ ጥያቄዎች (FAQ)፡-

ጥ፡ የክትትል ኤፒአይን ተጠቅሜ በራስ ሰር ምን ማድረግ እችላለሁ?

• A: የክትትል ኤፒአይ እንደ መጫን፣ ማጫወት፣ ውሂብ ወደ ውጭ መላክ፣ ነገሮችን ማንቃት/ማቦዘን እና የስራ ፍሰት ክፍሎችን ማስነሳት ያሉ የተለመዱ ተግባራትን በራስ ሰር እንዲሰሩ ይፈቅድልዎታል።

ጥ፡ የትኞቹ የፓይዘን ስሪቶች በ Tracker API የሚደገፉት?

• A: የ Tracker API Python ስሪቶች 2.7 እና Pythonን ይደግፋል

ስለዚህ መመሪያ

• የ Tracker API የተወሰኑ የክትትል ባህሪያትን በፓይዘን ኤፒአይ እንዲቆጣጠሩ ያስችልዎታል።
• ኤፒአይ እንደ ውሂብ መጫን፣ ማጫወት እና ወደ ውጪ መላክ፣ የተለያዩ ነገሮችን ማንቃት ወይም ማቦዘን፣ ወይም የስራ ፍሰቱን ክፍሎች እንደማስነሳት ያሉ አንዳንድ የተለመዱ የክትትል ተግባራትን በራስ ሰር እንድትሰራ ያስችልሃል።
• ይህ ሰነድ በ Tracker API ለመጀመር ያስችልዎታል።

Tracker API ን ጫን

• Tracker API በ Python ለመጠቀም ሁለታችሁም መጫኑን ማረጋገጥ አለቦት።
• የ Tracker API ለ Python 2.7 እና Python 3 ድጋፍ ይሰጣል። ቪኮን ፕሮጄክትዎ የተወሰነ የፓይዘንን ስሪት እንዲጠቀሙ ካልፈለገ በስተቀር የቅርብ ጊዜውን የ Python 3 ሙሉ ስሪት እንዲጠቀሙ ይመክራል።

እነዚህ ሂደቶች በመጫን ሂደት ውስጥ ይመራዎታል-

• የ Python ሥሪትን በ ላይ ያረጋግጡ
• Pythonን በመጫን ላይ
• የ Tracker Python ሞጁሉን በመጫን ላይ
• የ Python ሞጁል በትክክል መጫኑን ያረጋግጡ

የ Python ሥሪትን ያረጋግጡ

• Python መጫኑን ወይም የትኛውን የፓይዘን ስሪት እንደሚጠቀሙ እርግጠኛ ካልሆኑ የትእዛዝ መጠየቂያውን ከፍተው የ py ትዕዛዙን ማስኬድ ይችላሉ።

ለ exampላይ:

ፓይዘንን ከለኻ፡ ፓይዘንን ጫን እዩ።

Pythonን ጫን Python 2 ወይም 3 ን ለመጫን፡-

1. ወደ ሂድ  https://www.python.org/downloads/
2. የሚፈለገውን ስሪት አግኝ እና Pythonን ጫን፣ python.exe ወደ PATH አክል መመረጡን በማረጋገጥ፡

ከላይ ባለው ምስል ላይ ኤቢሲ ለመጫኛ አቃፊ በተጠቃሚ ስምዎ ተተክቷል።

የ Tracker Python ሞጁሉን ጫን የ Tracker Python ሞጁሉን ለመጫን፡-

1. መጫኑን ያግኙ fileኤስ. Trackerን በነባሪ ቦታ ከጫኑ፣ በዚህ አቃፊ ውስጥ ይገኛሉ፡ C:\Program Files \ Vicon \ Tracker4.x \ SDK \ Python
   • እነዚህ fileዎች ይታያሉ:
2. እንደ ልዩ ጭነትዎ ላይ በመመስረት የ Tracker Python ሞጁሉን ከሚከተሉት መንገዶች በአንዱ ይጫኑት።
   • በጣም ቀላሉ መንገድ ባችውን ማካሄድ ነው file (install_tracker_api.bat) በክትትል መጫኛ ውስጥ የተካተተ (ከላይ ባለው ምስል ላይ እንደሚታየው)።
   • ይህ ብዙውን ጊዜ በጥሩ ሁኔታ የሚሰራው-
   • Python ወደ PATH ተለዋዋጭ ተጭኗል; ወይም
   • በርካታ የፓይዘን ስሪቶች ተጭነዋል፣ ነገር ግን ኤፒአይ ወደ ጫንከው የቅርብ ጊዜ ስሪት መጫን ትፈልጋለህ። ወይም
   • አንድ ነጠላ የ Python ስሪት ብቻ ተጭኗል።
   • ከነዚህ ሁኔታዎች ውስጥ አንዳቸውም ከተመለከቱ፣ ባችውን በማሄድ የ python ሞጁሉን ይጫኑ file ላይ
   • በሌሎች በሁሉም ሁኔታዎች ፒፒን በመጠቀም የ Python ሞጁሉን ይጫኑ. ይህ ብዙውን ጊዜ የሚመለከተው ከሆነ፡-
   • ብዙ የፓይዘን ስሪቶች ተጭነዋል, ግን ወደ አንድ የተወሰነ ስሪት መጫን ይፈልጋሉ; ወይም
   • ብዙ የተለያዩ የፓይዘን ስሪቶች ተጭነዋል እና ሁሉንም መጫን ይፈልጋሉ (በዚህ አጋጣሚ ለእያንዳንዱ ስሪት ሞጁሉን መጫን አለብዎት); ወይም
   • አንድ ነጠላ የፓይዘን ስሪት ብቻ ነው የተጫነው፣ ግን ወደ PATH አልጫኑም።
   • ከነዚህ ሁኔታዎች ውስጥ አንዳቸውም ከተተገበሩ ፒፕን በማብራት የ Python ሞጁሉን ይጫኑ።

ባችውን በማሄድ የ Python ሞጁሉን ይጫኑ file ይህንን ለማድረግ፡-

1. ወደ Python መጫኛ አቃፊ ይሂዱ፡ C:\ፕሮግራም። Files \ Vicon \ Tracker4.x \ SDK \ Python
2. install_tracker_api.bat ን ሁለቴ ጠቅ ያድርጉ።
   • የመጫን ሂደቱ በራስ-ሰር ይጀምራል.

ፒፕን በማሄድ የ Python ሞጁሉን ይጫኑ

1. ሊጠቀሙበት ወደሚፈልጉት Python ወደ የስክሪፕቶች አቃፊ ይሂዱ።
2. ለ Python 3 ነባሪው የመጫኛ አቃፊ C: \users\ ነው. \ AppData \ አካባቢያዊ \\ ፕሮግራሞች \\ Python \\ Python \Sc ሪፕስ
   • ለ Python 2.7፣ ነባሪው የመጫኛ አቃፊ፡ C:\Python27\Scripts ነው።
3. በዚያ አቃፊ ውስጥ የትእዛዝ መስኮት ወይም PowerShell ይክፈቱ።
4. Vicon Core API ን ለመጫን የሚከተለውን ትዕዛዝ ያሂዱ፡ C፡ \ተጠቃሚዎች \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe "C:\ Program" ጫን Files\Vicon\ Tracker 4.0\SDK\Python\vicon_core_api"
   • የክትትል ኤፒአይ ሲን ለመጫን የሚከተለውን ትዕዛዝ ያሂዱ፡- \ተጠቃሚዎች \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe "C:\ Program" ጫን Files\Vicon\ Tracker 4.0\SDK\Python\tracker_api"

ማስታወሻ ከላይ ያለው exampየ Python 3.11 ጭነትን ከ Tracker 4.0 ጋር ይጠቀሙ። የእርስዎ መንገድ እና ትዕዛዞች በትንሹ ሊለያዩ ይችላሉ።

የ Python ሞጁል በትክክል መጫኑን ያረጋግጡ

• የሚከተሉት ሞጁሎች መጫኑን ያረጋግጡ።
• vicon_core_api፡ ይህ ዋናው የርቀት መቆጣጠሪያ ኤፒአይ ሲሆን ከተርሚናል አገልጋይ ጋር ለመገናኘት ደንበኛን ያካትታል።
• መከታተያ_ኤፒ፡ የክትትል-ተኮር መተግበሪያ ተግባርን ለመድረስ አገልግሎቶች API።
• የ Tracker Python ሞጁል በትክክል መጫኑን ለመፈተሽ በ Python ውስጥ ካሉት ሞጁሎች ውስጥ አንዱን ለማስመጣት ይሞክሩ፡ >>> vicon_core_api አስመጣ

ከላይ ያለው ሂደት ሞጁሉን ማወቅ ካልቻለ የሚከተለውን ይሞክሩ።

• ለ tracker_api ወይም vicon_core_api ማህደር በፓይዘን መጫኛ ውስጥ የሳይት-ጥቅል ማህደርን ያረጋግጡ። ለ Python 3.11፣ ነባሪ የመጫኛ ማህደር ያለበት ቦታ፡-
  • C:\ተጠቃሚዎች \AppData\Local\ፕሮግራሞች\Python\Python311\Lib\site-ጥቅሎች
• የስርዓት አካባቢዎን ተለዋዋጮች ይፈትሹ እና ለመጠቀም የሚፈልጉት የፓይዘን ጭነት የስክሪፕት ማህደር በዝርዝሩ ውስጥ ከፍተኛው መሆኑን ያረጋግጡ። ለ Python 3.11፣ የመጫኛ አቃፊው ነባሪ ቦታ፡-
  • C:\ተጠቃሚዎች \AppData\Local\ፕሮግራሞች\Python\Python311\ስክሪፕቶች
• ከሞጁሎቹ ውስጥ የትኛውም አቃፊ ከጠፋ እና መንገዱን ካረጋገጡ በኋላ የ Tracker Python moduleን መጫን ላይ በተገለጸው የመጫን ሂደት ውስጥ እንደገና ያሂዱ።

ወደ ተርሚናል አገልጋይ ያገናኙ

• ከተርሚናል አገልጋይ ጋር ለመገናኘት መጀመሪያ የቪኮን ኮር ኤፒአይ ሞጁሉን ያስመጡ፡ >>> vicon_core_api አስመጣ
  • >>> ከ vicon_core_api ማስመጣት
• በመቀጠል ደንበኛ ይፍጠሩ. ይሄ በነባሪ ወደብ (52800) >>> c = Client('localhost') ላይ ካለው የተወሰነ የአስተናጋጅ አድራሻ ጋር በራስ ሰር ለመገናኘት ይሞክራል።
• ደንበኛው በተሳካ ሁኔታ ከአገልጋዩ ጋር መገናኘቱን ያረጋግጡ፡- >>> ማተም(የተገናኘ) እውነት ነው።
• ምላሹ ሐሰት ከሆነ፣ አዲስ ደንበኛ ከመፍጠርዎ በፊት በተጠቀሰው የአስተናጋጅ አድራሻ የሚሰራ የክትትል ምሳሌ እንዳለዎት እና ፋየርዎል ወደብ 52800 ላይ ያለውን ትራፊክ እየከለከለ አለመሆኑን ያረጋግጡ።
• በተሳካ ሁኔታ ሲገናኙ፣ በ Tracker ተርሚናል አገልጋይ የሚሰጡትን አገልግሎቶች ማግኘት ይችላሉ።
• ይህ ለምሳሌample መሰረታዊ የነገር አገልግሎቶችን ይጠቀማል፡- >>> አስመጣ tracker_api >>> ከ tracker_api import BasicObjectServices >>> አገልግሎቶች = መሰረታዊObjectServices(ሐ)
• ሲገናኝ በ Tracker ምሳሌ ላይ ዘዴዎችን መደወል ይችላሉ።
  • ለ example፣ በክትትል ፓነል ውስጥ የነገሮችን ዝርዝር ለማግኘት፣ ተጠቀም፡ >>> ውጤት፣ object_list = services.መሰረታዊ_ነገር_ዝርዝር() >>> ማተም(ውጤት)
  • እሺ፡ ተግባሩ ተሳክቷል
  • >>> ማተም(የነገር_ዝርዝር)
  • ['Object1'፣ 'Object2'…]
• ሁሉም የኤፒአይ ጥሪዎች የውጤት ኮድ ይመልሳሉ፣ ይህም በ vicon_core_api/result.py ውስጥ የተገለጸ ነው።
• አንድ ሊሆን የሚችል አለመሳካት ኮድ Result.RPCNotConnected ነው, ይህም ከተርሚናል አገልጋይ ጋር ያለው ግንኙነት ከጠፋ ይቀበላል.
• ለ example: >>> ውጤት፣ object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: ከርቀት ተግባሩ ወይም መልሶ መደወል ጋር ያለው ግንኙነት ክፍት አይደለም
• ያሉትን ሁሉንም ተግባራት እና ሰነዶች ዝርዝር ለማሳየት፡ >>> እገዛ( tracker_api)

Example ስክሪፕቶች

• የቀድሞ ልታገኙ ትችላላችሁampየተለመዱ የኤፒአይ ተግባራት አጠቃቀምን የሚያሳዩ ስክሪፕቶች በ C:\ፕሮግራም። Files \ Vicon \ Tracker 4.0 \ SDK \ Python \ sampሌ_ስክሪፕቶች
• ሁሉም ስክሪፕቶች ሰነዶች አሏቸው እና ተዛማጅ የሆኑ ክርክሮችን ዝርዝር የሚሰጥ የእርዳታ አማራጭን ይውሰዱ።
• እንደ ለመሮጥampለ ስክሪፕት ፣ ከላይ ባለው የስክሪፕት አቃፊ ውስጥ የትእዛዝ መስኮት ወይም የኃይል ሼል ይክፈቱ። ይህንን ከሁለት መንገዶች በአንዱ ማድረግ ይችላሉ-
• የትእዛዝ መጠየቂያውን ይክፈቱ እና ማውጫዎን ወደ ስክሪፕቶች አቃፊ ይለውጡ። c:\> cd C:\ፕሮግራም። Files \ Vicon \ Tracker
  • 4.0\SDK\Python\sampሌ_ስክሪፕቶች
• በስክሪፕት ማህደር ውስጥ SHIFT+ ቀኝ-ጠቅ ያድርጉ እና እዚህ ክፈት የትዕዛዝ መስኮት ወይም የPowershell መስኮት ክፈት የሚለውን ይምረጡ።
• ከዚህ ሆነው የቀድሞ መሮጥ ይችላሉampየመረጡት ስክሪፕት።
• የሚከተለው የቀድሞampየትእዛዝ መስኮቱን እንጠቀማለን ።

የካሜራ_ካሊብሬሽን_ሞገድ.py

• ይህ ስክሪፕት የዋንድ ሞገድን ለመጀመር እና ለማቆም የመለኪያ ሂደትን ለመቆጣጠር የኤፒአይ ተግባራትን እንዴት መጠቀም እንደሚቻል ያሳያል።
  • C:\ፕሮግራም። Files \ Vicon \ Tracker 4.0 \ SDK \ Python \ sample_scripts> py camera_calibration_wave.py
• ከተሳካ፣ የመለኪያ መቆጣጠሪያዎች ይታያሉ

ያዝ_ቁጥጥር.py

• ይህ ስክሪፕት የቀጥታ ውሂብ C:\ፕሮግራምን እንዴት እንደሚይዝ ያሳያል Files \ Vicon \ Tracker 4.0 \ SDK \ Python \ sample_scripts> py ቀረጻ_control.py
• የቀረጻው ስም ከመቆጣጠሪያዎቹ በፊት ተዘርዝሯል። የተቀረጸውን ስም ለመቀየር ቀረጻ_አገልግሎትን እና SetCaptureNameን ይጠቀሙ።
• የክትትል ኤፒአይን ስለመጠቀም ጥያቄዎችን ለማግኘት Vicon Support1ን ያነጋግሩ።
• 1 ሜይል:support@vicon.com
• Vicon Tracker Python API ፈጣን ጅምር መመሪያ 31 ሜይ 2023፣ ክለሳ 1
• በ Tracker 4.0 ለመጠቀም
• © የቅጂ መብት 2020–2023 Vicon Motion Systems Limited። መብቱ በህግ የተጠበቀ ነው.
• ክለሳ 1. ከክትትል 4.0 ጋር ለመጠቀም
• ቪኮን ሞሽን ሲስተምስ ሊሚትድ በዚህ ሰነድ ላይ ያለ ማስታወቂያ በመረጃ ወይም ዝርዝር መግለጫ ላይ ለውጦችን የማድረግ መብቱ የተጠበቀ ነው።
• በ ex. ጥቅም ላይ የዋሉ ኩባንያዎች፣ ስሞች እና መረጃዎችampበሌላ መልኩ ካልተገለጸ በስተቀር ልቦለድ ናቸው። ማንኛውም የዚህ እትም ክፍል ሊባዛ፣ በዳግም ማግኛ ስርዓት ውስጥ ሊከማች ወይም በማንኛውም መልኩ ወይም በማንኛውም መንገድ በኤሌክትሮኒክስ ወይም ሜካኒካል፣ በፎቶ ኮፒ ወይም በመቅዳት ወይም በሌላ መልኩ ከ Vicon Motion Systems Ltd የጽሁፍ ፈቃድ ውጭ ሊሰራጭ አይችልም።
• ቪኮን® የኦክስፎርድ ሜትሪክስ ኃ.የተ.የግ.ማ የንግድ ምልክት ነው። Vicon Control™፣ Vicon Lock™፣ Vicon Lock Lab™፣ Vicon Lock Studio™፣ Vicon Tracker™፣ Vicon Valkyrie™፣ Vicon Vantage™፣ Vicon Vero™፣ Vicon Viper™፣ Vicon ViperX™ እና Vicon Vue™ የኦክስፎርድ ሜትሪክስ plc የንግድ ምልክቶች ናቸው።
• VESA® በVESA ባለቤትነት የተመዘገበ የንግድ ምልክት ነው። (www.vesa.org/about-vesa/)። ሌሎች የምርት እና የኩባንያ ስሞች የየባለቤቶቻቸው የንግድ ምልክቶች ሊሆኑ ይችላሉ።
• ለሙሉ እና ወቅታዊ የቅጂ መብት እና የንግድ ምልክት እውቅናዎች፣ ይጎብኙ https://www.vicon.com/vicon/copyright-information.
• ቪኮን ሞሽን ሲስተምስ የኦክስፎርድ ሜትሪክስ ኃ.የተ.የግ.ማ ኩባንያ ነው።
• ኢሜይል፡- support@vicon.com Web: http://www.vicon.com

ሰነዶች / መርጃዎች

VICON Tracker Python Api [pdf] የተጠቃሚ መመሪያ Tracker Python Api፣ Tracker፣ Python Api፣ Api

ዋቢዎች

• የተጠቃሚ መመሪያ