VICON Tracker Python API

ספּעסאַפאַקיישאַנז

• פּראָדוקט נאָמען: Vicon Tracker Python API
• קאַמפּאַטאַבילאַטי: טראַקער 4.0
• שטיצט פּיטהאָן ווערסיעס: 2.7 און Python 3

פּראָדוקט באַניץ אינסטרוקציעס

ינסטאַלירן די Tracker API

צו נוצן די Tracker API מיט Python, נאָכגיין די סטעפּס:

1. קוק די Python ווערסיע צו ענשור קאַמפּאַטאַבילאַטי.
2. ינסטאַלירן פּיטהאָן דורך דאַונלאָודינג עס פֿון דער באַאַמטער webפּלאַץ און סעלעקטירן די צונעמען ווערסיע.
3. געפֿינען און ינסטאַלירן די Tracker Python מאָדולע פֿון די ספּעסאַפייד טעקע.

קוק די Python ווערסיע

1. עפענען אַ באַפֿעל פּינטלעך.
2. טיפּ 'פּי' און דריקן אַרייַן.
3. אויב Python איז נישט אינסטאַלירן, אָפּשיקן צו די ינסטאַלירונג אינסטרוקציעס.

ינסטאַלירן פּיטהאָן

1. גיין צו דער באַאַמטער פון Python webפּלאַץ.
2. אראפקאפיע און ינסטאַלירן Python, ינשורינג צו לייגן python.exe צו PATH בעשאַס ינסטאַלירונג.

ינסטאַלירן די טראַקער פּיטהאָן מאָדולע:

1. געפֿינען די ינסטאַלירונג files אין די ספּעסאַפייד טעקע.
2. קלייַבן די ייַנמאָנטירונג אופֿן באזירט אויף דיין סעטאַפּ.

ינסטאַלירן די פּיטהאָן מאָדולע דורך פליסנדיק די פּעקל File:

1. נאַוויגירן צו די Python ינסטאַלירן טעקע: C: פּראָגראַם FilesViconTracker4.xSDKPython
2. טאָפּל גיט אויף 'install_tracker_api.bat' צו אָנהייבן די ינסטאַלירונג פּראָצעס.

אָפט געשטעלטע פֿראגן (FAQ):

ק: וואָס קענען איך אָטאַמייט ניצן די Tracker API?

• A: די Tracker API אַלאַוז איר צו אָטאַמייט פּראָסט פאַנגקשאַנז אַזאַ ווי לאָודינג, פּלייינג, עקספּאָרטינג דאַטן, אַקטאַווייטינג / דיאַקטיווייטינג אַבדזשעקץ און טריגערינג וואָרקפלאָוו פּאַרץ.

ק: וואָס פּיטהאָן ווערסיעס זענען געשטיצט דורך די טראַקער אַפּי?

• A: די טראַקער אַפּי שטיצט פּיטהאָן ווערסיעס 2.7 און פּיטהאָן

וועגן דעם פירער

• די Tracker API אַלאַוז איר צו קאָנטראָלירן זיכער פֿעיִקייטן פון Tracker דורך אַ Python API.
• די אַפּי ינייבאַלז איר צו אָטאַמייט עטלעכע פּראָסט פאַנגקשאַנז פון טראַקער, אַזאַ ווי לאָודינג, פּלייינג און עקספּאָרטינג דאַטן, אַקטאַווייטינג אָדער דיאַקטיווייטינג פאַרשידענע אַבדזשעקץ אָדער טריגערינג פּאַרץ פון די וואָרקפלאָוו.
• דעם דאָקומענט אַלאַוז איר צו אָנהייבן מיט די Tracker API.

ינסטאַלירן די Tracker API

• צו נוצן די Tracker API מיט Python, איר מוזן מאַכן זיכער אַז ביידע זענען אינסטאַלירן.
• די טראַקער אַפּי גיט שטיצן פֿאַר פּיטהאָן 2.7 און פּיטהאָן 3. וויקאָן רעקאַמענדז אַז איר נוצן די לעצטע פול מעלדונג פון פּיטהאָן 3 סייַדן דיין פּרויעקט ריקווייערז איר צו נוצן אַ ספּעציפיש ווערסיע פון ​​​​פּיטהאָן.

די פּראָוסידזשערז פירן איר דורך די ינסטאַלירונג פּראָצעס:

• קוק די Python ווערסיע אויף
• ינסטאָלינג פּיטהאָן אויף
• ינסטאַלירן די Tracker Python מאָדולע אויף
• קאָנטראָלירן אַז די Python מאָדולע איז אינסטאַלירן ריכטיק אויף

