VICON ٽريڪٽر پٿون API

وضاحتون

• پيداوار جو نالو: Vicon Tracker Python API
• مطابقت: ٽريڪٽر 4.0
• سپورٽ پٿون ورجن: 2.7 ۽ پٿون 3

پيداوار جي استعمال جون هدايتون

انسٽال ڪريو Tracker API

Python سان ٽريڪر API استعمال ڪرڻ لاء، انهن قدمن تي عمل ڪريو:

1. پٿون ورزن چيڪ ڪريو مطابقت کي يقيني بڻائڻ لاءِ.
2. Python انسٽال ڪريو ان کي سرڪاري مان ڊائون لوڊ ڪندي webسائيٽ ۽ مناسب نسخو چونڊيو.
3. ڳوليو ۽ انسٽال ڪريو Tracker Python ماڊل کي مخصوص فولڊر مان.

پٿون ورزن چيڪ ڪريو

1. هڪ حڪم پرامٽ کوليو.
2. ٽائپ ڪريو 'py' ۽ پريس ڪريو Enter.
3. جيڪڏهن پٿون انسٽال ٿيل نه آهي، تنصيب جي هدايتن جو حوالو ڏيو.

Python انسٽال ڪريو

1. ڏانهن وڃو پٿون جو سرڪاري webسائيٽ.
2. Python ڊائون لوڊ ۽ انسٽال ڪريو، انسٽال ڪرڻ دوران PATH ۾ python.exe شامل ڪرڻ کي يقيني بڻائي.

Tracker Python ماڊل انسٽال ڪريو:

1. انسٽاليشن کي ڳولھيو files مخصوص فولڊر ۾.
2. توھان جي سيٽ اپ جي بنياد تي انسٽاليشن جو طريقو چونڊيو.

بيچ کي هلائڻ سان پٿون ماڊل انسٽال ڪريو File:

1. پٿون انسٽال فولڊر ڏانھن وڃو: سي: پروگرام FilesViconTracker4.xSDKPython
2. انسٽاليشن جي عمل کي شروع ڪرڻ لاء 'install_tracker_api.bat' تي ڊبل ڪلڪ ڪريو.

اڪثر پڇيا ويندڙ سوال (FAQ):

سوال: مان ٽريڪر API استعمال ڪندي ڇا خودڪار ڪري سگهان ٿو؟

• A: ٽريڪر API توهان کي اجازت ڏئي ٿو ته عام ڪمن کي خودڪار ڪرڻ جهڙوڪ لوڊ ڪرڻ، راند ڪرڻ، ڊيٽا برآمد ڪرڻ، چالو ڪرڻ / غير فعال ڪرڻ، ۽ ڪم فلو حصن کي متحرڪ ڪرڻ.

سوال: ڪهڙن پٿون ورجن کي سپورٽ ڪيو ويو آهي ٽريڪر API؟

• A: ٽريڪر API پٿون ورزن 2.7 ۽ پٿون کي سپورٽ ڪري ٿو

ھن ھدايت بابت

• ٽريڪر API توهان کي Python API ذريعي ٽريڪر جي ڪجهه خاصيتن کي ڪنٽرول ڪرڻ جي اجازت ڏئي ٿي.
• API توهان کي ٽريڪر جي ڪجهه عام ڪمن کي خودڪار ڪرڻ جي قابل بڻائي ٿو، جهڙوڪ لوڊ ڪرڻ، راند ڪرڻ، ۽ ڊيٽا برآمد ڪرڻ، مختلف شين کي چالو يا غير فعال ڪرڻ، يا ڪم فلو جي حصن کي متحرڪ ڪرڻ.
• ھي دستاويز توھان کي قابل بنائي ٿو شروع ڪرڻ لاءِ Tracker API.

انسٽال ڪريو Tracker API

