VICON Tracker Python API

Műszaki adatok

• Termék neve: Vicon Tracker Python API
• Kompatibilitás: Tracker 4.0
• Támogatott Python verziók: 2.7 és Python 3

A termék használati útmutatója

Telepítse a Tracker API-t

A Tracker API Pythonnal való használatához kövesse az alábbi lépéseket:

1. Ellenőrizze a Python verziót a kompatibilitás érdekében.
2. Telepítse a Python-t úgy, hogy letölti a hivatalos oldalról webwebhelyet, és válassza ki a megfelelő verziót.
3. Keresse meg és telepítse a Tracker Python modult a megadott mappából.

Ellenőrizze a Python verzióját

1. Nyisson meg egy parancssort.
2. Írja be a „py” parancsot, és nyomja meg az Enter billentyűt.
3. Ha a Python nincs telepítve, olvassa el a telepítési utasításokat.

Telepítse a Python-t

1. Menj ide A Python hivatalos webtelek.
2. Töltse le és telepítse a Python-t, ügyelve arra, hogy a telepítés során hozzáadja a python.exe fájlt a PATH-hoz.

Telepítse a Tracker Python modult:

1. Keresse meg a telepítést files a megadott mappában.
2. Válassza ki a telepítési módot a beállítások alapján.

Telepítse a Python modult a Batch futtatásával File:

1. Keresse meg a Python telepítési mappáját: C: Program FilesViconTracker4.xSDKPython
2. A telepítési folyamat elindításához kattintson duplán az „install_tracker_api.bat” fájlra.

Gyakran Ismételt Kérdések (GYIK):

K: Mit automatizálhatok a Tracker API használatával?

• A: A Tracker API lehetővé teszi az olyan általános funkciók automatizálását, mint a betöltés, lejátszás, adatok exportálása, objektumok aktiválása/deaktiválása és a munkafolyamat-részek aktiválása.

K: Mely Python-verziókat támogatja a Tracker API?

• A: A Tracker API támogatja a Python 2.7 és Python verzióit

Erről az útmutatóról

• A Tracker API lehetővé teszi a Tracker bizonyos funkcióinak vezérlését Python API-n keresztül.
• Az API lehetővé teszi a Tracker néhány gyakori funkciójának automatizálását, például az adatok betöltését, lejátszását és exportálását, különböző objektumok aktiválását vagy deaktiválását, vagy a munkafolyamat egyes részeinek aktiválását.
• Ez a dokumentum lehetővé teszi a Tracker API használatának megkezdését.

Telepítse a Tracker API-t

• A Tracker API Pythonnal való használatához meg kell győződnie arról, hogy mindkettő telepítve van.
• A Tracker API támogatja a Python 2.7-et és a Python 3-at. A Vicon azt javasolja, hogy használja a Python 3 legújabb teljes kiadását, kivéve, ha a projekt megköveteli a Python egy adott verziójának használatát.

Ezek az eljárások végigvezetik a telepítési folyamaton:

• Ellenőrizze a Python verziót
• Python telepítése
• A Tracker Python modul telepítése
• Ellenőrizze, hogy a Python modul megfelelően van-e telepítve

Ellenőrizze a Python verzióját

• Ha nem biztos abban, hogy telepítve van-e a Python, vagy a Python melyik verzióját használja, megnyithat egy parancssort, és futtathatja a py parancsot.

Plample:

Ha nincs telepítve a Python, olvassa el a Python telepítése című részt.

Telepítse a Python-t A Python 2 vagy 3 telepítése:

1. Menj ide  https://www.python.org/downloads/
2. Keresse meg a kívánt verziót, és telepítse a Python-t, ügyelve arra, hogy a python.exe hozzáadása a PATH-hoz lehetőség legyen kiválasztva:

A fenti képen az ABC helyett az Ön felhasználóneve van a telepítési mappában.

A Tracker Python modul telepítése A Tracker Python modul telepítéséhez:

1. Keresse meg a telepítést files. Ha a Trackert az alapértelmezett helyre telepítette, akkor a következő mappában találhatók: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Ezek files jelennek meg:
2. Telepítse a Tracker Python modult az alábbi módok egyikével, az adott telepítéstől függően:
   • A legegyszerűbb módja a köteg futtatása file (install_tracker_api.bat), amely a Tracker telepítésében található (a fenti képen látható módon).
   • Ez általában jól működik, ha:
   • A Python a PATH változóhoz lett telepítve; vagy
   • A Python több verziója is telepítve van, de az API-t a legújabb verzióra szeretné telepíteni; vagy
   • A Python egyetlen verziója van telepítve.
   • Ha a fenti feltételek bármelyike ​​fennáll, tekintse meg a Python modul telepítése a köteg futtatásával című részt file on.
   • Minden más esetben telepítse a Python modult a pip használatával. Ez általában akkor érvényes, ha:
   • A Python több verziója is telepítve van, de Ön egy adott verzióra szeretné telepíteni; vagy
   • A Python több különböző verziója van telepítve, és mindegyikre telepíteni kívánja (ebben az esetben minden verzióhoz telepítenie kell a modult); vagy
   • A Python egyetlen verziója van telepítve, de Ön nem telepítette a PATH-ra.
   • Ha a fenti feltételek bármelyike ​​fennáll, tekintse meg a Python modul telepítése a pip on futtatásával című részt.

Telepítse a Python modult a köteg futtatásával file Ehhez tegye a következőket:

1. Keresse meg a Python telepítési mappáját: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Kattintson duplán az install_tracker_api.bat fájlra.
   • A telepítési folyamat automatikusan inicializálódik.

Telepítse a Python modult a pip futtatásával

1. Keresse meg a használni kívánt Python Scripts mappáját:
2. Python 3 esetén az alapértelmezett telepítési mappa: C: \Users\ \AppData\Local\Programs\Python\Python \Sc rip
   • Python 2.7 esetén az alapértelmezett telepítési mappa: C:\Python27\Scripts
3. Nyisson meg egy parancsablakot vagy a PowerShellt a mappában.
4. Futtassa a következő parancsot a Vicon Core API telepítéséhez: C: \Felhasználók\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe telepítse „C:\Program” Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Futtassa a következő parancsot a Tracker API C telepítéséhez: \Felhasználók\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe telepítse „C:\Program” Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Jegyzet A fenti plampPython 3.11-es telepítést használ a Tracker 4.0-val. Az útvonal és a parancsok kissé eltérhetnek.

Ellenőrizze, hogy a Python modul megfelelően van-e telepítve

• Ellenőrizze, hogy a következő modulok telepítve vannak-e.
• vicon_core_api: Ez az alapvető távvezérlő API, és egy klienst is tartalmaz a terminálkiszolgálóval való kommunikációhoz.
• tracker_api: Services API a Tracker-specifikus alkalmazásfunkciók eléréséhez.
• A Tracker Python modul helyes telepítésének teszteléséhez próbálja meg importálni az egyik modult a Pythonba: >>> import vicon_core_api

Ha a fenti folyamat nem ismeri fel a modult, próbálkozzon a következővel:

• Ellenőrizze a Python telepítésének site-packages mappájában a tracker_api vagy a vicon_core_api mappát. Python 3.11 esetén az alapértelmezett telepítési mappa helye:
  • C:\Felhasználók\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Ellenőrizze a rendszerkörnyezeti változókat, és győződjön meg arról, hogy a használni kívánt Python-telepítés parancsfájlmappája a legmagasabb a listában. Python 3.11 esetén a telepítési mappa alapértelmezett helye:
  • C:\Felhasználók\ \AppData\Local\Programs\Python\Python311\Scripts
• Ha valamelyik modul mappája hiányzik, és ellenőrizte az elérési utat, futtassa újra a Telepítési folyamatot, amelyet A Tracker Python modul telepítése a következő helyen ismertetett.

Csatlakozzon a terminálkiszolgálóhoz

• A terminálkiszolgálóhoz való csatlakozáshoz először importálja a Vicon Core API modult: >>> import vicon_core_api
  • >>> a vicon_core_api importból
• Ezután hozzon létre egy klienst. Ez automatikusan megpróbál csatlakozni az alapértelmezett porton lévő adott gazdagép címhez (52800) >>> c = Client('localhost')
• Ellenőrizze, hogy az ügyfél sikeresen csatlakozott-e a szerverhez: >>> print(c.connected) Igaz
• Ha a válasz hamis, új kliens létrehozása előtt győződjön meg arról, hogy a Tracker példánya fut a megadott gazdagépcímen, és a tűzfal nem blokkolja az 52800-as port forgalmat.
• Sikeres csatlakozás után hozzáférhet a Tracker terminálszerver által nyújtott szolgáltatásokhoz.
• Ez az exampa le alapvető objektumszolgáltatásokat használ: >>> import tracker_api >>> from tracker_api import BasicObjectServices >>> services = BasicObjectServices(c)
• Ha csatlakoztatva van, metódusokat hívhat meg a Tracker példányon.
  • Plample, a követési panelen lévő objektumok listájának megjelenítéséhez használja: >>> result, object_list = services.basic_object_list() >>> print(result)
  • Rendben: a funkció sikerült
  • >>> nyomtatás (objektumlista)
  • ['Object1', 'Object2'…]
