VICON-லோகோ

VICON டிராக்கர் பைதான் API

VICON-Tracker-Python-API-தயாரிப்பு

விவரக்குறிப்புகள்

  • தயாரிப்பு பெயர்: விகான் டிராக்கர் பைதான் ஏபிஐ
  • இணக்கத்தன்மை: டிராக்கர் 4.0
  • ஆதரிக்கப்படும் பைதான் பதிப்புகள்: 2.7 மற்றும் பைதான் 3

தயாரிப்பு பயன்பாட்டிற்கான வழிமுறைகள்

டிராக்கர் API ஐ நிறுவவும்

பைத்தானுடன் டிராக்கர் API ஐப் பயன்படுத்த, இந்தப் படிகளைப் பின்பற்றவும்:

  1. இணக்கத்தன்மையை உறுதிப்படுத்த பைதான் பதிப்பைச் சரிபார்க்கவும்.
  2. பைத்தானை அதிகாரப்பூர்வத்திலிருந்து பதிவிறக்கம் செய்து நிறுவவும் webதளம் மற்றும் பொருத்தமான பதிப்பைத் தேர்ந்தெடுப்பது.
  3. குறிப்பிட்ட கோப்புறையிலிருந்து டிராக்கர் பைதான் தொகுதியைக் கண்டுபிடித்து நிறுவவும்.

பைதான் பதிப்பைச் சரிபார்க்கவும்

  1. கட்டளை வரியில் திறக்கவும்.
  2. 'py' என தட்டச்சு செய்து Enter ஐ அழுத்தவும்.
  3. பைதான் நிறுவப்படவில்லை என்றால், நிறுவல் வழிமுறைகளைப் பார்க்கவும்.

பைத்தானை நிறுவவும்

  1. செல்க பைத்தானின் அதிகாரி webதளம்.
  2. பைத்தானைப் பதிவிறக்கி நிறுவவும், நிறுவலின் போது PATH இல் python.exe ஐச் சேர்ப்பதை உறுதிசெய்யவும்.

டிராக்கர் பைதான் தொகுதியை நிறுவவும்:

  1. நிறுவலைக் கண்டறியவும் fileகுறிப்பிட்ட கோப்புறையில் கள்.
  2. உங்கள் அமைப்பின் அடிப்படையில் நிறுவல் முறையைத் தேர்ந்தெடுக்கவும்.

தொகுப்பை இயக்குவதன் மூலம் பைதான் தொகுதியை நிறுவவும் File:

  1. பைதான் நிறுவல் கோப்புறைக்கு செல்லவும்: சி: நிரல் FilesViconTracker4.xSDKPython
  2. நிறுவல் செயல்முறையைத் தொடங்க 'install_tracker_api.bat' மீது இருமுறை கிளிக் செய்யவும்.

அடிக்கடி கேட்கப்படும் கேள்விகள் (FAQ):

கே: டிராக்கர் API ஐப் பயன்படுத்தி நான் என்ன தானியங்கு செய்யலாம்?

  • A: டிராக்கர் API ஆனது, ஏற்றுதல், விளையாடுதல், தரவை ஏற்றுமதி செய்தல், பொருட்களை செயல்படுத்துதல்/முடக்குதல் மற்றும் பணிப்பாய்வு பகுதிகளைத் தூண்டுதல் போன்ற பொதுவான செயல்பாடுகளை தானியங்குபடுத்த உங்களை அனுமதிக்கிறது.

கே: டிராக்கர் API ஆல் எந்த பைதான் பதிப்புகள் ஆதரிக்கப்படுகின்றன?

  • A: டிராக்கர் ஏபிஐ பைதான் பதிப்புகள் 2.7 மற்றும் பைத்தானை ஆதரிக்கிறது