קוק די פּיטהאָן ווערסיע

• אויב איר זענט נישט זיכער אויב איר האָט אינסטאַלירן Python אָדער וואָס ווערסיע פון ​​​​Python איר נוצן, איר קענען עפֿענען אַ באַפֿעל פּינטלעך און לויפן די py באַפֿעל.

פֿאַר עקסampלאַ:

אויב איר טאָן ניט האָבן פּיטהאָן אינסטאַלירן, זען ינסטאַלירן פּיטהאָן.

ינסטאַלירן פּיטהאָן צו ינסטאַלירן Python 2 אָדער 3:

1. גיין צו  https://www.python.org/downloads/
2. געפֿינען די פארלאנגט ווערסיע און ינסטאַלירן Python, און ינשורינג אַז לייג python.exe צו PATH איז אויסגעקליבן:

אין די אויבן בילד, ABC איז ריפּלייסט מיט דיין נאמען פֿאַר די ינסטאַלירונג טעקע.

ינסטאַלירן די Tracker Python מאָדולע צו ינסטאַלירן די Tracker Python מאָדולע:

1. געפֿינען די ינסטאַלירונג fileס. אויב איר אינסטאַלירן טראַקער אין די פעליקייַט אָרט, זיי זענען געפֿונען אין דעם טעקע: C: \ פּראָגראַם Files\Vicon\Tracker4.x\SDK\Python
   • די files זענען געוויזן:
2. ינסטאַלירן די Tracker Python מאָדולע אין איינער פון די פאלגענדע וועגן, דיפּענדינג אויף דיין באַזונדער ינסטאַלירונג:
   • די סימפּלאַסט וועג איז צו לויפן די פּעקל file (install_tracker_api.bat) וואָס איז אַרייַנגערעכנט אין די טראַקער ינסטאַלירונג (ווי געוויזן אין די אויבן בילד).
   • דאָס יוזשאַוואַלי אַרבעט גוט אויב:
   • פּיטהאָן איז אינסטאַלירן צו די PATH בייַטעוודיק; אָדער
   • קייפל ווערסיעס פון פּיטהאָן זענען אינסטאַלירן, אָבער איר ווילן צו ינסטאַלירן די אַפּי צו די לעצט ווערסיע אַז איר אינסטאַלירן; אָדער
   • בלויז אַ איין ווערסיע פון ​​​​פּיטהאָן איז אינסטאַלירן.
   • אויב קיין פון די באדינגונגען אַפּלייז, זען ינסטאַלירן די פּיטהאָן מאָדולע דורך פליסנדיק די פּעקל file אויף.
   • אין אַלע אנדערע קאַסעס, ינסטאַלירן די Python מאָדולע דורך ניצן פּיפּ. דאָס יוזשאַוואַלי אַפּלייז אויב:
   • קייפל ווערסיעס פון פּיטהאָן זענען אינסטאַלירן, אָבער איר ווילן צו ינסטאַלירן צו אַ ספּעציפיש ווערסיע; אָדער
   • קייפל פאַרשידענע ווערסיעס פון פּיטהאָן זענען אינסטאַלירן און איר ווילן צו ינסטאַלירן זיי אַלע (אין דעם פאַל, איר מוזן ינסטאַלירן די מאָדולע פֿאַר יעדער ווערסיע); אָדער
   • בלויז אַ איין ווערסיע פון ​​​​פּיטהאָן איז אינסטאַלירן, אָבער איר האָט נישט אינסטאַלירן PATH.
   • אויב קיין פון די באדינגונגען אַפּלייז, זען ינסטאַלירן די פּיטהאָן מאָדולע דורך פליסנדיק פּיפּ אויף.

ינסטאַלירן די Python מאָדולע דורך לויפן די פּעקל file צו טאָן דאָס:

1. נאַוויגירן צו די Python ינסטאַלירן טעקע: C: \ פּראָגראַם Files\Vicon\Tracker4.x\SDK\Python
2. טאָפּל-גיט install_tracker_api.bat.
   • דער ייַנמאָנטירונג פּראָצעס ינישאַלייזיז אויטאָמאַטיש.

ינסטאַלירן די פּיטהאָן מאָדולע דורך לויפן די פּיפּ

