VICON Tracker Python API

Тэхнічныя характарыстыкі

• Назва прадукту: Vicon Tracker Python API
• Сумяшчальнасць: Трэкер 4.0
• Падтрымліваюцца версіі Python: 2.7 і Python 3

Інструкцыя па ўжыванні прадукту

Усталюйце API Tracker

Каб выкарыстоўваць Tracker API з Python, выканайце наступныя дзеянні:

1. Праверце версію Python, каб пераканацца ў сумяшчальнасці.
2. Усталюйце Python, загрузіўшы яго з афіцыйнага сайта webсайта і выбраўшы адпаведную версію.
3. Знайдзіце і ўсталюйце модуль Tracker Python з указанай папкі.

Праверце версію Python

1. Адкрыйце камандны радок.
2. Увядзіце «py» і націсніце Enter.
3. Калі Python не ўсталяваны, звярніцеся да інструкцый па ўсталёўцы.

Усталюйце Python

1. Перайсці да Python афіцыйны webсайт.
2. Спампуйце і ўсталюйце Python, дадаўшы python.exe у PATH падчас усталёўкі.

Усталюйце модуль Tracker Python:

1. Знайдзіце ўстаноўку files у названай тэчцы.
2. Выберыце спосаб усталёўкі ў залежнасці ад налад.

Усталюйце модуль Python, запусціўшы пакет File:

1. Перайдзіце ў тэчку ўстаноўкі Python: C: Праграма FilesViconTracker4.xSDKPython
2. Двойчы пстрыкніце па «install_tracker_api.bat», каб пачаць працэс усталёўкі.

Часта задаюць пытанні (FAQ):

Q: Што я магу аўтаматызаваць з дапамогай Tracker API?

• A: API Tracker дазваляе аўтаматызаваць агульныя функцыі, такія як загрузка, прайграванне, экспарт дадзеных, актывацыя/дэактывацыя аб'ектаў і запуск частак працоўнага працэсу.

Пытанне: Якія версіі Python падтрымліваюцца API Tracker?

• A: API Tracker падтрымлівае Python версіі 2.7 і Python

Пра гэта кіраўніцтва

• API Tracker дазваляе вам кіраваць некаторымі функцыямі Tracker праз API Python.
• API дазваляе аўтаматызаваць некаторыя агульныя функцыі Tracker, такія як загрузка, прайграванне і экспарт дадзеных, актывацыя або дэактывацыя розных аб'ектаў або запуск частак працоўнага працэсу.
• Гэты дакумент дазваляе вам пачаць працу з API Tracker.

Усталюйце API Tracker

• Каб выкарыстоўваць Tracker API з Python, вы павінны пераканацца, што ў вас усталяваны абодва.
• API Tracker забяспечвае падтрымку Python 2.7 і Python 3. Vicon рэкамендуе вам выкарыстоўваць апошнюю поўную версію Python 3, калі ваш праект не патрабуе выкарыстання пэўнай версіі Python.

Гэтыя працэдуры правядуць вас праз працэс усталёўкі:

• Праверце версію Python на
• Ўстаноўка Python на
• Усталёўка модуля Tracker Python на
• Праверце, ці правільна ўсталяваны модуль Python

Праверце версію Python

• Калі вы не ўпэўненыя, ці ўсталяваны ў вас Python або якую версію Python вы выкарыстоўваеце, вы можаце адкрыць камандны радок і выканаць каманду py.

Напрыкладampль:

Калі ў вас не ўсталяваны Python, гл. Усталёўка Python.

Усталюйце Python Каб усталяваць Python 2 або 3:

1. Перайсці да  https://www.python.org/downloads/
2. Знайдзіце неабходную версію і ўсталюйце Python, пераканаўшыся, што выбрана Add python.exe to PATH:

На малюнку вышэй 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:\Праграма Files\Vicon\Tracker4.x\SDK\Python
2. Двойчы пстрыкніце install_tracker_api.bat.
   • Працэс усталёўкі запускаецца аўтаматычна.