இந்த வழிகாட்டி பற்றி

  • டிராக்கர் ஏபிஐ, பைதான் ஏபிஐ வழியாக டிராக்கரின் சில அம்சங்களைக் கட்டுப்படுத்த உங்களை அனுமதிக்கிறது.
  • தரவை ஏற்றுதல், விளையாடுதல் மற்றும் ஏற்றுமதி செய்தல், வெவ்வேறு பொருட்களை செயல்படுத்துதல் அல்லது செயலிழக்கச் செய்தல் அல்லது பணிப்பாய்வு பகுதிகளைத் தூண்டுதல் போன்ற டிராக்கரின் சில பொதுவான செயல்பாடுகளை தானியங்குபடுத்த API உங்களுக்கு உதவுகிறது.
  • இந்த ஆவணம் டிராக்கர் API உடன் தொடங்க உங்களை அனுமதிக்கிறது.

டிராக்கர் API ஐ நிறுவவும்

  • பைத்தானுடன் டிராக்கர் API ஐப் பயன்படுத்த, நீங்கள் இரண்டையும் நிறுவியுள்ளீர்கள் என்பதை உறுதிப்படுத்திக் கொள்ள வேண்டும்.
  • டிராக்கர் API ஆனது பைதான் 2.7 மற்றும் பைதான் 3க்கான ஆதரவை வழங்குகிறது. பைதான் 3 இன் குறிப்பிட்ட பதிப்பைப் பயன்படுத்த உங்கள் திட்டப்பணித் தேவையில்லாமல், பைதான் XNUMX இன் சமீபத்திய முழு வெளியீட்டைப் பயன்படுத்துமாறு Vicon பரிந்துரைக்கிறது.

இந்த செயல்முறைகள் நிறுவல் செயல்முறையின் மூலம் உங்களுக்கு வழிகாட்டுகின்றன:

  • பைதான் பதிப்பைச் சரிபார்க்கவும்
  • பைத்தானை நிறுவுகிறது
  • டிராக்கர் பைதான் தொகுதியை நிறுவுகிறது
  • பைதான் தொகுதி சரியாக நிறுவப்பட்டுள்ளதா என சரிபார்க்கவும்

பைதான் பதிப்பைச் சரிபார்க்கவும்

  • நீங்கள் பைதான் நிறுவியிருக்கிறீர்களா அல்லது பைத்தானின் எந்தப் பதிப்பைப் பயன்படுத்துகிறீர்கள் என்பது உங்களுக்குத் தெரியாவிட்டால், நீங்கள் ஒரு கட்டளை வரியைத் திறந்து py கட்டளையை இயக்கலாம்.

உதாரணமாகampலெ:VICON-Tracker-Python-API-fig-1

உங்களிடம் பைதான் நிறுவப்படவில்லை என்றால், பைத்தானை நிறுவு என்பதைப் பார்க்கவும்.

பைத்தானை நிறுவவும் பைதான் 2 அல்லது 3 ஐ நிறுவ:

  1. செல்க  https://www.python.org/downloads/
  2. தேவையான பதிப்பைக் கண்டறிந்து, பைத்தானை நிறுவவும், PATH இல் python.exe ஐ சேர் என்பதை உறுதிப்படுத்தவும்:VICON-Tracker-Python-API-fig-2

மேலே உள்ள படத்தில், நிறுவல் கோப்புறைக்கான உங்கள் பயனர்பெயருடன் ABC மாற்றப்பட்டுள்ளது.