1. נאַוויגירן צו די סקריפּטס טעקע פֿאַר די פּיטהאָן וואָס איר ווילן צו נוצן:
2. פֿאַר Python 3, די פעליקייַט ינסטאַלירונג טעקע איז: C: \Users\ \AppData\Local\Programs\Python\Python \ סק ריפּס
   • פֿאַר 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"
   • לויפן די פאלגענדע באַפֿעל צו ינסטאַלירן די Tracker API C: \ יוזערז \ \AppData\Local\Programs\Python\Python311\Scrip ts> .\pip.exe ינסטאַלירן "C:\Program Files\Vicon\Tracker 4.0\SDK\Python\tracker_api"

באַמערקונג די אויבן עקסampניצן אַ Python 3.11 ינסטאַלירונג מיט Tracker 4.0. דיין דרך און קאַמאַנדז קען זיין אַ ביסל אַנדערש.

קאָנטראָלירן אַז די Python מאָדולע איז אינסטאַלירן ריכטיק

• קאָנטראָלירן אַז די פאלגענדע מאַדזשולז זענען אינסטאַלירן.
• vicon_core_api: דאָס איז די האַרץ ווייַט קאָנטראָל אַפּי און כולל אַ קליענט פֿאַר קאָמוניקאַציע מיט די וואָקזאַל סערווער.
• טראַקער_אַפּי: סערוויס אַפּי פֿאַר אַקסעס טראַקער-ספּעציפיש אַפּלאַקיישאַן פאַנגקשאַנאַליטי.
• צו פּרובירן אַז די טראַקער פּיטהאָן מאָדולע איז אינסטאַלירן ריכטיק, פּרוּווט ימפּאָרטינג איינער פון די מאַדזשולז אין פּיטהאָן: >>> אַרייַנפיר vicon_core_api

אויב די אויבן פּראָצעס פיילז צו דערקענען די מאָדולע, פּרובירן די פאלגענדע:

• קוק די פּלאַץ-פּאַקידזשיז טעקע אין די Python ייַנמאָנטירונג פֿאַר די tracker_api אָדער vicon_core_api טעקע. פֿאַר Python 3.11, דער אָרט פון די פעליקייַט ינסטאַלירונג טעקע איז:
  • C:\Users\ \AppData\Local\Programs\Python\Python311\Lib\site-packages
• קאָנטראָלירן דיין סיסטעם סוויווע וועריאַבאַלז און ענשור אַז די סקריפּס טעקע פֿאַר די Python ייַנמאָנטירונג איר ווילן צו נוצן איז די העכסטן אין דער רשימה. פֿאַר Python 3.11, די פעליקייַט אָרט פון די ינסטאַלירונג טעקע איז:
  • C:\Users\ \AppData\Local\Programs\Python\Python311\Scripts
• אויב איינער פון די פאָלדערס פון די מאַדזשולז איז פעלנדיק און איר האָט וועראַפייד דעם דרך, לויפן די ינסטאַלירונג פּראָצעס דיסקרייבד אין ינסטאָלינג די טראַקער פּיטהאָן מאָדולע אויף.

פאַרבינדן צו די וואָקזאַל סערווער

• צו פאַרבינדן צו די וואָקזאַל סערווער, ערשטער אַרייַנפיר די Vicon Core API מאָדולע: >>> אַרייַנפיר vicon_core_api
  • >>> פֿון vicon_core_api אַרייַנפיר
• ווייַטער, שאַפֿן אַ קליענט. דעם אויטאָמאַטיש פרוווט צו פאַרבינדן צו די ספּעציפיש באַלעבאָס אַדרעס אויף די פעליקייַט פּאָרט (52800) >>> c = Client ('localhost')
• קאָנטראָלירן אַז דער קליענט איז הצלחה קאָננעקטעד צו די סערווער: >>> דרוק (ק. קאָננעקטעד) אמת
• אויב דער ענטפער איז פאַלש, פאַרזיכערן אַז איר האָבן אַ בייַשפּיל פון טראַקער פליסנדיק אויף די ספּעסיפיעד באַלעבאָס אַדרעס און דיין פיירוואַל איז נישט בלאַקינג פאַרקער אויף פּאָרט 52800 איידער איר שאַפֿן אַ נייַע קליענט.
• ווען איר האָט הצלחה קאָננעקטעד, איר קענט אַקסעס די סערוויסעס צוגעשטעלט דורך די טראַקער וואָקזאַל סערווער.
• דעם עקסample ניצט יקערדיק כייפעץ באַדינונגס: >>> אַרייַנפיר טראַקער_אַפּי >>> פֿון טראַקער_אַפּי אַרייַנפיר באַסיקאָבדזשעקטסערוויסעס >>> באַדינונגס = באַסיקאָבדזשעקטסערוויסעס (C)
• ווען עס איז קאָננעקטעד, איר קענען רופן מעטהאָדס אויף די טראַקער בייַשפּיל.
  • פֿאַר עקסampצו באַקומען אַ רשימה פון אַבדזשעקץ אין די טראַקינג טאַפליע, נוצן: >>> רעזולטאַט, אָבדזשעקט_ליסט = services.basic_object_list () >>> דרוקן (רעזולטאַט)
  • אקעי: די פֿונקציע איז געראָטן
  • >>> דרוק (אָבדזשעקט_ליסט)
  • ['אָבדזשעקט 1', 'אָבדזשעקט 2'...]
