VICON ट्रयाकर Python Api प्रयोगकर्ता गाइड

VICON Tracker Python API

निर्दिष्टीकरणहरू

• उत्पादन नाम: Vicon Tracker Python API
• अनुकूलता: ट्र्याकर 4.0
• समर्थित पाइथन संस्करणहरू: 2.7 र पाइथन 3

उत्पादन उपयोग निर्देशन

Tracker API स्थापना गर्नुहोस्

पाइथनसँग ट्र्याकर एपीआई प्रयोग गर्न, यी चरणहरू पालना गर्नुहोस्:

1. अनुकूलता सुनिश्चित गर्न पाइथन संस्करण जाँच गर्नुहोस्।
2. आधिकारिकबाट डाउनलोड गरेर पाइथन स्थापना गर्नुहोस् webसाइट र उपयुक्त संस्करण चयन।
3. निर्दिष्ट फोल्डरबाट Tracker Python मोड्युल पत्ता लगाउनुहोस् र स्थापना गर्नुहोस्।

पाइथन संस्करण जाँच गर्नुहोस्

1. आदेश प्रम्प्ट खोल्नुहोस्।
2. 'py' टाइप गर्नुहोस् र इन्टर थिच्नुहोस्।
3. यदि पाइथन स्थापना गरिएको छैन भने, स्थापना निर्देशनहरू हेर्नुहोस्।

पाइथन स्थापना गर्नुहोस्

1. मा जानुहोस् पाइथन आधिकारिक webसाइट.
2. पाइथन डाउनलोड र स्थापना गर्नुहोस्, स्थापनाको क्रममा PATH मा python.exe थप्न सुनिश्चित गर्नुहोस्।

ट्र्याकर पाइथन मोड्युल स्थापना गर्नुहोस्:

1. स्थापना पत्ता लगाउनुहोस् fileनिर्दिष्ट फोल्डरमा s।
2. तपाईंको सेटअपमा आधारित स्थापना विधि छनौट गर्नुहोस्।

ब्याच चलाएर पाइथन मोड्युल स्थापना गर्नुहोस् File:

1. पाइथन स्थापना फोल्डरमा नेभिगेट गर्नुहोस्: C: कार्यक्रम FilesViconTracker4.xSDKPython
2. स्थापना प्रक्रिया सुरु गर्न 'install_tracker_api.bat' मा डबल-क्लिक गर्नुहोस्।

बारम्बार सोधिने प्रश्नहरू (FAQ):

प्रश्न: मैले ट्र्याकर एपीआई प्रयोग गरेर के स्वचालित गर्न सक्छु?

• A: ट्र्याकर API ले तपाईंलाई लोड गर्ने, खेल्ने, डेटा निर्यात गर्ने, वस्तुहरू सक्रिय/निष्क्रिय गर्ने, र कार्यप्रवाह भागहरू ट्रिगर गर्ने जस्ता सामान्य कार्यहरू स्वचालित गर्न अनुमति दिन्छ।

Q: कुन पाइथन संस्करणहरू Tracker API द्वारा समर्थित छन्?

• A: Tracker API ले Python संस्करण 2.7 र Python लाई समर्थन गर्दछ

यस गाइडको बारेमा

• Tracker API ले तपाईंलाई Python API मार्फत ट्र्याकरका केही सुविधाहरू नियन्त्रण गर्न दिन्छ।
• API ले तपाईंलाई ट्र्याकरका केही सामान्य कार्यहरू स्वचालित गर्न सक्षम बनाउँछ, जस्तै डेटा लोड गर्ने, प्ले गर्ने, र निर्यात गर्ने, विभिन्न वस्तुहरू सक्रिय गर्ने वा निष्क्रिय गर्ने, वा कार्यप्रवाहका भागहरूलाई ट्रिगर गर्ने।
• यो कागजातले तपाईंलाई Tracker API सँग सुरु गर्न सक्षम बनाउँछ।

Tracker API स्थापना गर्नुहोस्

• पाइथनसँग ट्र्याकर एपीआई प्रयोग गर्नको लागि, तपाईंले दुवै स्थापना गर्नुभएको छ भनी सुनिश्चित गर्नुपर्छ।
• Tracker API ले Python 2.7 र Python 3 को लागि समर्थन प्रदान गर्दछ। Vicon सिफारिस गर्दछ कि तपाइँ पाइथन 3 को नवीनतम पूर्ण रिलीज प्रयोग गर्नुहोस् जब सम्म तपाइँको परियोजनाले तपाइँलाई Python को एक विशेष संस्करण प्रयोग गर्न आवश्यक छैन।

