API VICON Tracker w języku Python

Specyfikacje

• Nazwa produktu: API Pythona do śledzenia Vicon
• Zgodność: Śledzenie 4.0
• Obsługiwane wersje Pythona: 2.7 i Pythona 3

Instrukcje użytkowania produktu

Zainstaluj interfejs API modułu śledzącego

Aby użyć interfejsu API modułu śledzącego w języku Python, wykonaj następujące kroki:

1. Sprawdź wersję Pythona, aby zapewnić kompatybilność.
2. Zainstaluj Pythona, pobierając go z oficjalnego źródła webwitryny i wybranie odpowiedniej wersji.
3. Znajdź i zainstaluj moduł Tracker Python z określonego folderu.

Sprawdź wersję Pythona

1. Otwórz wiersz poleceń.
2. Wpisz „py” i naciśnij Enter.
3. Jeśli Python nie jest zainstalowany, zapoznaj się z instrukcją instalacji.

Zainstaluj Pythona

1. Idź do Urzędnik Pythona webstrona.
2. Pobierz i zainstaluj język Python, pamiętając o dodaniu pliku python.exe do PATH podczas instalacji.

Zainstaluj moduł Tracker Python:

1. Zlokalizuj instalację files w określonym folderze.
2. Wybierz metodę instalacji w oparciu o konfigurację.

Zainstaluj moduł Pythona, uruchamiając partię File:

1. Przejdź do folderu instalacyjnego Pythona: C: Program FilesViconTracker4.xSDKPython
2. Kliknij dwukrotnie plik „install_tracker_api.bat”, aby rozpocząć proces instalacji.

Najczęściej zadawane pytania (FAQ):

P: Co mogę zautomatyzować za pomocą interfejsu API modułu śledzącego?

• A: Interfejs API Trackera umożliwia automatyzację typowych funkcji, takich jak ładowanie, odtwarzanie, eksportowanie danych, aktywowanie/dezaktywowanie obiektów i uruchamianie części przepływu pracy.

P: Które wersje Pythona są obsługiwane przez API Trackera?

• A: Interfejs API modułu śledzącego obsługuje wersje Python 2.7 i Python

O tym przewodniku

• Interfejs API modułu śledzącego umożliwia kontrolowanie niektórych funkcji modułu śledzącego za pośrednictwem interfejsu API języka Python.
• Interfejs API umożliwia automatyzację niektórych typowych funkcji modułu śledzącego, takich jak ładowanie, odtwarzanie i eksportowanie danych, aktywowanie lub dezaktywowanie różnych obiektów lub uruchamianie części przepływu pracy.
• Ten dokument umożliwia rozpoczęcie pracy z interfejsem API modułu śledzącego.

Zainstaluj interfejs API modułu śledzącego

• Aby używać interfejsu Tracker API z Pythonem, musisz upewnić się, że masz zainstalowane oba.
• Interfejs API Tracker zapewnia obsługę języków Python 2.7 i Python 3. Vicon zaleca korzystanie z najnowszej pełnej wersji języka Python 3, chyba że projekt wymaga użycia określonej wersji języka Python.

Poniższe procedury przeprowadzą Cię przez proces instalacji:

• Sprawdź wersję Pythona na
• Instalowanie Pythona na
• Instalowanie modułu Tracker Python na
• Sprawdź, czy moduł Pythona jest poprawnie zainstalowany

Sprawdź wersję Pythona

• Jeśli nie masz pewności, czy masz zainstalowany język Python lub jakiej wersji Pythona używasz, możesz otworzyć wiersz poleceń i uruchomić polecenie py.

Na przykładampna:

Jeśli nie masz zainstalowanego języka Python, zobacz Instalowanie języka Python.

Zainstaluj Pythona Aby zainstalować Pythona 2 lub 3:

1. Idź do  https://www.python.org/downloads/
2. Znajdź wymaganą wersję i zainstaluj Python, upewniając się, że wybrana jest opcja Dodaj python.exe do PATH:

Na powyższym obrazku litera ABC została zastąpiona nazwą użytkownika folderu instalacyjnego.

Zainstaluj moduł Tracker Python Aby zainstalować moduł Tracker Python:

1. Zlokalizuj instalację fileS. Jeśli zainstalowałeś moduł śledzący w domyślnej lokalizacji, znajdują się one w tym folderze: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Te files są wyświetlane:
2. Zainstaluj moduł Tracker Python w jeden z następujących sposobów, w zależności od konkretnej instalacji:
   • Najprostszym sposobem jest uruchomienie partii file (install_tracker_api.bat) zawarty w instalacji modułu śledzącego (jak pokazano na powyższym obrazku).
   • Zwykle działa to dobrze, jeśli:
   • Python został zainstalowany do zmiennej PATH; Lub
   • Zainstalowanych jest wiele wersji języka Python, ale chcesz zainstalować interfejs API do najnowszej zainstalowanej wersji; Lub
   • Zainstalowana jest tylko jedna wersja Pythona.
   • Jeśli ma zastosowanie którykolwiek z tych warunków, zobacz Instalowanie modułu Pythona, uruchamiając partię file NA.
   • We wszystkich innych przypadkach zainstaluj moduł Pythona za pomocą pip. Zwykle ma to zastosowanie, jeśli:
   • Zainstalowanych jest wiele wersji języka Python, ale chcesz zainstalować konkretną wersję; Lub
   • Zainstalowanych jest wiele różnych wersji Pythona i chcesz zainstalować je wszystkie (w tym przypadku musisz zainstalować moduł dla każdej wersji); Lub
   • Zainstalowana jest tylko jedna wersja Pythona, ale nie zainstalowałeś jej w PATH.
   • Jeśli którykolwiek z tych warunków ma zastosowanie, zobacz Instalowanie modułu Pythona, uruchamiając polecenie pip on.

Zainstaluj moduł Python, uruchamiając partię file Aby to zrobić:

1. Przejdź do folderu instalacyjnego Pythona: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Kliknij dwukrotnie plik install_tracker_api.bat.
   • Proces instalacji rozpoczyna się automatycznie.

Zainstaluj moduł Pythona, uruchamiając polecenie pip

1. Przejdź do folderu Scripts dla języka Python, którego chcesz użyć:
2. W przypadku Pythona 3 domyślnym folderem instalacyjnym jest: C: \Users\ \AppData\Local\Programs\Python\Python \Sc ripuje
   • W przypadku Pythona 2.7 domyślnym folderem instalacyjnym jest: C:\Python27\Scripts
3. Otwórz okno poleceń lub PowerShell w tym folderze.
4. Uruchom następujące polecenie, aby zainstalować interfejs API Vicon Core: C: \Użytkownicy\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe zainstaluj „C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Uruchom następujące polecenie, aby zainstalować moduł Tracker API C: \Użytkownicy\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe zainstaluj „C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Notatka Powyższe examppliki używają instalacji Pythona 3.11 z Trackerem 4.0. Twoja ścieżka i polecenia mogą się nieznacznie różnić.

Sprawdź, czy moduł Pythona jest poprawnie zainstalowany

• Sprawdź, czy zostały zainstalowane następujące moduły.
• vicon_core_api: Jest to podstawowy interfejs API zdalnego sterowania, zawierający klienta do komunikacji z serwerem terminali.
• tracker_api: Interfejs API usług umożliwiający dostęp do funkcjonalności aplikacji specyficznej dla modułu śledzącego.
• Aby sprawdzić, czy moduł Tracker Python jest poprawnie zainstalowany, spróbuj zaimportować jeden z modułów w Pythonie: >>> import vicon_core_api

Jeśli powyższy proces nie rozpozna modułu, spróbuj wykonać następujące czynności:

• Sprawdź, czy w folderze site-packages w instalacji Pythona znajduje się folder tracker_api lub vicon_core_api. W przypadku Pythona 3.11 lokalizacja domyślnego folderu instalacyjnego to:
  • C:\Użytkownicy\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Sprawdź zmienne środowiskowe systemu i upewnij się, że folder skryptów dla instalacji Pythona, której chcesz użyć, znajduje się najwyżej na liście. W przypadku Pythona 3.11 domyślna lokalizacja folderu instalacyjnego to:
  • C:\Użytkownicy\ \AppData\Local\Programs\Python\Python311\Scripts
• Jeśli brakuje któregokolwiek z folderów modułów, a ścieżka została zweryfikowana, przeprowadź ponownie proces instalacji opisany w części Instalowanie modułu Tracker Python w sprawie.

Połącz się z serwerem terminali

• Aby połączyć się z serwerem terminali, najpierw zaimportuj moduł Vicon Core API: >>> import vicon_core_api
  • >>> z importu vicon_core_api
