VICON Tracker Python API

Προδιαγραφές

• Όνομα προϊόντος: Vicon Tracker Python API
• Αρμονία: Tracker 4.0
• Υποστηριζόμενες εκδόσεις Python: 2.7 και Python 3

Οδηγίες χρήσης προϊόντος

Εγκαταστήστε το Tracker API

Για να χρησιμοποιήσετε το Tracker API με την Python, ακολουθήστε αυτά τα βήματα:

1. Ελέγξτε την έκδοση Python για να διασφαλίσετε τη συμβατότητα.
2. Εγκαταστήστε την Python κατεβάζοντάς την από το επίσημο webτοποθεσία και επιλέγοντας την κατάλληλη έκδοση.
3. Εντοπίστε και εγκαταστήστε τη λειτουργική μονάδα Tracker Python από τον καθορισμένο φάκελο.

Ελέγξτε την έκδοση Python

1. Ανοίξτε μια γραμμή εντολών.
2. Πληκτρολογήστε «py» και πατήστε Enter.
3. Εάν η Python δεν είναι εγκατεστημένη, ανατρέξτε στις οδηγίες εγκατάστασης.

Εγκαταστήστε την Python

1. Μεταβείτε στο Επίσημος της Python webτοποθεσία.
2. Πραγματοποιήστε λήψη και εγκατάσταση της Python, διασφαλίζοντας ότι θα προσθέσετε το python.exe στο PATH κατά την εγκατάσταση.

Εγκαταστήστε το Tracker Python Module:

1. Εντοπίστε την εγκατάσταση files στον καθορισμένο φάκελο.
2. Επιλέξτε τη μέθοδο εγκατάστασης με βάση τις ρυθμίσεις σας.

Εγκαταστήστε τη μονάδα Python εκτελώντας το Batch File:

1. Μεταβείτε στο φάκελο εγκατάστασης της Python: C: Πρόγραμμα FilesViconTracker4.xSDKPython
2. Κάντε διπλό κλικ στο 'install_tracker_api.bat' για να ξεκινήσει η διαδικασία εγκατάστασης.

Συχνές Ερωτήσεις (FAQ):

Ε: Τι μπορώ να αυτοματοποιήσω χρησιμοποιώντας το Tracker API;

• A: Το Tracker API σάς επιτρέπει να αυτοματοποιείτε κοινές λειτουργίες όπως φόρτωση, αναπαραγωγή, εξαγωγή δεδομένων, ενεργοποίηση/απενεργοποίηση αντικειμένων και ενεργοποίηση τμημάτων ροής εργασίας.

Ε: Ποιες εκδόσεις Python υποστηρίζονται από το Tracker API;

• A: Το Tracker API υποστηρίζει Python εκδόσεις 2.7 και Python

Σχετικά με αυτόν τον οδηγό

• Το Tracker API σάς επιτρέπει να ελέγχετε ορισμένες δυνατότητες του Tracker μέσω ενός Python API.
• Το API σάς δίνει τη δυνατότητα να αυτοματοποιήσετε ορισμένες κοινές λειτουργίες του Tracker, όπως τη φόρτωση, την αναπαραγωγή και την εξαγωγή δεδομένων, την ενεργοποίηση ή απενεργοποίηση διαφορετικών αντικειμένων ή την ενεργοποίηση τμημάτων της ροής εργασίας.
• Αυτό το έγγραφο σάς δίνει τη δυνατότητα να ξεκινήσετε με το Tracker API.

Εγκαταστήστε το Tracker API

• Για να χρησιμοποιήσετε το Tracker API με την Python, πρέπει να βεβαιωθείτε ότι έχετε εγκαταστήσει και τα δύο.
• Το Tracker API παρέχει υποστήριξη για Python 2.7 και Python 3. Η Vicon συνιστά να χρησιμοποιείτε την πιο πρόσφατη πλήρη έκδοση της Python 3, εκτός εάν το έργο σας απαιτεί να χρησιμοποιήσετε μια συγκεκριμένη έκδοση της Python.