यी प्रक्रियाहरूले तपाईंलाई स्थापना प्रक्रिया मार्फत मार्गदर्शन गर्दछ:

• पाइथन संस्करण जाँच गर्नुहोस्
• पाइथन स्थापना गर्दै
• ट्र्याकर पाइथन मोड्युल स्थापना गर्दै
• पाइथन मोड्युल ठीकसँग स्थापना भएको छ भनी जाँच गर्नुहोस्

पाइथन संस्करण जाँच गर्नुहोस्

• यदि तपाइँ निश्चित हुनुहुन्न कि तपाइँसँग पाइथन स्थापना भएको छ वा तपाइँले पाइथनको कुन संस्करण प्रयोग गरिरहनु भएको छ, तपाइँ कमाण्ड प्रम्प्ट खोल्न र py आदेश चलाउन सक्नुहुन्छ।

पूर्वका लागिampLe:

यदि तपाइँसँग पाइथन स्थापना छैन भने, पाइथन स्थापना गर्नुहोस् हेर्नुहोस्।

पाइथन स्थापना गर्नुहोस् Python 2 वा 3 स्थापना गर्न:

1. मा जानुहोस्  https://www.python.org/downloads/
2. आवश्यक संस्करण पत्ता लगाउनुहोस् र पाइथन स्थापना गर्नुहोस्, सुनिश्चित गर्नुहोस् कि PATH मा python.exe थप्नुहोस् चयन गरिएको छ:

माथिको छविमा, एबीसी स्थापना फोल्डरको लागि तपाइँको प्रयोगकर्ता नाम संग प्रतिस्थापित गरिएको छ।

Tracker Python मोड्युल स्थापना गर्नुहोस् Tracker Python मोड्युल स्थापना गर्न:

1. स्थापना पत्ता लगाउनुहोस् files यदि तपाईंले पूर्वनिर्धारित स्थानमा ट्र्याकर स्थापना गर्नुभयो भने, तिनीहरू यस फोल्डरमा फेला पर्छन्: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • यी files प्रदर्शित छन्:
2. तपाईको विशेष स्थापनाको आधारमा निम्न मध्ये कुनै पनि तरिकामा ट्र्याकर पाइथन मोड्युल स्थापना गर्नुहोस्:
   • सबैभन्दा सरल तरिका ब्याच चलाउन हो file (install_tracker_api.bat) जुन ट्र्याकर स्थापनामा समावेश छ (माथिको छविमा देखाइएको छ)।
   • यो सामान्यतया राम्रो काम गर्छ यदि:
   • PATH चरमा पाइथन स्थापना गरिएको थियो; वा
   • पाइथनका धेरै संस्करणहरू स्थापित छन्, तर तपाईँले स्थापना गर्नुभएको नवीनतम संस्करणमा API स्थापना गर्न चाहनुहुन्छ; वा
   • Python को एकल संस्करण मात्र स्थापित छ।
   • यदि यी सर्तहरू मध्ये कुनै पनि लागू हुन्छ भने, ब्याच चलाएर पाइथन मोड्युल स्थापना गर्नुहोस् हेर्नुहोस् file मा।
   • अन्य सबै अवस्थामा, पाइप प्रयोग गरेर पाइथन मोड्युल स्थापना गर्नुहोस्। यो सामान्यतया लागू हुन्छ यदि:
   • पाइथनका धेरै संस्करणहरू स्थापित छन्, तर तपाइँ एक विशेष संस्करणमा स्थापना गर्न चाहनुहुन्छ; वा
   • पाइथनको धेरै फरक संस्करणहरू स्थापना गरिएका छन् र तपाइँ ती सबैमा स्थापना गर्न चाहनुहुन्छ (यस अवस्थामा, तपाइँ प्रत्येक संस्करणको लागि मोड्युल स्थापना गर्नुपर्छ); वा
   • पाइथनको एउटा मात्र संस्करण स्थापना गरिएको छ, तर तपाईंले PATH मा स्थापना गर्नुभएन।
   • यदि यी सर्तहरू मध्ये कुनै पनि लागू हुन्छ भने, पाइप अन चलाएर पाइथन मोड्युल स्थापना गर्नुहोस्।

ब्याच चलाएर पाइथन मोड्युल स्थापना गर्नुहोस् file यो गर्न:

1. पाइथन स्थापना फोल्डरमा नेभिगेट गर्नुहोस्: C: \ कार्यक्रम 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”

नोट माथिका पूर्वampलेस ट्र्याकर 3.11 सँग पाइथन 4.0 स्थापना प्रयोग गर्दछ। तपाईंको मार्ग र आदेशहरू थोरै फरक हुन सक्छ।