டிராக்கர் பைதான் தொகுதியை நிறுவ, டிராக்கர் பைதான் தொகுதியை நிறுவ:

  1. நிறுவலைக் கண்டறியவும் fileகள். நீங்கள் டிராக்கரை இயல்புநிலை இடத்தில் நிறுவியிருந்தால், அவை இந்தக் கோப்புறையில் காணப்படுகின்றன: C:\Program Files\Vicon\Tracker4.x\SDK\Python
    • இவை fileகள் காட்டப்படும்:VICON-Tracker-Python-API-fig-3
  2. உங்கள் குறிப்பிட்ட நிறுவலைப் பொறுத்து, பின்வரும் வழிகளில் டிராக்கர் பைதான் தொகுதியை நிறுவவும்:
    • தொகுப்பை இயக்குவதே எளிய வழி file (install_tracker_api.bat) இது டிராக்கர் நிறுவலில் சேர்க்கப்பட்டுள்ளது (மேலே உள்ள படத்தில் காட்டப்பட்டுள்ளது).
    • இது பொதுவாக நன்றாக வேலை செய்தால்:
    • PATH மாறியில் பைதான் நிறுவப்பட்டது; அல்லது
    • பைத்தானின் பல பதிப்புகள் நிறுவப்பட்டுள்ளன, ஆனால் நீங்கள் நிறுவிய சமீபத்திய பதிப்பில் API ஐ நிறுவ வேண்டும்; அல்லது
    • பைத்தானின் ஒற்றை பதிப்பு மட்டுமே நிறுவப்பட்டுள்ளது.
    • இந்த நிபந்தனைகளில் ஏதேனும் பொருந்தினால், தொகுப்பை இயக்குவதன் மூலம் பைதான் தொகுதியை நிறுவு என்பதைப் பார்க்கவும் file அன்று.
    • மற்ற எல்லா நிகழ்வுகளிலும், பிப்பைப் பயன்படுத்தி பைதான் தொகுதியை நிறுவவும். இது பொதுவாகப் பொருந்தும்:
    • பைத்தானின் பல பதிப்புகள் நிறுவப்பட்டுள்ளன, ஆனால் நீங்கள் ஒரு குறிப்பிட்ட பதிப்பில் நிறுவ விரும்புகிறீர்கள்; அல்லது
    • பைத்தானின் பல்வேறு பதிப்புகள் நிறுவப்பட்டுள்ளன, மேலும் அவை அனைத்தையும் நிறுவ விரும்புகிறீர்கள் (இந்த விஷயத்தில், ஒவ்வொரு பதிப்பிற்கும் நீங்கள் தொகுதியை நிறுவ வேண்டும்); அல்லது
    • பைத்தானின் ஒற்றை பதிப்பு மட்டுமே நிறுவப்பட்டுள்ளது, ஆனால் நீங்கள் PATH இல் நிறுவவில்லை.
    • இந்த நிபந்தனைகள் ஏதேனும் பொருந்தினால், பைதான் தொகுதியை நிறுவி, பிப்பை இயக்குவதன் மூலம் பார்க்கவும்.

தொகுப்பை இயக்குவதன் மூலம் பைதான் தொகுதியை நிறுவவும் file இதைச் செய்ய:

  1. பைதான் நிறுவல் கோப்புறைக்கு செல்லவும்: சி:\நிரல் Files\Vicon\Tracker4.x\SDK\Python
  2. install_tracker_api.bat ஐ இருமுறை கிளிக் செய்யவும்.
    • நிறுவல் செயல்முறை தானாகவே தொடங்கும்.

பிப்பை இயக்குவதன் மூலம் பைதான் தொகுதியை நிறுவவும்

  1. நீங்கள் பயன்படுத்த விரும்பும் பைத்தானுக்கான ஸ்கிரிப்ட் கோப்புறைக்கு செல்லவும்:
  2. Python 3க்கு, இயல்புநிலை நிறுவல் கோப்புறை: C: \Users\ \AppData\Local\Programs\Python\Python \Sc ரிப்ஸ்
    • 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”
    • டிராக்கர் ஏபிஐ சியை நிறுவ பின்வரும் கட்டளையை இயக்கவும்: \பயனர்கள்\ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe “C:\Program ஐ நிறுவவும் Files\Vicon\Tracker 4.0\SDK\Python\tracker_api”

குறிப்பு மேலே உள்ள முன்னாள்ampடிராக்கர் 3.11 உடன் பைதான் 4.0 நிறுவலைப் பயன்படுத்துகிறது. உங்கள் பாதை மற்றும் கட்டளைகள் சற்று வேறுபடலாம்.

