API-ul VICON Tracker Python

Specificații

• Nume produs: API-ul Vicon Tracker Python
• Compatibilitate: Tracker 4.0
• Versiuni Python acceptate: 2.7 și Python 3

Instrucțiuni de utilizare a produsului

Instalați API-ul Tracker

Pentru a utiliza API-ul Tracker cu Python, urmați acești pași:

1. Verificați versiunea Python pentru a vă asigura compatibilitatea.
2. Instalați Python descărcându-l din oficial website-ul și selectând versiunea corespunzătoare.
3. Localizați și instalați modulul Tracker Python din folderul specificat.

Verificați versiunea Python

1. Deschideți un prompt de comandă.
2. Tastați „py” și apăsați Enter.
3. Dacă Python nu este instalat, consultați instrucțiunile de instalare.

Instalați Python

1. Du-te la Oficialul lui Python website-ul.
2. Descărcați și instalați Python, asigurându-vă că adăugați python.exe la PATH în timpul instalării.

Instalați modulul Tracker Python:

1. Localizați instalația files în folderul specificat.
2. Alegeți metoda de instalare în funcție de configurația dvs.

Instalați modulul Python rulând lotul File:

1. Navigați la folderul de instalare Python: C: Program FilesViconTracker4.xSDKPython
2. Faceți dublu clic pe „install_tracker_api.bat” pentru a iniția procesul de instalare.

Întrebări frecvente (FAQ):

Î: Ce pot automatiza folosind API-ul Tracker?

• A: API-ul Tracker vă permite să automatizați funcții comune, cum ar fi încărcarea, redarea, exportul de date, activarea/dezactivarea obiectelor și declanșarea părților fluxului de lucru.

Î: Ce versiuni Python sunt acceptate de API-ul Tracker?

• A: API-ul Tracker acceptă versiunile Python 2.7 și Python

Despre acest ghid

• API-ul Tracker vă permite să controlați anumite funcții ale Tracker printr-un API Python.
• API-ul vă permite să automatizați unele funcții comune ale Tracker, cum ar fi încărcarea, redarea și exportul de date, activarea sau dezactivarea diferitelor obiecte sau declanșarea unor părți ale fluxului de lucru.
• Acest document vă permite să începeți cu API-ul Tracker.

Instalați API-ul Tracker

• Pentru a utiliza API-ul Tracker cu Python, trebuie să vă asigurați că le-ați instalat pe ambele.
• API-ul Tracker oferă suport pentru Python 2.7 și Python 3. Vicon vă recomandă să utilizați cea mai recentă versiune completă a Python 3, cu excepția cazului în care proiectul dvs. necesită să utilizați o anumită versiune de Python.

Aceste proceduri vă ghidează prin procesul de instalare:

• Verificați versiunea Python activată
• Instalarea Python pe
• Instalarea modulului Tracker Python
• Verificați dacă modulul Python este instalat corect

Verificați versiunea Python

• Dacă nu sunteți sigur dacă aveți instalat Python sau ce versiune de Python utilizați, puteți deschide un prompt de comandă și rulați comanda py.

De examppe:

Dacă nu aveți instalat Python, consultați Instalarea Python.

Instalați Python Pentru a instala Python 2 sau 3:

1. Du-te la  https://www.python.org/downloads/
2. Găsiți versiunea necesară și instalați Python, asigurându-vă că este selectat Add python.exe to PATH:

În imaginea de mai sus, ABC este înlocuit cu numele dvs. de utilizator pentru folderul de instalare.

Instalați modulul Tracker Python Pentru a instala modulul Tracker Python:

1. Localizați instalația files. Dacă ați instalat Tracker în locația implicită, acestea se găsesc în acest folder: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Aceste filesunt afișate:
2. Instalați modulul Tracker Python în oricare dintre următoarele moduri, în funcție de instalarea dvs.:
   • Cel mai simplu mod este să rulați lotul file (install_tracker_api.bat) care este inclus în instalarea Tracker (așa cum se arată în imaginea de mai sus).
   • Acest lucru funcționează de obicei bine dacă:
   • Python a fost instalat în variabila PATH; sau
   • Sunt instalate mai multe versiuni de Python, dar doriți să instalați API-ul la cea mai recentă versiune pe care ați instalat-o; sau
   • Este instalată doar o singură versiune de Python.
   • Dacă se aplică oricare dintre aceste condiții, consultați Instalarea modulului Python prin rularea lotului file pe.
   • În toate celelalte cazuri, instalați modulul Python utilizând pip. Acest lucru se aplică de obicei dacă:
   • Sunt instalate mai multe versiuni de Python, dar doriți să instalați într-o anumită versiune; sau
   • Sunt instalate mai multe versiuni diferite de Python și doriți să le instalați pe toate (în acest caz, trebuie să instalați modulul pentru fiecare versiune); sau
   • Este instalată doar o singură versiune de Python, dar nu ați instalat în PATH.
   • Dacă se aplică oricare dintre aceste condiții, consultați Instalarea modulului Python rulând pip on.

Instalați modulul Python rulând lotul file Pentru a face acest lucru:

1. Navigați la folderul de instalare Python: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Faceți dublu clic pe install_tracker_api.bat.
   • Procesul de instalare se inițializează automat.

Instalați modulul Python rulând pip

1. Navigați la folderul Scripturi pentru Python pe care doriți să îl utilizați:
2. Pentru Python 3, folderul de instalare implicit este: C: \Utilizatori\ \AppData\Local\Programs\Python\Python \Sc rupe
   • Pentru Python 2.7, folderul de instalare implicit este: C:\Python27\Scripts
3. Deschideți o fereastră de comandă sau PowerShell în acel folder.
4. Rulați următoarea comandă pentru a instala Vicon Core API: C: \Utilizatori\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instalați „C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Rulați următoarea comandă pentru a instala API-ul Tracker C: \Utilizatori\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instalați „C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Nota Ex. de mai susampfișierele folosesc o instalare Python 3.11 cu Tracker 4.0. Calea și comenzile dvs. pot diferi ușor.

Verificați dacă modulul Python este instalat corect

• Verificați dacă au fost instalate următoarele module.
• vicon_core_api: Acesta este API-ul principal de control la distanță și include un client pentru comunicarea cu serverul terminal.
• tracker_api: Servicii API pentru accesarea funcționalității aplicației specifice Tracker.
• Pentru a testa dacă modulul Tracker Python este instalat corect, încercați să importați unul dintre modulele în Python: >>> import vicon_core_api

Dacă procesul de mai sus nu recunoaște modulul, încercați următoarele:

• Verificați folderul site-packages din instalarea Python pentru folderul tracker_api sau vicon_core_api. Pentru Python 3.11, locația folderului de instalare implicit este:
  • C:\Utilizatori\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Verificați variabilele de mediu ale sistemului și asigurați-vă că folderul de scripturi pentru instalarea Python pe care doriți să o utilizați este cel mai înalt din listă. Pentru Python 3.11, locația implicită a folderului de instalare este:
  • C:\Utilizatori\ \AppData\Local\Programs\Python\Python311\Scripts
• Dacă unul dintre folderele modulelor lipsește și ați verificat calea, reluați procesul de instalare descris în Instalarea modulului Tracker Python.

Conectați-vă la serverul terminal

• Pentru a vă conecta la serverul terminal, importați mai întâi modulul Vicon Core API: >>> import vicon_core_api
  • >>> de la import vicon_core_api
