VICON Tracker Python API

Specifikacijos

• Produkto pavadinimas: Vicon Tracker Python API
• Suderinamumas: Tracker 4.0
• Palaikomos Python versijos: 2.7 ir Python 3

Produkto naudojimo instrukcijos

Įdiekite Tracker API

Norėdami naudoti Tracker API su Python, atlikite šiuos veiksmus:

1. Patikrinkite Python versiją, kad įsitikintumėte suderinamumu.
2. Įdiekite Python atsisiųsdami jį iš oficialaus websvetainę ir pasirinkite tinkamą versiją.
3. Raskite ir įdiekite Tracker Python modulį iš nurodyto aplanko.

Patikrinkite Python versiją

1. Atidarykite komandų eilutę.
2. Įveskite „py“ ir paspauskite „Enter“.
3. Jei Python neįdiegtas, žr. diegimo instrukcijas.

Įdiekite Python

1. Eikite į Python oficialus websvetainę.
2. Atsisiųskite ir įdiekite Python, užtikrindami, kad diegimo metu pridėtumėte python.exe į PATH.

Įdiekite Tracker Python modulį:

1. Raskite diegimo vietą files nurodytame aplanke.
2. Pasirinkite diegimo metodą pagal savo sąranką.

Įdiekite Python modulį paleisdami paketą File:

1. Eikite į Python diegimo aplanką: C: Program FilesViconTracker4.xSDKPython
2. Dukart spustelėkite „install_tracker_api.bat“, kad pradėtumėte diegimo procesą.

Dažnai užduodami klausimai (DUK):

Kl.: Ką galiu automatizuoti naudojant Tracker API?

• A: Tracker API leidžia automatizuoti įprastas funkcijas, tokias kaip įkėlimas, atkūrimas, duomenų eksportavimas, objektų aktyvinimas/deaktyvinimas ir darbo eigos dalių suaktyvinimas.

K: Kurias Python versijas palaiko Tracker API?

• A: Tracker API palaiko Python 2.7 ir Python versijas

Apie šį vadovą

• Tracker API leidžia valdyti tam tikras Tracker funkcijas per Python API.
• API leidžia automatizuoti kai kurias įprastas Tracker funkcijas, tokias kaip duomenų įkėlimas, atkūrimas ir eksportavimas, skirtingų objektų aktyvinimas arba išjungimas arba darbo eigos dalių suaktyvinimas.
• Šis dokumentas leidžia jums pradėti naudotis Tracker API.

Įdiekite Tracker API

• Norėdami naudoti Tracker API su Python, turite įsitikinti, kad įdiegėte abu.
• Tracker API palaiko Python 2.7 ir Python 3. Vicon rekomenduoja naudoti naujausią pilną Python 3 leidimą, nebent jūsų projektas reikalauja naudoti konkrečią Python versiją.

Šios procedūros padės jums atlikti diegimo procesą:

• Patikrinkite Python versiją
• Python įdiegimas
• Tracker Python modulio įdiegimas
• Patikrinkite, ar Python modulis tinkamai įdiegtas

Patikrinkite Python versiją

• Jei nesate tikri, ar įdiegėte Python, arba kokią Python versiją naudojate, galite atidaryti komandų eilutę ir paleisti py komandą.

Pavyzdžiui,ampLe:

Jei neturite įdiegto Python, žr. Python diegimas.

Įdiekite Python Norėdami įdiegti Python 2 arba 3:

1. Eikite į  https://www.python.org/downloads/
2. Raskite reikiamą versiją ir įdiekite Python, įsitikindami, kad pasirinkta Add python.exe to PATH:

Aukščiau esančiame paveikslėlyje ABC pakeistas jūsų vartotojo vardu diegimo aplanke.

Įdiekite „Tracker Python“ modulį Norėdami įdiegti „Tracker Python“ modulį:

1. Raskite diegimo vietą files. Jei įdiegėte „Tracker“ numatytojoje vietoje, juos rasite šiame aplanke: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Šios fileRodomi s:
2. Įdiekite „Tracker Python“ modulį vienu iš šių būdų, atsižvelgiant į konkretų diegimą:
   • Paprasčiausias būdas yra paleisti partiją file (install_tracker_api.bat), kuris yra įtrauktas į Tracker diegimą (kaip parodyta aukščiau esančiame paveikslėlyje).
   • Paprastai tai gerai veikia, jei:
   • Python buvo įdiegtas į PATH kintamąjį; arba
   • Įdiegtos kelios Python versijos, bet jūs norite įdiegti API į naujausią įdiegtą versiją; arba
   • Įdiegta tik viena Python versija.
   • Jei tinka kuri nors iš šių sąlygų, žr. „Python“ modulio įdiegimas paleisdami paketą file įjungta.
   • Visais kitais atvejais įdiekite Python modulį naudodami pip. Paprastai tai taikoma, jei:
   • Įdiegtos kelios Python versijos, bet norite įdiegti į konkrečią versiją; arba
   • Įdiegtos kelios skirtingos Python versijos, kurias norite įdiegti visose (šiuo atveju turite įdiegti kiekvienos versijos modulį); arba
   • Įdiegta tik viena Python versija, bet jūs neįdiegėte PATH.
   • Jei tinka kuri nors iš šių sąlygų, žr. Python modulio įdiegimas paleisdami pip on.

