VICON Tracker Python API

Specifikacije

• Ime izdelka: Vicon Tracker Python API
• Združljivost: Sledilnik 4.0
• Podprte različice Python: 2.7 in Python 3

Navodila za uporabo izdelka

Namestite Tracker API

Če želite uporabiti Tracker API s Pythonom, sledite tem korakom:

1. Preverite različico Python, da zagotovite združljivost.
2. Namestite Python tako, da ga prenesete z uradne strani webstrani in izberite ustrezno različico.
3. Poiščite in namestite modul Tracker Python iz navedene mape.

Preverite različico Python

1. Odprite ukazni poziv.
2. Vnesite 'py' in pritisnite Enter.
3. Če Python ni nameščen, glejte navodila za namestitev.

Namestite Python

1. Pojdi na Pythonov uradnik webmesto.
2. Prenesite in namestite Python ter zagotovite dodajanje python.exe v PATH med namestitvijo.

Namestite modul Tracker Python:

1. Poiščite namestitev files v določeni mapi.
2. Izberite način namestitve glede na vaše nastavitve.

Namestite modul Python tako, da zaženete paket File:

1. Pomaknite se do namestitvene mape Python: C: Program FilesViconTracker4.xSDKPython
2. Dvokliknite 'install_tracker_api.bat', da začnete postopek namestitve.

Pogosto zastavljena vprašanja (FAQ):

V: Kaj lahko avtomatiziram z API-jem Tracker?

• A: Tracker API vam omogoča avtomatizacijo običajnih funkcij, kot so nalaganje, predvajanje, izvoz podatkov, aktiviranje/deaktiviranje predmetov in proženje delov delovnega toka.

V: Katere različice Pythona podpira Tracker API?

• A: Tracker API podpira Python različice 2.7 in Python

O tem priročniku

• Tracker API vam omogoča nadzor določenih funkcij Trackerja prek API-ja Python.
• API vam omogoča avtomatizacijo nekaterih običajnih funkcij Trackerja, kot so nalaganje, predvajanje in izvoz podatkov, aktiviranje ali deaktiviranje različnih predmetov ali sprožitev delov delovnega toka.
• Ta dokument vam omogoča, da začnete uporabljati Tracker API.

Namestite Tracker API

• Če želite uporabljati Tracker API s Pythonom, se morate prepričati, da imate oba nameščena.
• Tracker API nudi podporo za Python 2.7 in Python 3. Vicon priporoča, da uporabite najnovejšo polno izdajo Pythona 3, razen če vaš projekt zahteva uporabo določene različice Pythona.

Ti postopki vas vodijo skozi postopek namestitve:

• Preverite različico Python na
• Namestitev Pythona na
• Namestitev modula Tracker Python na
• Preverite, ali je modul Python pravilno nameščen na

Preverite različico Python

• Če niste prepričani, ali imate nameščen Python ali katero različico Pythona uporabljate, lahko odprete ukazni poziv in zaženete ukaz py.

Na primerample:

Če nimate nameščenega Pythona, glejte Namestitev Pythona.

Namestite Python Če želite namestiti Python 2 ali 3:

1. Pojdi na  https://www.python.org/downloads/
2. Poiščite zahtevano različico in namestite Python ter zagotovite, da je izbrana možnost Add python.exe to PATH:

Na zgornji sliki je ABC nadomeščen z vašim uporabniškim imenom za namestitveno mapo.

Namestitev modula Tracker Python Če želite namestiti modul Tracker Python:

1. Poiščite namestitev files. Če ste Tracker namestili na privzeto lokacijo, jih najdete v tej mapi: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • te files se prikažejo:
2. Namestite modul Tracker Python na enega od naslednjih načinov, odvisno od vaše posebne namestitve:
   • Najenostavnejši način je zagon serije file (install_tracker_api.bat), ki je vključen v namestitev Trackerja (kot je prikazano na zgornji sliki).
   • To običajno dobro deluje, če:
   • Python je bil nameščen v spremenljivko PATH; oz
   • Nameščenih je več različic Pythona, vendar želite API namestiti na najnovejšo različico, ki ste jo namestili; oz
   • Nameščena je samo ena različica Pythona.
   • Če velja kateri koli od teh pogojev, glejte Namestitev modula python z izvajanjem paketa file na.
   • V vseh drugih primerih namestite modul Python z uporabo pip. To običajno velja, če:
   • Nameščenih je več različic Pythona, vendar želite namestiti na določeno različico; oz
   • Nameščenih je več različnih različic Pythona in želite jih namestiti na vse (v tem primeru morate namestiti modul za vsako različico); oz
   • Nameščena je samo ena različica Pythona, vendar niste namestili na PATH.
   • Če velja kateri koli od teh pogojev, glejte Namestitev modula Python z zagonom pip on.

Namestite modul Python tako, da zaženete paket file Če želite to narediti:

1. Pomaknite se do namestitvene mape Python: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Dvokliknite install_tracker_api.bat.
   • Postopek namestitve se inicializira samodejno.

Namestite modul Python tako, da zaženete pip

1. Pomaknite se do mape Scripts za Python, ki ga želite uporabiti:
2. Za Python 3 je privzeta namestitvena mapa: C: \Users\ \AppData\Local\Programs\Python\Python \Sc rips
   • Za Python 2.7 je privzeta namestitvena mapa: C:\Python27\Scripts
3. Odprite ukazno okno ali PowerShell v tej mapi.
4. Zaženite naslednji ukaz za namestitev Vicon Core API: C: \Uporabniki\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe namestite »C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
   • Zaženite naslednji ukaz za namestitev Tracker API C: \Uporabniki\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe namestite »C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

Opomba Zgornji exampuporabite namestitev Python 3.11 s Tracker 4.0. Vaša pot in ukazi se lahko nekoliko razlikujejo.

Preverite, ali je modul Python pravilno nameščen

• Preverite, ali so nameščeni naslednji moduli.
• vicon_core_api: To je glavni API za daljinsko upravljanje in vključuje odjemalca za komunikacijo s terminalskim strežnikom.
• tracker_api: Storitveni API za dostop do funkcij aplikacije Tracker.
• Če želite preveriti, ali je modul Tracker Python pravilno nameščen, poskusite uvoziti enega od modulov v Python: >>> import vicon_core_api

Če zgornji postopek ne prepozna modula, poskusite naslednje:

• Preverite mapo site-packages v namestitvi Python za mapo tracker_api ali vicon_core_api. Za Python 3.11 je lokacija privzete namestitvene mape:
  • C:\Uporabniki\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Preverite spremenljivke sistemskega okolja in zagotovite, da je mapa s skripti za namestitev Python, ki jo želite uporabiti, najvišja na seznamu. Za Python 3.11 je privzeta lokacija namestitvene mape:
  • C:\Uporabniki\ \AppData\Local\Programs\Python\Python311\Scripts
• Če katera od map modulov manjka in ste preverili pot, znova zaženite postopek namestitve, opisan v poglavju Namestitev modula Tracker Python na.

Povežite se s terminalskim strežnikom

• Za povezavo s terminalskim strežnikom najprej uvozite modul Vicon Core API: >>> import vicon_core_api
  • >>> iz uvoza vicon_core_api
• Nato ustvarite stranko. To se samodejno poskuša povezati z določenim naslovom gostitelja na privzetih vratih (52800) >>> c = Client('localhost')
• Preverite, ali je odjemalec uspešno povezan s strežnikom: >>> print(c.connected) True
• Če je odgovor False, se prepričajte, da imate primerek Trackerja, ki se izvaja na podanem naslovu gostitelja in vaš požarni zid ne blokira prometa na vratih 52800, preden ustvarite novega odjemalca.
• Ko se uspešno povežete, lahko dostopate do storitev, ki jih ponuja terminalski strežnik Tracker.
• Ta bivšiample uporablja osnovne objektne storitve: >>> import tracker_api >>> from tracker_api import BasicObjectServices >>> services = BasicObjectServices(c)
• Ko je povezan, lahko kličete metode na primerku Tracker.
  • Na primerample, da dobite seznam predmetov na plošči za sledenje, uporabite: >>> rezultat, object_list = services.basic_object_list() >>> print(result)
  • ok: funkcija je uspela
  • >>> natisni (seznam_predmetov)
  • ['Object1', 'Object2'…]