பைதான் தொகுதி சரியாக நிறுவப்பட்டுள்ளதா என சரிபார்க்கவும்

  • பின்வரும் தொகுதிகள் நிறுவப்பட்டுள்ளதா என சரிபார்க்கவும்.
  • vicon_core_api: இது முக்கிய ரிமோட் கண்ட்ரோல் ஏபிஐ மற்றும் டெர்மினல் சர்வருடன் தொடர்புகொள்வதற்கான கிளையண்டை உள்ளடக்கியது.
  • tracker_api: டிராக்கர்-குறிப்பிட்ட பயன்பாட்டு செயல்பாட்டை அணுகுவதற்கான சேவைகள் API.
  • டிராக்கர் பைதான் தொகுதி சரியாக நிறுவப்பட்டுள்ளதா என்பதை சோதிக்க, பைத்தானில் உள்ள தொகுதிகளில் ஒன்றை இறக்குமதி செய்ய முயற்சிக்கவும்: >>> import vicon_core_api

மேலே உள்ள செயல்முறை தொகுதியை அடையாளம் காணத் தவறினால், பின்வருவனவற்றை முயற்சிக்கவும்:

  • tracker_api அல்லது vicon_core_api கோப்புறைக்கு பைதான் நிறுவலில் உள்ள தள-தொகுப்புகள் கோப்புறையைச் சரிபார்க்கவும். பைதான் 3.11க்கு, இயல்புநிலை நிறுவல் கோப்புறையின் இடம்:
    • சி:\பயனர்கள்\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
  • உங்கள் கணினி சூழல் மாறிகளைச் சரிபார்த்து, நீங்கள் பயன்படுத்த விரும்பும் பைதான் நிறுவலுக்கான ஸ்கிரிப்ட் கோப்புறை பட்டியலில் மிக அதிகமாக இருப்பதை உறுதிசெய்யவும். பைதான் 3.11க்கு, நிறுவல் கோப்புறையின் இயல்புநிலை இடம்:
    • சி:\பயனர்கள்\ \AppData\Local\Programs\Python\Python311\Scripts
  • தொகுதிகளின் கோப்புறைகளில் ஏதேனும் ஒன்று விடுபட்டிருந்தால், நீங்கள் பாதையை சரிபார்த்திருந்தால், டிராக்கர் பைதான் தொகுதியை நிறுவுவதில் விவரிக்கப்பட்டுள்ள நிறுவல் செயல்முறையை மீண்டும் இயக்கவும்.

