API Python do rastreador VICON

Especificações

• Nome do produto: API Vicon Tracker Python
• Compatibilidade: Rastreador 4.0
• Versões Python suportadas: 2.7 e Python 3

Instruções de uso do produto

Instale a API do rastreador

Para usar a API Tracker com Python, siga estas etapas:

1. Verifique a versão do Python para garantir a compatibilidade.
2. Instale o Python baixando-o do site oficial website e selecionando a versão apropriada.
3. Localize e instale o módulo Tracker Python da pasta especificada.

Verifique a versão do Python

1. Abra um prompt de comando.
2. Digite 'py' e pressione Enter.
3. Se o Python não estiver instalado, consulte as instruções de instalação.

Instalar Python

1. Vá para Oficial do Python website.
2. Baixe e instale o Python, certificando-se de adicionar python.exe ao PATH durante a instalação.

Instale o módulo Tracker Python:

1. Localize a instalação files na pasta especificada.
2. Escolha o método de instalação com base na sua configuração.

Instale o módulo Python executando o lote File:

1. Navegue até a pasta de instalação do Python: C: Program FilesViconTracker4.xSDKPython
2. Clique duas vezes em 'install_tracker_api.bat' para iniciar o processo de instalação.

Perguntas frequentes (FAQ):

P: O que posso automatizar usando a API Tracker?

• A: A API Tracker permite automatizar funções comuns, como carregar, reproduzir, exportar dados, ativar/desativar objetos e acionar partes do fluxo de trabalho.

P: Quais versões do Python são suportadas pela API Tracker?

• A: A API Tracker oferece suporte às versões 2.7 e Python do Python

Sobre este guia

• A API Tracker permite controlar certos recursos do Tracker por meio de uma API Python.
• A API permite automatizar algumas funções comuns do Tracker, como carregar, reproduzir e exportar dados, ativar ou desativar diferentes objetos ou acionar partes do fluxo de trabalho.
• Este documento permite que você comece a usar a API Tracker.

Instale a API do rastreador

• Para usar a API Tracker com Python, você deve certificar-se de que ambos estão instalados.
• A API Tracker fornece suporte para Python 2.7 e Python 3. A Vicon recomenda que você use a versão completa mais recente do Python 3, a menos que seu projeto exija que você use uma versão específica do Python.

Estes procedimentos guiam você pelo processo de instalação:

• Verifique a versão do Python em
• Instalando Python em
• Instalando o módulo Tracker Python em
• Verifique se o módulo Python está instalado corretamente em

Verifique a versão do Python

• Se não tiver certeza se o Python está instalado ou qual versão do Python está usando, você pode abrir um prompt de comando e executar o comando py.

Por exemploampem:

Se você não tiver o Python instalado, consulte Instalar o Python.

Instalar Python Para instalar o Python 2 ou 3:

1. Vá para  https://www.python.org/downloads/
2. Localize a versão necessária e instale o Python, garantindo que Adicionar python.exe ao PATH esteja selecionado:

Na imagem acima, ABC é substituído pelo seu nome de usuário da pasta de instalação.

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

1. Localize a instalação fileS. Se você instalou o Tracker no local padrão, eles serão encontrados nesta pasta: C:\Programa Files\Vicon\Tracker4.x\SDK\Python
   • Esses files são exibidos:
2. Instale o módulo Tracker Python de uma das seguintes maneiras, dependendo de sua instalação específica:
   • A maneira mais simples é executar o lote file (install_tracker_api.bat) que está incluído na instalação do Tracker (conforme mostrado na imagem acima).
   • Isso geralmente funciona bem se:
   • Python foi instalado na variável PATH; ou
   • Várias versões do Python estão instaladas, mas você deseja instalar a API com a versão mais recente instalada; ou
   • Apenas uma única versão do Python está instalada.
   • Se alguma dessas condições se aplicar, consulte Instalar o módulo python executando o lote file sobre.
   • Em todos os outros casos, instale o módulo Python usando pip. Isso geralmente se aplica se:
   • Várias versões do Python estão instaladas, mas você deseja instalar em uma versão específica; ou
   • Várias versões diferentes do Python estão instaladas e você deseja instalar todas elas (neste caso, você deve instalar o módulo para cada versão); ou
   • Apenas uma única versão do Python está instalada, mas você não instalou no PATH.
   • Se alguma dessas condições se aplicar, consulte Instalar o módulo Python executando pip on.

Instale o módulo Python executando o lote file Para fazer isso:

1. Navegue até a pasta de instalação do Python: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. Clique duas vezes em install_tracker_api.bat.
   • O processo de instalação é inicializado automaticamente.

Instale o módulo Python executando o pip

1. Navegue até a pasta Scripts do Python que você deseja usar:
2. Para Python 3, a pasta de instalação padrão é: C:\Users\ \AppData\Local\Programas\Python\Python \Sc rasga
   • Para Python 2.7, a pasta de instalação padrão é: C:\Python27\Scripts
3. Abra uma janela de comando ou PowerShell nessa pasta.
4. Execute o seguinte comando para instalar a API Vicon Core: C: \Usuários\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instalar “C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\vicon_core_api”
   • Execute o seguinte comando para instalar a API C do Tracker: \Usuários\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe instalar “C:\Programa Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

Observação O ex acimaampEles usam uma instalação do Python 3.11 com o Tracker 4.0. Seu caminho e comandos podem ser ligeiramente diferentes.

Verifique se o módulo Python está instalado corretamente

