API de Python del rastreador VICON

Presupuesto

• Nombre del producto: API de Python de seguimiento de Vicon
• Compatibilidad: Rastreador 4.0
• Versiones de Python compatibles: 2.7 y Python 3

Instrucciones de uso del producto

Instalar la API de seguimiento

Para utilizar la API Tracker con Python, siga estos pasos:

1. Verifique la versión de Python para garantizar la compatibilidad.
2. Instale Python descargándolo del sitio oficial websitio y seleccionando la versión apropiada.
3. Localice e instale el módulo Tracker Python desde la carpeta especificada.

Comprobar la versión de Python

1. Abra un símbolo del sistema.
2. Escriba 'py' y presione Entrar.
3. Si Python no está instalado, consulte las instrucciones de instalación.

Instalar Python

1. Ir a Oficial de Python websitio.
2. Descargue e instale Python, asegurándose de agregar python.exe a PATH durante la instalación.

Instale el módulo Tracker Python:

1. Ubicar la instalación files en la carpeta especificada.
2. Elija el método de instalación según su configuración.

Instale el módulo Python ejecutando el lote File:

1. Navegue a la carpeta de instalación de Python: C: Programa FilesViconTracker4.xSDKPython
2. Haga doble clic en 'install_tracker_api.bat' para iniciar el proceso de instalación.

Preguntas frecuentes (FAQ):

P: ¿Qué puedo automatizar usando la API Tracker?

• A: La API Tracker le permite automatizar funciones comunes como cargar, reproducir, exportar datos, activar/desactivar objetos y activar partes del flujo de trabajo.

P: ¿Qué versiones de Python son compatibles con la API Tracker?

• A: La API Tracker es compatible con las versiones 2.7 y Python de Python.

Acerca de esta guía

• La API de Tracker le permite controlar ciertas funciones de Tracker a través de una API de Python.
• La API le permite automatizar algunas funciones comunes de Tracker, como cargar, reproducir y exportar datos, activar o desactivar diferentes objetos o activar partes del flujo de trabajo.
• Este documento le permite comenzar con la API de Tracker.

Instalar la API de seguimiento

• Para utilizar la API Tracker con Python, debe asegurarse de tener ambos instalados.
• La API Tracker proporciona soporte para Python 2.7 y Python 3. Vicon recomienda utilizar la última versión completa de Python 3 a menos que su proyecto requiera que utilice una versión específica de Python.

Estos procedimientos lo guiarán a través del proceso de instalación:

• Compruebe la versión de Python en
• Instalando Python en
• Instalación del módulo Tracker Python en
• Compruebe que el módulo Python esté instalado correctamente en

Verificar la versión de Python

• Si no está seguro de tener Python instalado o qué versión de Python está utilizando, puede abrir un símbolo del sistema y ejecutar el comando py.

Por ejemploampen:

Si no tiene Python instalado, consulte Instalar Python.

Instalar Python Para instalar Python 2 o 3:

1. Ir a  https://www.python.org/downloads/
2. Localice la versión requerida e instale Python, asegurándose de que Agregar python.exe a la RUTA esté seleccionado:

En la imagen de arriba, ABC se reemplaza con su nombre de usuario para la carpeta de instalación.

Instale el módulo Tracker Python Para instalar el módulo Tracker Python:

1. Ubicar la instalación files. Si instaló Tracker en la ubicación predeterminada, se encuentran en esta carpeta: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • Estos filese muestran:
2. Instale el módulo Tracker Python de cualquiera de las siguientes formas, según su instalación particular:
   • La forma más sencilla es ejecutar el lote. file (install_tracker_api.bat) que se incluye en la instalación de Tracker (como se muestra en la imagen de arriba).
   • Esto suele funcionar bien si:
   • Python se instaló en la variable PATH; o
   • Hay varias versiones de Python instaladas, pero desea instalar la API en la última versión que instaló; o
   • Solo está instalada una única versión de Python.
   • Si se aplica alguna de estas condiciones, consulte Instalar el módulo de Python ejecutando el lote file en.
   • En todos los demás casos, instale el módulo Python usando pip. Esto suele aplicarse si:
   • Hay varias versiones de Python instaladas, pero desea instalar una versión específica; o
   • Hay varias versiones diferentes de Python instaladas y desea instalarlas en todas (en este caso, debe instalar el módulo para cada versión); o
   • Solo está instalada una única versión de Python, pero no la instaló en PATH.
   • Si se aplica alguna de estas condiciones, consulte Instalar el módulo Python ejecutando pip on.

Instale el módulo Python ejecutando el lote file Para hacer esto:

1. Navegue a la carpeta de instalación de Python: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Haga doble clic en install_tracker_api.bat.
   • El proceso de instalación se inicializa automáticamente.

Instale el módulo Python ejecutando el pip

1. Navegue a la carpeta Scripts del Python que desea usar:
2. Para Python 3, la carpeta de instalación predeterminada es: C: \Users\ \AppData\Local\Programas\Python\Python \Sc rasgaduras
   • Para Python 2.7, la carpeta de instalación predeterminada es: C:\Python27\Scripts
3. Abra una ventana de comandos o PowerShell en esa carpeta.
4. Ejecute el siguiente comando para instalar la API de Vicon Core: C: \Usuarios\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instalar “C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Ejecute el siguiente comando para instalar Tracker API C: \Usuarios\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instalar “C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Nota El ejemplo anteriorampLes utilizamos una instalación de Python 3.11 con Tracker 4.0. Su ruta y sus comandos pueden diferir ligeramente.

Compruebe que el módulo Python esté instalado correctamente

