VICON Tracker Python API

Specifikacije

• Naziv proizvoda: Vicon Tracker Python API
• Kompatibilnost: Tracker 4.0
• Podržane verzije Pythona: 2.7 i Python 3

Upute za upotrebu proizvoda

Instalirajte Tracker API

Da biste koristili Tracker API sa Pythonom, slijedite ove korake:

1. Provjerite verziju Pythona kako biste osigurali kompatibilnost.
2. Instalirajte Python tako što ćete ga preuzeti sa službenog webstranice i odabirom odgovarajuće verzije.
3. Pronađite i instalirajte Tracker Python modul iz navedenog foldera.

Provjerite verziju Pythona

1. Otvorite komandnu liniju.
2. Upišite 'py' i pritisnite Enter.
3. Ako Python nije instaliran, pogledajte upute za instalaciju.

Instalirajte Python

1. Idi na Python je službeno website.
2. Preuzmite i instalirajte Python, osiguravajući da dodate python.exe u PATH tokom instalacije.

Instalirajte Tracker Python modul:

1. Pronađite instalaciju files u navedenom folderu.
2. Odaberite način instalacije na osnovu vašeg podešavanja.

Instalirajte Python modul tako što ćete pokrenuti paket File:

1. Idite na Python instalacioni folder: C: Program FilesViconTracker4.xSDKPython
2. Dvaput kliknite na 'install_tracker_api.bat' da započnete proces instalacije.

Često postavljana pitanja (FAQ):

P: Šta mogu automatizirati koristeći Tracker API?

• A: Tracker API vam omogućava automatizaciju uobičajenih funkcija kao što su učitavanje, reprodukcija, izvoz podataka, aktiviranje/deaktiviranje objekata i pokretanje dijelova toka posla.

P: Koje verzije Pythona podržava Tracker API?

• A: Tracker API podržava Python verzije 2.7 i Python

O ovom vodiču

• Tracker API vam omogućava da kontrolišete određene funkcije Tracker-a putem Python API-ja.
• API vam omogućava da automatizujete neke uobičajene funkcije Tracker-a, kao što su učitavanje, reprodukcija i izvoz podataka, aktiviranje ili deaktiviranje različitih objekata ili pokretanje delova toka posla.
• Ovaj dokument vam omogućava da počnete sa Tracker API-jem.

Instalirajte Tracker API

• Da biste koristili Tracker API sa Pythonom, morate biti sigurni da imate oba instalirana.
• Tracker API pruža podršku za Python 2.7 i Python 3. Vicon preporučuje da koristite najnovije potpuno izdanje Python-a 3 osim ako vaš projekt ne zahtijeva da koristite određenu verziju Pythona.

Ove procedure vas vode kroz proces instalacije:

• Provjerite uključenu verziju Pythona
• Instaliranje Pythona na
• Instaliranje Tracker Python modula na
• Provjerite je li Python modul ispravno instaliran

Provjerite verziju Pythona

• Ako niste sigurni da li imate instaliran Python ili koju verziju Pythona koristite, možete otvoriti komandnu liniju i pokrenuti naredbu py.

Za nprample:

Ako nemate instaliran Python, pogledajte Instalirajte Python.

Instalirajte Python Da biste instalirali Python 2 ili 3:

1. Idi na  https://www.python.org/downloads/
2. Pronađite potrebnu verziju i instalirajte Python, osiguravajući da je odabrano Dodaj python.exe na PATH:

Na gornjoj slici, ABC je zamijenjen vašim korisničkim imenom za instalacioni folder.

Instalirajte Tracker Python modul Da biste instalirali Tracker Python modul:

