VICON Tracker Python Api -käyttöopas

A: Tracker API:n avulla voit automatisoida yleisiä toimintoja, kuten lataamisen, toiston, tietojen viemisen, objektien aktivoinnin/deaktivoinnin ja työnkulun osien käynnistämisen.

K: Mitä Python-versioita Tracker API tukee?

A: Tracker API tukee Python-versioita 2.7 ja Python

Tietoja tästä oppaasta

Tracker-sovellusliittymän avulla voit hallita tiettyjä Trackerin ominaisuuksia Python-sovellusliittymän kautta.

API mahdollistaa joidenkin Trackerin yleisten toimintojen automatisoinnin, kuten tietojen lataamisen, toiston ja viennin, eri objektien aktivoinnin tai deaktivoinnin tai työnkulun osien käynnistämisen.
Tämän asiakirjan avulla voit aloittaa Tracker API:n käytön.

Asenna Tracker API

Jotta voit käyttää Tracker API:ta Pythonin kanssa, sinun on varmistettava, että molemmat ovat asennettuina.
Tracker API tarjoaa tuen Python 2.7:lle ja Python 3:lle. Vicon suosittelee, että käytät Python 3:n viimeisintä täyttä versiota, ellei projektisi edellytä tietyn Python-version käyttöä.

Nämä ohjeet opastavat sinua asennusprosessin läpi:

Tarkista Python-versio
Pythonin asentaminen päälle
Tracker Python -moduulin asentaminen päälle
Tarkista, että Python-moduuli on asennettu oikein

Tarkista Python-versio

Jos et ole varma, onko Python asennettuna tai mitä Python-versiota käytät, voit avata komentokehotteen ja suorittaa py-komennon.

esimampseuraavat:

Jos sinulla ei ole Python asennettuna, katso Pythonin asennus.

Asenna Python Python 2:n tai 3:n asentaminen:

Siirry osoitteeseen https://www.python.org/downloads/
Etsi tarvittava versio ja asenna Python varmistaen, että Add python.exe to PATH on valittuna:

Yllä olevassa kuvassa ABC on korvattu asennuskansion käyttäjänimelläsi.

Tracker Python -moduulin asentaminen Tracker Python -moduulin asentaminen:

Paikanna asennus files. Jos asensit Trackerin oletussijaintiin, ne löytyvät tästä kansiosta: C:\Program Files\Vicon\Tracker4.x\SDK\Python
- Nämä files näytetään:

Asenna Tracker Python -moduuli jommallakummalla seuraavista tavoista riippuen asennuksestasi:
- Yksinkertaisin tapa on suorittaa erä file (install_tracker_api.bat), joka sisältyy Tracker-asennukseen (kuten yllä olevassa kuvassa näkyy).
- Tämä toimii yleensä hyvin, jos:
- Python asennettiin PATH-muuttujaan; tai
- Pythonista on asennettu useita versioita, mutta haluat asentaa API:n uusimpaan asentamaasi versioon. tai
- Pythonista on asennettu vain yksi versio.
- Jos jokin näistä ehdoista pätee, katso Python-moduulin asentaminen suorittamalla erä file päällä.
- Kaikissa muissa tapauksissa asenna Python-moduuli pip-komennolla. Tämä pätee yleensä, jos:
- Pythonista on asennettu useita versioita, mutta haluat asentaa tiettyyn versioon. tai
- Pythonista on asennettu useita eri versioita ja haluat asentaa ne kaikkiin (tässä tapauksessa sinun on asennettava moduuli jokaiselle versiolle); tai
- Pythonista on asennettu vain yksi versio, mutta et asentanut PATH:iin.
- Jos jokin näistä ehdoista pätee, katso Python-moduulin asentaminen suorittamalla pip on.

Asenna Python-moduuli suorittamalla erä file Voit tehdä tämän seuraavasti:

Siirry Python-asennuskansioon: C:\Ohjelma Files\Vicon\Tracker4.x\SDK\Python
Kaksoisnapsauta install_tracker_api.bat.
- Asennusprosessi käynnistyy automaattisesti.