டெர்மினல் சர்வருடன் இணைக்கவும்

  • டெர்மினல் சர்வருடன் இணைக்க, முதலில் Vicon Core API தொகுதியை இறக்குமதி செய்யவும்: >>> vicon_core_api ஐ இறக்குமதி செய்யவும்
    • >>> vicon_core_api இறக்குமதியிலிருந்து
  • அடுத்து, ஒரு கிளையண்டை உருவாக்கவும். இது தானாகவே இயல்புநிலை போர்ட்டில் (52800) >>> c = Client('localhost') குறிப்பிட்ட ஹோஸ்ட் முகவரியுடன் இணைக்க முயற்சிக்கிறது.
  • கிளையன்ட் வெற்றிகரமாக சர்வருடன் இணைக்கப்பட்டுள்ளதா என்பதைச் சரிபார்க்கவும்: >>> அச்சு(c.connected) உண்மை
  • பதில் தவறு எனில், குறிப்பிட்ட ஹோஸ்ட் முகவரியில் டிராக்கர் இயங்கியிருப்பதை உறுதிசெய்து, புதிய கிளையண்டை உருவாக்கும் முன், உங்கள் ஃபயர்வால் போர்ட் 52800 இல் போக்குவரத்தைத் தடுக்கவில்லை.
  • நீங்கள் வெற்றிகரமாக இணைக்கப்பட்டதும், டிராக்கர் டெர்மினல் சர்வர் வழங்கும் சேவைகளை அணுகலாம்.
  • இந்த முன்னாள்ample அடிப்படை பொருள் சேவைகளைப் பயன்படுத்துகிறது: >>> tracker_api இறக்குமதி >>> tracker_api இலிருந்து BasicObjectServices இறக்குமதி >>> சேவைகள் = BasicObjectServices(c)
  • இது இணைக்கப்படும் போது, ​​நீங்கள் டிராக்கர் நிகழ்வில் முறைகளை அழைக்கலாம்.
    • உதாரணமாகample, டிராக்கிங் பேனலில் உள்ள பொருட்களின் பட்டியலைப் பெற, இதைப் பயன்படுத்தவும்: >>> முடிவு, object_list = services.basic_object_list() >>> அச்சு(முடிவு)
    • சரி: செயல்பாடு வெற்றி பெற்றது
    • >>> அச்சு(object_list)
    • ['ஆப்ஜெக்ட்1', 'ஆப்ஜெக்ட்2'...]
  • அனைத்து API அழைப்புகளும் முடிவுக் குறியீட்டை வழங்கும், இது vicon_core_api/result.py இல் விவரிக்கப்பட்டுள்ளது.
  • ஒரு சாத்தியமான தோல்விக் குறியீடு Result.RPCNotConnected ஆகும், இது டெர்மினல் சேவையகத்திற்கான இணைப்பு தொலைந்தால் பெறப்படும்.
  • உதாரணமாகample: >>> முடிவு, object_list = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: ரிமோட் செயல்பாடு அல்லது கால்பேக்கிற்கான இணைப்பு திறக்கப்படவில்லை
  • கிடைக்கக்கூடிய அனைத்து செயல்பாடுகள் மற்றும் ஆவணங்களின் பட்டியலைக் காண்பிக்க: >>> உதவி( tracker_api)

Example ஸ்கிரிப்டுகள்

  • நீங்கள் முன்னாள் கண்டுபிடிக்க முடியும்ample ஸ்கிரிப்டுகள் பொதுவான API செயல்பாடுகளின் பயன்பாட்டைக் காட்டுகிறது சி:\நிரல் Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
  • அனைத்து ஸ்கிரிப்ட்களிலும் ஆவணங்கள் உள்ளன மற்றும் தொடர்புடைய வாதங்களின் விவரங்களை வழங்கும் உதவி விருப்பத்தை எடுத்துக்கொள்கின்றன.
  • என இயக்கample script, மேலே உள்ள ஸ்கிரிப்ட் கோப்புறையில் கட்டளை சாளரம் அல்லது பவர் ஷெல் திறக்கவும். நீங்கள் இதை இரண்டு வழிகளில் ஒன்றில் செய்யலாம்:
  • கட்டளை வரியைத் திறந்து உங்கள் கோப்பகத்தை ஸ்கிரிப்ட் கோப்புறைக்கு மாற்றவும்: c:\> cd C:\Program Files\Vicon\ட்ராக்கர்
    • 4.0\SDK\Python\sample_scripts
  • ஸ்கிரிப்ட்கள் கோப்புறையில் SHIFT+வலது-கிளிக் செய்து, இங்கே கட்டளை சாளரத்தைத் திற அல்லது இங்கே பவர்ஷெல் சாளரத்தைத் திற என்பதைத் தேர்ந்தெடுக்கவும்.
  • இங்கிருந்து நீங்கள் முன்னாள் இயக்க முடியும்ampஉங்கள் விருப்பப்படி ஸ்கிரிப்ட்.
  • பின்வரும் முன்னாள்amples கட்டளை சாளரத்தைப் பயன்படுத்துகிறது.

camera_calibration_wave.py

  • இந்த ஸ்கிரிப்ட், மந்திரக்கோலை அலையை தொடங்கி நிறுத்தும் அளவுத்திருத்த செயல்முறையை கட்டுப்படுத்த API செயல்பாடுகளை எவ்வாறு பயன்படுத்துவது என்பதை விளக்குகிறது.
    • சி:\நிரல் Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py camera_calibration_wave.py
  • வெற்றிகரமாக இருந்தால், அளவுத்திருத்தக் கட்டுப்பாடுகள் காட்டப்படும்VICON-Tracker-Python-API-fig-4