• Apoi, creați un client. Aceasta încearcă automat să se conecteze la adresa gazdă specifică pe portul implicit (52800) >>> c = Client('localhost')
• Verificați dacă clientul s-a conectat cu succes la server: >>> print(c.conectat) Adevărat
• Dacă răspunsul este Fals, asigurați-vă că aveți o instanță a Tracker care rulează la adresa gazdă specificată și firewall-ul dvs. nu blochează traficul pe portul 52800, înainte de a crea un nou client.
• După ce v-ați conectat cu succes, puteți accesa serviciile oferite de serverul terminal Tracker.
• Acest example folosește servicii obiect de bază: >>> import tracker_api >>> din tracker_api import BasicObjectServices >>> services = BasicObjectServices(c)
• Când este conectat, puteți apela metode pe instanța Tracker.
  • De example, pentru a obține o listă de obiecte în panoul Urmărire, utilizați: >>> result, object_list = services.basic_object_list() >>> print(result)
  • Bine: functia a reusit
  • >>> print(lista_obiecte)
  • [„Obiect1”, „Obiect2”…]
• Toate apelurile API returnează un cod de rezultat, care este descris în vicon_core_api/result.py.
• Un posibil cod de eroare este Result.RPCNotConnected, care este primit dacă se pierde conexiunea la serverul terminal.
• De example: >>> rezultat, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: conexiunea la funcția de la distanță sau callback nu este deschisă
• Pentru a afișa o listă cu toate funcțiile și documentația disponibile: >>> help( tracker_api)

Example scripturi

• Puteți găsi exampScripturi de fișier care arată utilizarea funcțiilor API comune la C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Toate scripturile au documentație și au o opțiune –help care oferă detalii despre argumentele relevante.
• A alerga caampscript-ul, deschideți o fereastră de comandă sau un shell de putere în folderul scripturi de mai sus. Puteți face acest lucru într-unul din două moduri:
• Deschideți promptul de comandă și schimbați directorul în folderul scripturi: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Țineți apăsată SHIFT+clic dreapta în folderul scripturi și selectați Deschideți fereastra de comandă aici sau Deschideți fereastra Powershell aici.
• De aici puteți rula exampscriptul la alegere.
• Următorul exampcherile folosesc fereastra de comandă.

camera_calibration_wave.py

• Acest script demonstrează cum să utilizați funcțiile API pentru a controla procesul de calibrare de pornire și oprire a valului baghetei.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Dacă reușește, sunt afișate controalele de calibrare

capture_control.py

• Acest script arată cum să capturați date live C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Numele Capturii este listat înaintea controalelor. Pentru a schimba numele capturii, utilizați capture_services și SetCaptureName.
• Pentru întrebări despre utilizarea API-ului Tracker, contactați asistența Vicon1.
• 1 mailto:support@vicon.com
• Ghid de pornire rapidă Vicon Tracker Python API 31 mai 2023, revizuirea 1
• Pentru utilizare cu Tracker 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Toate drepturile rezervate.
• Revizia 1. Pentru utilizare cu Tracker 4.0
• Vicon Motion Systems Limited își rezervă dreptul de a modifica informațiile sau specificațiile din acest document fără notificare.
• Companiile, numele și datele utilizate în exampfișierele sunt fictive, dacă nu este menționat altfel. Nicio parte a acestei publicații nu poate fi reprodusă, stocată într-un sistem de recuperare sau transmisă sub nicio formă sau prin orice mijloc, electronic sau mecanic, prin fotocopiere sau înregistrare sau în alt mod fără permisiunea prealabilă scrisă a Vicon Motion Systems Ltd.
• Vicon® este o marcă înregistrată a 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™ sunt mărci comerciale ale Oxford Metrics plc.
• VESA® este o marcă înregistrată deținută de VESA (www.vesa.org/about-vesa/). Alte nume de produse și companii incluse aici pot fi mărci comerciale ale proprietarilor respectivi.
• Pentru recunoașterea completă și actualizată a drepturilor de autor și a mărcilor comerciale, vizitați https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems este o companie Oxford Metrics plc.
• E-mail: support@vicon.com Web: http://www.vicon.com

Documente/Resurse

VICON Tracker Python Api [pdfGhid de utilizare Tracker Python Api, Tracker, Python Api, Api

Referințe

• Manual de utilizare