VICON Tracker Python Api кориснички водич

Содржини скриј

1 VICON Tracker Python API

2 Упатство за употреба на производот

3 За овој водич

4 Инсталирајте го Tracker API

5 Поврзете се со терминалниот сервер

6 Exampскрипти

7 Документи / ресурси

7.1 Референци

8 Поврзани мислења

VICON Tracker Python API

Спецификации

Име на производ: Vicon Tracker Python API
Компатибилност: Тракер 4.0
Поддржани верзии на Python: 2.7 и Python 3

Упатство за употреба на производот

Инсталирајте го Tracker API

За да го користите Tracker API со Python, следете ги овие чекори:

Проверете ја верзијата на Python за да се обезбеди компатибилност.
Инсталирајте го Python со преземање од официјалното webсајт и избирање на соодветната верзија.
Лоцирајте го и инсталирајте го модулот Tracker Python од наведената папка.

Проверете ја верзијата на Python

Отворете командна линија.
Напишете 'py' и притиснете Enter.
Ако Python не е инсталиран, погледнете ги упатствата за инсталација.

Инсталирајте Python

Одете на Службеник на Пајтон webсајт.
Преземете и инсталирајте го Python, осигурувајќи се да додадете python.exe на PATH за време на инсталацијата.

Инсталирајте го Tracker Python модулот:

Лоцирајте ја инсталацијата files во наведената папка.
Изберете го методот на инсталација врз основа на вашето поставување.

Инсталирајте го модулот Python со извршување на серијата File:

Одете во папката за инсталирање на Python: C: Program FilesViconTracker4.xSDKPython
Кликнете двапати на „install_tracker_api.bat“ за да го започнете процесот на инсталација.

Најчесто поставувани прашања (ЧПП):

П: Што можам да автоматизирам користејќи го Tracker API?

A: Tracker API ви овозможува да ги автоматизирате вообичаените функции како што се вчитување, играње, извоз на податоци, активирање/деактивирање на објекти и активирање на делови од работниот тек.

П: Кои верзии на Python се поддржани од Tracker API?

A: Tracker API поддржува Python верзии 2.7 и Python

За овој водич

Tracker API ви овозможува да контролирате одредени карактеристики на Tracker преку Python API.

API ви овозможува да автоматизирате некои вообичаени функции на Tracker, како што се вчитување, играње и извоз на податоци, активирање или деактивирање на различни објекти или активирање на делови од работниот тек.
Овој документ ви овозможува да започнете со Tracker API.

Инсталирајте го Tracker API

За да го користите Tracker API со Python, мора да бидете сигурни дека сте ги инсталирале и двете.
Tracker API обезбедува поддршка за 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:

Одете на https://www.python.org/downloads/
Лоцирајте ја потребната верзија и инсталирајте го Python, осигурувајќи дека е избрано Додај python.exe на PATH:

На горната слика, ABC е заменет со вашето корисничко име за папката за инсталација.

Инсталирајте го модулот Tracker Python За да го инсталирате модулот Tracker Python:

Лоцирајте ја инсталацијата fileс. Ако сте го инсталирале Tracker на стандардната локација, тие се наоѓаат во оваа папка: C:\Program Files\Vicon\Tracker4.x\SDK\Python
- Овие files се прикажани:

Инсталирајте го модулот Tracker Python на кој било од следниве начини, во зависност од вашата конкретна инсталација:
- Наједноставниот начин е да ја стартувате серијата file (install_tracker_api.bat) што е вклучено во инсталацијата на Tracker (како што е прикажано на горната слика).
- Ова обично функционира добро ако:
- Python беше инсталиран на променливата PATH; или
- Инсталирани се повеќе верзии на Python, но сакате да го инсталирате API на најновата верзија што сте ја инсталирале; или
- Инсталирана е само една верзија на Python.
- Ако се применува некој од овие услови, видете Инсталирајте го модулот python со вклучување на серијата file на.
- Во сите други случаи, инсталирајте го модулот Python користејќи pip. Ова обично се применува ако:
- Инсталирани се повеќе верзии на Python, но сакате да инсталирате на одредена верзија; или
- Инсталирани се повеќе различни верзии на Python и сакате да ги инсталирате на сите (во овој случај, мора да го инсталирате модулот за секоја верзија); или
- Само една верзија на Python е инсталирана, но вие не сте ја инсталирале на PATH.
- Ако се применува некој од овие услови, видете Инсталирајте го модулот Python со вклучување на пип.

Инсталирајте го модулот Python со извршување на серијата file За да го направите ова:

Одете во папката за инсталирање на Python: C:\Програма Files\Vicon\Tracker4.x\SDK\Python
Кликнете двапати install_tracker_api.bat.
- Процесот на инсталација се иницијализира автоматски.

Инсталирајте го модулот Python со извршување на пип

Одете до папката Скрипти за Python што сакате да ја користите:
За Python 3, стандардната папка за инсталација е: C: \Users\ \AppData\Local\Programs\Python\Python \Sc рипува
- За Python 2.7, стандардната папка за инсталација е: C:\Python27\Scripts

Отворете команден прозорец или PowerShell во таа папка.
Извршете ја следнава команда за да го инсталирате 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: Services API за пристап до функционалноста на апликацијата специфична за Tracker.
За да тестирате дали модулот Tracker Python е правилно инсталиран, обидете се да внесете еден од модулите во Python: >>> import vicon_core_api

Ако горенаведениот процес не успее да го препознае модулот, обидете се со следново:

Проверете ја папката site-packages во инсталацијата на Python за папката tracker_api или vicon_core_api. За Python 3.11, локацијата на стандардната папка за инсталација е:
- В:\Корисници\ \AppData\Local\Programs\Python\Python311\Lib\сајт-пакети
Проверете ги променливите на вашата системска околина и проверете дали папката со скрипти за инсталацијата на Python што сакате да ја користите е највисока во списокот. За Python 3.11, стандардната локација на папката за инсталација е:
- В:\Корисници\ \AppData\Local\Programs\Python\Python311\Scripts
Ако некоја од папките на модулите недостасува, а сте ја потврдиле патеката, повторно стартувајте низ процесот на инсталација опишан во Инсталирање на модулот Tracker Python вклучен.

Поврзете се со терминалниот сервер

За да се поврзете со терминалниот сервер, прво увезете го Vicon Core API модулот: >>> увезете vicon_core_api
- >>> од увоз на vicon_core_api
Следно, креирајте клиент. Ова автоматски се обидува да се поврзе со конкретната адреса на домаќинот на стандардната порта (52800) >>> c = Client('localhost')
Проверете дали клиентот успешно се поврзал на серверот: >>> print(c.поврзано) Точно
Ако одговорот е неточен, уверете се дека имате пример на Tracker што работи на наведената адреса на домаќинот и вашиот заштитен ѕид не го блокира сообраќајот на портата 52800, пред да креирате нов клиент.
Кога успешно ќе се поврзете, можете да пристапите до услугите што ги обезбедува терминалниот сервер на Tracker.
Овој ексampкористи основни објект услуги: >>> увезете tracker_api >>> од tracker_api увезете BasicObjectServices >>> услуги = BasicObjectServices(c)
Кога е поврзан, можете да повикате методи на примерот на Tracker.
- За прample, за да добиете листа на објекти во панелот за следење, користете: >>> резултат, објект_листа = services.basic_object_list() >>> print(резултат)
- Во ред: функцијата успеа
- >>> печатење (список_објекти)
- ['Објект 1', 'Објект2'…]

Сите повици на API враќаат код за резултат, кој е опишан во vicon_core_api/result.py.
Еден можен код за неуспех е Result.RPCNotConnected, кој се прима ако се изгуби врската со терминалниот сервер.
За прample: >>> резултат, објект_листа = services.basic_object_list() vicon_core_api.client.RPCE грешка: RPCNotConnected: Врската со далечинската функција или повратен повик не е отворена

За да се прикаже список со сите достапни функции и документација: >>> help( tracker_api)

Exampскрипти

Можете да најдете ексample скрипти кои прикажуваат употреба на заеднички API функции на C:\Програма Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
Сите скрипти имаат документација и земаат опција –помош која дава детали за соодветните аргументи.

Да се кандидира какоample script, отворете команден прозорец или школка за напојување во папката скрипти погоре. Можете да го направите ова на еден од двата начини:
Отворете ја командната линија и сменете го директориумот во папката скрипти: c:\> cd C:\Program Files\Vicon\Tracker
- 4.0\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 е наведено пред контролите. За да го промените името на фотографирањето, користете capture_services и SetCaptureName.
За прашања за користење на Tracker API, контактирајте со Vicon Support1.
1 пошта до:support@vicon.com
Vicon Tracker Python API Водич за брз почеток 31 мај 2023 година, ревизија 1

За употреба со Tracker 4.0
Ревизија 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] Упатство за корисникот
Тракер Python Api, Tracker, Python Api, Api

Референци

Упатство за употреба