VICON Tracker Python API

Mga detalye

• Ngalan sa Produkto: Vicon Tracker Python API
• Pagkaangay: Tracker 4.0
• Gisuportahan nga Mga Bersyon sa Python: 2.7 ug Python 3

Mga Instruksyon sa Paggamit sa Produkto

I-install ang Tracker API

Aron magamit ang Tracker API sa Python, sunda kini nga mga lakang:

1. Susiha ang bersyon sa Python aron masiguro ang pagkaangay.
2. I-install ang Python pinaagi sa pag-download niini gikan sa opisyal website ug pagpili sa angay nga bersyon.
3. Pangitaa ug i-install ang Tracker Python module gikan sa piho nga folder.

Susiha ang Bersyon sa Python

1. Ablihi ang usa ka command prompt.
2. I-type ang 'py' ug pindota ang Enter.
3. Kung wala ma-install ang Python, tan-awa ang mga panudlo sa pag-install.

I-install ang Python

1. Adto sa Opisyal sa Python website.
2. Pag-download ug pag-install sa Python, pagsiguro nga idugang ang python.exe sa PATH sa panahon sa pag-install.

I-install ang Tracker Python Module:

1. Pangitaa ang instalasyon files sa gipiho nga folder.
2. Pilia ang pamaagi sa pag-install base sa imong setup.

I-install ang Python Module pinaagi sa Pagdagan sa Batch File:

1. Pagdala ngadto sa Python install folder: C: Program FilesViconTracker4.xSDKPython
2. Dobleng pag-klik sa 'install_tracker_api.bat' aron masugdan ang proseso sa pag-instalar.

Kanunay nga Gipangutana nga mga Pangutana (FAQ):

P: Unsa ang akong mahimo nga awtomatiko gamit ang Tracker API?

• A: Ang Tracker API nagtugot kanimo sa pag-automate sa komon nga mga gimbuhaton sama sa pagkarga, pagdula, pag-eksport sa datos, pagpaaktibo/pag-deactivate sa mga butang, ug pag-trigger sa mga parte sa workflow.

P: Unsang mga bersyon sa Python ang gisuportahan sa Tracker API?

• A: Ang Tracker API nagsuporta sa Python nga bersyon 2.7 ug Python

Mahitungod niini nga giya

• Gitugotan ka sa Tracker API nga makontrol ang pipila nga mga bahin sa Tracker pinaagi sa usa ka Python API.
• Gitugotan ka sa API nga ma-automate ang pipila ka sagad nga mga gimbuhaton sa Tracker, sama sa pagkarga, pagdula, ug pag-eksport sa datos, pag-aktibo o pag-deactivate sa lainlaing mga butang, o pag-trigger sa mga bahin sa dagan sa trabaho.
• Kini nga dokumento makapahimo kanimo sa pagsugod sa Tracker API.

I-install ang Tracker API

• Aron magamit ang Tracker API sa Python, kinahanglan nimong sigurohon nga pareho nimo nga na-install.
• Ang Tracker API naghatag og suporta alang sa Python 2.7 ug Python 3. Girekomenda ni Vicon nga imong gamiton ang pinakabag-o nga hingpit nga pagpagawas sa Python 3 gawas kung ang imong proyekto nagkinahanglan kanimo sa paggamit sa usa ka piho nga bersyon sa Python.

Kini nga mga pamaagi naggiya kanimo sa proseso sa pag-install:

• Susiha ang bersyon sa Python sa
• Pag-instalar sa Python sa
• Pag-instalar sa Tracker Python module sa
• Susiha nga ang Python module na-install sa husto

Susiha ang bersyon sa Python

• Kung dili ka sigurado kung na-install nimo ang Python o kung unsang bersyon sa Python ang imong gigamit, mahimo nimong ablihan ang command prompt ug ipadagan ang py command.

Kay example:

Kung wala kay na-install nga Python, tan-awa ang Install Python.

I-install ang Python Aron i-install ang Python 2 o 3:

1. Adto sa  https://www.python.org/downloads/
2. Pangitaa ang gikinahanglan nga bersyon ug i-install ang Python, pagsiguro nga ang Add python.exe sa PATH gipili:

Sa imahe sa ibabaw, ang ABC gipulihan sa imong username alang sa folder sa pag-install.

I-install ang Tracker Python module Aron ma-install ang Tracker Python module:

1. Pangitaa ang instalasyon files. Kung imong gi-install ang Tracker sa default nga lokasyon, kini makita sa kini nga folder: C: \ Program Files\Vicon\Tracker4.x\SDK\Python
   • Kini files gipakita:
2. I-install ang Tracker Python module sa bisan hain sa mosunod nga mga paagi, depende sa imong partikular nga pag-instalar:
   • Ang pinakasimple nga paagi mao ang pagpadagan sa batch file (install_tracker_api.bat) nga gilakip sa instalasyon sa Tracker (sama sa gipakita sa hulagway sa ibabaw).
   • Kasagaran kini molihok kung:
   • Ang Python gi-install sa PATH variable; o
   • Daghang mga bersyon sa Python ang na-install, apan gusto nimo nga i-install ang API sa pinakabag-o nga bersyon nga imong gi-install; o
   • Usa ra ka bersyon sa Python ang na-install.
   • Kung adunay bisan unsang mga kondisyon nga magamit, tan-awa ang Pag-install sa module sa python pinaagi sa pagpadagan sa batch file sa.
   • Sa tanan nga uban nga mga kaso, i-install ang Python module pinaagi sa paggamit sa pip. Kasagaran kini magamit kung:
   • Daghang mga bersyon sa Python ang gi-install, apan gusto nimo i-install sa usa ka piho nga bersyon; o
   • Daghang lainlain nga bersyon sa Python ang na-install ug gusto nimo i-install sa tanan niini (sa kini nga kaso, kinahanglan nimo nga i-install ang module alang sa matag bersyon); o
   • Usa ra ka bersyon sa Python ang na-install, apan wala nimo gi-install sa PATH.
   • Kung adunay bisan unsang mga kondisyon nga magamit, tan-awa ang Pag-install sa module sa Python pinaagi sa pagpadagan sa pip.

I-install ang Python module pinaagi sa pagpadagan sa batch file Sa pagbuhat niini:

1. Pagdala ngadto sa Python install folder: C:\Programa Files\Vicon\Tracker4.x\SDK\Python
2. Doble nga pag-klik install_tracker_api.bat.
   • Ang proseso sa pag-install awtomatikong magsugod.

I-install ang Python module pinaagi sa pagpadagan sa pip

1. Pagdala ngadto sa Scripts folder alang sa Python nga gusto nimong gamiton:
2. Alang sa Python 3, ang default nga folder sa pag-install mao ang: C: \ Users \ \AppData\Local\Programs\Python\Python \Sc gisi
   • Alang sa Python 2.7, ang default nga folder sa pag-install mao ang: C:\Python27\Scripts
3. Ablihi ang command window o PowerShell sa maong folder.
4. Pagdalagan ang mosunod nga sugo aron i-install ang Vicon Core API: C: \Mga Gumagamit\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe i-install ang "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
   • Pagdalagan ang mosunod nga sugo aron i-install ang Tracker API C: \Mga Gumagamit\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe i-install ang "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

Nota Ang labaw sa exampGigamit nila ang pag-install sa Python 3.11 nga adunay Tracker 4.0. Ang imong dalan ug mga sugo mahimong magkalahi og gamay.

Susiha nga ang Python module na-install sa husto

• Susiha nga ang mosunod nga mga module na-install.
• vicon_core_api: Kini ang kinauyokan nga remote control API ug naglakip sa usa ka kliyente alang sa komunikasyon sa terminal server.
• tracker_api: Services API para sa pag-access sa Tracker-specific application functionality.
• Aron masulayan nga ang Tracker Python module na-install sa husto, sulayi ang pag-import sa usa sa mga module sa Python: >>> import vicon_core_api

Kung ang proseso sa ibabaw mapakyas sa pag-ila sa module, sulayi ang mosunod:

• Susiha ang site-packages folder sa Python installation para sa tracker_api o vicon_core_api folder. Alang sa Python 3.11, ang lokasyon sa default nga folder sa pag-install mao ang:
  • C:\Users\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Susiha ang imong system environment variables ug siguroha nga ang scripts folder para sa Python installation nga gusto nimong gamiton mao ang pinakataas sa listahan. Alang sa Python 3.11, ang default nga lokasyon sa folder sa pag-install mao ang:
  • C:\Users\ \AppData\Local\Programs\Python\Python311\Scripts
• Kung nawala ang bisan hain sa mga folder sa mga module, ug imong napamatud-an ang agianan, balik-balik ang proseso sa pag-install nga gihulagway sa Pag-install sa Tracker Python module sa.

Sumpaysumpaya ang terminal server

• Aron makonektar sa terminal server, i-import una ang Vicon Core API module: >>> import vicon_core_api
  • >>> gikan sa vicon_core_api import
