VICON Tracker Python API

Specifikimet

• Emri i produktit: Vicon Tracker Python API
• Përputhshmëria: Gjurmuesi 4.0
• Versionet e mbështetura të Python: 2.7 dhe Python 3

Udhëzimet e përdorimit të produktit

Instaloni API-në Tracker

Për të përdorur API-në Tracker me Python, ndiqni këto hapa:

1. Kontrolloni versionin e Python për të siguruar përputhshmërinë.
2. Instaloni Python duke e shkarkuar atë nga zyrtari webfaqe dhe zgjedhjen e versionit të duhur.
3. Gjeni dhe instaloni modulin Tracker Python nga dosja e specifikuar.

Kontrolloni versionin e Python

1. Hapni një vijë komandimi.
2. Shkruani 'py' dhe shtypni Enter.
3. Nëse Python nuk është i instaluar, referojuni udhëzimeve të instalimit.

Instaloni Python

1. Shko tek Zyrtari i Python webfaqe.
2. Shkarkoni dhe instaloni Python, duke siguruar që të shtoni python.exe në PATH gjatë instalimit.

Instaloni modulin Tracker Python:

1. Gjeni instalimin files në dosjen e specifikuar.
2. Zgjidhni metodën e instalimit bazuar në konfigurimin tuaj.

Instaloni modulin Python duke ekzekutuar grupin File:

1. Navigoni te dosja e instalimit të Python: C: Program FilesViconTracker4.xSDKPython
2. Klikoni dy herë në 'install_tracker_api.bat' për të nisur procesin e instalimit.

Pyetjet e bëra më shpesh (FAQ):

Pyetje: Çfarë mund të automatizoj duke përdorur API-në Tracker?

• A: API Tracker ju lejon të automatizoni funksionet e zakonshme si ngarkimi, luajtja, eksportimi i të dhënave, aktivizimi/çaktivizimi i objekteve dhe aktivizimi i pjesëve të rrjedhës së punës.

Pyetje: Cilat versione të Python mbështeten nga API Tracker?

• A: API Tracker mbështet versionet 2.7 të Python dhe Python

Rreth këtij udhëzuesi

• API Tracker ju lejon të kontrolloni disa veçori të Tracker përmes një API Python.
• API ju mundëson të automatizoni disa funksione të zakonshme të Tracker, të tilla si ngarkimi, luajtja dhe eksportimi i të dhënave, aktivizimi ose çaktivizimi i objekteve të ndryshme ose aktivizimi i pjesëve të rrjedhës së punës.
• Ky dokument ju mundëson të filloni me API-në e gjurmuesit.

Instaloni API-në Tracker

• Për të përdorur API-në Tracker me Python, duhet të siguroheni që i keni instaluar të dyja.
• API Tracker ofron mbështetje për Python 2.7 dhe Python 3. Vicon rekomandon që të përdorni versionin më të fundit të plotë të Python 3, përveç nëse projekti juaj kërkon që ju të përdorni një version specifik të Python.

Këto procedura ju udhëzojnë gjatë procesit të instalimit:

• Kontrolloni versionin e Python
• Instalimi i Python në
• Instalimi i modulit Tracker Python në
• Kontrolloni nëse moduli Python është instaluar saktë

Kontrolloni versionin e Python

• Nëse nuk jeni i sigurt nëse e keni të instaluar Python ose cilin version të Python po përdorni, mund të hapni një linjë komande dhe të ekzekutoni komandën py.

Për shembullampe:

Nëse nuk keni të instaluar Python, shihni Instalo Python.

Instaloni Python Për të instaluar Python 2 ose 3:

1. Shko tek  https://www.python.org/downloads/
2. Gjeni versionin e kërkuar dhe instaloni Python, duke u siguruar që është zgjedhur Add python.exe në PATH:

Në imazhin e mësipërm, ABC zëvendësohet me emrin tuaj të përdoruesit për dosjen e instalimit.

Instaloni modulin Tracker Python Për të instaluar modulin Tracker Python:

1. Gjeni instalimin files. Nëse keni instaluar Tracker në vendndodhjen e paracaktuar, ato gjenden në këtë dosje: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Këto files janë shfaqur:
2. Instaloni modulin Tracker Python në njërën nga mënyrat e mëposhtme, në varësi të instalimit tuaj të veçantë:
   • Mënyra më e thjeshtë është të ekzekutoni grupin file (install_tracker_api.bat) që përfshihet në instalimin e Tracker (siç tregohet në imazhin e mësipërm).
   • Kjo zakonisht funksionon mirë nëse:
   • Python u instalua në variablin PATH; ose
   • Janë instaluar shumë versione të Python, por ju dëshironi të instaloni API-në në versionin më të fundit që keni instaluar; ose
   • Është instaluar vetëm një version i vetëm i Python.
   • Nëse zbatohet ndonjë nga këto kushte, shihni Instaloni modulin python duke ekzekutuar grupin file në.
   • Në të gjitha rastet e tjera, instaloni modulin Python duke përdorur pip. Kjo zakonisht zbatohet nëse:
   • Janë instaluar shumë versione të Python, por ju dëshironi të instaloni në një version specifik; ose
   • Janë instaluar shumë versione të ndryshme të Python dhe ju dëshironi të instaloni në të gjitha ato (në këtë rast, duhet të instaloni modulin për secilin version); ose
   • Vetëm një version i vetëm i Python është instaluar, por ju nuk e keni instaluar në PATH.
   • Nëse zbatohet ndonjë nga këto kushte, shihni Instaloni modulin Python duke ekzekutuar pip-in.

Instaloni modulin Python duke ekzekutuar grupin file Për ta bërë këtë:

1. Navigoni në dosjen e instalimit të Python: C:\Programi Files\Vicon\Tracker4.x\SDK\Python
2. Klikoni dy herë install_tracker_api.bat.
   • Procesi i instalimit inicializohet automatikisht.

Instaloni modulin Python duke ekzekutuar pip

1. Navigoni në dosjen Scripts për Python që dëshironi të përdorni:
2. Për Python 3, dosja e instalimit të paracaktuar është: C: \Users\ \AppData\Local\Programs\Python\Python \Sc gris
   • Për Python 2.7, dosja e instalimit të paracaktuar është: C:\Python27\Scripts
3. Hapni një dritare komandimi ose PowerShell në atë dosje.
4. Ekzekutoni komandën e mëposhtme për të instaluar Vicon Core API: C: \Përdoruesit\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instaloni "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
   • Ekzekutoni komandën e mëposhtme për të instaluar Tracker API C: \Përdoruesit\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instaloni "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

Shënim IshampLe të përdorim një instalim Python 3.11 me Tracker 4.0. Rruga dhe komandat tuaja mund të ndryshojnë pak.

Kontrolloni që moduli Python të jetë instaluar saktë

• Kontrolloni nëse modulet e mëposhtme janë instaluar.
• vicon_core_api: Ky është API kryesor i telekomandës dhe përfshin një klient për komunikim me serverin e terminalit.
• tracker_api: Shërbimet API për të hyrë në funksionalitetin e aplikacionit specifik të gjurmuesit.
• Për të testuar nëse moduli Tracker Python është instaluar saktë, provoni të importoni një nga modulet në Python: >>> import vicon_core_api

Nëse procesi i mësipërm dështon të njohë modulin, provoni sa më poshtë:

• Kontrolloni dosjen e paketave të faqes në instalimin e Python për dosjen tracker_api ose vicon_core_api. Për Python 3.11, vendndodhja e dosjes së instalimit të paracaktuar është:
  • C:\Përdoruesit\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Kontrolloni variablat e mjedisit të sistemit tuaj dhe sigurohuni që dosja e skripteve për instalimin e Python që dëshironi të përdorni është më e larta në listë. Për Python 3.11, vendndodhja e paracaktuar e dosjes së instalimit është:
  • C:\Përdoruesit\ \AppData\Local\Programs\Python\Python311\Scripts
• Nëse mungon ndonjë prej dosjeve të moduleve dhe ju e keni verifikuar shtegun, rinisni procesin e instalimit të përshkruar në Instalimi i modulit Tracker Python në.

Lidhu me serverin e terminalit

• Për t'u lidhur me serverin e terminalit, fillimisht importoni modulin Vicon Core API: >>> importoni vicon_core_api
  • >>> nga importi vicon_core_api
• Tjetra, krijoni një klient. Kjo automatikisht përpiqet të lidhet me adresën specifike të hostit në portën e paracaktuar (52800) >>> c = Klient ('localhost')
• Kontrolloni nëse klienti është lidhur me sukses me serverin: >>> print(c.lidhur) E vërtetë
• Nëse përgjigja është e rreme, sigurohuni që të keni një shembull të Tracker që funksionon në adresën e specifikuar të hostit dhe muri juaj i zjarrit nuk po bllokon trafikun në portin 52800, përpara se të krijoni një klient të ri.
• Kur të jeni lidhur me sukses, mund të përdorni shërbimet e ofruara nga serveri i terminalit Tracker.
• Ky ishample përdor shërbimet bazë të objekteve: >>> importoni tracker_api >>> nga importi tracker_api BasicObjectServices >>> shërbimet = BasicObjectServices(c)
• Kur është i lidhur, mund të telefononi metoda në shembullin Tracker.
  • Për shembullample, për të marrë një listë të objekteve në panelin e gjurmimit, përdorni: >>> rezultat, listë_objekte = shërbime.basic_object_list() >>> print(rezultat)
  • Në rregull: funksioni pati sukses
  • >>> print(lista_objektesh)
  • ['Objekti1', 'Objekti2'…]