• Python سان Tracker API استعمال ڪرڻ لاء، توهان کي پڪ ڪرڻ گهرجي ته توهان ٻنهي کي نصب ڪيو آهي.
• Tracker API Python 2.7 ۽ Python 3 لاءِ مدد فراهم ڪري ٿي. Vicon سفارش ڪري ٿو ته توھان Python 3 جو جديد مڪمل رليز استعمال ڪريو جيستائين توھان جو پروجيڪٽ توھان کي پٿون جو مخصوص ورزن استعمال ڪرڻ جي ضرورت نه ٿو ڏئي.

اهي طريقا توهان کي انسٽاليشن جي عمل ذريعي رهنمائي ڪن ٿا:

• پٿون ورزن تي چيڪ ڪريو
• Python انسٽال ڪرڻ تي
• Tracker Python ماڊل کي انسٽال ڪرڻ تي
• چيڪ ڪريو ته پٿون ماڊل صحيح طور تي نصب ٿيل آهي

پٿون ورجن چيڪ ڪريو

• جيڪڏهن توهان کي پڪ ناهي ته توهان Python انسٽال ڪيو آهي يا توهان Python جو ڪهڙو نسخو استعمال ڪري رهيا آهيو، توهان هڪ ڪمان پرامٽ کوليو ۽ py ڪمانڊ هلائي سگهو ٿا.

مثال طورampاليزي:

جيڪڏهن توهان وٽ پٿون نصب نه آهي، ڏسو پائٿون انسٽال ڪريو.

Python انسٽال ڪريو Python 2 يا 3 انسٽال ڪرڻ لاءِ:

1. ڏانهن وڃو  https://www.python.org/downloads/
2. گھربل ورجن ڳوليو ۽ پٿون انسٽال ڪريو، پڪ ڪريو ته شامل ڪريو python.exe کي PATH چونڊيو ويو آھي:

مٿي ڏنل تصوير ۾، ABC کي انسٽاليشن فولڊر لاء توهان جي يوزرنيم سان تبديل ڪيو ويو آهي.

Tracker Python module انسٽال ڪريو Tracker Python module انسٽال ڪرڻ لاءِ:

1. انسٽاليشن کي ڳولھيو fileايس. جيڪڏهن توهان ٽريڪٽر کي ڊفالٽ هنڌ تي نصب ڪيو، اهي هن فولڊر ۾ مليا آهن: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • هنن files ڏيکاريل آهن:
2. انسٽال ڪريو Tracker Python ماڊل ھيٺ ڏنل طريقن مان، توھان جي خاص تنصيب تي منحصر آھي:
   • سادو طريقو بيچ کي هلائڻ آهي file (install_tracker_api.bat) جيڪو ٽريڪر جي انسٽاليشن ۾ شامل آهي (جيئن مٿي ڏنل تصوير ۾ ڏيکاريل آهي).
   • اهو عام طور تي سٺو ڪم ڪري ٿو جيڪڏهن:
   • Python PATH متغير کي نصب ڪيو ويو؛ يا
   • Python جا گھڻا ورجن انسٽال ٿيل آھن، پر توھان چاھيو ٿا API کي انسٽال ڪرڻ لاءِ جديد ورجن تي جيڪو توھان انسٽال ڪيو آھي؛ يا
   • Python جو صرف ھڪڙو نسخو نصب ٿيل آھي.
   • جيڪڏهن انهن شرطن مان ڪي به لاڳو ٿين ٿيون، ڏسو پيٿون ماڊل انسٽال ڪريو بيچ کي هلائيندي file تي.
   • ٻين سڀني حالتن ۾، پائپ استعمال ڪندي پٿون ماڊل انسٽال ڪريو. اهو عام طور تي لاڳو ٿئي ٿو جيڪڏهن:
   • پٿون جا گھڻا ورجن انسٽال ٿيل آھن، پر توھان چاھيو ٿا ھڪ مخصوص ورزن تي انسٽال ڪريو؛ يا
   • پٿون جا ڪيترائي مختلف ورجن انسٽال ٿيل آھن ۽ توھان چاھيو ٿا انھن مڙني تي انسٽال ڪريو (ھن صورت ۾، توھان کي ھر ورزن لاءِ ماڊل انسٽال ڪرڻ گھرجي)؛ يا
   • Python جو صرف ھڪڙو نسخو انسٽال ٿيل آھي، پر توھان PATH تي انسٽال نه ڪيو آھي.
   • جيڪڏهن انهن شرطن مان ڪي به لاڳو ٿين ٿيون، ڏسو پائٿون ماڊل انسٽال ڪريو پِپ آن هلائيندي.