Asenna Python-moduuli suorittamalla pip

Siirry sen Pythonin komentosarjat-kansioon, jota haluat käyttää:
Python 3:n oletusasennuskansio on: C: \Users\ \AppData\Local\Programs\Python\Python \Sc repii
- Python 2.7:n oletusasennuskansio on: C:\Python27\Scripts

Avaa komentoikkuna tai PowerShell kyseisessä kansiossa.
Asenna Vicon Core API suorittamalla seuraava komento: C: \Käyttäjät\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe asenna “C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
- Asenna Tracker API C suorittamalla seuraava komento: \Käyttäjät\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe asenna “C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

Huom Yllä oleva exampKäytä Python 3.11 -asennusta Tracker 4.0:n kanssa. Polkusi ja komennot voivat vaihdella hieman.

Tarkista, että Python-moduuli on asennettu oikein

Tarkista, että seuraavat moduulit on asennettu.
vicon_core_api: Tämä on kaukosäätimen ydinsovellusliittymä ja sisältää asiakkaan päätepalvelimen kanssa kommunikointia varten.
tracker_api: Services API Tracker-kohtaisten sovellustoimintojen käyttämiseen.
Testaaksesi, että Tracker Python -moduuli on asennettu oikein, yritä tuoda jokin Python-moduuleista: >>> import vicon_core_api

Jos yllä oleva prosessi ei tunnista moduulia, kokeile seuraavaa:

Tarkista Python-asennuksen site-packages-kansiosta tracker_api- tai vicon_core_api-kansio. Python 3.11:ssä oletusasennuskansion sijainti on:
- C:\Käyttäjät\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
Tarkista järjestelmäympäristömuuttujat ja varmista, että haluamasi Python-asennuksen komentosarjakansio on luettelon korkein. Python 3.11:ssä asennuskansion oletussijainti on:
- C:\Käyttäjät\ \AppData\Local\Programs\Python\Python311\Scripts
Jos jompikumpi moduulien kansioista puuttuu ja olet tarkistanut polun, suorita asennusprosessi uudelleen, joka on kuvattu kohdassa Tracker Python -moduulin asentaminen.

Yhdistä päätepalvelimeen

Muodosta yhteys päätepalvelimeen tuomalla ensin Vicon Core API -moduuli: >>> import vicon_core_api
- >>> vicon_core_api-tuonnista
Luo seuraavaksi asiakas. Tämä yrittää automaattisesti muodostaa yhteyden tiettyyn isäntäosoitteeseen oletusportissa (52800) >>> c = Client('localhost')
Tarkista, että asiakas on muodostanut yhteyden palvelimeen: >>> print(c.connected) True
Jos vastaus on False, varmista ennen uuden asiakkaan luomista, että Tracker-esiintymä on käynnissä määritetyssä isäntäosoitteessa ja että palomuurisi ei estä liikennettä portissa 52800.
Kun olet muodostanut yhteyden onnistuneesti, voit käyttää Tracker-päätepalvelimen tarjoamia palveluita.
Tämä example käyttää objektin peruspalveluita: >>> tuo tracker_api >>> from tracker_api tuo BasicObjectServices >>> services = BasicObjectServices(c)
Kun se on yhdistetty, voit kutsua menetelmiä Tracker-esiintymässä.
- esimample, saadaksesi luettelon kohteista Seuranta-paneelissa, käytä: >>> result, object_list = services.basic_object_list() >>> print(result)
- Ok: toiminto onnistui
- >>> tulosta (object_list)
- ['Object1', 'Object2'…]

Kaikki API-kutsut palauttavat tuloskoodin, joka on kuvattu osoitteessa vicon_core_api/result.py.
Yksi mahdollinen vikakoodi on Result.RPCNotConnected, joka vastaanotetaan, jos yhteys päätepalvelimeen katkeaa.
esimample: >>> tulos, objektiluettelo = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: Yhteys etätoimintoon tai takaisinsoittoon ei ole auki