पाइथन मोड्युल ठीकसँग स्थापना भएको छ भनी जाँच गर्नुहोस्

• जाँच गर्नुहोस् कि निम्न मोड्युलहरू स्थापना गरिएको छ।
• vicon_core_api: यो कोर रिमोट कन्ट्रोल API हो र टर्मिनल सर्भरसँग सञ्चारको लागि ग्राहक समावेश गर्दछ।
• tracker_api: ट्र्याकर-विशिष्ट अनुप्रयोग कार्यक्षमता पहुँच गर्न सेवाहरू API।
• ट्र्याकर पाइथन मोड्युल सही रूपमा स्थापना भएको छ भनी परीक्षण गर्न, पाइथनमा भएको एउटा मोड्युल आयात गर्ने प्रयास गर्नुहोस्: >>> vicon_core_api आयात गर्नुहोस्।

यदि माथिको प्रक्रियाले मोड्युल पहिचान गर्न असफल भयो भने, निम्न प्रयास गर्नुहोस्:

• tracker_api वा vicon_core_api फोल्डरको लागि पाइथन स्थापनामा साइट-प्याकेज फोल्डर जाँच गर्नुहोस्। Python 3.11 को लागि, पूर्वनिर्धारित स्थापना फोल्डरको स्थान हो:
  • C: प्रयोगकर्ताहरू \AppData\Local\Programs\Python\Python311\Lib\site-packages
• आफ्नो प्रणाली वातावरण चर जाँच गर्नुहोस् र सुनिश्चित गर्नुहोस् कि पाइथन स्थापनाको लागि स्क्रिप्ट फोल्डर तपाईले प्रयोग गर्न चाहानुहुन्छ सूचीमा उच्चतम छ। Python 3.11 को लागि, स्थापना फोल्डरको पूर्वनिर्धारित स्थान हो:
  • C: प्रयोगकर्ताहरू \AppData\Local\Programs\Python\Python311\Scripts
• यदि मोड्युलको फोल्डरहरू मध्ये कुनै पनि हराइरहेको छ भने, र तपाईंले मार्ग प्रमाणित गर्नुभएको छ भने, ट्र्याकर पाइथन मोड्युल स्थापनामा वर्णन गरिएको स्थापना प्रक्रिया मार्फत पुन: चलाउनुहोस्।

टर्मिनल सर्भरमा जडान गर्नुहोस्

• टर्मिनल सर्भरमा जडान गर्न, पहिले Vicon Core API मोड्युल आयात गर्नुहोस्: >>> vicon_core_api आयात गर्नुहोस्
  • >>> vicon_core_api आयातबाट
• अर्को, ग्राहक सिर्जना गर्नुहोस्। यसले स्वचालित रूपमा पूर्वनिर्धारित पोर्ट (52800) मा विशिष्ट होस्ट ठेगानामा जडान गर्न प्रयास गर्दछ >>> c = ग्राहक('localhost')
• क्लाइन्ट सफलतापूर्वक सर्भरमा जडान भएको जाँच गर्नुहोस्: >>> प्रिन्ट(c.connected) True
• यदि प्रतिक्रिया गलत छ भने, निश्चित होस्ट ठेगानामा चलिरहेको ट्र्याकरको उदाहरण र तपाईंको फायरवालले नयाँ क्लाइन्ट सिर्जना गर्नु अघि, पोर्ट 52800 मा ट्राफिक अवरुद्ध गरिरहेको छैन भनेर सुनिश्चित गर्नुहोस्।
• जब तपाइँ सफलतापूर्वक जडान गर्नुभयो, तपाइँ ट्र्याकर टर्मिनल सर्भर द्वारा प्रदान गरिएका सेवाहरू पहुँच गर्न सक्नुहुन्छ।
• यो पूर्वampले आधारभूत वस्तु सेवाहरू प्रयोग गर्दछ: >>> tracker_api आयात गर्नुहोस् >>> tracker_api बाट BasicObjectServices आयात गर्नुहोस् >>> सेवाहरू = BasicObjectServices(c)
• जब यो जडान हुन्छ, तपाईंले ट्र्याकर उदाहरणमा विधिहरू कल गर्न सक्नुहुन्छ।
  • पूर्वका लागिample, ट्र्याकिङ प्यानलमा वस्तुहरूको सूची प्राप्त गर्न, प्रयोग गर्नुहोस्: >>> परिणाम, object_list = services.basic_object_list() >>> print(नतिजा)
  • ठीक छ: समारोह सफल भयो
  • >>> प्रिन्ट (वस्तु_सूची)
  • ['वस्तु1', 'वस्तु2'...]