• Następnie utwórz klienta. To automatycznie próbuje połączyć się z określonym adresem hosta na domyślnym porcie (52800) >>> c = Client('localhost')
• Sprawdź, czy klient pomyślnie połączył się z serwerem: >>> print(c.connected) Prawda
• Jeśli odpowiedź brzmi Fałsz, przed utworzeniem nowego klienta upewnij się, że masz instancję modułu śledzącego działającą pod określonym adresem hosta, a zapora sieciowa nie blokuje ruchu na porcie 52800.
• Po pomyślnym połączeniu możesz uzyskać dostęp do usług świadczonych przez serwer terminali Tracker.
• Ten byłyampplik korzysta z podstawowych usług obiektowych: >>> import tracker_api >>> z tracker_api import BasicObjectServices >>> Services = BasicObjectServices(c)
• Kiedy jest podłączony, możesz wywoływać metody w instancji Tracker.
  • Na przykładample, aby uzyskać listę obiektów w panelu Śledzenie, użyj: >>>result, object_list = Services.basic_object_list() >>> print(result)
  • OK: funkcja się powiodła
  • >>> drukuj(lista_obiektów)
  • ['Obiekt1', 'Obiekt2'…]
• Wszystkie wywołania API zwracają kod wyniku, który jest opisany w vicon_core_api/result.py.
• Jednym z możliwych kodów błędu jest Result.RPCNotConnected, który jest odbierany w przypadku utraty połączenia z serwerem terminali.
• Na przykładample: >>> wynik, object_list = Services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: Połączenie ze zdalną funkcją lub wywołaniem zwrotnym nie jest otwarte
• Aby wyświetlić listę wszystkich dostępnych funkcji i dokumentacji: >>> help( tracker_api)

Exampskrypty

• Można znaleźć npample skrypty pokazujące wykorzystanie typowych funkcji API pod adresem C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Wszystkie skrypty posiadają dokumentację i posiadają opcję –help, która podaje szczegółowe informacje na temat odpowiednich argumentów.
• Biegać jakoample skrypt, otwórz okno poleceń lub Power Shell w folderze skryptów powyżej. Można to zrobić na jeden z dwóch sposobów:
• Otwórz wiersz poleceń i zmień katalog na folder skryptów: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Przytrzymaj SHIFT i kliknij prawym przyciskiem myszy w folderze skryptów i wybierz Otwórz tutaj okno poleceń lub Otwórz tutaj okno Powershell.
• Stąd możesz uruchomić exampwybrany przez Ciebie skrypt.
• Następujący examples użyj okna poleceń.

kamera_kalibracja_wave.py

• Ten skrypt demonstruje, jak używać funkcji API do kontrolowania procesu kalibracji uruchamiania i zatrzymywania fali różdżki.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py Camera_calibration_wave.py
• Jeśli operacja się powiedzie, zostaną wyświetlone elementy sterujące kalibracją

Capture_control.py

• Ten skrypt pokazuje, jak przechwytywać aktualne dane C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py Capture_control.py
• Nazwa przechwytywania jest wyświetlana przed elementami sterującymi. Aby zmienić nazwę przechwytywania, użyj usług przechwytywania i SetCaptureName.
• W przypadku pytań dotyczących korzystania z interfejsu Tracker API skontaktuj się z pomocą techniczną Vicon1.
• 1 maildo:wsparcie@vicon.com
• Skrócona instrukcja obsługi interfejsu API Vicon Tracker Python, 31 maja 2023 r., wersja 1
• Do użytku z Trackerem 4.0
• © Prawa autorskie 2020–2023 Vicon Motion Systems Limited. Wszelkie prawa zastrzeżone.
• Wersja 1. Do użytku z Trackerem 4.0
• Vicon Motion Systems Limited zastrzega sobie prawo do wprowadzania zmian w informacjach lub specyfikacjach zawartych w tym dokumencie bez powiadomienia.
• Firmy, nazwy i dane użyte w npampPliki są fikcyjne, chyba że zaznaczono inaczej. Żadna część tej publikacji nie może być powielana, przechowywana w systemie wyszukiwania ani przekazywana w jakiejkolwiek formie lub jakimikolwiek środkami, elektronicznymi lub mechanicznymi, poprzez kopiowanie lub nagrywanie, lub w inny sposób bez uprzedniej pisemnej zgody Vicon Motion Systems Ltd.
• Vicon® jest zastrzeżonym znakiem towarowym firmy 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™ i Vicon Vue™ są znakami towarowymi firmy Oxford Metrics plc.
• VESA® jest zastrzeżonym znakiem towarowym należącym do VESA (www.vesa.org/about-vesa/). Inne nazwy produktów i firm zawarte w niniejszym dokumencie mogą być znakami towarowymi ich odpowiednich właścicieli.
• Aby uzyskać pełne i aktualne informacje o prawach autorskich i znakach towarowych, odwiedź stronę https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems to firma Oxford Metrics plc.
• E-mail: wsparcie@vicon.com Web: http://www.vicon.com

Dokumenty / Zasoby

VICON Tracker API Pythona [plik PDF] Instrukcja użytkownika Tracker Python Api, Tracker, Python Api, Api

Odniesienia

• Instrukcja obsługi