VICON Tracker Python API 사용자 가이드

내용물 숨다

1 VICON 트래커 Python API

2 제품 사용 지침

VICON 트래커 Python API

명세서

제품 이름: Vicon 추적기 Python API
호환성: 트래커 4.0
지원되는 Python 버전: 2.7과 파이썬 3

제품 사용 지침

추적기 API 설치

Python에서 Tracker API를 사용하려면 다음 단계를 따르세요.

호환성을 확인하려면 Python 버전을 확인하세요.
공식 사이트에서 Python을 다운로드하여 설치하세요. web사이트를 방문하여 적절한 버전을 선택하세요.
지정된 폴더에서 Tracker Python 모듈을 찾아 설치합니다.

파이썬 버전 확인

명령 프롬프트를 엽니다.
'py'를 입력하고 Enter를 누르세요.
Python이 설치되어 있지 않은 경우 설치 지침을 참조하세요.

파이썬 설치

이동하다 파이썬의 공식 web대지.
Python을 다운로드하고 설치합니다. 설치 중에 python.exe를 PATH에 추가해야 합니다.

Tracker Python 모듈을 설치합니다.

설치 찾기 file지정된 폴더에 있습니다.
설정에 따라 설치 방법을 선택하세요.

배치를 실행하여 Python 모듈 설치 File:

Python 설치 폴더: C: Program으로 이동합니다. FilesViconTracker4.xSDKPython
설치 프로세스를 시작하려면 'install_tracker_api.bat'를 두 번 클릭하세요.

자주 묻는 질문(FAQ):

Q: Tracker API를 사용하여 무엇을 자동화할 수 있습니까?

A: Tracker API를 사용하면 데이터 로드, 재생, 내보내기, 개체 활성화/비활성화, 워크플로 부분 트리거와 같은 일반적인 기능을 자동화할 수 있습니다.

Q: Tracker API는 어떤 Python 버전을 지원합니까?

A: Tracker API는 Python 버전 2.7 및 Python을 지원합니다.

이 가이드에 대하여

Tracker API를 사용하면 Python API를 통해 Tracker의 특정 기능을 제어할 수 있습니다.

API를 사용하면 데이터 로드, 재생 및 내보내기, 다양한 개체 활성화 또는 비활성화, 작업 흐름 일부 트리거 등 Tracker의 일부 일반적인 기능을 자동화할 수 있습니다.
이 문서를 사용하면 Tracker API를 시작할 수 있습니다.

추적기 API 설치

Python에서 Tracker API를 사용하려면 둘 다 설치되어 있는지 확인해야 합니다.
Tracker API는 Python 2.7 및 Python 3에 대한 지원을 제공합니다. Vicon은 프로젝트에서 특정 Python 버전을 사용해야 하는 경우를 제외하고 Python 3의 최신 전체 릴리스를 사용할 것을 권장합니다.

다음 절차는 설치 프로세스를 안내합니다.

Python 버전을 확인하세요
Python 설치
Tracker Python 모듈 설치
Python 모듈이 올바르게 설치되었는지 확인하세요.

파이썬 버전 확인

Python이 설치되어 있는지 또는 사용 중인 Python 버전이 확실하지 않은 경우 명령 프롬프트를 열고 py 명령을 실행할 수 있습니다.

예를 들어amp르 :

Python이 설치되어 있지 않은 경우 Python 설치를 참조하세요.

파이썬 설치 Python 2 또는 3을 설치하려면 다음 안내를 따르세요.

이동하다 https://www.python.org/downloads/
필요한 버전을 찾아 Python을 설치하고 Add python.exe to PATH가 선택되어 있는지 확인합니다.

위 이미지에서 ABC는 설치 폴더의 사용자 이름으로 대체됩니다.

Tracker Python 모듈 설치 Tracker Python 모듈을 설치하려면:

설치 찾기 file에스. 기본 위치에 Tracker를 설치한 경우 C:\Program 폴더에 있습니다. Files\Vicon\Tracker4.x\SDK\Python
- 이것들 files가 표시됩니다:

특정 설치에 따라 다음 방법 중 하나로 Tracker Python 모듈을 설치합니다.
- 가장 간단한 방법은 배치를 실행하는 것입니다. file (위 이미지 참조) Tracker 설치에 포함된 (install_tracker_api.bat)
- 이는 일반적으로 다음과 같은 경우에 잘 작동합니다.
- Python이 PATH 변수에 설치되었습니다. 또는
- 여러 버전의 Python이 설치되어 있지만 API를 설치한 최신 버전으로 설치하려고 합니다. 또는
- 단일 버전의 Python만 설치됩니다.
- 이러한 조건 중 하나라도 적용되는 경우 일괄 처리를 실행하여 Python 모듈 설치를 참조하세요. file 에.
- 다른 모든 경우에는 pip를 사용하여 Python 모듈을 설치합니다. 이는 일반적으로 다음과 같은 경우에 적용됩니다.
- 여러 버전의 Python이 설치되어 있지만 특정 버전으로 설치하려고 합니다. 또는
- 여러 다른 버전의 Python이 설치되어 있고 모든 버전에 설치하려고 합니다(이 경우 각 버전에 대한 모듈을 설치해야 합니다). 또는
- 단일 버전의 Python만 설치되었지만 PATH에 설치하지 않았습니다.
- 이러한 조건 중 하나라도 적용되면 pip를 실행하여 Python 모듈 설치를 참조하세요.

배치를 실행하여 Python 모듈을 설치합니다. file 이렇게 하려면:

Python 설치 폴더로 이동합니다. C:\프로그램 Files\Vicon\Tracker4.x\SDK\Python
install_tracker_api.bat를 두 번 클릭합니다.
- 설치 프로세스가 자동으로 초기화됩니다.

pip를 실행하여 Python 모듈을 설치합니다.

사용하려는 Python의 Scripts 폴더로 이동합니다.
Python 3의 경우 기본 설치 폴더는 C:\Users\입니다. \AppData\Local\Programs\Python\Python \Sc 립
- Python 2.7의 경우 기본 설치 폴더는 C:\Python27\Scripts입니다.

해당 폴더에서 명령 창이나 PowerShell을 엽니다.
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이 파일은 Tracker 3.11과 함께 Python 4.0 설치를 사용합니다. 경로와 명령은 약간 다를 수 있습니다.

Python 모듈이 올바르게 설치되었는지 확인하십시오.

다음 모듈이 설치되어 있는지 확인하십시오.
vicon_core_api: 이는 핵심 원격 제어 API이며 터미널 서버와 통신하기 위한 클라이언트를 포함합니다.
tracker_api: Tracker별 애플리케이션 기능에 액세스하기 위한 서비스 API입니다.
Tracker Python 모듈이 올바르게 설치되었는지 테스트하려면 Python에서 모듈 중 하나를 가져와 보십시오. >>> import vicon_core_api

위의 프로세스에서 모듈을 인식하지 못하는 경우 다음을 시도해 보십시오.

tracker_api 또는 vicon_core_api 폴더에 대한 Python 설치의 site-packages 폴더를 확인하십시오. Python 3.11의 경우 기본 설치 폴더 위치는 다음과 같습니다.
- C:\사용자\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
시스템 환경 변수를 확인하고 사용하려는 Python 설치용 스크립트 폴더가 목록에서 가장 높은 곳에 있는지 확인하세요. Python 3.11의 경우 설치 폴더의 기본 위치는 다음과 같습니다.
- C:\사용자\ \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) 참
응답이 False인 경우 새 클라이언트를 생성하기 전에 지정된 호스트 주소에서 실행 중인 Tracker 인스턴스가 있고 방화벽이 포트 52800에서 트래픽을 차단하지 않는지 확인하세요.
성공적으로 연결되면 Tracker 터미널 서버에서 제공하는 서비스에 접근할 수 있습니다.
이 전amp파일은 기본 개체 서비스를 사용합니다. >>> import tracker_api >>> tracker_api에서 import BasicObjectServices >>> services = BasicObjectServices(c)
연결되면 Tracker 인스턴스에서 메서드를 호출할 수 있습니다.
- 예를 들어amp파일, 추적 패널에서 개체 목록을 가져오려면 다음을 사용합니다. >>> result, object_list = services.basic_object_list() >>> print(result)
- 좋아요: 함수가 성공했습니다
- >>> 인쇄(객체_목록)
- ['객체1', '객체2'…]

