API Python Penjejak VICON

Spesifikasi

• Nama Produk: Vicon Tracker Python API
• Keserasian: Penjejak 4.0
• Versi Python yang Disokong: 2.7 dan Python 3

Arahan Penggunaan Produk

Pasang API Penjejak

Untuk menggunakan API Tracker dengan Python, ikuti langkah berikut:

1. Semak versi Python untuk memastikan keserasian.
2. Pasang Python dengan memuat turunnya daripada rasmi webtapak dan memilih versi yang sesuai.
3. Cari dan pasang modul Tracker Python dari folder yang ditentukan.

Semak Versi Python

1. Buka gesaan arahan.
2. Taip 'py' dan tekan Enter.
3. Jika Python tidak dipasang, rujuk arahan pemasangan.

Pasang Python

1. Pergi ke rasmi Python webtapak.
2. Muat turun dan pasang Python, pastikan anda menambah python.exe ke PATH semasa pemasangan.

Pasang Modul Tracker Python:

1. Cari pemasangan files dalam folder yang ditentukan.
2. Pilih kaedah pemasangan berdasarkan persediaan anda.

Pasang Modul Python dengan Menjalankan Kumpulan File:

1. Navigasi ke folder pemasangan Python: C: Program FilesViconTracker4.xSDKPython
2. Klik dua kali pada 'install_tracker_api.bat' untuk memulakan proses pemasangan.

Soalan Lazim (FAQ):

S: Apakah yang boleh saya automasi menggunakan API Penjejak?

• A: API Penjejak membolehkan anda mengautomasikan fungsi biasa seperti memuatkan, memainkan, mengeksport data, mengaktifkan/menyahaktifkan objek dan mencetuskan bahagian aliran kerja.

S: Versi Python manakah yang disokong oleh API Penjejak?

• A: API Tracker menyokong versi Python 2.7 dan Python

Mengenai panduan ini

• API Tracker membolehkan anda mengawal ciri tertentu Tracker melalui API Python.
• API membolehkan anda mengautomasikan beberapa fungsi biasa Tracker, seperti memuatkan, memainkan dan mengeksport data, mengaktifkan atau menyahaktifkan objek yang berbeza, atau mencetuskan bahagian aliran kerja.
• Dokumen ini membolehkan anda bermula dengan API Penjejak.

Pasang API Penjejak

• Untuk menggunakan API Tracker dengan Python, anda mesti memastikan bahawa anda telah memasang kedua-duanya.
• API Penjejak menyediakan sokongan untuk Python 2.7 dan Python 3. Vicon mengesyorkan agar anda menggunakan keluaran penuh Python 3 terbaharu melainkan projek anda memerlukan anda menggunakan versi Python tertentu.

Prosedur ini membimbing anda melalui proses pemasangan:

• Semak versi Python pada
• Memasang Python pada
• Memasang modul Tracker Python dihidupkan
• Semak sama ada modul Python dipasang dengan betul

Semak versi Python

• Jika anda tidak pasti sama ada anda telah memasang Python atau versi Python yang anda gunakan, anda boleh membuka gesaan arahan dan menjalankan arahan py.

Untuk example:

Jika anda tidak memasang Python, lihat Pasang Python.

Pasang Python Untuk memasang Python 2 atau 3:

1. Pergi ke  https://www.python.org/downloads/
2. Cari versi yang diperlukan dan pasang Python, pastikan Add python.exe ke PATH dipilih:

Dalam imej di atas, ABC digantikan dengan nama pengguna anda untuk folder pemasangan.

Pasang modul Tracker Python Untuk memasang modul Tracker Python:

1. Cari pemasangan files. Jika anda memasang Tracker di lokasi lalai, ia ditemui dalam folder ini: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Ini files dipaparkan:
2. Pasang modul Tracker Python dalam salah satu daripada cara berikut, bergantung pada pemasangan tertentu anda:
   • Cara paling mudah ialah menjalankan kumpulan file (install_tracker_api.bat) yang disertakan dalam pemasangan Tracker (seperti yang ditunjukkan dalam imej di atas).
   • Ini biasanya berfungsi dengan baik jika:
   • Python telah dipasang pada pembolehubah PATH; atau
   • Berbilang versi Python dipasang, tetapi anda mahu memasang API kepada versi terkini yang anda pasang; atau
   • Hanya satu versi Python dipasang.
   • Jika mana-mana syarat ini dikenakan, lihat Pasang modul python dengan menjalankan kumpulan file pada.
   • Dalam semua kes lain, pasang modul Python dengan menggunakan pip. Ini biasanya terpakai jika:
   • Berbilang versi Python dipasang, tetapi anda ingin memasang ke versi tertentu; atau
   • Berbilang versi Python yang berbeza dipasang dan anda ingin memasang pada kesemuanya (dalam kes ini, anda mesti memasang modul untuk setiap versi); atau
   • Hanya satu versi Python dipasang, tetapi anda tidak memasang ke PATH.
   • Jika mana-mana syarat ini dikenakan, lihat Pasang modul Python dengan menjalankan pip on.

Pasang modul Python dengan menjalankan kumpulan file Untuk melakukan ini:

1. Navigasi ke folder pemasangan Python: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Klik dua kali install_tracker_api.bat.
   • Proses pemasangan dimulakan secara automatik.

Pasang modul Python dengan menjalankan pip

1. Navigasi ke folder Skrip untuk Python yang anda mahu gunakan:
2. Untuk Python 3, folder pemasangan lalai ialah: C: \Users\ \AppData\Local\Programs\Python\Python \Sc robek
   • Untuk Python 2.7, folder pemasangan lalai ialah: C:\Python27\Scripts
3. Buka tetingkap arahan atau PowerShell dalam folder itu.
4. Jalankan arahan berikut untuk memasang Vicon Core API: C: \Pengguna\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe pasang "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Jalankan arahan berikut untuk memasang Tracker API C: \Pengguna\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe pasang "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Nota Ex di atasampsaya menggunakan pemasangan Python 3.11 dengan Tracker 4.0. Laluan dan arahan anda mungkin berbeza sedikit.

Semak sama ada modul Python dipasang dengan betul

• Semak bahawa modul berikut telah dipasang.
• vicon_core_api: Ini ialah API kawalan jauh teras dan termasuk pelanggan untuk komunikasi dengan pelayan terminal.
• tracker_api: API Perkhidmatan untuk mengakses kefungsian aplikasi khusus Tracker.
• Untuk menguji bahawa modul Tracker Python dipasang dengan betul, cuba import salah satu modul dalam Python: >>> import vicon_core_api

Jika proses di atas gagal mengenali modul, cuba yang berikut:

• Semak folder pakej tapak dalam pemasangan Python untuk folder tracker_api atau vicon_core_api. Untuk Python 3.11, lokasi folder pemasangan lalai ialah:
  • C:\Users\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Semak pembolehubah persekitaran sistem anda dan pastikan folder skrip untuk pemasangan Python yang anda mahu gunakan adalah yang tertinggi dalam senarai. Untuk Python 3.11, lokasi lalai folder pemasangan ialah:
  • C:\Users\ \AppData\Local\Programs\Python\Python311\Scripts
• Jika salah satu daripada folder modul hilang, dan anda telah mengesahkan laluan, jalankan semula melalui proses pemasangan yang diterangkan dalam Memasang modul Tracker Python pada.

Sambung ke pelayan terminal

• Untuk menyambung ke pelayan terminal, mula-mula import modul API Vicon Core: >>> import vicon_core_api
  • >>> daripada import vicon_core_api
• Seterusnya, buat pelanggan. Ini secara automatik cuba menyambung ke alamat hos tertentu pada port lalai (52800) >>> c = Client('localhost')
• Semak bahawa klien berjaya menyambung ke pelayan: >>> cetak(c.bersambung) Benar
• Jika respons adalah Palsu, pastikan anda mempunyai instance Tracker yang dijalankan pada alamat hos yang ditentukan dan firewall anda tidak menyekat trafik pada port 52800, sebelum membuat klien baharu.
• Apabila anda telah berjaya menyambung, anda boleh mengakses perkhidmatan yang disediakan oleh pelayan terminal Tracker.
• bekas iniample menggunakan perkhidmatan objek asas: >>> import tracker_api >>> daripada tracker_api import BasicObjectServices >>> perkhidmatan = BasicObjectServices(c)
• Apabila ia disambungkan, anda boleh memanggil kaedah pada contoh Penjejak.
  • Untuk example, untuk mendapatkan senarai objek dalam panel Penjejakan, gunakan: >>> result, object_list = services.basic_object_list() >>> print(result)
  • ok: fungsi berjaya
  • >>> cetak(senarai_objek)
  • ['Objek1', 'Objek2'…]