1. Pronađite instalaciju files. Ako ste instalirali Tracker na zadanu lokaciju, oni se nalaze u ovoj fascikli: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Ove files se prikazuju:
2. Instalirajte Tracker Python modul na jedan od sljedećih načina, ovisno o vašoj instalaciji:
   • Najjednostavniji način je pokretanje serije file (install_tracker_api.bat) koji je uključen u instalaciju Tracker-a (kao što je prikazano na gornjoj slici).
   • Ovo obično dobro funkcionira ako:
   • Python je instaliran u varijablu PATH; ili
   • Instalirano je više verzija Pythona, ali želite da instalirate API na najnoviju verziju koju ste instalirali; ili
   • Instalirana je samo jedna verzija Pythona.
   • Ako postoji bilo koji od ovih uslova, pogledajte Instalirajte python modul pokretanjem serije file on.
   • U svim ostalim slučajevima, instalirajte Python modul koristeći pip. Ovo se obično primjenjuje ako:
   • Instalirano je više verzija Pythona, ali želite da instalirate na određenu verziju; ili
   • Instalirano je više različitih verzija Pythona i želite da ih instalirate na sve (u ovom slučaju morate instalirati modul za svaku verziju); ili
   • Instalirana je samo jedna verzija Pythona, ali niste instalirali na PATH.
   • Ako postoji bilo koji od ovih uslova, pogledajte Instalirajte Python modul pokretanjem pip on.

Instalirajte Python modul pokretanjem serije file Da biste to učinili:

1. Idite na Python instalacijski folder: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Dvaput kliknite na install_tracker_api.bat.
   • Proces instalacije se automatski inicijalizira.

Instalirajte Python modul tako što ćete pokrenuti pip

1. Idite do foldera Scripts za Python koji želite koristiti:
2. Za Python 3, podrazumevani instalacioni folder je: C: \Users\ \AppData\Local\Programs\Python\Python \Sc rips
   • Za Python 2.7, podrazumevana fascikla za instalaciju je: C:\Python27\Scripts
3. Otvorite komandni prozor ili PowerShell u toj fascikli.
4. Pokrenite sljedeću naredbu da instalirate Vicon Core API: C: \Korisnici\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instalirajte “C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Pokrenite sljedeću naredbu da instalirate Tracker API C: \Korisnici\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instalirajte “C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Napomena Gore navedeni exampkoriste Python 3.11 instalaciju sa Tracker 4.0. Vaš put i komande se mogu malo razlikovati.

Provjerite je li Python modul ispravno instaliran

• Provjerite jesu li instalirani sljedeći moduli.
• vicon_core_api: Ovo je osnovni API daljinskog upravljanja i uključuje klijenta za komunikaciju sa terminal serverom.
• tracker_api: Services API za pristup funkcionalnosti aplikacije specifične za Tracker.
• Da biste testirali da li je Tracker Python modul ispravno instaliran, pokušajte uvesti jedan od modula u Python: >>> import vicon_core_api

Ako gornji proces ne uspije prepoznati modul, pokušajte sljedeće:

• Provjerite folder site-packages u Python instalaciji za folder tracker_api ili vicon_core_api. Za Python 3.11, lokacija podrazumevane fascikle za instalaciju je:
  • C:\Korisnici\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Proverite varijable vašeg sistemskog okruženja i uverite se da je fascikla sa skriptama za Python instalaciju koju želite da koristite najviši na listi. Za Python 3.11, zadana lokacija instalacionog foldera je:
  • C:\Korisnici\ \AppData\Local\Programs\Python\Python311\Scripts
• Ako neki od foldera modula nedostaje, a vi ste potvrdili putanju, ponovo pokrenite proces instalacije opisan u Instaliranje Tracker Python modula na.

Povežite se na terminal server

• Da biste se povezali na terminal server, prvo uvezite Vicon Core API modul: >>> import vicon_core_api
  • >>> iz uvoza vicon_core_api