Αυτές οι διαδικασίες σας καθοδηγούν στη διαδικασία εγκατάστασης:

• Ελέγξτε την έκδοση Python ενεργοποιημένη
• Εγκατάσταση Python σε
• Εγκατάσταση της λειτουργικής μονάδας Tracker Python σε
• Ελέγξτε ότι η λειτουργική μονάδα Python έχει εγκατασταθεί σωστά

Ελέγξτε την έκδοση Python

• Εάν δεν είστε σίγουροι αν έχετε εγκαταστήσει την Python ή ποια έκδοση της Python χρησιμοποιείτε, μπορείτε να ανοίξετε μια γραμμή εντολών και να εκτελέσετε την εντολή py.

Για π.χample:

Εάν δεν έχετε εγκαταστήσει την Python, ανατρέξτε στην ενότητα Εγκατάσταση Python.

Εγκαταστήστε την Python Για να εγκαταστήσετε την Python 2 ή 3:

1. Μεταβείτε στο  https://www.python.org/downloads/
2. Εντοπίστε την απαιτούμενη έκδοση και εγκαταστήστε την Python, διασφαλίζοντας ότι είναι επιλεγμένο το Add python.exe στο PATH:

Στην παραπάνω εικόνα, το ABC αντικαθίσταται με το όνομα χρήστη σας για το φάκελο εγκατάστασης.

Εγκατάσταση της λειτουργικής μονάδας Tracker Python Για να εγκαταστήσετε τη λειτουργική μονάδα Tracker Python:

1. Εντοπίστε την εγκατάσταση fileμικρό. Εάν εγκαταστήσατε το Tracker στην προεπιλεγμένη θέση, βρίσκονται σε αυτόν τον φάκελο: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Αυτοί files εμφανίζονται:
2. Εγκαταστήστε τη λειτουργική μονάδα Tracker Python με έναν από τους παρακάτω τρόπους, ανάλογα με τη συγκεκριμένη εγκατάσταση:
   • Ο απλούστερος τρόπος είναι να τρέξετε την παρτίδα file (install_tracker_api.bat) που περιλαμβάνεται στην εγκατάσταση του Tracker (όπως φαίνεται στην παραπάνω εικόνα).
   • Αυτό συνήθως λειτουργεί καλά εάν:
   • Η Python εγκαταστάθηκε στη μεταβλητή PATH. ή
   • Έχουν εγκατασταθεί πολλές εκδόσεις της Python, αλλά θέλετε να εγκαταστήσετε το API στην πιο πρόσφατη έκδοση που εγκαταστήσατε. ή
   • Είναι εγκατεστημένη μόνο μία έκδοση της Python.
   • Εάν ισχύει οποιαδήποτε από αυτές τις συνθήκες, ανατρέξτε στην ενότητα Εγκατάσταση της λειτουργικής μονάδας python εκτελώντας τη δέσμη file επί.
   • Σε όλες τις άλλες περιπτώσεις, εγκαταστήστε τη λειτουργική μονάδα Python χρησιμοποιώντας pip. Αυτό ισχύει συνήθως εάν:
   • Έχουν εγκατασταθεί πολλές εκδόσεις της Python, αλλά θέλετε να εγκαταστήσετε σε μια συγκεκριμένη έκδοση. ή
   • Έχουν εγκατασταθεί πολλές διαφορετικές εκδόσεις της Python και θέλετε να τις εγκαταστήσετε σε όλες (σε αυτήν την περίπτωση, πρέπει να εγκαταστήσετε τη λειτουργική μονάδα για κάθε έκδοση). ή
   • Έχει εγκατασταθεί μόνο μία έκδοση της Python, αλλά δεν την εγκαταστήσατε στο PATH.
   • Εάν ισχύει οποιαδήποτε από αυτές τις συνθήκες, ανατρέξτε στην ενότητα Εγκατάσταση της λειτουργικής μονάδας Python εκτελώντας το pip on.