모든 API 호출은 vicon_core_api/result.py에 설명된 결과 코드를 반환합니다.
가능한 오류 코드 중 하나는 터미널 서버에 대한 연결이 끊어진 경우 수신되는 Result.RPCNotConnected입니다.
예를 들어ample: >>> 결과, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: 원격 함수 또는 콜백에 대한 연결이 열려 있지 않습니다.

사용 가능한 모든 기능 및 문서 목록을 표시하려면: >>> help( tracker_api)

Examp르 스크립트

전직을 찾을 수 있습니다amp일반적인 API 함수의 사용을 보여주는 파일 스크립트 C:\프로그램 Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
모든 스크립트에는 문서가 있으며 관련 인수에 대한 세부 정보를 제공하는 –help 옵션을 사용합니다.

다음으로 실행하려면amp파일 스크립트를 실행하려면 위의 스크립트 폴더에서 명령 창이나 Power Shell을 엽니다. 다음 두 가지 방법 중 하나로 이 작업을 수행할 수 있습니다.
명령 프롬프트를 열고 디렉터리를 scripts 폴더로 변경합니다. c:\> cd C:\프로그램 Files\Vicon\Tracker
- 4.0\SDK\Python\sample_scripts
스크립트 폴더에서 Shift 키를 누른 채 마우스 오른쪽 버튼을 클릭하고 여기에서 명령 창 열기 또는 여기에서 Powershell 창 열기를 선택합니다.

여기에서 ex를 실행할 수 있습니다amp원하는 스크립트를 선택하세요.
다음 예amp명령 창을 사용합니다.

Camera_calibration_wave.py

이 스크립트는 API 함수를 사용하여 완드 웨이브 시작 및 중지의 교정 프로세스를 제어하는 방법을 보여줍니다.
- C:\프로그램 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_services 및 SetCaptureName을 사용하십시오.
Tracker API 사용에 대한 질문이 있는 경우 Vicon 지원1에 문의하세요.
1 메일:support@vicon.com
Vicon Tracker Python API 빠른 시작 가이드 31년 2023월 1일, 개정 XNUMX

추적기 4.0과 함께 사용
개정 1. Tracker 4.0과 함께 사용
Vicon Motion Systems Limited는 사전 통지 없이 이 문서의 정보나 사양을 변경할 권리를 보유합니다.
ex에 사용된 회사, 이름 및 데이터amp파일은 달리 명시되지 않는 한 가상입니다. 이 출판물의 어떤 부분도 Vicon Motion Systems Ltd.의 사전 서면 승인 없이 복제하거나 검색 시스템에 저장하거나 전자적 또는 기계적, 복사 또는 녹음을 통한 어떠한 형태나 수단으로도 전송할 수 없습니다.

Vicon®은 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™ 및 Vicon Vue™는 Oxford Metrics plc의 상표입니다.
VESA®는 VESA 소유의 등록 상표입니다. (www.vesa.org/about-vesa/). 여기에 있는 기타 제품 및 회사 이름은 해당 소유자의 상표일 수 있습니다.

Vicon Motion Systems는 Oxford Metrics plc 회사입니다.
이메일: support@vicon.com Web: http://www.vicon.com

문서 / 리소스

VICON 트래커 Python API [PDF 파일] 사용자 가이드
추적기 Python Api, 추적기, Python Api, Api

참고문헌

사용자 설명서