• Semua panggilan API mengembalikan kod hasil, yang diterangkan dalam vicon_core_api/result.py.
• Satu kemungkinan kod kegagalan ialah Result.RPCNotConnected, yang diterima jika sambungan ke pelayan terminal terputus.
• Untuk example: >>> result, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: Sambungan ke fungsi jauh atau panggil balik tidak dibuka
• Untuk memaparkan senarai semua fungsi dan dokumentasi yang tersedia: >>> help( tracker_api)

Exampskrip le

• Anda boleh mencari bekasampskrip yang menunjukkan penggunaan fungsi API biasa di C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Semua skrip mempunyai dokumentasi dan mengambil pilihan –help yang memberikan butiran hujah yang berkaitan.
• Untuk menjalankan sebagaiampskrip, buka tetingkap arahan atau shell kuasa dalam folder skrip di atas. Anda boleh melakukan ini dalam salah satu daripada dua cara:
• Buka command prompt dan tukar direktori anda ke folder skrip: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Tahan SHIFT+klik kanan dalam folder skrip dan pilih Buka tetingkap arahan di sini atau Buka tetingkap Powershell di sini.
• Dari sini anda boleh menjalankan bekasampskrip pilihan anda.
• Ex berikutamples gunakan tetingkap arahan.

camera_calibration_wave.py

• Skrip ini menunjukkan cara menggunakan fungsi API untuk mengawal proses penentukuran memulakan dan menghentikan gelombang tongkat.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Jika berjaya, kawalan penentukuran dipaparkan

capture_control.py

• Skrip ini menunjukkan cara untuk menangkap data langsung C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Nama Tangkapan disenaraikan sebelum kawalan. Untuk menukar nama tangkapan, gunakan capture_services dan SetCaptureName.
• Untuk soalan tentang menggunakan API Penjejak, hubungi Sokongan Vicon1.
• 1 mailto:support@vicon.com
• Panduan Mula Pantas Vicon Tracker Python API 31 Mei 2023, Semakan 1
• Untuk digunakan dengan Tracker 4.0
• © Hak Cipta 2020–2023 Vicon Motion Systems Limited. Hak cipta terpelihara.
• Semakan 1. Untuk digunakan dengan Tracker 4.0
• Vicon Motion Systems Limited berhak untuk membuat perubahan pada maklumat atau spesifikasi dalam dokumen ini tanpa notis.
• Syarikat, nama dan data yang digunakan dalam examples adalah rekaan melainkan dinyatakan sebaliknya. Tiada bahagian daripada penerbitan ini boleh diterbitkan semula, disimpan dalam sistem perolehan semula, atau dihantar dalam sebarang bentuk atau dengan sebarang cara, elektronik atau mekanikal, dengan fotokopi atau rakaman, atau sebaliknya tanpa kebenaran bertulis daripada Vicon Motion Systems Ltd.
• Vicon® ialah tanda dagangan berdaftar 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™ dan Vicon Vue™ ialah tanda dagangan Oxford Metrics plc.
• VESA® ialah tanda dagangan berdaftar yang dimiliki oleh VESA (www.vesa.org/about-vesa/). Nama produk dan syarikat lain di sini mungkin merupakan tanda dagangan pemilik masing-masing.
• Untuk mendapatkan pengakuan hak cipta dan tanda dagangan penuh dan terkini, lawati https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems ialah sebuah syarikat Oxford Metrics plc.
• e-mel: support@vicon.com Web: http://www.vicon.com

Dokumen / Sumber

Api Python Penjejak VICON [pdf] Panduan Pengguna Penjejak Python Api, Penjejak, Python Api, Api

Rujukan

• Manual Pengguna