Εγκαταστήστε τη λειτουργική μονάδα Python εκτελώντας τη δέσμη file Για να το κάνετε αυτό:

1. Μεταβείτε στον φάκελο εγκατάστασης της Python: Γ:\Πρόγραμμα Files\Vicon\Tracker4.x\SDK\Python
2. Κάντε διπλό κλικ στο install_tracker_api.bat.
   • Η διαδικασία εγκατάστασης ξεκινά αυτόματα.

Εγκαταστήστε τη λειτουργική μονάδα Python εκτελώντας το pip

1. Μεταβείτε στο φάκελο Scripts για την Python που θέλετε να χρησιμοποιήσετε:
2. Για την Python 3, ο προεπιλεγμένος φάκελος εγκατάστασης είναι: C: \Users\ \AppData\Local\Programs\Python\Python \Sc rips
   • Για την Python 2.7, ο προεπιλεγμένος φάκελος εγκατάστασης είναι: C:\Python27\Scripts
3. Ανοίξτε ένα παράθυρο εντολών ή PowerShell σε αυτόν τον φάκελο.
4. Εκτελέστε την ακόλουθη εντολή για να εγκαταστήσετε το Vicon Core API: C: \Χρήστες\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe εγκαταστήστε το "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api"
   • Εκτελέστε την ακόλουθη εντολή για να εγκαταστήσετε το Tracker API C: \Χρήστες\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe εγκαταστήστε το "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

Σημείωμα Οι παραπάνω π.χampχρησιμοποιούν μια εγκατάσταση Python 3.11 με Tracker 4.0. Η διαδρομή και οι εντολές σας ενδέχεται να διαφέρουν ελαφρώς.

Ελέγξτε ότι η λειτουργική μονάδα Python έχει εγκατασταθεί σωστά

• Ελέγξτε ότι έχουν εγκατασταθεί οι ακόλουθες μονάδες.
• vicon_core_api: Αυτό είναι το βασικό API απομακρυσμένου ελέγχου και περιλαμβάνει έναν πελάτη για επικοινωνία με τον διακομιστή τερματικού.
• tracker_api: Υπηρεσίες API για πρόσβαση σε λειτουργίες εφαρμογών ειδικά για το Tracker.
• Για να ελέγξετε ότι η λειτουργική μονάδα Tracker Python έχει εγκατασταθεί σωστά, δοκιμάστε να εισαγάγετε μία από τις λειτουργικές μονάδες στην Python: >>> import vicon_core_api

Εάν η παραπάνω διαδικασία δεν αναγνωρίσει τη λειτουργική μονάδα, δοκιμάστε τα εξής:

• Ελέγξτε το φάκελο site-packages στην εγκατάσταση της Python για το φάκελο tracker_api ή vicon_core_api. Για την Python 3.11, η θέση του προεπιλεγμένου φακέλου εγκατάστασης είναι:
  • Γ:\Χρήστες\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Ελέγξτε τις μεταβλητές περιβάλλοντος του συστήματός σας και βεβαιωθείτε ότι ο φάκελος scripts για την εγκατάσταση Python που θέλετε να χρησιμοποιήσετε είναι ο υψηλότερος στη λίστα. Για την Python 3.11, η προεπιλεγμένη θέση του φακέλου εγκατάστασης είναι:
  • Γ:\Χρήστες\ \AppData\Local\Programs\Python\Python311\Scripts
• Εάν λείπει κάποιος από τους φακέλους των λειτουργικών μονάδων και έχετε επαληθεύσει τη διαδρομή, εκτελέστε ξανά τη διαδικασία εγκατάστασης που περιγράφεται στην ενότητα Εγκατάσταση της λειτουργικής μονάδας Tracker Python σε.