بيچ کي هلائڻ سان Python ماڊل انسٽال ڪريو file ائين ڪرڻ لاءِ:

1. پٿون انسٽال فولڊر ڏانھن وڃو: ج: پروگرام Files\Vicon\Tracker4.x\SDK\Python
2. install_tracker_api.bat تي ڊبل ڪلڪ ڪريو.
   • انسٽاليشن جو عمل خودڪار طريقي سان شروع ٿئي ٿو.

انسٽال ڪريو پائٿون ماڊل کي هلائڻ سان

1. پٿون لاءِ اسڪرپٽ فولڊر ڏانھن وڃو جيڪو توھان استعمال ڪرڻ چاھيو ٿا:
2. Python 3 لاءِ، ڊفالٽ انسٽاليشن فولڊر آھي: C: \Users\ \AppData\Local\Programs\Python\Python \Sc rips
   • 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“
   • Tracker API C انسٽال ڪرڻ لاءِ ھيٺ ڏنل حڪم ھلايو: \ استعمال ڪندڙ \ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe انسٽال ڪريو "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api“

نوٽ مٿي ڄاڻايل اڳوڻيamples ٽريڪر 3.11 سان گڏ پٿون 4.0 تنصيب استعمال ڪريو. توھان جو رستو ۽ حڪم ڪجھ مختلف ٿي سگھن ٿا.

چيڪ ڪريو ته پٿون ماڊل صحيح طور تي نصب ٿيل آهي

• چيڪ ڪريو ته ھيٺ ڏنل ماڊل نصب ڪيا ويا آھن.
• vicon_core_api: هي بنيادي ريموٽ ڪنٽرول API آهي ۽ ٽرمينل سرور سان رابطي لاءِ ڪلائنٽ شامل آهي.
• tracker_api: ٽريڪر-مخصوص ايپليڪيشن ڪارڪردگي تائين رسائي لاءِ خدمتون API.
• جانچڻ لاءِ ته ٽريڪر پٿون ماڊل صحيح طرح سان انسٽال ٿيل آهي، ڪوشش ڪريو پيٿون مان هڪ ماڊل درآمد ڪرڻ: >>> import vicon_core_api

جيڪڏهن مٿيون عمل ماڊل کي سڃاڻڻ ۾ ناڪام ٿئي، هيٺ ڏنل ڪوشش ڪريو:

• ٽريڪر_api يا vicon_core_api فولڊر لاءِ Python انسٽاليشن ۾ سائيٽ-پيڪيجز فولڊر چيڪ ڪريو. Python 3.11 لاءِ، ڊفالٽ انسٽاليشن فولڊر جو مقام آھي:
  • ج: استعمال ڪندڙ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• پنھنجي سسٽم جي ماحوليات جي متغيرن کي چيڪ ڪريو ۽ پڪ ڪريو ته اسڪرپٽ فولڊر پٿون تنصيب لاءِ توھان استعمال ڪرڻ چاھيو ٿا لسٽ ۾ سڀ کان وڌيڪ آھي. Python 3.11 لاءِ، انسٽاليشن فولڊر جو ڊفالٽ مقام آھي:
  • ج: استعمال ڪندڙ \AppData\Local\Programs\Python\Python311\Scripts
• جيڪڏهن ڪنهن به ماڊلز جي فولڊر غائب آهي، ۽ توهان رستي جي تصديق ڪئي آهي، انسٽاليشن جي عمل ذريعي ٻيهر هلايو جنهن ۾ بيان ڪيل ٽريڪر پٿون ماڊل تي نصب ڪرڻ ۾.

ٽرمينل سرور سان ڳنڍيو