Įdiekite Python modulį paleisdami paketą file Norėdami tai padaryti:

1. Eikite į Python diegimo aplanką: C:\Programa Files\Vicon\Tracker4.x\SDK\Python
2. Dukart spustelėkite install_tracker_api.bat.
   • Diegimo procesas pradedamas automatiškai.

Įdiekite Python modulį paleisdami pip

1. Eikite į norimo naudoti Python aplanką Skriptai:
2. Python 3 numatytasis diegimo aplankas yra: C: \Users\ \AppData\Local\Programs\Python\Python \Sc plėšimai
   • Python 2.7 numatytasis diegimo aplankas yra: C:\Python27\Scripts
3. Tame aplanke atidarykite komandų langą arba „PowerShell“.
4. Vykdykite šią komandą, kad įdiegtumėte Vicon Core API: C: \Vartotojai\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe įdiekite „C:\Program“ Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api“
   • Vykdykite šią komandą, kad įdiegtumėte Tracker API C: \Vartotojai\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe įdiekite „C:\Program“ Files\Vicon\Tracker 4.0\SDK\Python\tracker_api“

Pastaba Aukščiau nurodytas buvęsamples naudoti Python 3.11 diegimą su Tracker 4.0. Jūsų kelias ir komandos gali šiek tiek skirtis.

Patikrinkite, ar tinkamai įdiegtas Python modulis

• Patikrinkite, ar įdiegti šie moduliai.
• vicon_core_api: Tai yra pagrindinė nuotolinio valdymo API ir apima klientą ryšiui su terminalo serveriu.
• tracker_api: Paslaugų API, skirta prieigai prie „Tracker“ specifinių programų funkcijų.
• Norėdami patikrinti, ar „Tracker Python“ modulis įdiegtas tinkamai, pabandykite importuoti vieną iš „Python“ modulių: >>> importuoti vicon_core_api

Jei aukščiau aprašytas procesas neatpažįsta modulio, pabandykite atlikti šiuos veiksmus:

• „Python“ diegimo svetainės paketų aplanke patikrinkite, ar nėra aplanko tracker_api arba vicon_core_api. Python 3.11 numatytojo diegimo aplanko vieta yra:
  • C:\Vartotojai\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Patikrinkite sistemos aplinkos kintamuosius ir įsitikinkite, kad norimos naudoti Python diegimo scenarijų aplankas yra aukščiausias sąraše. Python 3.11 numatytoji diegimo aplanko vieta yra:
  • C:\Vartotojai\ \AppData\Local\Programs\Python\Python311\Scripts
• Jei trūksta kurio nors iš modulių aplankų ir patvirtinote kelią, dar kartą vykdykite diegimo procesą, aprašytą skyriuje „Tracker Python“ modulio įdiegimas.

Prisijunkite prie terminalo serverio

• Norėdami prisijungti prie terminalo serverio, pirmiausia importuokite Vicon Core API modulį: >>> importuokite vicon_core_api
  • >>> iš vicon_core_api importo
• Tada sukurkite klientą. Tai automatiškai bando prisijungti prie konkretaus pagrindinio kompiuterio adreso numatytame prievade (52800) >>> c = Client('localhost')
• Patikrinkite, ar klientas sėkmingai prisijungė prie serverio: >>> spausdinti(c.connected) Tiesa
• Jei atsakymas yra klaidingas, prieš kurdami naują klientą įsitikinkite, kad jūsų stebėjimo priemonės egzempliorius veikia nurodytu pagrindinio kompiuterio adresu ir ugniasienė neblokuoja srauto 52800 prievade.
• Sėkmingai prisijungę galite pasiekti Tracker terminalo serverio teikiamas paslaugas.
• Šis buvęsample naudojasi pagrindinėmis objekto paslaugomis: >>> importuoti tracker_api >>> iš tracker_api importuoti BasicObjectServices >>> paslaugos = BasicObjectServices(c)
• Kai jis prijungtas, galite iškviesti metodus Tracker egzemplioriuje.
  • Pavyzdžiui,ample, norėdami gauti objektų sąrašą stebėjimo skydelyje, naudokite: >>> result, object_list = services.basic_object_list() >>> print(result)
  • Gerai: funkcija pavyko
  • >>> spausdinti(objektų_sąrašas)
  • ['Object1', 'Object2'...]