Συνδεθείτε στον τερματικό διακομιστή

• Για να συνδεθείτε στον τερματικό διακομιστή, πρώτα εισαγάγετε τη μονάδα Vicon Core API: >>> import vicon_core_api
  • >>> από την εισαγωγή vicon_core_api
• Στη συνέχεια, δημιουργήστε έναν πελάτη. Αυτό προσπαθεί αυτόματα να συνδεθεί στη συγκεκριμένη διεύθυνση κεντρικού υπολογιστή στην προεπιλεγμένη θύρα (52800) >>> c = Client('localhost')
• Ελέγξτε ότι ο πελάτης συνδέθηκε επιτυχώς στον διακομιστή: >>> print(c.connected) True
• Εάν η απόκριση είναι False, βεβαιωθείτε ότι έχετε μια παρουσία του Tracker που εκτελείται στην καθορισμένη διεύθυνση κεντρικού υπολογιστή και ότι το τείχος προστασίας δεν αποκλείει την κυκλοφορία στη θύρα 52800, προτού δημιουργήσετε έναν νέο πελάτη.
• Όταν συνδεθείτε με επιτυχία, μπορείτε να αποκτήσετε πρόσβαση στις υπηρεσίες που παρέχονται από τον τερματικό διακομιστή Tracker.
• Αυτό το πρώηνampΤο le χρησιμοποιεί βασικές υπηρεσίες αντικειμένων: >>> εισαγωγή tracker_api >>> από το tracker_api εισαγωγή BasicObjectServices >>> υπηρεσίες = BasicObjectServices(c)
• Όταν είναι συνδεδεμένο, μπορείτε να καλέσετε μεθόδους στην παρουσία Tracker.
  • Για π.χample, για να λάβετε μια λίστα αντικειμένων στον πίνακα παρακολούθησης, χρησιμοποιήστε: >>> αποτέλεσμα, αντικείμενο_λίστα = services.basic_object_list() >>> εκτύπωση(αποτέλεσμα)
  • Εντάξει: η λειτουργία πέτυχε
  • >>> εκτύπωση(λίστα_αντικειμένων)
  • ['Object1', 'Object2'…]
• Όλες οι κλήσεις API επιστρέφουν έναν κωδικό αποτελέσματος, ο οποίος περιγράφεται στο vicon_core_api/result.py.
• Ένας πιθανός κωδικός αποτυχίας είναι το Result.RPCNotConnected, ο οποίος λαμβάνεται εάν χαθεί η σύνδεση με τον τερματικό διακομιστή.
• Για π.χample: >>> αποτέλεσμα, object_list = services.basic_object_list() vicon_core_api.client.RPCEσφάλμα: RPCNotConnected: Η σύνδεση με την απομακρυσμένη λειτουργία ή την επανάκληση δεν είναι ανοιχτή
• Για να εμφανίσετε μια λίστα με όλες τις διαθέσιμες λειτουργίες και τεκμηρίωση: >>> help( tracker_api)

Example scripts

• Μπορείτε να βρείτε πρώηνample σενάρια που δείχνουν τη χρήση κοινών συναρτήσεων API στο Γ:\Πρόγραμμα Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Όλα τα σενάρια έχουν τεκμηρίωση και έχουν μια επιλογή –help που δίνει λεπτομέρειες για τα σχετικά ορίσματα.
• Να τρέξει ωςample script, ανοίξτε ένα παράθυρο εντολών ή ένα power shell στον παραπάνω φάκελο scripts. Μπορείτε να το κάνετε αυτό με έναν από τους δύο τρόπους:
• Ανοίξτε τη γραμμή εντολών και αλλάξτε τον κατάλογό σας στο φάκελο scripts: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Κρατήστε πατημένο το πλήκτρο SHIFT+ δεξί κλικ στο φάκελο scripts και επιλέξτε Άνοιγμα παραθύρου εντολής εδώ ή Άνοιγμα παραθύρου Powershell εδώ.
• Από εδώ μπορείτε να τρέξετε τον πρώηνampσενάριο της επιλογής σας.
• Οι παρακάτω π.χamples χρησιμοποιούμε το παράθυρο εντολών.