• Vsi klici API vrnejo kodo rezultata, ki je opisana v vicon_core_api/result.py.
• Ena možna koda napake je Result.RPCNotConnected, ki se prejme, če je povezava s terminalskim strežnikom prekinjena.
• Na primerample: >>> rezultat, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: povezava z oddaljeno funkcijo ali povratnim klicem ni odprta
• Za prikaz seznama vseh razpoložljivih funkcij in dokumentacije: >>> pomoč (tracker_api)

Example skripte

• Lahko najdete example skripti, ki prikazujejo uporabo običajnih funkcij API-ja pri C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Vsi skripti imajo dokumentacijo in imajo možnost –help, ki poda podrobnosti o ustreznih argumentih.
• Teči kotample skript, odprite ukazno okno ali Power Shell v zgornji mapi s skripti. To lahko storite na enega od dveh načinov:
• Odprite ukazni poziv in spremenite svoj imenik v mapo s skripti: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Držite SHIFT + desni klik v mapi s skripti in izberite Odpri ukazno okno tukaj ali Odpri okno Powershell tukaj.
• Od tu lahko vodite exampskript po vaši izbiri.
• Naslednji exampuporabite ukazno okno.

camera_calibration_wave.py

• Ta skript prikazuje, kako uporabljati funkcije API za nadzor postopka umerjanja zagona in zaustavitve valovanja palice.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Če je uspešno, se prikažejo kontrole za umerjanje

capture_control.py

• Ta skript prikazuje, kako zajeti podatke v živo C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Ime zajemanja je navedeno pred kontrolniki. Če želite spremeniti ime zajema, uporabite capture_services in SetCaptureName.
• Za vprašanja o uporabi API-ja Tracker se obrnite na podporo Vicon1.
• 1 mailto:support@vicon.com
• Vicon Tracker Python API Quick Start Guide 31. maj 2023, Revizija 1
• Za uporabo s Trackerjem 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Vse pravice pridržane.
• Revizija 1. Za uporabo s Trackerjem 4.0
• Vicon Motion Systems Limited si pridržuje pravico do sprememb informacij ali specifikacij v tem dokumentu brez predhodnega obvestila.
• Podjetja, imena in podatki, uporabljeni v prample-te so izmišljene, razen če ni navedeno drugače. Nobenega dela te publikacije ni dovoljeno reproducirati, shraniti v sistem za iskanje ali posredovati v kakršni koli obliki ali na kakršen koli način, elektronski ali mehanski, s fotokopiranjem ali snemanjem ali kako drugače brez predhodnega pisnega dovoljenja Vicon Motion Systems Ltd.
• Vicon® je registrirana blagovna znamka družbe 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™ in Vicon Vue™ so blagovne znamke družbe Oxford Metrics plc.
• VESA® je registrirana blagovna znamka v lasti VESA (www.vesa.org/about-vesa/). Druga imena izdelkov in podjetij v tem dokumentu so lahko blagovne znamke njihovih lastnikov.
• Za popolne in posodobljene potrditve avtorskih pravic in blagovnih znamk obiščite https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems je podjetje Oxford Metrics plc.
• E-pošta: support@vicon.com Web: http://www.vicon.com

Dokumenti / Viri

VICON Tracker Python Api [pdf] Uporabniški priročnik Sledilnik Python Api, sledilnik, Python Api, Api

Reference

• Uporabniški priročnik