API Python VICON Tracker

Specifiche

• Nome del prodotto: API Vicon Tracker Python
• Compatibilità: Tracciatore 4.0
• Versioni Python supportate: 2.7 e Python 3

Istruzioni per l'uso del prodotto

Installa l'API Tracker

Per utilizzare l'API Tracker con Python, attenersi alla seguente procedura:

1. Controlla la versione di Python per garantire la compatibilità.
2. Installa Python scaricandolo dal sito ufficiale websito e selezionando la versione appropriata.
3. Individua e installa il modulo Tracker Python dalla cartella specificata.

Controlla la versione di Python

1. Aprire un prompt dei comandi.
2. Digita "py" e premi Invio.
3. Se Python non è installato, fare riferimento alle istruzioni di installazione.

Installa Python

1. Vai a Ufficiale di Python websito.
2. Scarica e installa Python, assicurandoti di aggiungere python.exe a PATH durante l'installazione.

Installa il modulo Tracker Python:

1. Individua l'installazione files nella cartella specificata.
2. Scegli il metodo di installazione in base alla tua configurazione.

Installa il modulo Python eseguendo il batch File:

1. Passare alla cartella di installazione di Python: C: Program FilesViconTracker4.xSDKPython
2. Fare doppio clic su "install_tracker_api.bat" per avviare il processo di installazione.

Domande frequenti (FAQ):

D: Cosa posso automatizzare utilizzando l'API Tracker?

• A: L'API Tracker ti consente di automatizzare funzioni comuni come caricamento, riproduzione, esportazione di dati, attivazione/disattivazione di oggetti e attivazione di parti del flusso di lavoro.

D: Quali versioni di Python sono supportate dall'API Tracker?

• A: L'API Tracker supporta le versioni Python 2.7 e Python

Informazioni su questa guida

• L'API Tracker ti consente di controllare alcune funzionalità di Tracker tramite un'API Python.
• L'API ti consente di automatizzare alcune funzioni comuni di Tracker, come il caricamento, la riproduzione e l'esportazione dei dati, l'attivazione o la disattivazione di diversi oggetti o l'attivazione di parti del flusso di lavoro.
• Questo documento ti consente di iniziare con l'API Tracker.

Installa l'API Tracker

• Per utilizzare l'API Tracker con Python, devi assicurarti di averli installati entrambi.
• L'API Tracker fornisce supporto per Python 2.7 e Python 3. Vicon consiglia di utilizzare l'ultima versione completa di Python 3 a meno che il tuo progetto non richieda l'utilizzo di una versione specifica di Python.

Queste procedure guidano l'utente attraverso il processo di installazione:

• Controlla la versione di Python su
• Installazione di Python su
• Installazione del modulo Tracker Python su
• Verifica che il modulo Python sia installato correttamente su

Controlla la versione di Python

• Se non sei sicuro di avere Python installato o quale versione di Python stai utilizzando, puoi aprire un prompt dei comandi ed eseguire il comando py.

Per esempioampon:

Se Python non è installato, consulta Installare Python.

Installa Python Per installare Python 2 o 3:

1. Vai a  https://www.python.org/downloads/
2. Individua la versione richiesta e installa Python, assicurandoti che sia selezionato Aggiungi python.exe al PATH:

Nell'immagine sopra, ABC viene sostituito con il tuo nome utente per la cartella di installazione.

Installare il modulo Tracker Python Per installare il modulo Tracker Python:

1. Individua l'installazione fileS. Se hai installato Tracker nella posizione predefinita, si trovano in questa cartella: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Questi fileVengono visualizzati:
2. Installa il modulo Tracker Python in uno dei seguenti modi, a seconda della tua particolare installazione:
   • Il modo più semplice è eseguire il batch file (install_tracker_api.bat) incluso nell'installazione del Tracker (come mostrato nell'immagine sopra).
   • Di solito funziona bene se:
   • Python è stato installato nella variabile PATH; O
   • Sono installate più versioni di Python, ma desideri installare l'API sull'ultima versione installata; O
   • È installata solo una singola versione di Python.
   • Se si applica una di queste condizioni, vedere Installare il modulo Python eseguendo il batch file SU.
   • In tutti gli altri casi, installa il modulo Python utilizzando pip. Questo di solito si applica se:
   • Sono installate più versioni di Python, ma desideri eseguire l'installazione su una versione specifica; O
   • Sono installate più versioni diverse di Python e desideri installarle su tutte (in questo caso, devi installare il modulo per ciascuna versione); O
   • È installata solo una versione di Python, ma non è stata installata su PATH.
   • Se si applica una di queste condizioni, vedere Installare il modulo Python eseguendo pip on.

Installa il modulo Python eseguendo il batch file Per fare questo:

1. Passare alla cartella di installazione di Python: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Fare doppio clic su install_tracker_api.bat.
   • Il processo di installazione si inizializza automaticamente.

Installa il modulo Python eseguendo pip

1. Passare alla cartella Scripts per il Python che si desidera utilizzare:
2. Per Python 3, la cartella di installazione predefinita è: C: \Users\ \AppData\Local\Programmi\Python\Python \Sc strappa
   • Per Python 2.7, la cartella di installazione predefinita è: C:\Python27\Scripts
3. Apri una finestra di comando o PowerShell in quella cartella.
4. Eseguire il comando seguente per installare l'API Vicon Core: C: \Utenti\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe installa “C:\Program Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Esegui il comando seguente per installare l'API C del Tracker: \Utenti\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe installa “C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Nota Quanto sopra exampi le utilizzano un'installazione Python 3.11 con Tracker 4.0. Il percorso e i comandi potrebbero differire leggermente.

Verifica che il modulo Python sia installato correttamente

