API на Python за проследяване на VICON

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

• Име на продукта: Vicon Tracker Python API
• Съвместимост: Тракер 4.0
• Поддържани версии на Python: 2.7 и Python 3

Инструкции за употреба на продукта

Инсталирайте API за проследяване

За да използвате 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 по време на инсталацията.

Инсталирайте модула Python за проследяване:

1. Намерете инсталацията files в посочената папка.
2. Изберете метода на инсталиране въз основа на вашата настройка.

Инсталирайте модула на Python чрез стартиране на пакета File:

1. Отидете до папката за инсталиране на Python: C: Програма FilesViconTracker4.xSDKPython
2. Щракнете двукратно върху „install_tracker_api.bat“, за да започнете инсталационния процес.

Често задавани въпроси (FAQ):

Въпрос: Какво мога да автоматизирам с помощта на API за проследяване?

• A: API за проследяване ви позволява да автоматизирате общи функции като зареждане, възпроизвеждане, експортиране на данни, активиране/дезактивиране на обекти и задействане на части от работния процес.

Въпрос: Кои версии на Python се поддържат от API на Tracker?

• A: API на Tracker поддържа Python версии 2.7 и Python

Относно това ръководство

• API на Tracker ви позволява да контролирате определени функции на Tracker чрез API на Python.
• API ви позволява да автоматизирате някои общи функции на Tracker, като зареждане, възпроизвеждане и експортиране на данни, активиране или дезактивиране на различни обекти или задействане на части от работния процес.
• Този документ ви позволява да започнете с API на Tracker.

Инсталирайте API за проследяване

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

1. Отидете на  https://www.python.org/downloads/
2. Намерете необходимата версия и инсталирайте Python, като се уверите, че е избрано Add python.exe към PATH:

В изображението по-горе ABC е заменено с вашето потребителско име за инсталационната папка.

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

1. Намерете инсталацията fileс. Ако сте инсталирали Tracker в местоположението по подразбиране, те се намират в тази папка: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Тези fileсе показват:
2. Инсталирайте модула Tracker Python по един от следните начини, в зависимост от вашата конкретна инсталация:
   • Най-лесният начин е да стартирате партидата file (install_tracker_api.bat), който е включен в инсталацията на Tracker (както е показано на изображението по-горе).
   • Това обикновено работи добре, ако:
   • Python е инсталиран на променливата PATH; или
   • Инсталирани са множество версии на Python, но вие искате да инсталирате API до най-новата версия, която сте инсталирали; или
   • Инсталирана е само една версия на Python.
   • Ако някое от тези условия е приложимо, вижте Инсталиране на модула python чрез стартиране на пакета file на.
   • Във всички останали случаи инсталирайте модула Python с помощта на pip. Това обикновено се прилага, ако:
   • Инсталирани са няколко версии на Python, но вие искате да инсталирате до конкретна версия; или
   • Инсталирани са множество различни версии на Python и искате да инсталирате на всички тях (в този случай трябва да инсталирате модула за всяка версия); или
   • Инсталирана е само една версия на Python, но вие не сте инсталирали в PATH.
   • Ако някое от тези условия е приложимо, вижте Инсталиране на модула Python чрез изпълнение на pip.

Инсталирайте модула 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 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)
  • Добре: функцията е успешна
  • >>> печат (списък_обекти)
  • ['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)

Example скриптове

• Можете да намерите пр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 тук.
• От тук можете да стартирате ексample скрипт по ваш избор.
• Следният пример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.
• За въпроси относно използването на API за проследяване се свържете с поддръжката на Vicon1.
• 1 имейл:support@vicon.com
• Ръководство за бързо стартиране на API на Vicon Tracker Python 31 май 2023 г., ревизия 1
• За използване с Tracker 4.0
• © Copyright 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

Референции

• Ръководство за потребителя