VICON Tracker Python API

Speċifikazzjonijiet

• Isem tal-Prodott: Vicon Tracker Python API
• Kompatibilità: Tracker 4.0
• Verżjonijiet ta' Python appoġġjati: 2.7 u Python 3

Istruzzjonijiet għall-Użu tal-Prodott

Installa l-API Tracker

Biex tuża l-API Tracker ma' Python, segwi dawn il-passi:

1. Iċċekkja l-verżjoni Python biex tiżgura l-kompatibilità.
2. Installa Python billi tniżżlu mill-uffiċjal websit u tagħżel il-verżjoni xierqa.
3. Sib u installa l-modulu Tracker Python mill-folder speċifikat.

Iċċekkja l-Verżjoni Python

1. Iftaħ pront tal-kmand.
2. Ittajpja 'py' u agħfas Enter.
3. Jekk Python mhux installat, irreferi għall-istruzzjonijiet tal-installazzjoni.

Installa Python

1. Mur fuq Uffiċjal ta' Python websit.
2. Niżżel u installa Python, filwaqt li tiżgura li żżid python.exe ma' PATH waqt l-installazzjoni.

Installa l-Modulu Tracker Python:

1. Sib l-installazzjoni files fil-folder speċifikat.
2. Agħżel il-metodu ta 'installazzjoni bbażat fuq is-setup tiegħek.

Installa l-Modulu Python billi Tmexxi l-Lott File:

1. Innaviga lejn il-folder tal-installazzjoni Python: C: Programm FilesViconTracker4.xSDKPython
2. Ikklikkja darbtejn fuq 'install_tracker_api.bat' biex tibda l-proċess ta' installazzjoni.

Mistoqsijiet Frekwenti (FAQ):

Q: X'nista 'awtomatizza bl-użu tal-API Tracker?

• A: L-API Tracker jippermettilek awtomat funzjonijiet komuni bħat-tagħbija, il-logħob, l-esportazzjoni tad-dejta, l-attivazzjoni/diżattivazzjoni tal-oġġetti, u l-iskattar tal-partijiet tal-fluss tax-xogħol.

Q: Liema verżjonijiet Python huma appoġġjati mill-API Tracker?

• A: L-API Tracker tappoġġja l-verżjonijiet Python 2.7 u Python

Dwar din il-gwida

• L-API Tracker iħallik tikkontrolla ċerti karatteristiċi ta 'Tracker permezz ta' API Python.
• L-API tgħinek awtomatizza xi funzjonijiet komuni ta' Tracker, bħal tagħbija, tilgħab, u tesporta dejta, tattiva jew diżattivazzjoni ta' oġġetti differenti, jew tiskatta partijiet tal-fluss tax-xogħol.
• Dan id-dokument jippermettilek tibda bl-API Tracker.

Installa l-API Tracker

• Biex tuża l-API Tracker ma 'Python, trid tiżgura li għandek it-tnejn installati.
• L-API Tracker tipprovdi appoġġ għal Python 2.7 u Python 3. Vicon jirrakkomanda li tuża l-aħħar rilaxx sħiħ ta 'Python 3 sakemm il-proġett tiegħek ma jeħtieġx li tuża verżjoni speċifika ta' Python.

Dawn il-proċeduri jiggwidak matul il-proċess ta 'installazzjoni:

• Iċċekkja l-verżjoni Python fuq
• Installazzjoni ta 'Python fuq
• Installazzjoni tal-modulu Tracker Python fuq
• Iċċekkja li l-modulu Python huwa installat sew fuq

Iċċekkja l-verżjoni Python

• Jekk m'intix ċert jekk għandekx Python installat jew liema verżjoni ta 'Python qed tuża, tista' tiftaħ pront tal-kmand u tħaddem il-kmand py.

Per example:

Jekk ma jkollokx Python installat, ara Installa Python.

Installa Python Biex tinstalla Python 2 jew 3:

1. Mur fuq  https://www.python.org/downloads/
2. Sib il-verżjoni meħtieġa u installa Python, filwaqt li tiżgura li jintgħażel Żid python.exe mal-PATH:

Fl-immaġni ta 'hawn fuq, ABC huwa sostitwit bl-isem tal-utent tiegħek għall-folder tal-installazzjoni.

Installa l-modulu Tracker Python Biex tinstalla l-modulu Tracker Python:

1. Sib l-installazzjoni files. Jekk installajt Tracker fil-post default, jinsabu f'dan il-folder: C:\Programm Files\Vicon\Tracker4.x\SDK\Python
   • Dawn files jintwerew:
2. Installa l-modulu Tracker Python b'wieħed mill-modi li ġejjin, skont l-installazzjoni partikolari tiegħek:
   • L-aktar mod sempliċi huwa li tmexxi l-lott file (install_tracker_api.bat) li hija inkluża fl-installazzjoni tat-Tracker (kif muri fl-immaġni ta 'hawn fuq).
   • Dan normalment jaħdem tajjeb jekk:
   • Python ġie installat għall-varjabbli PATH; jew
   • Verżjonijiet multipli ta 'Python huma installati, iżda trid tinstalla l-API għall-aħħar verżjoni li installajt; jew
   • Verżjoni waħda biss ta 'Python hija installata.
   • Jekk tapplika xi waħda minn dawn il-kundizzjonijiet, ara Installa l-modulu python billi tħaddem il-lott file fuq.
   • Fil-każijiet l-oħra kollha, installa l-modulu Python billi tuża pip. Dan normalment japplika jekk:
   • Verżjonijiet multipli ta 'Python huma installati, iżda trid tinstalla għal verżjoni speċifika; jew
   • Verżjonijiet differenti multipli ta 'Python huma installati u trid tinstallahom kollha (f'dan il-każ, trid tinstalla l-modulu għal kull verżjoni); jew
   • Verżjoni waħda biss ta 'Python hija installata, imma int ma installajtx għal PATH.
   • Jekk tapplika xi waħda minn dawn il-kundizzjonijiet, ara Installa l-modulu Python billi tħaddem pip fuq.

Installa l-modulu Python billi tħaddem il-lott file Biex tagħmel dan:

1. Innaviga lejn il-folder tal-installazzjoni Python: C:\Programm Files\Vicon\Tracker4.x\SDK\Python
2. Ikklikkja darbtejn install_tracker_api.bat.
   • Il-proċess ta 'installazzjoni jinizjalizza awtomatikament.

Installa l-modulu Python billi tħaddem il-pip

1. Innaviga fil-folder tal-Scripts għall-Python li trid tuża:
2. Għal Python 3, il-folder tal-installazzjoni default huwa: C: \Utenti\ \AppData\Local\Programmi\Python\Python \Sc rips
   • Għal Python 2.7, il-folder tal-installazzjoni default huwa: C:\Python27\Scripts
3. Iftaħ tieqa tal-kmand jew PowerShell f'dak il-folder.
4. Mexxi l-kmand li ġej biex tinstalla l-API Core Vicon: C: \Utenti\ \AppData\Local\Programmi\Python\Python311\Scrip ts> .\pip.exe install “C:\Programm Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Mexxi l-kmand li ġej biex tinstalla t-Tracker API C: \Utenti\ \AppData\Local\Programmi\Python\Python311\Scrip ts> .\pip.exe install “C:\Programm Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Nota L-eżamples jużaw installazzjoni ta' Python 3.11 ma' Tracker 4.0. It-triq u l-kmandi tiegħek jistgħu jvarjaw xi ftit.

Iċċekkja li l-modulu Python huwa installat sew

• Iċċekkja li l-moduli li ġejjin ġew installati.
• vicon_core_api: Din hija l-API tal-kontroll mill-bogħod tal-qalba u tinkludi klijent għall-komunikazzjoni mas-server tat-terminal.
• tracker_api: Servizzi API għall-aċċess għall-funzjonalità tal-applikazzjoni speċifika għal Tracker.
• Biex tittestja li l-modulu Tracker Python huwa installat b'mod korrett, ipprova jimporta wieħed mill-moduli f'Python: >>> import vicon_core_api

Jekk il-proċess ta 'hawn fuq jonqos milli jagħraf il-modulu, ipprova dan li ġej:

• Iċċekkja l-folder tal-pakketti tas-sit fl-installazzjoni Python għall-folder tracker_api jew vicon_core_api. Għal Python 3.11, il-post tal-folder tal-installazzjoni default huwa:
  • C:\Utenti\ \AppData\Local\Programmi\Python\Python311\Lib\site-packages
• Iċċekkja l-varjabbli tal-ambjent tas-sistema tiegħek u kun żgur li l-folder tal-iskripts għall-installazzjoni Python li trid tuża huwa l-ogħla fil-lista. Għal Python 3.11, il-post default tal-folder tal-installazzjoni huwa:
  • C:\Utenti\ \AppData\Local\Programmi\Python\Python311\Scripts
• Jekk xi waħda mill-folders tal-moduli tkun nieqsa, u ivverifikajt il-mogħdija, erġa' wettaq il-proċess ta' installazzjoni deskritt fl-Installazzjoni tal-modulu Tracker Python fuq.

Qabbad mas-server tat-terminal

• Biex tikkonnettja mas-server tat-terminal, l-ewwel importa l-modulu Vicon Core API: >>> importa vicon_core_api
  • >>> mill-importazzjoni vicon_core_api