• Zatim kreirajte klijenta. Ovo automatski pokušava da se poveže sa specifičnom adresom domaćina na podrazumevanom portu (52800) >>> c = Client('localhost')
• Provjerite da li se klijent uspješno povezao na server: >>> print(c.connected) Tačno
• Ako je odgovor False, uvjerite se da imate instancu Tracker-a koja radi na navedenoj adresi hosta i da vaš firewall ne blokira promet na portu 52800, prije kreiranja novog klijenta.
• Kada se uspješno povežete, možete pristupiti uslugama koje pruža Tracker terminal server.
• Ovaj exampkoristi osnovne objektne usluge: >>> import tracker_api >>> from tracker_api import BasicObjectServices >>> usluge = BasicObjectServices(c)
• Kada je povezan, možete pozvati metode na Tracker instanci.
  • Za nprample, da dobijete listu objekata u panelu za praćenje, koristite: >>> rezultat, object_list = services.basic_object_list() >>> print(result)
  • ok: funkcija je uspjela
  • >>> print(list_objekta)
  • ['Objekat1', 'Objekat2'…]
• Svi API pozivi vraćaju kod rezultata, koji je opisan u vicon_core_api/result.py.
• Jedan mogući kod kvara je Result.RPCNotConnected, koji se prima ako se veza s terminalnim poslužiteljem izgubi.
• Za nprample: >>> rezultat, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: Veza sa udaljenom funkcijom ili povratnim pozivom nije otvorena
• Za prikaz liste svih dostupnih funkcija i dokumentacije: >>> help( tracker_api)

Example scripts

• Možete pronaći example skripte koje pokazuju upotrebu uobičajenih API funkcija na C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Sve skripte imaju dokumentaciju i imaju opciju –help koja daje detalje relevantnih argumenata.
• Da trčim kaoample script, otvorite komandni prozor ili power shell u folderu skripti iznad. To možete učiniti na jedan od dva načina:
• Otvorite komandnu liniju i promijenite svoj direktorij u folder sa skriptama: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Držite SHIFT+desni klik u fascikli skripti i izaberite Otvori komandni prozor ovde ili Otvori Powershell prozor ovde.
• Odavde možete pokrenuti exampskriptu po vašem izboru.
• Sljedeći pramples koristi komandni prozor.

camera_calibration_wave.py

• Ova skripta pokazuje kako koristiti API funkcije za kontrolu procesa kalibracije pokretanja i zaustavljanja talasa štapića.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Ako je uspješno, prikazuju se kontrole kalibracije

capture_control.py

• Ova skripta pokazuje kako snimiti podatke uživo C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Ime Capture je navedeno ispred kontrola. Za promjenu naziva snimanja koristite capture_services i SetCaptureName.
• Za pitanja o korištenju Tracker API-ja, kontaktirajte Vicon podršku1.
• 1 mailto:support@vicon.com
• Vicon Tracker Python API Vodič za brzi početak 31. maj 2023., revizija 1
• Za korištenje sa Tracker 4.0
• © Autorsko pravo 2020–2023 Vicon Motion Systems Limited. Sva prava zadržana.
• Revizija 1. Za upotrebu sa Tracker 4.0
• Vicon Motion Systems Limited zadržava pravo izmjene informacija ili specifikacija u ovom dokumentu bez prethodne najave.
• Kompanije, imena i podaci korišteni u npramppredmeti su fiktivni osim ako nije drugačije naznačeno. Nijedan dio ove publikacije ne smije se reproducirati, pohraniti u sistem za pronalaženje ili prenijeti u bilo kojem obliku ili na bilo koji način, elektronski ili mehanički, fotokopiranjem ili snimanjem, ili na drugi način bez prethodne pismene dozvole Vicon Motion Systems Ltd.
• Vicon® je registrovani zaštitni znak kompanije 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™ su zaštitni znakovi Oxford Metrics plc.
• VESA® je registrovani zaštitni znak u vlasništvu VESA (www.vesa.org/about-vesa/). Ostali nazivi proizvoda i kompanija u ovom dokumentu mogu biti zaštitni znakovi njihovih vlasnika.
• Za potpuna i ažurirana priznanja autorskih prava i zaštitnih znakova, posjetite https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems je kompanija Oxford Metrics plc.
• Email: support@vicon.com Web: http://www.vicon.com

Dokumenti / Resursi

VICON Tracker Python Api [pdf] Korisnički priručnik Tracker Python Api, Tracker, Python Api, Api

Reference

• Uputstvo za upotrebu