Усталюйце модуль Python, запусціўшы pip

1. Перайдзіце ў тэчку Scripts для 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”

Заўвага Вышэй выпрampвыкарыстоўваць устаноўку Python 3.11 з Tracker 4.0. Ваш шлях і каманды могуць нязначна адрознівацца.

Праверце, ці правільна ўсталяваны модуль Python

• Праверце, ці ўсталяваны наступныя модулі.
• vicon_core_api: Гэта асноўны API дыстанцыйнага кіравання і ўключае ў сябе кліент для сувязі з тэрмінальным серверам.
• tracker_api: API паслуг для доступу да функцый прыкладання Tracker.
• Каб праверыць, ці правільна ўсталяваны модуль Tracker Python, паспрабуйце імпартаваць адзін з модуляў у Python: >>> import vicon_core_api

Калі прыведзены вышэй працэс не можа распазнаць модуль, паспрабуйце наступнае:

• Праверце папку site-packages ва ўсталёўцы Python на наяўнасць папкі tracker_api або vicon_core_api. Для 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')
• Праверце, што кліент паспяхова падключыўся да сервера: >>> print(c.connected) Праўда
• Калі адказ False, упэўніцеся, што ў вас ёсць асобнік Tracker, запушчаны на ўказаным адрасе хаста, і ваш брандмаўэр не блакуе трафік на порце 52800, перш чым ствараць новы кліент.
• Калі вы паспяхова падключыліся, вы можаце атрымаць доступ да паслуг, якія прадстаўляюцца тэрмінальным серверам Tracker.
• Гэты былыample выкарыстоўвае асноўныя службы аб'ектаў: >>> імпартаваць tracker_api >>> з tracker_api імпартаваць BasicObjectServices >>> паслугі = BasicObjectServices(c)
• Калі ён падключаны, вы можаце выклікаць метады ў асобніку Tracker.
  • Напрыкладample, каб атрымаць спіс аб'ектаў на панэлі адсочвання, выкарыстоўвайце: >>> вынік, object_list = services.basic_object_list() >>> print(result)
  • Добра: функцыя выканана паспяхова
  • >>> друк(спіс_аб'ектаў)
  • ['Аб'ект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скрыпты

• Вы можаце знайсці эксample скрыпты, якія паказваюць выкарыстанне агульных функцый API на C:\Праграма Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Усе скрыпты маюць дакументацыю і маюць опцыю -help, якая дае падрабязную інфармацыю аб адпаведных аргументах.
• Бегаць якample script, адкрыйце каманднае акно або Power Shell у папцы scripts вышэй. Вы можаце зрабіць гэта адным з двух спосабаў:
• Адкрыйце камандны радок і зменіце свой каталог на тэчку сцэнарыяў: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Утрымлівайце SHIFT+пстрыкніце правай кнопкай мышы ў тэчцы сцэнарыяў і абярыце Адкрыць акно каманд тут або Адкрыць акно Powershell тут.
• Адсюль вы можаце запусціць эксampскрыпт на ваш выбар.
• Наступны выпрampвыкарыстоўваць каманднае акно.

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 паказана перад элементамі кіравання. Каб змяніць імя захопу, выкарыстоўвайце capture_services і SetCaptureName.
• Па пытаннях выкарыстання Tracker API звяртайцеся ў службу падтрымкі Vicon1.
• 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 пакідае за сабой права ўносіць змены ў інфармацыю або спецыфікацыі ў гэтым дакуменце без папярэдняга паведамлення.
• Кампаніі, імёны і даныя, якія выкарыстоўваюцца ў экс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

Дакументы / Рэсурсы

VICON Tracker Python API [pdfКіраўніцтва карыстальніка Трэкер Python Api, Трэкер, Python Api, Api

Спасылкі

• Кіраўніцтва карыстальніка