catch_control.py

  • இந்த ஸ்கிரிப்ட் நேரடி தரவு C:\Program ஐ எவ்வாறு கைப்பற்றுவது என்பதைக் காட்டுகிறது Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py catch_control.pyVICON-Tracker-Python-API-fig-5
  • பிடிப்பு பெயர் கட்டுப்பாடுகளுக்கு முன் பட்டியலிடப்பட்டுள்ளது. பிடிப்பு பெயரை மாற்ற, capture_services மற்றும் SetCaptureName ஐப் பயன்படுத்தவும்.
  • டிராக்கர் API ஐப் பயன்படுத்துவது பற்றிய கேள்விகளுக்கு, Vicon Support1ஐத் தொடர்பு கொள்ளவும்.
  • 1 அஞ்சல்:support@vicon.com
  • Vicon Tracker Python API விரைவு தொடக்க வழிகாட்டி 31 மே 2023, திருத்தம் 1
  • டிராக்கர் 4.0 உடன் பயன்படுத்த
  • © பதிப்புரிமை 2020–2023 Vicon Motion Systems Limited. அனைத்து உரிமைகளும் பாதுகாக்கப்பட்டவை.
  • திருத்தம் 1. டிராக்கர் 4.0 உடன் பயன்படுத்த
  • விகான் மோஷன் சிஸ்டம்ஸ் லிமிடெட் இந்த ஆவணத்தில் உள்ள தகவல் அல்லது விவரக்குறிப்புகளில் அறிவிப்பு இல்லாமல் மாற்றங்களைச் செய்யும் உரிமையை கொண்டுள்ளது.
  • Ex இல் பயன்படுத்தப்படும் நிறுவனங்கள், பெயர்கள் மற்றும் தரவுampகுறிப்பிடப்படாத வரை les கற்பனையானவை. விகான் மோஷன் சிஸ்டம்ஸ் லிமிடெட்டின் முன் எழுத்துப்பூர்வ அனுமதியின்றி, இந்த வெளியீட்டின் எந்தப் பகுதியையும் மீண்டும் உருவாக்கவோ, மீட்டெடுக்கும் அமைப்பில் சேமிக்கவோ அல்லது எந்த வடிவத்திலும் அல்லது எந்த வகையிலும், மின்னணு அல்லது இயந்திர, புகைப்பட நகல் அல்லது பதிவு செய்தல் அல்லது வேறுவிதமாக அனுப்பக்கூடாது.
  • Vicon® என்பது Oxford Metrics plc இன் பதிவு செய்யப்பட்ட வர்த்தக முத்திரையாகும். Vicon கண்ட்ரோல்™, 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/). இங்குள்ள பிற தயாரிப்பு மற்றும் நிறுவனத்தின் பெயர்கள் அந்தந்த உரிமையாளர்களின் வர்த்தக முத்திரைகளாக இருக்கலாம்.
  • முழு மற்றும் புதுப்பித்த பதிப்புரிமை மற்றும் வர்த்தக முத்திரை ஒப்புதல்களுக்கு, பார்வையிடவும் https://www.vicon.com/vicon/copyright-information.
  • விகான் மோஷன் சிஸ்டம்ஸ் என்பது ஆக்ஸ்போர்டு மெட்ரிக்ஸ் பிஎல்சி நிறுவனமாகும்.
  • மின்னஞ்சல்: support@vicon.com Web: http://www.vicon.com

ஆவணங்கள் / ஆதாரங்கள்

விகான் டிராக்கர் பைதான் ஏபிஐ [pdf] பயனர் வழிகாட்டி
டிராக்கர் பைதான் அபி, டிராக்கர், பைதான் அபி, ஏபி

குறிப்புகள்

கருத்து தெரிவிக்கவும்

உங்கள் மின்னஞ்சல் முகவரி வெளியிடப்படாது. தேவையான புலங்கள் குறிக்கப்பட்டுள்ளன *