VICON Tracker Python API

Specifications

• Navê Berhem: Vicon Tracker Python API
• Lihevhatî: Tracker 4.0
• Guhertoyên Python piştgirî kirin: 2.7 û Python 3

Talîmatên Bikaranîna Product

Tracker API-ê saz bikin

Ji bo ku bi Python re Tracker API-ê bikar bînin, van gavan bişopînin:

1. Guhertoya Python-ê kontrol bikin da ku lihevhatinê piştrast bikin.
2. Python bi daxistina wê ji fermî saz bikin webmalperê û guhertoya guncan hilbijêrin.
3. Modula Tracker Python ji peldanka diyarkirî bibînin û saz bikin.

Guhertoya Python kontrol bikin

1. Serlêdanek fermanê vekin.
2. 'py' binivîse û Enter binivîse.
3. Ger Python nehatiye saz kirin, serî li rêwerzên sazkirinê bidin.

Python saz bikin

1. Biçe fermî Python website.
2. Python dakêşin û saz bikin, piştrast bikin ku di dema sazkirinê de python.exe li PATH zêde bikin.

Modula Tracker Python saz bikin:

1. Cihê sazkirinê bibînin files di peldanka diyarkirî de.
2. Rêbaza sazkirinê li gorî sazkirina xwe hilbijêrin.

Modula Python bi Rêvekirina Batchê saz bikin File:

1. Biçe peldanka sazkirinê ya Python: C: Bername FilesViconTracker4.xSDKPython
2. Ji bo destpêkirina pêvajoya sazkirinê du caran li ser 'install_tracker_api.bat' bikirtînin.

Pirsên Pir Pir Pir pirsîn (FAQ):

Pirs: Ez dikarim bi karanîna API-ya Tracker çi bixweber bikim?

• A: Tracker API destûrê dide te ku hûn fonksiyonên hevpar ên wekî barkirin, lîstin, hinardekirina daneyan, çalakkirin / neçalakkirina tiştan, û xistina beşên xebata xebatê otomatîk bikin.

Pirs: Kîjan guhertoyên Python ji hêla Tracker API ve têne piştgirî kirin?

• A: Tracker API guhertoyên Python 2.7 û Python piştgirî dike

Li ser vê rêberê

• Tracker API dihêle hûn hin taybetmendiyên Tracker bi navgîniya Python API-yê kontrol bikin.
• API dihêle hûn hin fonksiyonên hevpar ên Tracker-ê otomatîk bikin, wek barkirin, lîstin, û hinardekirina daneyan, aktîvkirin an neçalakkirina tiştên cihêreng, an vekirina beşên xebata xebatê.
• Vê belgeyê dihêle hûn bi API-a Tracker re dest pê bikin.

Tracker API-ê saz bikin

• Ji bo ku hûn API-a Tracker bi Python-ê re bikar bînin, divê hûn pê ewle bin ku we herdu jî saz kirine.
• Tracker API piştgirî dide Python 2.7 û Python 3. Vicon pêşniyar dike ku hûn serbestberdana tevahî ya herî dawî ya Python 3 bikar bînin heya ku projeya we hewce neke ku hûn guhertoyek taybetî ya Python bikar bînin.

Ev prosedurên we di pêvajoya sazkirinê de rêber dikin:

• Guhertoya Python li ser kontrol bikin
• Sazkirina Python li ser
• Sazkirina modula Tracker Python li ser
• Kontrol bikin ka modula Python rast li ser hatî saz kirin

Guhertoya Python kontrol bikin

• Heke hûn nebawer in ku we Python sazkirî ye an hûn kîjan guhertoya Python bikar tînin, hûn dikarin fermanek fermanê vekin û fermana py bimeşînin.

Ji bo example:

Heke we Python saz nekiribe, binihêrin Python Saz bikin.

Python saz bikin Ji bo sazkirina Python 2 an 3:

1. Biçe  https://www.python.org/downloads/
2. Guhertoya pêwîst bibînin û Python saz bikin, pê ewle bin ku python.exe li PATH-ê were hilbijartin:

Di wêneya jorîn de, ABC ji bo peldanka sazkirinê bi navê bikarhênerê we tê guhertin.

Modula Tracker Python saz bikin Ji bo sazkirina modula Tracker Python:

1. Cihê sazkirinê bibînin files. Ger we Tracker li cîhê xwerû saz kir, ew di vê peldankê de têne dîtin: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Eva files têne xuyang kirin:
2. Modula Tracker Python bi yek ji awayên jêrîn saz bikin, li gorî sazkirina weya taybetî:
   • Riya herî hêsan e ku meriv birêkûpêk bike file (install_tracker_api.bat) ku di sazkirina Trackerê de tê de heye (wekî ku di wêneya jorîn de tê xuyang kirin).
   • Ev bi gelemperî baş dixebite heke:
   • Python li guhêrbar PATH hate saz kirin; an
   • Gelek guhertoyên Python-ê hatine saz kirin, lê hûn dixwazin API-ê li guhertoya herî dawî ya ku we saz kiriye saz bikin; an
   • Tenê guhertoyek yekane ya Python tê saz kirin.
   • Ger yek ji van şertan pêk were, binihêrin Modula python-ê bi xebitandina berhevokê saz bikin file li.
   • Di hemî rewşên din de, bi karanîna pip modula Python saz bikin. Ev bi gelemperî derbas dibe heke:
   • Gelek guhertoyên Python têne saz kirin, lê hûn dixwazin li guhertoyek taybetî saz bikin; an
   • Gelek guhertoyên cihêreng ên Python-ê hatine saz kirin û hûn dixwazin li hemî wan saz bikin (di vê rewşê de, divê hûn ji bo her guhertoyek modulê saz bikin); an
   • Tenê guhertoyek Python-ê hatî saz kirin, lê we li PATH saz nekir.
   • Ger yek ji van şertan derbas bibe, binihêrin Modula Python bi xebitandina pip-ê saz bikin.

Modula Python-ê bi rêvekirina tevlê saz bikin file Ji bo vê yekê bikin:

1. Biçe peldanka sazkirinê ya Python: C: \ Bername Files\Vicon\Tracker4.x\SDK\Python
2. Du caran bikirtînin install_tracker_api.bat.
   • Pêvajoya sazkirinê bixweber dest pê dike.

Modula Python bi xebitandina pip saz bikin

1. Ji bo Python-a ku hûn dixwazin bikar bînin, biçin peldanka Skrîptan:
2. Ji bo Python 3, peldanka sazkirinê ya xwerû ev e: C: \ Bikarhêner\ \ AppData \ Herêmî \ Bername \ Python \ Python \Sc rips
   • Ji bo Python 2.7, peldanka sazkirinê ya xwerû ev e: C:\Python27\Scripts
3. Di wê peldankê de pencereyek fermanê an PowerShell vekin.
4. Ji bo sazkirina Vicon Core API emrê jêrîn bimeşînin: C: \Bikarhêner\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe "C:\Bername" saz bike Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
   • Fermana jêrîn bimeşînin da ku Tracker API C saz bikin: \Bikarhêner\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe "C:\Bername" saz bike Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

Not Berê jorînamples bi Tracker 3.11 re sazkirinek Python 4.0 bikar tînin. Dibe ku rê û fermanên we hinekî cûda bibin.

Kontrol bikin ka modula Python rast hatiye saz kirin

• Kontrol bikin ku modulên jêrîn hatine saz kirin.
• vicon_core_api: Ev API-ya kontrola dûr a bingehîn e û xerîdarek ji bo danûstendina bi servera termînalê re vedihewîne.
• tracker_api: Karûbarên API-ê ji bo gihîştina fonksiyona serîlêdana taybet a Tracker.
• Ji bo ceribandina ku modula Tracker Python rast hatiye saz kirin, biceribînin ku yek ji modulên Python-ê derxînin: >>> import vicon_core_api

Ger pêvajoya jorîn modulê nas neke, jêrîn biceribîne:

• Ji bo peldanka tracker_api an vicon_core_api peldanka malper-pakêtan di sazkirina Python de binihêrin. Ji bo Python 3.11, cîhê peldanka sazkirinê ya xwerû ev e:
  • C:\Bikarhêner\ \ AppData \ Herêmî \ Bername \ Python \ Python311 \ Lib \ pakêtên malperê
• Guherbarên hawîrdora pergala xwe kontrol bikin û pê ewle bibin ku peldanka nivîsarên ji bo sazkirina Python-ê ku hûn dixwazin bikar bînin di navnîşê de herî bilind e. Ji bo Python 3.11, cîhê xwerû ya peldanka sazkirinê ev e:
  • C:\Bikarhêner\ \ AppData \ Herêmî \ Bername \ Python \ Python311 \ Skrîpt
• Ger yek ji peldankên modulan tune be, û we rê verast kir, pêvajoya sazkirinê ya ku di Sazkirina Modula Tracker Python li ser hatî vegotin ji nû ve bimeşînin.

Bi servera termînalê ve girêdin

• Ji bo girêdana bi servera termînalê re, pêşî modula Vicon Core API-ê derxînin: >>> vicon_core_api derxînin
  • >>> ji importa vicon_core_api
• Piştre, xerîdarek çêbikin. Ev bixweber hewl dide ku bi navnîşana mêvandar a taybetî ya li ser porta xwerû ve girêbide (52800) >>> c = Client ('localhost')
• Kontrol bikin ku xerîdar bi serfirazî bi serverê ve girêdayî ye: >>> çapkirin(c.girêdayî) Rast
• Ger bersiv xelet be, berî ku hûn xerîdarek nû biafirînin, pê ewle bin ku we mînakek Tracker li navnîşana mêvandar a diyarkirî dimeşîne û dîwarê weya agir seyrûsefera port 52800 asteng nake.
• Dema ku we bi serfirazî ve girêdayî ye, hûn dikarin bigihîjin karûbarên ku ji hêla servera termînalê Tracker ve têne peyda kirin.
• Ev example karûbarên tiştên bingehîn bikar tîne: >>> tracker_api derxe >>> ji tracker_api import BasicObjectServices >>> karûbar = BasicObjectServices(c)
• Dema ku ew ve girêdayî ye, hûn dikarin rêbazên li ser mînaka Tracker bang bikin.
  • Ji bo example, ji bo bidestxistina navnîşek tiştan di panela Şopandinê de, bikar bînin: >>> encam, lîsteya_object = services.basic_object_list() >>> çapkirin(encam)
  • Ok: fonksiyon bi ser ket
  • >>> çapkirin (lîsteya_object)
  • ['Object1', 'Object2'…]