• Sunod, paghimo usa ka kliyente. Kini awtomatik nga mosulay sa pagkonektar sa piho nga host address sa default port (52800) >>> c = Client('localhost')
• Susiha nga ang kliyente malampuson nga konektado sa server: >>> print(c.connected) Tinuod
• Kung ang tubag usa ka Bakak, siguroha nga ikaw adunay usa ka pananglitan sa Tracker nga nagdagan sa gitakda nga adres sa host ug ang imong firewall wala makababag sa trapiko sa port 52800, sa dili pa maghimo og bag-ong kliyente.
• Kung malampuson ka nga nakakonekta, mahimo nimong ma-access ang mga serbisyo nga gihatag sa Tracker terminal server.
• Kini nga exampGigamit ni le ang batakang serbisyo sa butang: >>> import tracker_api >>> gikan sa tracker_api import BasicObjectServices >>> serbisyo = BasicObjectServices(c)
• Kung kini konektado, mahimo nimong tawagan ang mga pamaagi sa pananglitan sa Tracker.
  • Kay example, aron makakuha og lista sa mga butang sa Tracking panel, gamita ang: >>> resulta, object_list = services.basic_object_list() >>> print(resulta)
  • ok: milampos ang function
  • >>> print(lista_butang)
  • ['Object1', 'Object2'…]
• Ang tanan nga mga tawag sa API nagbalik usa ka code sa resulta, nga gihulagway sa vicon_core_api/result.py.
• Usa ka posible nga code sa kapakyasan mao ang Result.RPCNotConnected, nga madawat kung nawala ang koneksyon sa terminal server.
• Kay example: >>> resulta, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: Ang koneksyon sa remote function o callback dili bukas
• Aron ipakita ang usa ka lista sa tanan nga magamit nga mga gimbuhaton ug dokumentasyon: >>> tabang( tracker_api)

Exampmga script

• Makita nimo si example mga script nga nagpakita sa paggamit sa komon nga API function sa C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Ang tanan nga mga script adunay dokumentasyon ug pagkuha usa ka -help nga kapilian nga naghatag mga detalye sa may kalabutan nga mga argumento.
• Sa pagdagan ingonampsa script, ablihi ang command window o power shell sa mga script sa ibabaw. Mahimo nimo kini sa usa sa duha ka paagi:
• Ablihi ang command prompt ug usba ang imong direktoryo sa folder sa mga script: c:\> cd C:\Programa Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Hupti ang SHIFT+right-click sa folder sa mga script ug pilia ang Open command window dinhi o Open Powershell window dinhi.
• Gikan dinhi mahimo nimong padagan ang exampang script nga imong gipili.
• Ang mosunod nga examples gamiton ang command window.

camera_calibration_wave.py

• Gipakita niini nga script kung giunsa paggamit ang mga function sa API aron makontrol ang proseso sa pagkakalibrate sa pagsugod ug paghunong sa wand wave.
  • C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Kung malampuson, ang mga kontrol sa pagkakalibrate gipakita

capture_control.py

• Kini nga script nagpakita kung giunsa pagkuha ang live data C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Ang Capture ngalan gilista sa atubangan sa mga kontrol. Aron mausab ang ngalan sa pagkuha, gamita ang capture_services ug SetCaptureName.
• Para sa mga pangutana sa paggamit sa Tracker API, kontaka ang Vicon Support1.
• 1 mailto:support@vicon.com
• Vicon Tracker Python API Quick Start Guide 31 Mayo 2023, Rebisyon 1
• Alang sa paggamit sa Tracker 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Tanang katungod gigahin.
• Rebisyon 1. Para gamiton sa Tracker 4.0
• Ang Vicon Motion Systems Limited adunay katungod sa paghimo og mga pagbag-o sa impormasyon o mga detalye niini nga dokumento nga walay pahibalo.
• Mga kompanya, ngalan, ug datos nga gigamit sa exampAng mga les kay tinumotumo lang gawas kon mamatikdan. Walay bahin niini nga publikasyon ang mahimong kopyahon, tipigan sa usa ka sistema sa pagkuha, o ipasa sa bisan unsang porma o sa bisan unsang paagi, elektroniko o mekanikal, pinaagi sa pag-photocopy o pagrekord, o sa laing paagi nga walay sinulat nga pagtugot sa Vicon Motion Systems Ltd.
• Ang Vicon® kay rehistrado nga marka sa 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™ ug Vicon Vue™ maoy mga marka sa pamatigayon sa Oxford Metrics plc.
• Ang VESA® usa ka rehistradong marka sa pamatigayon nga gipanag-iya sa VESA (www.vesa.org/about-vesa/). Ang ubang mga produkto ug mga ngalan sa kompanya dinhi mahimong mga marka sa pamatigayon sa ilang mga tag-iya.
• Para sa bug-os ug pinakabag-o nga copyright ug trademark nga pag-ila, bisitaha https://www.vicon.com/vicon/copyright-information.
• Ang Vicon Motion Systems usa ka kompanya sa Oxford Metrics plc.
• Email: support@vicon.com Web: http://www.vicon.com

Mga Dokumento / Mga Kapanguhaan

VICON Tracker Python Api [pdf] Giya sa Gumagamit Tracker Python Api, Tracker, Python Api, Api

Mga pakisayran

• Manwal sa Gumagamit