camera_calibration_wave.py

• Αυτό το σενάριο δείχνει πώς να χρησιμοποιείτε τις λειτουργίες API για τον έλεγχο της διαδικασίας βαθμονόμησης της έναρξης και της διακοπής του κύματος ράβδου.
  • Γ:\Πρόγραμμα Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Εάν είναι επιτυχής, εμφανίζονται τα στοιχεία ελέγχου βαθμονόμησης

capture_control.py

• Αυτό το σενάριο δείχνει πώς να καταγράψετε ζωντανά δεδομένα C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Το όνομα Capture παρατίθεται πριν από τα στοιχεία ελέγχου. Για να αλλάξετε το όνομα λήψης, χρησιμοποιήστε capture_services και SetCaptureName.
• Για ερωτήσεις σχετικά με τη χρήση του Tracker API, επικοινωνήστε με την Υποστήριξη της Vicon1.
• 1 mailto:support@vicon.com
• Vicon Tracker Python API Quick Start Guide 31 Μαΐου 2023, Αναθεώρηση 1
• Για χρήση με το Tracker 4.0
• © Πνευματικά δικαιώματα 2020–2023 Vicon Motion Systems Limited. Ολα τα δικαιώματα διατηρούνται.
• Αναθεώρηση 1. Για χρήση με το Tracker 4.0
• Η Vicon Motion Systems Limited διατηρεί το δικαίωμα να κάνει αλλαγές στις πληροφορίες ή τις προδιαγραφές σε αυτό το έγγραφο χωρίς προειδοποίηση.
• Εταιρείες, ονόματα και δεδομένα που χρησιμοποιούνται στην π.χamples είναι πλασματικές εκτός εάν σημειώνεται διαφορετικά. Κανένα μέρος αυτής της δημοσίευσης δεν επιτρέπεται να αναπαραχθεί, να αποθηκευτεί σε σύστημα ανάκτησης ή να μεταδοθεί με οποιαδήποτε μορφή ή με οποιοδήποτε μέσο, ​​ηλεκτρονικό ή μηχανικό, με φωτοτυπία ή ηχογράφηση ή με άλλο τρόπο χωρίς την προηγούμενη γραπτή άδεια της Vicon Motion Systems Ltd.
• Το Vicon® είναι σήμα κατατεθέν της Oxford Metrics plc. Vicon Control™, Vicon Lock™, Vicon Lock Lab™, Vicon Lock Studio™, Vicon Tracker™, Vicon Valkyrie™, Vicon VantagΤα e™, Vicon Vero™, Vicon Viper™, Vicon ViperX™ και Vicon Vue™ είναι εμπορικά σήματα της Oxford Metrics plc.
• Το VESA® είναι σήμα κατατεθέν που ανήκει στην VESA (www.vesa.org/about-vesa/). Άλλα ονόματα προϊόντων και εταιρειών στο παρόν ενδέχεται να είναι εμπορικά σήματα των αντίστοιχων κατόχων τους.
• Για πλήρεις και ενημερωμένες επιβεβαιώσεις πνευματικών δικαιωμάτων και εμπορικών σημάτων, επισκεφθείτε https://www.vicon.com/vicon/copyright-information.
• Η Vicon Motion Systems είναι μια εταιρεία Oxford Metrics plc.
• E-mail: support@vicon.com Web: http://www.vicon.com

Έγγραφα / Πόροι

VICON Tracker Python Api [pdf] Οδηγός χρήστη Tracker Python Api, Tracker, Python Api, Api

Αναφορές

• Εγχειρίδιο χρήστη