• Visi API iškvietimai grąžina rezultato kodą, kuris aprašytas vicon_core_api/result.py.
• Vienas iš galimų gedimų kodas yra Result.RPCNotConnected, kuris gaunamas, jei nutrūksta ryšys su terminalo serveriu.
• Pavyzdžiui,ample: >>> rezultatas, object_list = services.basic_object_list() vicon_core_api.client.RPCEklaida: RPCNotConnected: ryšys su nuotoline funkcija arba atgalinis skambutis nėra atidarytas
• Norėdami parodyti visų galimų funkcijų sąrašą ir dokumentaciją: >>> help( tracker_api)

Example scenarijus

• Galite rasti exampscenarijų, rodančių įprastų API funkcijų naudojimą C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Visi scenarijai turi dokumentaciją ir pasirenka pagalbos parinktį, kurioje pateikiama išsami informacija apie atitinkamus argumentus.
• Paleisti kaipample script, atidarykite komandų langą arba galios apvalkalą aukščiau esančiame scenarijų aplanke. Tai galite padaryti vienu iš dviejų būdų:
• Atidarykite komandų eilutę ir pakeiskite savo katalogą į scenarijų aplanką: c:\> cd C:\Programa Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Laikykite nuspaudę SHIFT + dešiniuoju pelės klavišu spustelėkite scenarijų aplanką ir pasirinkite Atidaryti komandų langą čia arba Atidaryti Powershell langą čia.
• Iš čia galite paleisti buvampjūsų pasirinktas scenarijus.
• Šis buvęsampnaudokite komandų langą.

camera_calibration_wave.py

• Šis scenarijus parodo, kaip naudoti API funkcijas norint valdyti lazdelės bangos paleidimo ir sustabdymo kalibravimo procesą.
  • C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Jei pavyksta, rodomi kalibravimo valdikliai

capture_control.py

• Šis scenarijus parodo, kaip užfiksuoti tiesioginius duomenis C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Užfiksavimo pavadinimas pateikiamas prieš valdiklius. Norėdami pakeisti fiksavimo pavadinimą, naudokite capture_services ir SetCaptureName.
• Jei turite klausimų apie Tracker API naudojimą, susisiekite su Vicon Support1.
• 1 paštas:support@vicon.com
• Vicon Tracker Python API greitos pradžios vadovas 31 m. gegužės 2023 d., 1 versija
• Skirta naudoti su Tracker 4.0
• © Autorių teisės 2020–2023 „Vicon Motion Systems Limited“. Visos teisės saugomos.
• 1 versija. Skirta naudoti su Tracker 4.0
• Vicon Motion Systems Limited pasilieka teisę be įspėjimo keisti informaciją ar specifikacijas šiame dokumente.
• Įmonės, pavadinimai ir duomenys, naudojami pvzamples yra fiktyvūs, jei nenurodyta kitaip. Be išankstinio raštiško Vicon Motion Systems Ltd. leidimo jokia šio leidinio dalis negali būti atkuriama, saugoma paieškos sistemoje ar perduodama bet kokia forma ar bet kokiomis priemonėmis, elektroninėmis ar mechaninėmis, kopijuojant, įrašant ar kitaip.
• Vicon® yra registruotasis Oxford Metrics plc prekės ženklas. Vicon Control™, Vicon Lock™, Vicon Lock Lab™, Vicon Lock Studio™, Vicon Tracker™, Vicon Valkyrie™, Vicon Vantage™, Vicon Vero™, Vicon Viper™, Vicon ViperX™ ir Vicon Vue™ yra Oxford Metrics plc prekių ženklai.
• VESA® yra registruotasis prekės ženklas, priklausantis VESA (www.vesa.org/about-vesa/). Kiti čia pateikiami gaminių ir įmonių pavadinimai gali būti atitinkamų savininkų prekių ženklai.
• Norėdami gauti išsamų ir naujausią autorių teisių ir prekės ženklo pripažinimą, apsilankykite https://www.vicon.com/vicon/copyright-information.
• „Vicon Motion Systems“ yra „Oxford Metrics plc“ įmonė.
• El. paštas: support@vicon.com Web: http://www.vicon.com

Dokumentai / Ištekliai

VICON Tracker Python Api [pdfVartotojo vadovas Tracker Python Api, Tracker, Python Api, Api

Nuorodos

• Vartotojo vadovas