• ٽرمينل سرور سان ڳنڍڻ لاءِ، پهرين درآمد ڪريو Vicon Core API ماڊل: >>> import vicon_core_api
  • >>> vicon_core_api درآمد کان
• اڳيون، هڪ ڪلائنٽ ٺاهيو. اهو خودڪار طريقي سان ڳنڍڻ جي ڪوشش ڪري ٿو مخصوص ميزبان ايڊريس تي ڊفالٽ پورٽ (52800) >>> c = ڪلائنٽ('localhost')
• چيڪ ڪريو ته ڪلائنٽ ڪاميابي سان سرور سان ڳنڍيل آهي: >>> پرنٽ(c.connected) صحيح
• جيڪڏهن جواب غلط آهي، پڪ ڪريو ته توهان وٽ ٽريڪٽر جو هڪ مثال آهي جيڪو مخصوص ميزبان ايڊريس تي هلندو آهي ۽ توهان جو فائر وال هڪ نئون ڪلائنٽ ٺاهڻ کان اڳ، پورٽ 52800 تي ٽرئفڪ کي بلاڪ نه ڪري رهيو آهي.
• جڏهن توهان ڪاميابيءَ سان ڳنڍجي ويا آهيو، توهان ٽريڪٽر ٽرمينل سرور پاران مهيا ڪيل خدمتن تائين رسائي حاصل ڪري سگهو ٿا.
• هن اڳوڻيample استعمال ڪري ٿو بنيادي اعتراض خدمتون: >>> Tracker_api درآمد ڪريو >>> tracker_api مان درآمد ڪريو BasicObjectServices >>> خدمتون = BasicObjectServices(c)
• جڏهن اهو ڳنڍيل آهي، توهان ٽريڪر مثال تي طريقن کي ڪال ڪري سگهو ٿا.
  • مثال طورampلي، ٽريڪنگ پينل ۾ شين جي لسٽ حاصل ڪرڻ لاءِ، استعمال ڪريو: >>> نتيجو، object_list = services.basic_object_list() >>> print(نتيجو)
  • ٺيڪ: فنڪشن ڪامياب ٿيو
  • >>> پرنٽ (object_list)
  • ['Object1'، 'Object2'...]
• سڀ API ڪالون ھڪڙو نتيجو ڪوڊ موٽائي ٿو، جيڪو بيان ڪيو ويو آھي vicon_core_api/result.py.
• ھڪڙو ممڪن ناڪامي ڪوڊ آھي Result.RPCNotConnected، جيڪو ملي ويندو آھي جيڪڏھن ٽرمينل سرور جو ڪنيڪشن گم ٿي وڃي.
• مثال طورample: >>> نتيجو، object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: ريموٽ فنڪشن يا ڪال بڪ جو ڪنيڪشن کليل ناهي
• سڀني موجود ڪمن ۽ دستاويزن جي فهرست ڏيکارڻ لاءِ: >>> مدد( tracker_api)

Exampلي اسڪرپٽ

• توهان ڳولي سگهو ٿا example اسڪرپٽ عام API افعال جي استعمال کي ڏيکاريندي ج: پروگرام Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• سڀني اسڪرپٽس ۾ دستاويز آهن ۽ هڪ مدد اختيار ڪريو جيڪو لاڳاپيل دليلن جا تفصيل ڏئي ٿو.
• هلائڻ جي طور تيample اسڪرپٽ، مٿي ڏنل اسڪرپٽ فولڊر ۾ ڪمانڊ ونڊو يا پاور شيل کوليو. توهان اهو ڪري سگهو ٿا ٻن طريقن مان هڪ ۾:
• ڪمانڊ پرامپٽ کوليو ۽ پنھنجي ڊاريڪٽري کي اسڪرپٽ فولڊر ۾ تبديل ڪريو. c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• اسڪرپٽ فولڊر ۾ SHIFT + ساڄي ڪلڪ کي دٻايو ۽ ھتي اوپن ڪمانڊ ونڊو چونڊيو يا ھتي پاور شيل ونڊو کوليو.
• هتان کان توهان هلائي سگهو ٿا اڳوڻيampتوهان جي پسند جي اسڪرپٽ.
• هيٺيون سابقamples ڪمانڊ ونڊو استعمال ڪريو.

