VICON Tracker Python Api Brûkersgids

VICON Tracker Python API

Spesifikaasjes

• Produkt Namme: Vicon Tracker Python API
• Kompatibiliteit: Tracker 4.0
• Stipe Python-ferzjes: 2.7 en Python 3

Produkt Usage Ynstruksjes

Ynstallearje de Tracker API

Om de Tracker API te brûken mei Python, folgje dizze stappen:

1. Kontrolearje de Python-ferzje om kompatibiliteit te garandearjen.
2. Ynstallearje Python troch it te downloaden fan 'e offisjele website en selektearje de passende ferzje.
3. Sykje en ynstallearje de Tracker Python-module út de opjûne map.

Kontrolearje Python Ferzje

1. Iepenje in kommando-prompt.
2. Typ 'py' en druk op Enter.
3. As Python is net ynstallearre, ferwize nei de ynstallaasje ynstruksjes.

Ynstallearje Python

1. Gean nei Python syn offisjele website.
2. Download en ynstallearje Python, soargje derfoar dat jo python.exe tafoegje oan PATH by ynstallaasje.

Ynstallearje de Tracker Python Module:

1. Sykje de ynstallaasje files yn de oantsjutte map.
2. Kies de ynstallaasjemetoade basearre op jo opset.

Ynstallearje de Python-module troch de batch út te fieren File:

1. Gean nei de Python ynstallaasje map: C: Program FilesViconTracker4.xSDKPython
2. Dûbelklik op 'install_tracker_api.bat' om it ynstallaasjeproses te begjinnen.

Faak stelde fragen (FAQ):

F: Wat kin ik automatisearje mei de Tracker API?

• A: De Tracker API lit jo mienskiplike funksjes automatisearje lykas laden, spieljen, eksportearjen fan gegevens, aktivearjen / deaktivearjen fan objekten en it triggerjen fan workflow-dielen.

F: Hokker Python-ferzjes wurde stipe troch de Tracker API?

• A: De Tracker API stipet Python ferzjes 2.7 en Python

Oer dizze gids

• De Tracker API lit jo bepaalde funksjes fan Tracker kontrolearje fia in Python API.
• De API stelt jo yn steat om guon mienskiplike funksjes fan Tracker te automatisearjen, lykas it laden, spieljen en eksportearjen fan gegevens, aktivearjen of deaktivearjen fan ferskate objekten, of it triggerjen fan dielen fan 'e workflow.
• Dit dokumint stelt jo yn steat om te begjinnen mei de Tracker API.

Ynstallearje de Tracker API

• Om de Tracker API te brûken mei Python, moatte jo derfoar soargje dat jo beide ynstalleare hawwe.
• De Tracker API biedt stipe foar Python 2.7 en Python 3. Vicon advisearret dat jo de lêste folsleine release fan Python 3 brûke, útsein as jo projekt fereasket dat jo in spesifike ferzje fan Python brûke.

Dizze prosedueres liede jo troch it ynstallaasjeproses:

• Kontrolearje de Python-ferzje op
• Python ynstallearje op
• Ynstallearje de Tracker Python module op
• Kontrolearje dat de Python-module goed is ynstalleare op

Kontrolearje Python ferzje

• As jo ​​net wis binne oft jo Python ynstalleare hawwe of hokker ferzje fan Python jo brûke, kinne jo in kommando-prompt iepenje en it kommando py útfiere.

Bygelyksample:

As jo ​​Python net ynstalleare hawwe, sjoch Python ynstallearje.

Ynstallearje Python Om Python 2 of 3 te ynstallearjen:

1. Gean nei  https://www.python.org/downloads/
2. Sykje de fereaske ferzje en ynstallearje Python, soargje derfoar dat Add python.exe oan PATH is selektearre:

Yn 'e boppesteande ôfbylding wurdt ABC ferfongen troch jo brûkersnamme foar de ynstallaasjemap.

De Tracker Python-module ynstallearje Om de Tracker Python-module te ynstallearjen:

1. Sykje de ynstallaasje files. As jo ​​Tracker ynstalleare yn 'e standertlokaasje, wurde se fûn yn dizze map: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Dizze files wurde werjûn:
2. Ynstallearje de Tracker Python-module op ien fan 'e folgjende manieren, ôfhinklik fan jo bepaalde ynstallaasje:
   • De maklikste manier is om de batch út te fieren file (install_tracker_api.bat) dat is opnaam yn de Tracker ynstallaasje (lykas werjûn yn de boppesteande ôfbylding).
   • Dit wurket normaal goed as:
   • Python waard ynstallearre oan de PATH fariabele; of
   • Meardere ferzjes fan Python binne ynstalleare, mar jo wolle de API ynstallearje nei de lêste ferzje dy't jo ynstalleare; of
   • Allinich ien ferzje fan Python is ynstalleare.
   • As ien fan dizze betingsten jildt, sjoch Ynstallearje de python-module troch de batch út te fieren file op.
   • Yn alle oare gefallen ynstallearje de Python-module mei pip. Dit jildt normaal as:
   • Meardere ferzjes fan Python binne ynstallearre, mar jo wolle ynstallearje nei in spesifike ferzje; of
   • Meardere ferskillende ferzjes fan Python binne ynstalleare en jo wolle se allegear ynstallearje (yn dit gefal moatte jo de module foar elke ferzje ynstallearje); of
   • Allinich ien ferzje fan Python is ynstalleare, mar jo hawwe net ynstalleare op PATH.
   • As ien fan dizze betingsten jildt, sjoch Ynstallearje de Python-module troch pip op te rinnen.

Ynstallearje de Python-module troch de batch út te fieren file Om dit te dwaan:

1. Gean nei de Python-ynstallaasjemap: C:\Programma Files\Vicon\Tracker4.x\SDK\Python
2. Dûbelklik op install_tracker_api.bat.
   • It ynstallaasjeproses initialisearret automatysk.

Ynstallearje de Python-module troch de pip út te fieren

1. Gean nei de map Skripten foar de Python dy't jo wolle brûke:
2. Foar Python 3 is de standert ynstallaasjemap: C: \Users\ \AppData\Local\Programs\Python\Python \Sc ryp
   • Foar Python 2.7 is de standert ynstallaasjemap: C:\Python27\Scripts
3. Iepenje in kommandofinster as PowerShell yn dy map.
4. Rin it folgjende kommando út om de Vicon Core API te ynstallearjen: C: \Users\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe ynstallearje "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
   • Rin it folgjende kommando út om de Tracker API C te ynstallearjen: \Users\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe ynstallearje "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

Noat It boppesteande eksamples brûke in Python 3.11 ynstallaasje mei Tracker 4.0. Jo paad en kommando's kinne wat ferskille.

Kontrolearje dat de Python-module goed ynstalleare is

• Kontrolearje dat de folgjende modules binne ynstallearre.
• vicon_core_api: Dit is de kearn remote control API en omfettet in kliïnt foar kommunikaasje mei de terminal tsjinner.
• tracker_api: Services API foar tagong ta Tracker-spesifike applikaasje funksjonaliteit.
• Om te testen dat de Tracker Python-module goed ynstalleare is, besykje ien fan 'e modules yn Python te ymportearjen: >>> ymportearje vicon_core_api

As it boppesteande proses de module net erkent, besykje dan it folgjende:

• Kontrolearje de map site-pakketten yn 'e Python-ynstallaasje foar de map tracker_api of vicon_core_api. Foar Python 3.11 is de lokaasje fan 'e standert ynstallaasjemap:
  • C:\Users\ \AppData\Local\Programs\Python\Python311\Lib\site-pakketten
• Kontrolearje jo systeemomjouwingsfariabelen en soargje derfoar dat de skriptmap foar de Python-ynstallaasje dy't jo brûke wolle de heechste yn 'e list is. Foar Python 3.11 is de standert lokaasje fan 'e ynstallaasjemap:
  • C:\Users\ \AppData\Local\Programs\Python\Python311\Scripts
• As ien fan 'e mappen fan' e modules ûntbrekt, en jo hawwe it paad ferifiearre, rinne dan opnij troch it ynstallaasjeproses beskreaun yn Ynstallearje fan de Tracker Python-module op.

Ferbine mei de terminal tsjinner

• Om te ferbinen mei de terminaltsjinner, ymportearje earst de Vicon Core API-module: >>> ymportearje vicon_core_api
  • >>> fan vicon_core_api ymportearje
