VICON Tracker Python API

Technische Daten

• Produktname: Vicon Tracker Python-API
• Kompatibilität: Tracker 4.0
• Unterstützte Python-Versionen: 2.7 und Python 3

Anweisungen zur Produktverwendung

Installieren der Tracker-API

Um die Tracker-API mit Python zu verwenden, gehen Sie folgendermaßen vor:

1. Überprüfen Sie die Python-Version, um Kompatibilität sicherzustellen.
2. Installieren Sie Python, indem Sie es von der offiziellen webSite und wählen Sie die entsprechende Version aus.
3. Suchen und installieren Sie das Tracker-Python-Modul aus dem angegebenen Ordner.

Überprüfen Sie die Python-Version

1. Öffnen Sie eine Eingabeaufforderung.
2. Geben Sie „py“ ein und drücken Sie die Eingabetaste.
3. Wenn Python nicht installiert ist, lesen Sie die Installationsanweisungen.

Installieren Sie Python

1. Gehe zu Pythons offizielle webWebsite.
2. Laden Sie Python herunter und installieren Sie es. Achten Sie dabei darauf, python.exe während der Installation zu PATH hinzuzufügen.

Installieren Sie das Tracker-Python-Modul:

1. Suchen Sie die Installation files im angegebenen Ordner.
2. Wählen Sie die Installationsmethode basierend auf Ihrem Setup.

Installieren Sie das Python-Modul durch Ausführen der Batch- File:

1. Navigieren Sie zum Python-Installationsordner: C: Program FilesViconTracker4.xSDKPython
2. Doppelklicken Sie auf „install_tracker_api.bat“, um den Installationsvorgang zu starten.

Häufig gestellte Fragen (FAQ):

F: Was kann ich mit der Tracker-API automatisieren?

• A: Mit der Tracker-API können Sie gängige Funktionen wie das Laden, Wiedergeben und Exportieren von Daten, das Aktivieren/Deaktivieren von Objekten und das Auslösen von Workflow-Teilen automatisieren.

F: Welche Python-Versionen werden von der Tracker-API unterstützt?

• A: Die Tracker API unterstützt Python-Versionen 2.7 und Python

Über dieses Handbuch

• Mit der Tracker-API können Sie bestimmte Funktionen von Tracker über eine Python-API steuern.
• Mithilfe der API können Sie einige allgemeine Funktionen von Tracker automatisieren, etwa das Laden, Wiedergeben und Exportieren von Daten, das Aktivieren oder Deaktivieren verschiedener Objekte oder das Auslösen von Teilen des Workflows.
• Dieses Dokument ermöglicht Ihnen den Einstieg in die Tracker-API.

Installieren der Tracker-API

• Um die Tracker-API mit Python zu verwenden, müssen Sie sicherstellen, dass Sie beides installiert haben.
• Die Tracker-API unterstützt Python 2.7 und Python 3. Vicon empfiehlt, die neueste Vollversion von Python 3 zu verwenden, sofern Ihr Projekt nicht die Verwendung einer bestimmten Python-Version erfordert.

Diese Verfahren führen Sie durch den Installationsvorgang:

• Überprüfen Sie die Python-Version auf
• Installieren von Python auf
• Installieren des Tracker-Python-Moduls auf
• Überprüfen Sie, ob das Python-Modul korrekt installiert ist auf

Überprüfen Sie die Python-Version

• Wenn Sie nicht sicher sind, ob Sie Python installiert haben oder welche Python-Version Sie verwenden, können Sie eine Eingabeaufforderung öffnen und den Befehl „py“ ausführen.

Zum Beispielampauf:

Wenn Sie Python nicht installiert haben, lesen Sie „Python installieren“.

Installieren Sie Python So installieren Sie Python 2 oder 3:

1. Gehe zu  https://www.python.org/downloads/
2. Suchen Sie die erforderliche Version und installieren Sie Python. Stellen Sie dabei sicher, dass „python.exe zu PATH hinzufügen“ ausgewählt ist:

Im obigen Bild wird ABC durch Ihren Benutzernamen für den Installationsordner ersetzt.

Installieren Sie das Tracker-Python-Modul. So installieren Sie das Tracker-Python-Modul:

1. Suchen Sie die Installation files. Wenn Sie Tracker im Standardverzeichnis installiert haben, befinden sie sich in diesem Ordner: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Diese filewerden angezeigt:
2. Installieren Sie das Tracker-Python-Modul je nach Ihrer individuellen Installation auf eine der folgenden Arten:
   • Der einfachste Weg ist, den Batch auszuführen file (install_tracker_api.bat), das in der Tracker-Installation enthalten ist (wie im obigen Bild gezeigt).
   • Dies funktioniert normalerweise gut, wenn:
   • Python wurde in der PATH-Variable installiert; oder
   • Es sind mehrere Python-Versionen installiert, Sie möchten die API jedoch in der neuesten Version installieren, die Sie installiert haben. oder
   • Es ist nur eine einzige Version von Python installiert.
   • Wenn eine dieser Bedingungen zutrifft, lesen Sie Installieren Sie das Python-Modul durch Ausführen des Batches file An.
   • In allen anderen Fällen installieren Sie das Python-Modul mithilfe von pip. Dies gilt normalerweise, wenn:
   • Es sind mehrere Python-Versionen installiert, Sie möchten aber eine bestimmte Version installieren; oder
   • Es sind mehrere unterschiedliche Python-Versionen installiert und Sie möchten sie alle installieren (in diesem Fall müssen Sie das Modul für jede Version installieren); oder
   • Es ist nur eine einzige Version von Python installiert, aber Sie haben die Installation nicht in PATH durchgeführt.
   • Wenn eine dieser Bedingungen zutrifft, lesen Sie „Installieren Sie das Python-Modul, indem Sie „pip on“ ausführen.“

Installieren Sie das Python-Modul durch Ausführen des Batches file Gehen Sie hierzu wie folgt vor:

1. Navigieren Sie zum Python-Installationsordner: C:\Programm Files\Vicon\Tracker4.x\SDK\Python
2. Doppelklicken Sie auf install_tracker_api.bat.
   • Der Installationsvorgang wird automatisch initialisiert.

Installieren Sie das Python-Modul, indem Sie pip ausführen

1. Navigieren Sie zum Scripts-Ordner für das Python, das Sie verwenden möchten:
2. Für Python 3 ist der Standardinstallationsordner: C:\Users\ \AppData\Local\Programme\Python\Python \Sc reißt
   • Für Python 2.7 ist der Standardinstallationsordner: C:\Python27\Scripts
3. Öffnen Sie in diesem Ordner ein Eingabeaufforderungsfenster oder PowerShell.
4. Führen Sie den folgenden Befehl aus, um die Vicon Core API zu installieren: C: \Benutzer\ \AppData\Local\Programs\Python\Python311\Scripts> .\pip.exe install “C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Führen Sie den folgenden Befehl aus, um die Tracker-API C zu installieren: \Benutzer\ \AppData\Local\Programs\Python\Python311\Scripts> .\pip.exe install “C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Notiz Das obige Beispielamples verwenden eine Python 3.11-Installation mit Tracker 4.0. Ihr Pfad und Ihre Befehle können leicht abweichen.

Überprüfen Sie, ob das Python-Modul korrekt installiert ist

• Überprüfen Sie, ob die folgenden Module installiert wurden.
• vicon_core_api: Dies ist die zentrale Fernsteuerungs-API und umfasst einen Client für die Kommunikation mit dem Terminalserver.
• tracker_api: Services-API für den Zugriff auf Tracker-spezifische Anwendungsfunktionen.
• Um zu testen, ob das Tracker-Python-Modul korrekt installiert ist, versuchen Sie, eines der Module in Python zu importieren: >>> import vicon_core_api

Wenn das Modul durch den obigen Vorgang nicht erkannt wird, versuchen Sie Folgendes:

• Suchen Sie im Ordner site-packages in der Python-Installation nach dem Ordner tracker_api oder vicon_core_api. Für Python 3.11 ist der Speicherort des Standardinstallationsordners:
  • C:\Benutzer\ \AppData\Local\Programme\Python\Python311\Lib\site-packages
• Überprüfen Sie die Umgebungsvariablen Ihres Systems und stellen Sie sicher, dass der Skriptordner für die gewünschte Python-Installation ganz oben in der Liste steht. Für Python 3.11 ist der Standardspeicherort des Installationsordners:
  • C:\Benutzer\ \AppData\Local\Programme\Python\Python311\Scripts
• Wenn einer der Modulordner fehlt und Sie den Pfad überprüft haben, führen Sie den unter Installieren des Tracker-Python-Moduls beschriebenen Installationsvorgang erneut aus.

Herstellen einer Verbindung zum Terminalserver

• Um eine Verbindung zum Terminalserver herzustellen, importieren Sie zuerst das Vicon Core API-Modul: >>> import vicon_core_api
  • >>> vom vicon_core_api-Import