• Verificare che siano stati installati i seguenti moduli.
• vicon_core_api: Questa è l'API di controllo remoto principale e include un client per la comunicazione con il server terminal.
• tracker_api: API dei servizi per accedere alle funzionalità dell'applicazione specifiche del Tracker.
• Per verificare che il modulo Tracker Python sia installato correttamente, prova a importare uno dei moduli in Python: >>> import vicon_core_api

Se il processo precedente non riesce a riconoscere il modulo, provare quanto segue:

• Controlla la cartella site-packages nell'installazione di Python per la cartella tracker_api o vicon_core_api. Per Python 3.11, il percorso della cartella di installazione predefinita è:
  • C:\Utenti\ \AppData\Local\Programmi\Python\Python311\Lib\site-packages
• Controlla le variabili di ambiente del tuo sistema e assicurati che la cartella degli script per l'installazione di Python che desideri utilizzare sia la più alta nell'elenco. Per Python 3.11, il percorso predefinito della cartella di installazione è:
  • C:\Utenti\ \AppData\Local\Programmi\Python\Python311\Scripts
• Se una delle cartelle dei moduli manca e hai verificato il percorso, esegui nuovamente il processo di installazione descritto in Installazione del modulo Tracker Python su.

Connettersi al server terminale

• Per connettersi al server terminal, importare prima il modulo API Vicon Core: >>> import vicon_core_api
  • >>> da vicon_core_api import
• Successivamente, crea un client. Questo tenta automaticamente di connettersi all'indirizzo host specifico sulla porta predefinita (52800) >>> c = Client('localhost')
• Verificare che il client si sia connesso correttamente al server: >>> print(c.connesso) Vero
• Se la risposta è False, assicurati di avere un'istanza di Tracker in esecuzione all'indirizzo host specificato e che il tuo firewall non stia bloccando il traffico sulla porta 52800, prima di creare un nuovo client.
• Una volta connesso con successo, è possibile accedere ai servizi forniti dal server terminale Tracker.
• Questo example utilizza servizi oggetto di base: >>> import tracker_api >>> from tracker_api import BasicObjectServices >>> services = BasicObjectServices(c)
• Quando è connesso, puoi chiamare metodi sull'istanza Tracker.
  • Per esempioample, per ottenere un elenco di oggetti nel pannello Tracciamento, utilizzare: >>> risultato, object_list = services.basic_object_list() >>> print(risultato)
  • OK: la funzione è riuscita
  • >>> stampa(elenco_oggetti)
  • ['Oggetto1', 'Oggetto2'...]
• Tutte le chiamate API restituiscono un codice risultato, descritto in vicon_core_api/result.py.
• Un possibile codice di errore è Result.RPCNotConnected, che viene ricevuto se la connessione al server terminal viene persa.
• Per esempioample: >>> risultato, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: la connessione alla funzione remota o al callback non è aperta
• Per visualizzare un elenco di tutte le funzioni e la documentazione disponibili: >>> help( tracker_api)

Exampgli script

• Puoi trovare example script che mostrano l'uso delle funzioni API comuni su C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Tutti gli script dispongono di documentazione e accettano un'opzione –help che fornisce dettagli sugli argomenti rilevanti.
• Per correre comeample script, apri una finestra di comando o una power shell nella cartella degli script in alto. Puoi farlo in due modi:
• Apri il prompt dei comandi e cambia la directory nella cartella degli script: c:\> cd C:\Programma Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Tieni premuto MAIUSC+fai clic con il pulsante destro del mouse sulla cartella degli script e seleziona Apri la finestra di comando qui o Apri la finestra di PowerShell qui.
• Da qui puoi eseguire l'examplo script di tua scelta.
• Il seguente esempioamputilizzano la finestra di comando.

camera_calibration_wave.py

• Questo script dimostra come utilizzare le funzioni API per controllare il processo di calibrazione di avvio e arresto dell'onda della bacchetta.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• In caso di esito positivo, vengono visualizzati i controlli di calibrazione

capture_control.py

• Questo script mostra come acquisire dati in tempo reale C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• Il nome della cattura è elencato prima dei controlli. Per modificare il nome dell'acquisizione, utilizzare capture_services e SetCaptureName.
• Per domande sull'utilizzo dell'API Tracker, contattare il supporto Vicon1.
• 1 mail:support@vicon.com
• Guida rapida all'API Vicon Tracker Python 31 maggio 2023, revisione 1
• Da utilizzare con Tracker 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Tutti i diritti riservati.
• Revisione 1. Da utilizzare con Tracker 4.0
• Vicon Motion Systems Limited si riserva il diritto di apportare modifiche alle informazioni o alle specifiche contenute in questo documento senza preavviso.
• Società, nomi e dati utilizzati in exampi le sono fittizi se non diversamente specificato. Nessuna parte di questa pubblicazione può essere riprodotta, archiviata in un sistema di recupero o trasmessa in qualsiasi forma o con qualsiasi mezzo, elettronico o meccanico, fotocopiando o registrando, o in altro modo senza il previo consenso scritto di Vicon Motion Systems Ltd.
• Vicon® è un marchio registrato di 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™ e Vicon Vue™ sono marchi di Oxford Metrics plc.
• VESA® è un marchio registrato di proprietà di VESA (www.vesa.org/about-vesa/). Altri nomi di prodotti e società qui riportati possono essere marchi dei rispettivi proprietari.
• Per i riconoscimenti completi e aggiornati di copyright e marchi, visitare https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems è una società di Oxford Metrics plc.
• E-mail: support@vicon.com Web: http://www.vicon.com

Documenti / Risorse

API Python Tracker VICON [pdf] Guida utente Tracker Python Api, Tracker, Python Api, Api

Riferimenti

• Manuale d'uso