VICON Tracker Python API

Техникалық сипаттамалар

• Өнім атауы: Vicon Tracker Python API
• Үйлесімділік: Tracker 4.0
• Қолдау көрсетілетін Python нұсқалары: 2.7 және Python 3

Өнімді пайдалану нұсқаулары

Tracker API орнатыңыз

Tracker API интерфейсін Python көмегімен пайдалану үшін мына қадамдарды орындаңыз:

1. Үйлесімділікті қамтамасыз ету үшін Python нұсқасын тексеріңіз.
2. Python бағдарламасын ресми жерден жүктеп алу арқылы орнатыңыз webсайт және сәйкес нұсқаны таңдау.
3. Көрсетілген қалтадан Tracker Python модулін тауып, орнатыңыз.

Python нұсқасын тексеріңіз

1. Пәрмен жолын ашыңыз.
2. «py» деп теріп, Enter пернесін басыңыз.
3. Python орнатылмаған болса, орнату нұсқауларын қараңыз.

Python орнатыңыз

1. өтіңіз Python ресми өкілі webсайт.
2. Орнату кезінде PATH файлына python.exe файлын қосуды қамтамасыз ете отырып, Python бағдарламасын жүктеп алыңыз және орнатыңыз.

Tracker Python модулін орнату:

1. Орнатуды табыңыз files көрсетілген қалтада.
2. Орнату әдісіне негізделген орнату әдісін таңдаңыз.

Пакетті іске қосу арқылы Python модулін орнатыңыз File:

1. Python орнату қалтасына өтіңіз: C: Бағдарлама FilesViconTracker4.xSDKPython
2. Орнату процесін бастау үшін 'install_tracker_api.bat' сілтемесін екі рет басыңыз.

Жиі қойылатын сұрақтар (ЖҚС):

С: Tracker API арқылы нені автоматтандыруға болады?

• A: Tracker API сізге деректерді жүктеу, ойнату, экспорттау, нысандарды белсендіру/өшіру және жұмыс процесінің бөліктерін іске қосу сияқты жалпы функцияларды автоматтандыруға мүмкіндік береді.

С: Tracker API қай Python нұсқаларына қолдау көрсетеді?

• A: Tracker API Python 2.7 және Python нұсқаларын қолдайды

Осы нұсқаулық туралы

• Tracker API Python API арқылы Tracker кейбір мүмкіндіктерін басқаруға мүмкіндік береді.
• API сізге деректерді жүктеу, ойнату және экспорттау, әртүрлі нысандарды белсендіру немесе өшіру немесе жұмыс процесінің бөліктерін іске қосу сияқты Tracker қолданбасының кейбір жалпы функцияларын автоматтандыруға мүмкіндік береді.
• Бұл құжат Tracker API-мен жұмысты бастауға мүмкіндік береді.

Tracker API орнатыңыз

• Tracker API интерфейсін Python көмегімен пайдалану үшін екеуінде де орнатылғанына көз жеткізу керек.
• Tracker API Python 2.7 және Python 3 үшін қолдау көрсетеді. Жобаңыз Python бағдарламасының нақты нұсқасын пайдалануды талап етпесе, Vicon Python 3 нұсқасының соңғы толық нұсқасын пайдалануды ұсынады.

Бұл процедуралар орнату процесінде сізге нұсқау береді:

• Python нұсқасын тексеріңіз
• Python орнатылуда
• Tracker Python модулін орнату
• Python модулінің дұрыс орнатылғанын тексеріңіз

Python нұсқасын тексеріңіз

• Егер сізде Python орнатылғанына немесе Python нұсқасының қай нұсқасын пайдаланып жатқаныңызға сенімді болмасаңыз, пәрмен жолын ашып, py пәрменін іске қосуға болады.

Мысалыampле:

Егер сізде Python орнатылмаған болса, Python орнату бөлімін қараңыз.

Python орнатыңыз Python 2 немесе 3 орнату үшін:

1. өтіңіз  https://www.python.org/downloads/
2. Қажетті нұсқаны тауып, Python.exe файлын PATH ішіне қосу таңдалғанына көз жеткізіп, Python орнатыңыз:

Жоғарыдағы суретте ABC орнату қалтасының пайдаланушы атымен ауыстырылған.

Tracker Python модулін орнату Tracker Python модулін орнату үшін:

1. Орнатуды табыңыз fileс. Tracker қолданбасын әдепкі орында орнатқан болсаңыз, олар мына қалтада болады: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Бұл files көрсетіледі:
2. Нақты орнатуыңызға байланысты Tracker Python модулін келесі жолдардың кез келгенімен орнатыңыз:
   • Ең қарапайым әдіс - топтаманы іске қосу file (install_tracker_api.bat) ол Tracker орнатуына кіреді (жоғарыдағы суретте көрсетілгендей).
   • Бұл әдетте жақсы жұмыс істейді, егер:
   • Python PATH айнымалысына орнатылды; немесе
   • Python бағдарламасының бірнеше нұсқасы орнатылған, бірақ сіз API орнатқан соңғы нұсқаға орнатқыңыз келеді; немесе
   • Python бағдарламасының бір ғана нұсқасы орнатылған.
   • Осы шарттардың кез келгені қолданылса, пакетті іске қосу арқылы python модулін орнату бөлімін қараңыз file қосулы.
   • Барлық басқа жағдайларда, Python модулін pip көмегімен орнатыңыз. Бұл әдетте қолданылады, егер:
   • Python бағдарламасының бірнеше нұсқасы орнатылған, бірақ сіз белгілі бір нұсқаға орнатқыңыз келеді; немесе
   • Python бағдарламасының бірнеше түрлі нұсқалары орнатылған және олардың барлығына орнатқыңыз келеді (бұл жағдайда модульді әр нұсқа үшін орнату керек); немесе
   • Python бағдарламасының бір ғана нұсқасы орнатылған, бірақ сіз PATH жүйесіне орнатпадыңыз.
   • Осы шарттардың кез келгені қолданылса, Python модулін pip on іске қосу арқылы орнату бөлімін қараңыз.

Пакетті іске қосу арқылы Python модулін орнатыңыз file Мұны істеу үшін:

1. Python орнату қалтасына өтіңіз: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. install_tracker_api.bat файлын екі рет басыңыз.
   • Орнату процесі автоматты түрде инициализацияланады.

Python модулін пипті іске қосу арқылы орнатыңыз

1. Пайдаланғыңыз келетін Python үшін Сценарийлер қалтасына өтіңіз:
2. Python 3 үшін әдепкі орнату қалтасы: C: \Users\ \AppData\Local\Programs\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”
   • Tracker API C орнату үшін келесі пәрменді орындаңыз: \Пайдаланушылар\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe орнату "C:\Program" Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Ескерту Жоғарыдағы бұрынғыampTracker 3.11 жүйесі бар Python 4.0 орнатуын пайдаланады. Жолыңыз бен пәрмендеріңіз сәл өзгеше болуы мүмкін.

Python модулінің дұрыс орнатылғанын тексеріңіз

• Келесі модульдердің орнатылғанын тексеріңіз.
• vicon_core_api: Бұл қашықтан басқарудың негізгі API интерфейсі және терминал серверімен байланысуға арналған клиентті қамтиды.
• tracker_api: Tracker-арнайы қолданба функцияларына қол жеткізу үшін API Services.
• Tracker Python модулінің дұрыс орнатылғанын тексеру үшін Python ішіндегі модульдердің бірін импорттап көріңіз: >>> import vicon_core_api

Жоғарыдағы процесс модульді тани алмаса, келесі әрекеттерді орындап көріңіз:

• tracker_api немесе vicon_core_api қалталары үшін Python орнатуындағы сайт пакеттері қалтасын тексеріңіз. Python 3.11 үшін әдепкі орнату қалтасының орны:
  • C:\Пайдаланушылар\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Жүйе ортасының айнымалы мәндерін тексеріңіз және пайдаланғыңыз келетін Python орнатуына арналған сценарийлер қалтасының тізімдегі ең жоғарғысы екеніне көз жеткізіңіз. Python 3.11 үшін орнату қалтасының әдепкі орны:
  • C:\Пайдаланушылар\ \AppData\Local\Programs\Python\Python311\Scripts
• Модульдердің қалталарының біреуі жоқ болса және жолды растасаңыз, Tracker Python модулін орнату қосулы бөлімінде сипатталған орнату процесін қайта орындаңыз.

Терминал серверіне қосылыңыз