• Als nächstes erstellen Sie einen Client. Dieser versucht automatisch, eine Verbindung zur angegebenen Hostadresse auf dem Standardport (52800) herzustellen >>> c = Client('localhost')
• Überprüfen Sie, ob der Client erfolgreich eine Verbindung zum Server hergestellt hat: >>> drucken(c.connected) True
• Wenn die Antwort „Falsch“ lautet, stellen Sie sicher, dass Sie eine Instanz von Tracker unter der angegebenen Hostadresse ausführen und dass Ihre Firewall den Datenverkehr auf Port 52800 nicht blockiert, bevor Sie einen neuen Client erstellen.
• Wenn die Verbindung erfolgreich hergestellt wurde, können Sie auf die vom Tracker-Terminalserver bereitgestellten Dienste zugreifen.
• Dieses Example verwendet grundlegende Objektdienste: >>> importiere tracker_api >>> von tracker_api importiere BasicObjectServices >>> Dienste = BasicObjectServices(c)
• Wenn die Verbindung hergestellt ist, können Sie Methoden der Tracker-Instanz aufrufen.
  • Zum BeispielampUm eine Liste der Objekte im Tracking-Bereich zu erhalten, verwenden Sie: >>> result, object_list = services.basic_object_list() >>> print(result)
  • OK: die Funktion war erfolgreich
  • >>> drucken(Objektliste)
  • ['Objekt1', 'Objekt2'…]
• Alle API-Aufrufe geben einen Ergebniscode zurück, der in vicon_core_api/result.py beschrieben ist.
• Ein möglicher Fehlercode ist Result.RPCNotConnected, der empfangen wird, wenn die Verbindung zum Terminalserver verloren geht.
• Zum Beispielample: >>> result, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: Die Verbindung zur Remote-Funktion oder zum Remote-Callback ist nicht geöffnet.
• Um eine Liste aller verfügbaren Funktionen und Dokumentationen anzuzeigen: >>> help( tracker_api)

Exampdie Skripte

• Sie finden exampDateiskripte, die die Verwendung allgemeiner API-Funktionen zeigen C:\Programm Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Alle Skripte verfügen über eine Dokumentation und verfügen über die Option „–help“, die Einzelheiten zu den relevanten Argumenten angibt.
• Laufen alsample script, öffnen Sie ein Befehlsfenster oder eine Power Shell im obigen Skriptordner. Sie können dies auf zwei Arten tun:
• Öffnen Sie die Eingabeaufforderung und wechseln Sie in das Verzeichnis „scripts“: c:\> cd C:\Programm Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Halten Sie die UMSCHALTTASTE gedrückt und klicken Sie mit der rechten Maustaste in den Skriptordner, und wählen Sie „Eingabeaufforderung hier öffnen“ oder „PowerShell-Fenster hier öffnen“.
• Von hier aus können Sie die Ex ausführenampDateiskript Ihrer Wahl.
• Das folgende BeispielampDateien verwenden das Befehlsfenster.

Kamerakalibrierung Wave.py

• Dieses Skript zeigt, wie API-Funktionen verwendet werden, um den Kalibrierungsprozess zum Starten und Stoppen der Zauberstabwelle zu steuern.
  • C:\Programm Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py Kamerakalibrierung_Welle.py
• Bei erfolgreicher Kalibrierung werden die Kontrollen angezeigt

capture_control.py

• Dieses Skript zeigt, wie Live-Daten erfasst werden C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Der Capture-Name wird vor den Steuerelementen aufgeführt. Um den Capture-Namen zu ändern, verwenden Sie capture_services und SetCaptureName.
• Wenden Sie sich bei Fragen zur Verwendung der Tracker-API an den Vicon Support1.
• 1 Mail an:support@vicon.com
• Vicon Tracker Python API – Kurzanleitung 31. Mai 2023, Revision 1
• Zur Verwendung mit Tracker 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Alle Rechte vorbehalten.
• Revision 1. Zur Verwendung mit Tracker 4.0
• Vicon Motion Systems Limited behält sich das Recht vor, ohne vorherige Ankündigung Änderungen an Informationen oder Spezifikationen in diesem Dokument vorzunehmen.
• Unternehmen, Namen und Daten, die in ex verwendet werdenampDateien sind fiktiv, sofern nicht anders angegeben. Kein Teil dieser Veröffentlichung darf ohne die vorherige schriftliche Genehmigung von Vicon Motion Systems Ltd.
• Vicon® ist ein eingetragenes Warenzeichen von 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™ und Vicon Vue™ sind Marken von Oxford Metrics plc.
• VESA® ist eine eingetragene Marke von VESA (www.vesa.org/about-vesa/). Andere Produkt- und Firmennamen in diesem Dokument können Marken ihrer jeweiligen Eigentümer sein.
• Vollständige und aktuelle Angaben zu Urheberrecht und Marken finden Sie unter https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems ist ein Unternehmen von Oxford Metrics plc.
• E-Mail: support@vicon.com Web: http://www.vicon.com

Dokumente / Ressourcen

VICON Tracker Python API [pdf] Benutzerhandbuch Tracker Python API, Tracker, Python API, API

Verweise

• Bedienungsanleitung