• Sussegwentement, oħloq klijent. Dan awtomatikament jipprova jgħaqqad mal-indirizz tal-host speċifiku fuq il-port default (52800) >>> c = Client('localhost')
• Iċċekkja li l-klijent konness b'suċċess mas-server: >>> print(c.connected) Veru
• Jekk ir-rispons huwa Falz, kun żgur li għandek istanza ta' Tracker taħdem fl-indirizz tal-host speċifikat u l-firewall tiegħek mhux qed jimblokka t-traffiku fuq il-port 52800, qabel ma toħloq klijent ġdid.
• Meta tkun ikkonnettja b'suċċess, tista' taċċessa s-servizzi pprovduti mis-server tat-terminal Tracker.
• Dan example tuża servizzi bażiċi ta' oġġetti: >>> importazzjoni tracker_api >>> minn tracker_api importazzjoni BasicObjectServices >>> services = BasicObjectServices(c)
• Meta tkun konnessa, tista' ċċempel metodi fuq l-istanza Tracker.
  • Per example, biex tikseb lista ta 'oġġetti fil-pannell tat-Traċċar, uża: >>> result, object_list = services.basic_object_list () >>> print (result)
  • Ok: il-funzjoni rnexxielha
  • >>> print(lista_oġġetti)
  • ['Oġġett1', 'Oġġett2'...]
• Is-sejħiet kollha tal-API jirritornaw kodiċi tar-riżultat, li huwa deskritt f'vicon_core_api/result.py.
• Kodiċi ta' falliment possibbli wieħed huwa Result.RPCNotConnected, li jiġi riċevut jekk tintilef il-konnessjoni mas-server tat-terminal.
• Per example: >>> riżultat, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: Il-konnessjoni mal-funzjoni remota jew callback mhix miftuħa
• Biex turi lista tal-funzjonijiet u d-dokumentazzjoni kollha disponibbli: >>> help( tracker_api)

Example skripts

• Tista' ssib example skripts li juru l-użu ta 'funzjonijiet API komuni fuq C:\Programm Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• L-iskripts kollha għandhom dokumentazzjoni u jieħdu għażla –help li tagħti dettalji tal-argumenti rilevanti.
• Biex tmexxi bħalaample script, iftaħ tieqa tal-kmand jew qoxra tal-qawwa fil-folder tal-iskripts hawn fuq. Tista 'tagħmel dan f'wieħed minn żewġ modi:
• Iftaħ il-pront tal-kmand u ibdel id-direttorju tiegħek fil-folder tal-iskripts: c:\> cd C:\Programm Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Żomm SHIFT+ikklikkja bil-lemin fil-folder tal-iskripts u agħżel Iftaħ tieqa tal-kmand hawn jew Open Powershell tieqa hawn.
• Minn hawn tista 'tmexxi l-example script tal-għażla tiegħek.
• L-eżamples jużaw it-tieqa tal-kmand.

camera_calibration_wave.py

• Din l-iskrittura turi kif tuża l-funzjonijiet API biex tikkontrolla l-proċess ta 'kalibrazzjoni tal-bidu u t-twaqqif tal-mewġ tal-bastun.
  • C:\Programm Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Jekk jirnexxi, jintwerew il-kontrolli tal-kalibrazzjoni

capture_control.py

• Din l-iskrittura turi kif taqbad data diretta C:\Programm Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• L-isem tal-Qbid huwa elenkat qabel il-kontrolli. Biex tibdel l-isem tal-qbid, uża capture_services u SetCaptureName.
• Għal mistoqsijiet dwar l-użu tal-API Tracker, ikkuntattja lill-Appoġġ ta' Vicon1.
• 1 mailto:support@vicon.com
• Vicon Tracker Python API Quick Start Guide 31 ta' Mejju 2023, Reviżjoni 1
• Għall-użu ma' Tracker 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Id-drittijiet kollha riżervati.
• Reviżjoni 1. Għall-użu ma' Tracker 4.0
• Vicon Motion Systems Limited tirriżerva d-dritt li tagħmel bidliet fl-informazzjoni jew l-ispeċifikazzjonijiet f’dan id-dokument mingħajr avviż.
• Kumpaniji, ismijiet, u data użati fl-eżamples huma fittizji sakemm ma jkunx innutat mod ieħor. L-ebda parti minn din il-pubblikazzjoni ma tista’ tiġi riprodotta, maħżuna f’sistema ta’ rkupru, jew trażmessa fi kwalunkwe forma jew bi kwalunkwe mezz, elettroniku jew mekkaniku, permezz ta’ fotokopji jew reġistrazzjoni, jew mod ieħor mingħajr il-permess bil-miktub minn qabel ta’ Vicon Motion Systems Ltd.
• Vicon® hija trademark reġistrata ta' 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™ u Vicon Vue™ huma trademarks ta' Oxford Metrics plc.
• VESA® hija trademark reġistrata proprjetà ta' VESA (www.vesa.org/about-vesa/). Ismijiet oħra ta' prodotti u kumpaniji hawnhekk jistgħu jkunu trademarks tas-sidien rispettivi tagħhom.
• Għal rikonoxximenti sħaħ u aġġornati tad-drittijiet tal-awtur u trademarks, żur https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems hija kumpanija Oxford Metrics plc.
• Email: support@vicon.com Web: http://www.vicon.com

Dokumenti / Riżorsi

VICON Tracker Python Api [pdfGwida għall-Utent Tracker Python Api, Tracker, Python Api, Api

Referenzi

• Manwal għall-Utent