• Të gjitha thirrjet API kthejnë një kod rezultati, i cili përshkruhet në vicon_core_api/result.py.
• Një kod i mundshëm i dështimit është Result.RPCNotConnected, i cili merret nëse lidhja me serverin e terminalit humbet.
• Për shembullample: >>> rezultati, objekt_lista = services.basic_object_list() vicon_core_api.client.RPCE gabim: RPCNotConnected: Lidhja me funksionin në distancë ose kthimi i thirrjes nuk është i hapur
• Për të shfaqur një listë të të gjitha funksioneve dhe dokumentacionit të disponueshëm: >>> ndihmë ( tracker_api)

Example skriptet

• Mund të gjeni ishample skriptet që tregojnë përdorimin e funksioneve të zakonshme API në C:\Programi Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Të gjithë skriptet kanë dokumentacion dhe marrin një opsion –help që jep detaje të argumenteve përkatëse.
• Për të kandiduar siample script, hapni një dritare komandimi ose një guaskë të energjisë në dosjen e skripteve më sipër. Ju mund ta bëni këtë në një nga dy mënyrat:
• Hapni vijën e komandës dhe ndryshoni drejtorinë tuaj në dosjen e skripteve: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Mbani SHIFT + kliko me të djathtën në dosjen e skripteve dhe zgjidhni Hap dritaren e komandës këtu ose Hap dritaren e Powershell këtu.
• Nga këtu mund të drejtoni ishampskenarin e zgjedhjes suaj.
• Ish-i i mëposhtëmampLe të përdorim dritaren komanduese.

camera_calibration_wave.py

• Ky skript demonstron se si të përdoren funksionet API për të kontrolluar procesin e kalibrimit të fillimit dhe ndalimit të valës së shkopit.
  • C:\Programi Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Nëse ka sukses, shfaqen kontrollet e kalibrimit

capture_control.py

• Ky skenar tregon se si të kapni të dhëna të drejtpërdrejta C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Emri Capture është renditur përpara kontrolleve. Për të ndryshuar emrin e kapjes, përdorni capture_services dhe SetCaptureName.
• Për pyetje mbi përdorimin e API-së Tracker, kontaktoni Vicon Support1.
• 1 postë në:support@vicon.com
• Vicon Tracker Python API Udhëzuesi i fillimit të shpejtë 31 maj 2023, rishikimi 1
• Për përdorim me Tracker 4.0
• © E drejta e autorit 2020–2023 Vicon Motion Systems Limited. Të gjitha të drejtat e rezervuara.
• Rishikimi 1. Për përdorim me Tracker 4.0
• Vicon Motion Systems Limited rezervon të drejtën të bëjë ndryshime në informacionin ose specifikimet në këtë dokument pa paralajmërim.
• Kompanitë, emrat dhe të dhënat e përdorura në p.shamples janë fiktive përveç rasteve kur shënohet ndryshe. Asnjë pjesë e këtij botimi nuk mund të riprodhohet, ruhet në një sistem rikthimi, ose të transmetohet në çfarëdo forme ose me ndonjë mjet, elektronik ose mekanik, me fotokopje ose regjistrim, ose ndryshe pa lejen paraprake me shkrim të Vicon Motion Systems Ltd.
• Vicon® është një markë e regjistruar e 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™ dhe Vicon Vue™ janë marka tregtare të Oxford Metrics plc.
• VESA® është një markë e regjistruar tregtare në pronësi të VESA (www.vesa.org/about-vesa/). Emrat e tjerë të produkteve dhe kompanive këtu mund të jenë marka tregtare të pronarëve të tyre përkatës.
• Për njohjen e plotë dhe të përditësuar të të drejtës së autorit dhe markës tregtare, vizitoni https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems është një kompani Oxford Metrics plc.
• Email: support@vicon.com Web: http://www.vicon.com

Dokumentet / Burimet

VICON Tracker Python Api [pdfUdhëzuesi i përdoruesit Tracker Python Api, Tracker, Python Api, Api

Referencat

• Manuali i Përdoruesit