• Compruebe que se hayan instalado los siguientes módulos.
• vicon_core_api: Esta es la API principal de control remoto e incluye un cliente para la comunicación con el servidor terminal.
• rastreador_api: API de servicios para acceder a la funcionalidad de la aplicación específica de Tracker.
• Para probar que el módulo Tracker Python está instalado correctamente, intente importar uno de los módulos en Python: >>> import vicon_core_api

Si el proceso anterior no reconoce el módulo, intente lo siguiente:

• Verifique la carpeta de paquetes del sitio en la instalación de Python para ver la carpeta tracker_api o vicon_core_api. Para Python 3.11, la ubicación de la carpeta de instalación predeterminada es:
  • C:\Usuarios\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Verifique las variables de entorno de su sistema y asegúrese de que la carpeta de scripts para la instalación de Python que desea utilizar sea la más alta de la lista. Para Python 3.11, la ubicación predeterminada de la carpeta de instalación es:
  • C:\Usuarios\ \AppData\Local\Programas\Python\Python311\Scripts
• Si falta alguna de las carpetas de los módulos y ha verificado la ruta, vuelva a ejecutar el proceso de instalación descrito en Instalación del módulo Tracker Python en.

Conéctese al servidor de terminal

• Para conectarse al servidor de terminal, primero importe el módulo Vicon Core API: >>> import vicon_core_api
  • >>> desde vicon_core_api importar
• A continuación, cree un cliente. Esto intenta conectarse automáticamente a la dirección de host específica en el puerto predeterminado (52800) >>> c = Cliente('localhost')
• Compruebe que el cliente se haya conectado correctamente al servidor: >>> imprimir(c.conectado) Verdadero
• Si la respuesta es Falso, asegúrese de tener una instancia de Tracker ejecutándose en la dirección de host especificada y de que su firewall no esté bloqueando el tráfico en el puerto 52800 antes de crear un nuevo cliente.
• Cuando se haya conectado correctamente, podrá acceder a los servicios proporcionados por el servidor del terminal Tracker.
• Este example utiliza servicios de objetos básicos: >>> importar tracker_api >>> desde tracker_api importar BasicObjectServices >>> servicios = BasicObjectServices(c)
• Cuando está conectado, puede llamar a métodos en la instancia de Tracker.
  • Por ejemploamparchivo, para obtener una lista de objetos en el panel Seguimiento, use: >>> resultado, lista_objetos = servicios.basic_object_list() >>> imprimir(resultado)
  • De acuerdo: la función tuvo éxito
  • >>> imprimir(lista_objetos)
  • ['Objeto1', 'Objeto2'…]
• Todas las llamadas API devuelven un código de resultado, que se describe en vicon_core_api/result.py.
• Un posible código de error es Result.RPCNotConnected, que se recibe si se pierde la conexión con el servidor de terminal.
• Por ejemploample: >>> resultado, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: la conexión a la función remota o devolución de llamada no está abierta
• Para mostrar una lista de todas las funciones y documentación disponibles: >>> ayuda( tracker_api)

Examplos guiones

• puedes encontrar exampscripts de archivos que muestran el uso de funciones API comunes en C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Todos los scripts tienen documentación y aceptan una opción de ayuda que brinda detalles de los argumentos relevantes.
• para ejecutar comoample script, abra una ventana de comandos o power shell en la carpeta de scripts de arriba. Puedes hacer esto de dos maneras:
• Abra el símbolo del sistema y cambie su directorio a la carpeta de scripts: c:\> cd C:\Programa Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Mantenga presionada la tecla MAYÚS+clic derecho en la carpeta de scripts y seleccione Abrir ventana de comando aquí o Abrir ventana de Powershell aquí.
• Desde aquí puedes ejecutar el ex.ampel guión de su elección.
• El siguiente ejemploampUtilicemos la ventana de comandos.

cámara_calibración_onda.py

• Este script demuestra cómo utilizar las funciones API para controlar el proceso de calibración de iniciar y detener la onda de la varita.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts>py camera_calibration_wave.py
• Si tiene éxito, se muestran los controles de calibración.

captura_control.py

• Este script muestra cómo capturar datos en vivo C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts>py capture_control.py
• El nombre de la captura aparece antes de los controles. Para cambiar el nombre de la captura, utilice capture_services y SetCaptureName.
• Si tiene preguntas sobre el uso de Tracker API, comuníquese con el soporte de Vicon1.
• 1 correo a:soporte@vicon.com
• Guía de inicio rápido de la API de Python de Vicon Tracker 31 de mayo de 2023, revisión 1
• Para usar con Tracker 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Reservados todos los derechos.
• Revisión 1. Para usar con Tracker 4.0
• Vicon Motion Systems Limited se reserva el derecho de realizar cambios en la información o especificaciones de este documento sin previo aviso.
• Empresas, nombres y datos utilizados en exampLos archivos son ficticios a menos que se indique lo contrario. Ninguna parte de esta publicación puede ser reproducida, almacenada en un sistema de recuperación o transmitida de ninguna forma o por ningún medio, electrónico o mecánico, mediante fotocopia o grabación, o de otra manera sin el permiso previo por escrito de Vicon Motion Systems Ltd.
• Vicon® es una marca registrada de 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™ y Vicon Vue™ son marcas comerciales de Oxford Metrics plc.
• VESA® es una marca registrada propiedad de VESA (www.vesa.org/about-vesa/). Otros nombres de productos y empresas aquí mencionados pueden ser marcas comerciales de sus respectivos propietarios.
• Para obtener reconocimientos completos y actualizados de derechos de autor y marcas registradas, visite https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems es una empresa de Oxford Metrics plc.
• Correo electrónico: soporte@vicon.com Web: http://www.vicon.com

Documentos / Recursos

API de Python del rastreador VICON [pdf] Guía del usuario Rastreador Python Api, Rastreador, Python Api, Api

Referencias

• Manual de usuario