• Verifique se os seguintes módulos foram instalados.
• vicon_core_api: Esta é a API principal de controle remoto e inclui um cliente para comunicação com o servidor de terminal.
• tracker_api: API de serviços para acessar funcionalidades específicas do aplicativo Tracker.
• Para testar se o módulo Tracker Python está instalado corretamente, tente importar um dos módulos em Python: >>> import vicon_core_api

Se o processo acima não reconhecer o módulo, tente o seguinte:

• Verifique a pasta site-packages na instalação do Python para a pasta tracker_api ou vicon_core_api. Para Python 3.11, o local da pasta de instalação padrão é:
  • C:\Usuários\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• Verifique as variáveis ​​de ambiente do sistema e certifique-se de que a pasta de scripts da instalação do Python que você deseja usar seja a mais alta da lista. Para Python 3.11, o local padrão da pasta de instalação é:
  • C:\Usuários\ \AppData\Local\Programas\Python\Python311\Scripts
• Se alguma das pastas dos módulos estiver faltando e você tiver verificado o caminho, execute novamente o processo de instalação descrito em Instalando o módulo Tracker Python em.

Conecte-se ao servidor de terminal

• Para se conectar ao servidor de terminal, primeiro importe o módulo Vicon Core API: >>> import vicon_core_api
  • >>> da importação vicon_core_api
• Em seguida, crie um cliente. Isso tenta se conectar automaticamente ao endereço de host específico na porta padrão (52800) >>> c = Client('localhost')
• Verifique se o cliente se conectou com sucesso ao servidor: >>> print(c.conectado) Verdadeiro
• Se a resposta for False, certifique-se de ter uma instância do Tracker em execução no endereço de host especificado e de que seu firewall não esteja bloqueando o tráfego na porta 52800, antes de criar um novo cliente.
• Depois de se conectar com sucesso, você poderá acessar os serviços fornecidos pelo servidor de terminal Tracker.
• Este example usa serviços de objeto básicos: >>> importar tracker_api >>> de tracker_api importar BasicObjectServices >>> serviços = BasicObjectServices(c)
• Quando estiver conectado, você pode chamar métodos na instância do Tracker.
  • Por exemploamparquivo, para obter uma lista de objetos no painel Tracking, use: >>> result, object_list = services.basic_object_list() >>> print(result)
  • OK: a função foi bem sucedida
  • >>> imprimir(lista_objetos)
  • ['Objeto1', 'Objeto2'…]
• Todas as chamadas de API retornam um código de resultado, descrito em vicon_core_api/result.py.
• Um possível código de falha é Result.RPCNotConnected, que será recebido se a conexão com o servidor de terminal for perdida.
• Por exemploample: >>> resultado, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: A conexão com a função remota ou retorno de chamada não está aberta
• Para exibir uma lista de todas as funções e documentação disponíveis: >>> help( tracker_api)

Exampos scripts

• Você pode encontrar example scripts mostrando o uso de funções API comuns em C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• Todos os scripts possuem documentação e possuem uma opção –help que fornece detalhes dos argumentos relevantes.
• Para executar comoample script, abra uma janela de comando ou power shell na pasta de scripts acima. Você pode fazer isso de duas maneiras:
• Abra o prompt de comando e mude seu diretório para a pasta de scripts: c:\> cd C:\Programa Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• Segure SHIFT + clique com o botão direito na pasta de scripts e selecione Abrir janela de comando aqui ou Abrir janela do Powershell aqui.
• A partir daqui você pode executar o example script de sua escolha.
• O seguinte exampvamos usar a janela de comando.

camera_calibration_wave.py

• Este script demonstra como usar funções de API para controlar o processo de calibração de início e parada da onda da varinha.
  • C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
• Se for bem-sucedido, os controles de calibração serão exibidos

capture_control.py

• Este script mostra como capturar dados ao vivo C:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• O nome do Capture é listado antes dos controles. Para alterar o nome da captura, use capture_services e SetCaptureName.
• Para dúvidas sobre como usar a API Tracker, entre em contato com o Suporte Vicon1.
• 1 mail para:suporte@vicon.com
• Guia de início rápido da API Vicon Tracker Python 31 de maio de 2023, Revisão 1
• Para uso com Rastreador 4.0
• © Copyright 2020–2023 Vicon Motion Systems Limited. Todos os direitos reservados.
• Revisão 1. Para uso com Tracker 4.0
• A Vicon Motion Systems Limited reserva-se o direito de fazer alterações nas informações ou especificações deste documento sem aviso prévio.
• Empresas, nomes e dados usados ​​em exampos arquivos são fictícios, salvo indicação em contrário. Nenhuma parte desta publicação pode ser reproduzida, armazenada em um sistema de recuperação ou transmitida de qualquer forma ou por qualquer meio, eletrônico ou mecânico, por fotocópia ou gravação, ou de outra forma, sem a permissão prévia por escrito da Vicon Motion Systems Ltd.
• Vicon® é uma marca registrada da 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™ são marcas registradas da Oxford Metrics plc.
• VESA® é uma marca registrada de propriedade da VESA (www.vesa.org/about-vesa/). Outros nomes de produtos e empresas aqui mencionados podem ser marcas comerciais de seus respectivos proprietários.
• Para obter reconhecimentos completos e atualizados de direitos autorais e marcas registradas, visite https://www.vicon.com/vicon/copyright-information.
• A Vicon Motion Systems é uma empresa Oxford Metrics plc.
• E-mail: suporte@vicon.com Web: http://www.vicon.com

Documentos / Recursos

API Python do rastreador VICON [pdf] Guia do Usuário Rastreador Python Api, Rastreador, Python Api, Api

Referências

• Manual do usuário