• सबै API कलहरूले परिणाम कोड फर्काउँछ, जुन vicon_core_api/result.py मा वर्णन गरिएको छ।
• एउटा सम्भावित विफलता कोड Result.RPCNotConnected हो, जुन टर्मिनल सर्भरमा जडान हराएमा प्राप्त हुन्छ।
• पूर्वका लागिample: >>> परिणाम, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: रिमोट प्रकार्य वा कलब्याकमा जडान खुला छैन
• सबै उपलब्ध कार्यहरू र कागजातहरूको सूची प्रदर्शन गर्न: >>> मद्दत ( tracker_api)

Exampले स्क्रिप्टहरू

• तपाइँ पूर्व फेला पार्न सक्नुहुन्छampले स्क्रिप्टहरू मा सामान्य API प्रकार्यहरूको प्रयोग देखाउँदै C: \ कार्यक्रम Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• सबै स्क्रिप्टहरूसँग कागजातहरू छन् र - मद्दत विकल्प लिनुहोस् जसले सान्दर्भिक तर्कहरूको विवरण दिन्छ।
• रूपमा चलाउनample स्क्रिप्ट, माथिको स्क्रिप्ट फोल्डरमा आदेश विन्डो वा पावर शेल खोल्नुहोस्। तपाइँ यसलाई दुई मध्ये एक तरिकामा गर्न सक्नुहुन्छ:
• आदेश प्रम्प्ट खोल्नुहोस् र स्क्रिप्ट फोल्डरमा आफ्नो डाइरेक्टरी परिवर्तन गर्नुहोस्: c:\> cd C:\ कार्यक्रम Files\Vicon\Tracker
  • ४.०\SDK\Python\sample_scripts
• स्क्रिप्ट फोल्डरमा SHIFT+दायाँ क्लिक गर्नुहोस् र यहाँ कमाण्ड विन्डो खोल्नुहोस् वा यहाँ Powershell विन्डो खोल्नुहोस् चयन गर्नुहोस्।
• यहाँबाट तपाइँ पूर्व चलाउन सक्नुहुन्छampतपाईंको रोजाइको लि स्क्रिप्ट।
• निम्न पूर्वamples आदेश सञ्झ्याल प्रयोग गर्नुहोस्।

camera_calibration_wave.py

• यो स्क्रिप्टले छडी लहर सुरु गर्ने र रोक्ने क्यालिब्रेसन प्रक्रिया नियन्त्रण गर्न API प्रकार्यहरू कसरी प्रयोग गर्ने भनेर देखाउँछ।
  • C: \ कार्यक्रम 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 क्विक स्टार्ट गाइड ३१ मे २०२३, संशोधन १
• Tracker 4.0 को साथ प्रयोगको लागि
• © प्रतिलिपि अधिकार 2020–2023 Vicon Motion Systems Limited। सबै अधिकार सुरक्षित।
• संशोधन १. ट्र्याकर ४.० सँग प्रयोगको लागि
• Vicon Motion Systems Limited ले यस कागजातमा सूचना वा विनिर्देशहरू बिना सूचना परिवर्तन गर्ने अधिकार सुरक्षित गर्दछ।
• कम्पनीहरू, नामहरू, र डेटा पूर्वमा प्रयोग गरियोampअन्यथा उल्लेख नगरेसम्म काल्पनिक हुन्। यस प्रकाशनको कुनै पनि अंश पुन: उत्पादन, पुन: प्राप्ति प्रणालीमा भण्डारण, वा कुनै पनि रूपमा वा कुनै पनि माध्यमबाट, इलेक्ट्रोनिक वा मेकानिकल, फोटोकपी वा रेकर्डिङद्वारा, वा अन्यथा 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™ Oxford Metrics plc का ट्रेडमार्कहरू हुन्।
• VESA® VESA को स्वामित्वमा रहेको दर्ता गरिएको ट्रेडमार्क हो (www.vesa.org/about-vesa/)। यहाँ अन्य उत्पादन र कम्पनी नामहरू तिनीहरूको सम्बन्धित मालिकहरूको ट्रेडमार्क हुन सक्छ।
• पूर्ण र अप-टु-डेट प्रतिलिपि अधिकार र ट्रेडमार्क स्वीकृतिहरूको लागि, भ्रमण गर्नुहोस् https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems एक Oxford Metrics plc कम्पनी हो।
• इमेल: support@vicon.com Web: http://www.vicon.com