• אַלע אַפּי קאַללס צוריקקומען אַ רעזולטאַט קאָד, וואָס איז דיסקרייבד אין vicon_core_api/result.py.
• איינער מעגלעך דורכפאַל קאָד איז Result.RPCNotConnected, וואָס איז באקומען אויב די קשר צו די וואָקזאַל סערווער איז פאַרפאַלן.
• פֿאַר עקסample: >>> רעזולטאַט, אָבדזשעקט_ליסט = services.basic_object_list() vicon_core_api.client.RPCError: RPCNotConnected: די קשר צו די ווייַט פונקציע אָדער קאַללבאַקק איז נישט אָפן
• צו ווייַזן אַ רשימה פון אַלע בנימצא פאַנגקשאַנז און דאַקיומענטיישאַן: >>> הילף (tracker_api)

Exampדי סקריפּס

• איר קענען געפֿינען עקסampדי סקריפּס וואָס ווייַזן די נוצן פון פּראָסט אַפּי פאַנגקשאַנז אין C: \ פּראָגראַם Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• אַלע די סקריפּס האָבן דאַקיומענטיישאַן און נעמען אַ -הילף אָפּציע וואָס גיט דעטאַילס פון די באַטייַטיק אַרגומענטן.
• צו לויפן וויample script, עפענען אַ באַפֿעל פֿענצטער אָדער מאַכט שאָל אין די סקריפּס טעקע אויבן. איר קענען טאָן דאָס אין איינער פון צוויי וועגן:
• עפֿענען די באַפֿעל פּינטלעך און טוישן דיין וועגווייַזער צו די סקריפּס טעקע: c:\> cd C:\ פּראָגראַם Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• האַלטן SHIFT + רעכט גיט אין די סקריפּס טעקע און סעלעקטירן עפֿן באַפֿעלן פֿענצטער דאָ אָדער עפֿן פּאָווערשעלל פֿענצטער דאָ.
• פון דאָ איר קענען לויפן די עקס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: \ פּראָגראַם Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts> py capture_control.py
• די קאַפּטורע נאָמען איז ליסטעד איידער די קאָנטראָלס. צו טוישן די כאַפּן נאָמען, נוצן capture_services און SetCaptureName.
• פֿאַר פֿראגן וועגן ניצן די Tracker API, קאָנטאַקט Vicon Support1.
• 1 מייל צו:support@vicon.com
• Vicon Tracker Python API שנעל אָנהייב גייד 31 מאי 2023, רעוויזיע 1
• פֿאַר נוצן מיט Tracker 4.0
• © קאַפּירייט 2020–2023 Vicon Motion Systems לימיטעד. אלע רעכטן רעזערווירט.
• רעוויזיע 1. פֿאַר נוצן מיט טראַקער 4.0
• Vicon Motion Systems לימיטעד ריזערווז די רעכט צו מאַכן ענדערונגען צו אינפֿאָרמאַציע אָדער ספּעסאַפאַקיישאַנז אין דעם דאָקומענט אָן באַמערקן.
• קאָמפּאַניעס, נעמען און דאַטן געניצט אין עקס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/). אנדערע פּראָדוקט און פירמע נעמען דאָ קען זיין די טריידמאַרקס פון זייער ריספּעקטיוו אָונערז.
• פֿאַר פול און דערהייַנטיקט קאַפּירייט און טריידמאַרק אַקנאַלידזשמאַנץ, באַזוכן https://www.vicon.com/vicon/copyright-information.
• Vicon Motion Systems איז אַן Oxford Metrics plc פירמע.
• בליצפּאָסט: support@vicon.com Web: http://www.vicon.com

דאָקומענטן / רעסאָורסעס

VICON Tracker Python Api [pdfבאַניצער גייד טראַקער פּיטהאָן אַפּי, טראַקער, פּיטהאָן אַפּי, אַפּי

רעפערענצן

• באַניצער מאַנואַל