Voit näyttää luettelon kaikista käytettävissä olevista toiminnoista ja dokumentaatiosta seuraavasti: >>> help( tracker_api)

Example käsikirjoituksia

Löydät example skriptejä, jotka osoittavat yleisten API-toimintojen käytön osoitteessa C:\Ohjelma Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
Kaikilla skripteillä on dokumentaatio, ja niissä on -help-vaihtoehto, joka antaa tiedot asiaankuuluvista argumenteista.

Juoksemaan kuinample script, avaa komentoikkuna tai komentotulkki yllä olevassa komentosarjakansiossa. Voit tehdä tämän kahdella tavalla:
Avaa komentokehote ja vaihda hakemistosi komentosarjakansioksi: c:\> cd C:\Ohjelma Files\Vicon\Tracker
- 4.0\SDK\Python\sample_scripts
Pidä SHIFT + napsauta hiiren kakkospainiketta komentosarjakansiossa ja valitse Avaa komentoikkuna tästä tai Avaa Powershell-ikkuna tästä.

Täältä voit ajaa exampvalitsemasi käsikirjoitus.
Seuraava exampKäytä komentoikkunaa.

camera_calibration_wave.py

Tämä skripti osoittaa, kuinka API-toimintojen avulla ohjataan sauvan aallon käynnistämisen ja pysäyttämisen kalibrointiprosessia.
- C:\Ohjelma Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
Jos onnistut, kalibrointisäätimet tulevat näkyviin

capture_control.py

Tämä skripti näyttää kuinka kaapataan live-dataa C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py

Sieppauksen nimi on lueteltu ennen säätimiä. Voit muuttaa kaappauksen nimeä käyttämällä Capture_services- ja SetCaptureName-komentoja.
Jos sinulla on kysyttävää Tracker API:n käytöstä, ota yhteyttä Viconin tukeen1.
1 postia:support@vicon.com
Vicon Tracker Python API -pikaopas 31, versio 2023

Käytetään Tracker 4.0:n kanssa
Versio 1. Käytetään Tracker 4.0:n kanssa
Vicon Motion Systems Limited pidättää oikeuden tehdä muutoksia tämän asiakirjan tietoihin tai spesifikaatioihin ilman ennakkoilmoitusta.
Yritykset, nimet ja tiedot, joita käytetään esimampovat fiktiivisiä, ellei toisin mainita. Mitään tämän julkaisun osaa ei saa jäljentää, tallentaa hakujärjestelmään tai siirtää missään muodossa tai millään tavalla, elektronisesti tai mekaanisesti, valokopioimalla tai tallentamalla tai muuten ilman Vicon Motion Systems Ltd:n kirjallista lupaa.

Vicon® on Oxford Metrics plc:n rekisteröity tavaramerkki. Vicon Control™, Vicon Lock™, Vicon Lock Lab™, Vicon Lock Studio™, Vicon Tracker™, Vicon Valkyrie™, Vicon Vantage™, Vicon Vero™, Vicon Viper™, Vicon ViperX™ ja Vicon Vue™ ovat Oxford Metrics plc:n tavaramerkkejä.
VESA® on VESA:n omistama rekisteröity tavaramerkki (www.vesa.org/about-vesa/). Muut tässä olevat tuotteiden ja yritysten nimet voivat olla omistajiensa tavaramerkkejä.
Täydelliset ja ajantasaiset tekijänoikeus- ja tavaramerkkitunnustukset ovat osoitteessa https://www.vicon.com/vicon/copyright-information.

Vicon Motion Systems on Oxford Metrics plc -yhtiö.
Sähköposti: support@vicon.com Web: http://www.vicon.com

Asiakirjat / Resurssit

VICON Tracker Python Api [pdfKäyttöopas
Tracker Python Api, Tracker, Python Api, Api

Viitteet

Käyttöopas

VICON Tracker Python API

Tuotteen käyttöohjeet