• Minden API-hívás eredménykódot ad vissza, amely a vicon_core_api/result.py webhelyen található.
• Az egyik lehetséges hibakód a Result.RPCNotConnected, amely akkor érkezik meg, ha megszakad a kapcsolat a terminálkiszolgálóval.
• Plample: >>> result, object_list = services.basic_object_list() vicon_core_api.client.RPCEhiba: RPCNotConnected: A távoli függvényhez vagy visszahíváshoz való kapcsolat nincs nyitva
• Az összes elérhető funkció és dokumentáció megjelenítése: >>> help( tracker_api)

Example scripts

• Megtalálhatod plample szkriptek, amelyek a gyakori API-függvények használatát mutatják be C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Minden szkript rendelkezik dokumentációval, és egy –help opcióval rendelkezik, amely részletesen ismerteti a releváns argumentumokat.
• Futni mintample script, nyisson meg egy parancsablakot vagy power shellt a fenti scripts mappában. Ezt kétféleképpen teheti meg:
• Nyissa meg a parancssort, és módosítsa a könyvtárat a scripts mappára: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Tartsa lenyomva a SHIFT + jobb gomb megnyomását a szkriptek mappájában, és válassza a Parancsablak megnyitása itt vagy a Powershell ablak megnyitása itt lehetőséget.
• Innen futtathatja az exampaz Ön által választott forgatókönyvet.
• A következő plamphasználjuk a parancsablakot.

camera_calibration_wave.py

• Ez a szkript bemutatja, hogyan lehet API-függvényeket használni a pálcahullám indításának és leállításának kalibrációs folyamatának vezérlésére.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Ha sikeres, megjelennek a kalibrációs vezérlők

Capture_control.py

• Ez a szkript megmutatja, hogyan rögzíthet élő adatokat C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• A rögzítés neve a vezérlőelemek előtt látható. A rögzítés nevének módosításához használja a Capture_services és a SetCaptureName paramétereket.
• A Tracker API használatával kapcsolatos kérdéseivel forduljon a Vicon Support1-hez.
• 1 levél:support@vicon.com
• Vicon Tracker Python API rövid útmutató, 31. május 2023., 1. változat
• A Tracker 4.0-val való használatra
• © Copyright 2020–2023 Vicon Motion Systems Limited. Minden jog fenntartva.
• 1. verzió. A Tracker 4.0-val való használatra
• A Vicon Motion Systems Limited fenntartja a jogot, hogy előzetes értesítés nélkül módosítsa a jelen dokumentumban szereplő információkat vagy specifikációkat.
• A plampfiktívek, hacsak másképp nem jelezzük. A Vicon Motion Systems Ltd. előzetes írásbeli engedélye nélkül ennek a kiadványnak egyetlen része sem reprodukálható, nem tárolható visszakereső rendszerben, illetve nem továbbítható semmilyen formában és eszközzel, akár elektronikusan, akár mechanikusan, fénymásolással vagy felvétellel, vagy más módon.
• A Vicon® az Oxford Metrics plc bejegyzett védjegye. Vicon Control™, Vicon Lock™, Vicon Lock Lab™, Vicon Lock Studio™, Vicon Tracker™, Vicon Valkyrie™, Vicon Vantage™, Vicon Vero™, Vicon Viper™, Vicon ViperX™ és Vicon Vue™ az Oxford Metrics plc védjegyei.
• A VESA® a VESA bejegyzett védjegye (www.vesa.org/about-vesa/). Az itt található egyéb termék- és cégnevek a megfelelő tulajdonosaik védjegyei lehetnek.
• A teljes és naprakész szerzői jogi és védjegy-elismerésért látogasson el ide https://www.vicon.com/vicon/copyright-information.
• A Vicon Motion Systems egy Oxford Metrics plc.
• Email: support@vicon.com Web: http://www.vicon.com

Dokumentumok / Források

VICON Tracker Python Api [pdf] Felhasználói útmutató Tracker Python Api, Tracker, Python Api, Api

Hivatkozások

• Felhasználói kézikönyv