camera_calibration_wave.py

• هي اسڪرپٽ ظاهر ڪري ٿو ته ڪيئن استعمال ڪجي API افعال کي ڪنٽرول ڪرڻ جي عمل کي ڪنٽرول ڪرڻ لاءِ ونڊ جي موج کي شروع ڪرڻ ۽ بند ڪرڻ.
  • ج: پروگرام Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• جيڪڏهن ڪامياب ٿيو ته، حساب ڪتاب جا ڪنٽرول ڏيکاريا ويندا

capture_control.py

• هي اسڪرپٽ ڏيکاري ٿو ته لائيو ڊيٽا کي ڪيئن پڪڙيو وڃي C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• قبضي جو نالو ڪنٽرول کان اڳ درج ٿيل آهي. قبضي جو نالو تبديل ڪرڻ لاء، capture_services ۽ SetCaptureName استعمال ڪريو.
• Tracker API استعمال ڪرڻ بابت سوالن لاءِ، Vicon Support1 سان رابطو ڪريو.
• 1 ميل:support@vicon.com
• Vicon Tracker Python API Quick Start Guide 31 مئي 2023، نظرثاني 1
• ٽريڪٽر 4.0 سان استعمال لاءِ
• © ڪاپي رائيٽ 2020–2023 Vicon Motion Systems Limited. سڀ حق محفوظ آهن.
• نظرثاني 1. ٽريڪر 4.0 سان استعمال لاءِ
• Vicon Motion Systems Limited بغير اطلاع جي هن دستاويز ۾ معلومات يا وضاحتن ۾ تبديليون ڪرڻ جو حق محفوظ رکي ٿو.
• ڪمپنيون، نالا، ۽ ڊيٽا examples فرضي آهن جيستائين ٻي صورت ۾ نوٽ ڪيو وڃي. ھن پبليڪيشن جو ڪو به حصو ورجائي نه ٿو سگھجي، وصولي واري نظام ۾ ذخيرو ٿيل، يا ڪنھن به شڪل ۾ يا ڪنھن به طريقي سان، اليڪٽرونڪ يا ميخانياتي، فوٽوڪپي يا رڪارڊنگ ذريعي، يا ٻي صورت ۾ Vicon Motion Systems Ltd جي اڳواٽ اجازت کان سواءِ.
• Vicon® Oxford Metrics plc جو رجسٽرڊ ٽريڊ مارڪ آھي. Vicon Control™, Vicon Lock™, Vicon Lock Lab™, Vicon Lock Studio™, Vicon Tracker™, Vicon Valkyrie™, Vicon Vantage™، Vicon Vero™، Vicon Viper™، Vicon ViperX™ ۽ Vicon Vue™ آڪسفورڊ ميٽرڪس پي ايل سي جا ٽريڊ مارڪ آهن.
• VESA® هڪ رجسٽرڊ ٽريڊ مارڪ آهي جيڪو VESA جي ملڪيت آهي (www.vesa.org/about-vesa/). ٻيا پراڊڪٽ ۽ ڪمپني جا نالا هتي انهن جي لاڳاپيل مالڪن جا ٽريڊ مارڪ ٿي سگهن ٿا.
• مڪمل ۽ تازه ترين ڪاپي رائيٽ ۽ ٽريڊ مارڪ جي اعترافن لاءِ، دورو ڪريو https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems هڪ آڪسفورڊ ميٽرڪس پي ايل سي ڪمپني آهي.
• اي ميل: support@vicon.com Web: http://www.vicon.com

دستاويز / وسيلا

VICON ٽريڪٽر Python Api [pdf] استعمال ڪندڙ ھدايت ٽريڪٽر پٿون اپي ، ٽريڪٽر ، پٿون اپي ، اپي

حوالو

• استعمال ڪندڙ دستي