• Терминал серверіне қосылу үшін алдымен Vicon Core API модулін импорттаңыз: >>> import vicon_core_api
  • >>> vicon_core_api импортынан
• Содан кейін клиентті жасаңыз. Бұл автоматты түрде әдепкі порттағы белгілі бір хост мекенжайына қосылуға әрекеттенеді (52800) >>> c = Client('localhost')
• Клиенттің серверге сәтті қосылғанын тексеріңіз: >>> басып шығару(c.connected) Рас
• Жауап False болса, жаңа клиентті жасамас бұрын, көрсетілген хост мекенжайында жұмыс істейтін Tracker данасы бар екеніне және брандмауэр 52800 портындағы трафикті блоктамайтынына көз жеткізіңіз.
• Сәтті қосылған кезде, Tracker терминал сервері ұсынатын қызметтерге қол жеткізе аласыз.
• Бұл бұрынғыampнегізгі объектілік қызметтерді пайдаланады: >>> tracker_api импорттау >>> tracker_api ішінен BasicObjectServices импорттау >>> қызметтері = BasicObjectServices(c)
• Ол қосылған кезде Tracker данасында әдістерді шақыруға болады.
  • Мысалыample, Бақылау тақтасындағы нысандардың тізімін алу үшін мынаны пайдаланыңыз: >>> нәтиже, object_list = services.basic_object_list() >>> print(result)
  • Жарайды: функция орындалды
  • >>> басып шығару (нысандар_тізімі)
  • ['Object1', 'Object2'…]
• Барлық API қоңыраулары vicon_core_api/result.py ішінде сипатталған нәтиже кодын қайтарады.
• Бір ықтимал ақаулық коды - нәтиже.RPCNotConnected, ол терминал серверіне қосылым жоғалған жағдайда алынады.
• Мысалыample: >>> нәтиже, object_list = services.basic_object_list() vicon_core_api.client.RPCEқате: RPCNotConnected: қашықтағы функцияға қосылым немесе кері шақыру ашық емес
• Барлық қолжетімді функциялар мен құжаттамалардың тізімін көрсету үшін: >>> help( tracker_api)

Exampсценарийлер

• Сіз бұрынғысын таба аласызampжалпы API функцияларын пайдалануды көрсететін сценарийлер C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Барлық сценарийлерде құжаттама бар және сәйкес аргументтердің мәліметтерін беретін –help опциясын қабылдайды.
• ретінде іске қосуample script үшін жоғарыдағы сценарийлер қалтасында пәрмен терезесін немесе қуат қабығын ашыңыз. Мұны екі жолдың бірімен орындауға болады:
• Пәрмен жолын ашып, каталогты сценарийлер қалтасына өзгертіңіз: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• SHIFT пернесін басып тұрып, сценарийлер қалтасында тінтуірдің оң жақ түймешігін басыңыз және пәрмен терезесін осы жерден ашу немесе Powershell терезесін осы жерден ашу опциясын таңдаңыз.
• Осы жерден сіз бұрынғыны іске қоса аласызampсіздің таңдауыңыз бойынша сценарий.
• Келесі эксampпәрмен терезесін пайдаланады.

camera_calibration_wave.py

• Бұл сценарий таяқша толқынын бастау және тоқтату калибрлеу процесін басқару үшін API функцияларын пайдалану жолын көрсетеді.
  • C:\Program 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 жылдам бастау нұсқаулығы 31 жылғы 2023 мамыр, 1-нұсқа
• Tracker 4.0 бағдарламасымен пайдалануға арналған
• © Авторлық құқық 2020–2023 Vicon Motion Systems Limited. Барлық құқықтар сақталған.
• Түзету 1. Tracker 4.0 бағдарламасымен пайдалануға арналған
• Vicon Motion Systems Limited компаниясы ескертусіз осы құжаттағы ақпаратқа немесе техникалық сипаттамаларға өзгертулер енгізу құқығын өзіне қалдырады.
• Бұрын пайдаланылған компаниялар, атаулар және деректерamples, егер басқаша белгіленбесе, жалған болып табылады. Осы жарияланымның ешбір бөлігін 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

Құжаттар / Ресурстар

VICON Tracker Python Api [pdf] Пайдаланушы нұсқаулығы Tracker Python Api, Tracker, Python Api, Api

Анықтамалар

• Пайдаланушы нұсқаулығы