• Hemî bangên API-ê kodek encam vedigerînin, ku di vicon_core_api/result.py de tê vegotin.
• Yek kodek têkçûna gengaz Result.RPCNotConnected e, ku heke girêdana bi servera termînalê winda bibe tê wergirtin.
• Ji bo example: >>> encam, lîsteya_object = services.basic_object_list() vicon_core_api.client.RPCEçewtî: RPCNotConnected: Girêdana bi fonksiyona dûr an vegerandina bangê ne vekirî ye
• Ji bo nîşankirina navnîşek hemî fonksiyon û belgeyên berdest: >>> alîkarî( tracker_api)

Example scripts

• Hûn dikarin ex-ê bibîninample skrîptên ku karanîna fonksiyonên hevpar ên API-ê li ser destnîşan dikin C: \ Bername Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Hemî nivîsan belge hene û vebijarkek -alîkariyê digirin ku hûrguliyên argumanên têkildar dide.
• To run wekample skrîptê de, di peldanka nivîsarên li jor de pencereyek fermanê an şêlê hêzê vekin. Hûn dikarin vê yekê bi yek ji du awayan bikin:
• Serlêdana fermanê vekin û peldanka xwe biguherînin peldanka skrîptê: c:\> cd C:\Bername Files\Vicon\Tracker
  • 4.0 \ SDK \ Python \ sample_scripts
• Di peldanka skrîptan de SHIFT-ya rast bikirtînin û li vir pencereya fermanê vekin an li vir pencereya Powershell vekin hilbijêrin.
• Ji vir hûn dikarin berê birevinample script ji hilbijartina xwe.
• Berê jêrînamples pencereya fermanê bikar bînin.

camera_calibration_wave.py

• Ev skrîpt destnîşan dike ka meriv çawa fonksiyonên API-ê bikar tîne da ku pêvajoya kalibrasyonê ya destpêkirin û rawestandina pêla wand kontrol bike.
  • C: \ Bername Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Ger serketî be, kontrolên kalibrasyonê têne xuyang kirin

capture_control.py

• Ev skrîpt nîşan dide ka meriv çawa daneyên zindî C:\Bername digire Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Navê Capture berî kontrolê tête navnîş kirin. Ji bo guhertina navê girtinê, capture_services û SetCaptureName bikar bînin.
• Ji bo pirsên li ser karanîna Tracker API, bi Vicon Support1 re têkilî daynin.
• 1 mailto:support@vicon.com
• Vicon Tracker Python API Rêbernameya Destpêka Zû 31 Gulan 2023, Guhertoya 1
• Ji bo karanîna bi Tracker 4.0 re
• © Copyright 2020–2023 Vicon Motion Systems Limited. Hemû maf parastî ne.
• Guhertoya 1. Ji bo karanîna bi Tracker 4.0
• Vicon Motion Systems Limited mafê guherandina agahdarî an taybetmendiyên di vê belgeyê de bêyî agahdarkirinê parastî ye.
• Pargîdanî, nav û daneyên ku di berê de têne bikar anînamples xeyalî ne heya ku wekî din neyê destnîşan kirin. Nabe ku tu beşek ji vê weşanê bête hilberandin, di pergalek vegerandinê de were hilanîn, an bi rengekî an rêgezek, elektronîkî an mekanîkî, bi fotokopîkirin an tomarkirin, an wekî din bêyî destûra nivîskî ya berê ya Vicon Motion Systems Ltd.
• Vicon® marqeyek qeydkirî ya Oxford Metrics plc ye. Vicon Control™, Vicon Lock™, Vicon Lock Lab™, Vicon Lock Studio™, Vicon Tracker™, Vicon Valkyrie™, Vicon Vantage™, Vicon Vero™, Vicon Viper™, Vicon ViperX™ û Vicon Vue™ marqeyên Oxford Metrics plc ne.
• VESA® marqeyek qeydkirî ye ku xwediyê VESA ye (www.vesa.org/about-vesa/). Navên hilber û pargîdaniyên din ên li vir dibe ku marqeyên xwediyên wan ên têkildar bin.
• Ji bo pejirandinên tam û nûjen ên mafnasî û nîşana bazirganî, biçin https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems pargîdaniyek Oxford Metrics plc ye.
• Email: support@vicon.com Web: http://www.vicon.com

Belge / Çavkanî

VICON Tracker Python Api [pdf] Rehbera bikaranînê Tracker Python Api, Tracker, Python Api, Api

Çavkanî

• Manual Bikarhêner