• Folgjende, meitsje in klant. Dit besiket automatysk te ferbinen mei it spesifike hostadres op de standertpoarte (52800) >>> c = Client('localhost')
• Kontrolearje dat de kliïnt mei sukses ferbûn is mei de tsjinner: >>> print(c.connected) Wier
• As it antwurd falsk is, soargje derfoar dat jo in eksimplaar hawwe fan Tracker dy't rint op it opjûne hostadres en jo firewall blokkearret gjin ferkear op poarte 52800, foardat jo in nije kliïnt meitsje.
• As jo ​​​​mei súkses ferbûn binne, kinne jo tagong krije ta de tsjinsten oanbean troch de Tracker-terminalserver.
• Dizze eksample brûkt basisobjekttsjinsten: >>> ymportearje tracker_api >>> fan tracker_api ymportearje BasicObjectServices >>> tsjinsten = BasicObjectServices(c)
• As it ferbûn is, kinne jo metoaden neame op 'e Tracker-eksimplaar.
  • Bygelyksample, om in list mei objekten yn it Trackingpaniel te krijen, brûk: >>> resultaat, object_list = services.basic_object_list() >>> print(resultaat)
  • Okee: de funksje slagge
  • >>> print(object_list)
  • ['Object1', 'Object2'...]
• Alle API-oproppen jouwe in resultaatkoade werom, dy't wurdt beskreaun yn vicon_core_api/result.py.
• Ien mooglike flaterkoade is Result.RPCNotConnected, dy't ûntfongen is as de ferbining mei de terminaltsjinner ferlern is.
• Bygelyksample: >>> resultaat, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: De ferbining mei de funksje op ôfstân of werombel is net iepen
• Om in list fan alle beskikbere funksjes en dokumintaasje wer te jaan: >>> help(tracker_api)

Example skripts

• Jo kinne eksample skripts sjen litte it gebrûk fan mienskiplike API funksjes by C:\Programma Files\Vicon\Tracker 4.0\SDK\Python\sample_skripts
• Alle skripts hawwe dokumintaasje en nim in -help-opsje dy't details jout oer de relevante arguminten.
• Om te rinnen asample skript, iepenje in kommando-finster of machtshell yn 'e skriptmap hjirboppe. Jo kinne dit dwaan op ien fan twa manieren:
• Iepenje de kommando-prompt en feroarje jo map nei de skriptmap: c:\> cd C:\Programma Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_skripts
• Hâld SHIFT + rjochts-klik yn 'e skriptmap en selektearje Kommando-finster iepenje hjir of Powershell-finster iepenje hjir.
• Hjirwei kinne jo rinne de eksample skript fan jo kar.
• De folgjende eksamples brûke it kommando finster.

camera_calibration_wave.py

• Dit skript toant hoe't jo API-funksjes brûke kinne om it kalibraasjeproses te kontrolearjen fan it starten en stopjen fan 'e wandwelle.
  • C:\Programma Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• As suksesfol, wurde kalibraasjekontrôles werjûn

capture_control.py

• Dit skript lit sjen hoe't jo live gegevens C:\Program fêstlizze Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• De Capture namme wurdt fermeld foar de kontrôles. Om de capture namme te feroarjen, brûk capture_services en SetCaptureName.
• Foar fragen oer it brûken fan de Tracker API, nim dan kontakt op mei Vicon Support1.
• 1 mailto:support@vicon.com
• Vicon Tracker Python API Quick Start Guide 31 maaie 2023, Ferzje 1
• Foar gebrûk mei Tracker 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Alle rjochten foarbehâlden.
• Revision 1. Foar gebrûk mei Tracker 4.0
• Vicon Motion Systems Limited behâldt it rjocht foar om feroarings te meitsjen oan ynformaasje of spesifikaasjes yn dit dokumint sûnder notice.
• Bedriuwen, nammen en gegevens brûkt yn bglamples binne fiktyf, útsein as oars oanjûn. Gjin diel fan dizze publikaasje meie wurde reprodusearre, opslein yn in opheljen systeem, of oerdroegen yn hokker foarm of troch hokker middel, elektroanysk of meganysk, troch fotokopy of opname, of oars sûnder de foarôfgeande skriftlike tastimming fan Vicon Motion Systems Ltd.
• Vicon® is in registrearre hannelsmerk fan 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™ en Vicon Vue™ binne hannelsmerken fan Oxford Metrics plc.
• VESA® is in registrearre hannelsmerk eigendom fan VESA (www.vesa.org/about-vesa/). Oare produkt- en bedriuwsnammen hjiryn kinne de hannelsmerken wêze fan har respektive eigners.
• Foar folsleine en aktuele erkenningen fan auteursrjocht en hannelsmerken, besykje https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems is in Oxford Metrics plc bedriuw.
• E-post: support@vicon.com Web: http://www.vicon.com