VICON Tracker Python API

מפרטים

• שם המוצר: Vicon Tracker Python API
• תְאִימוּת: Tracker 4.0
• גרסאות פייתון נתמכות: 2.7 ופייתון 3

הוראות שימוש במוצר

התקן את ה-API של Tracker

כדי להשתמש ב-Tracker API עם Python, בצע את השלבים הבאים:

1. בדוק את גרסת Python כדי להבטיח תאימות.
2. התקן את Python על ידי הורדתו מהרשמי webאתר ובחירת הגרסה המתאימה.
3. אתר והתקן את מודול Tracker Python מהתיקיה שצוינה.

בדוק את גרסת Python

1. פתח שורת פקודה.
2. הקלד 'py' והקש Enter.
3. אם Python לא מותקן, עיין בהוראות ההתקנה.

התקן את Python

1. עבור אל הפקיד של פייתון webאֲתַר.
2. הורד והתקן את Python, תוך הקפדה על הוספת python.exe ל-PATH במהלך ההתקנה.

התקן את מודול Tracker Python:

1. אתר את ההתקנה files בתיקייה שצוינה.
2. בחר את שיטת ההתקנה בהתאם להגדרות שלך.

התקן את מודול Python על ידי הפעלת האצווה File:

1. נווט אל תיקיית ההתקנה של Python: C: Program FilesViconTracker4.xSDKPython
2. לחץ פעמיים על 'install_tracker_api.bat' כדי להתחיל את תהליך ההתקנה.

שאלות נפוצות (שאלות נפוצות):

ש: מה אני יכול להפוך לאוטומטי באמצעות ה-Tracker API?

• A: ה-API של Tracker מאפשר לך להפוך פונקציות נפוצות לאוטומטיות כמו טעינה, הפעלה, ייצוא נתונים, הפעלה/ביטול של אובייקטים והפעלת חלקי זרימת עבודה.

ש: אילו גרסאות Python נתמכות על ידי Tracker API?

• A: ה-API של Tracker תומך בגרסאות Python 2.7 ו-Python

על המדריך הזה

• ה-API של Tracker מאפשר לך לשלוט בתכונות מסוימות של Tracker באמצעות Python API.
• ה-API מאפשר לך להפוך כמה פונקציות נפוצות של Tracker לאוטומטיות, כגון טעינה, הפעלה וייצוא נתונים, הפעלה או השבתה של אובייקטים שונים, או הפעלת חלקים מזרימת העבודה.
• מסמך זה מאפשר לך להתחיל עם ה-API של Tracker.

התקן את ה-API של Tracker

• כדי להשתמש ב-Tracker API עם Python, עליך לוודא שהתקנת את שניהם.
• ה-API של Tracker מספק תמיכה עבור Python 2.7 ו- Python 3. Vicon ממליצה להשתמש במהדורה המלאה האחרונה של Python 3, אלא אם הפרויקט שלך דורש ממך להשתמש בגרסה ספציפית של Python.

נהלים אלה מנחים אותך בתהליך ההתקנה:

• בדוק את גרסת Python פועלת
• מתקין Python על
• התקנת מודול Tracker Python על
• בדוק שמודול Python מותקן כהלכה על

בדוק את גרסת Python

• אם אינך בטוח אם התקנת את Python או באיזו גרסה של Python אתה משתמש, תוכל לפתוח שורת פקודה ולהפעיל את הפקודה py.

למשלampעל:

אם אין לך Python מותקן, ראה התקנת Python.

התקן את Python כדי להתקין Python 2 או 3:

1. עבור אל  https://www.python.org/downloads/
2. אתר את הגירסה הדרושה והתקן את Python, וודא שהוספה של python.exe ל-PATH נבחרה:

בתמונה למעלה, ABC מוחלף בשם המשתמש שלך עבור תיקיית ההתקנה.

התקן את מודול Tracker Python כדי להתקין את מודול Tracker Python:

1. אתר את ההתקנה fileס. אם התקנת את Tracker במיקום ברירת המחדל, הם נמצאים בתיקייה זו: C:\Program Files\Vicon\Tracker4.x\SDK\Python
   • אֵלֶה fileמוצגים s:
2. התקן את מודול Tracker Python באחת מהדרכים הבאות, בהתאם להתקנה הספציפית שלך:
   • הדרך הפשוטה ביותר היא להפעיל את האצווה file (install_tracker_api.bat) הכלולה בהתקנת Tracker (כפי שמוצג בתמונה למעלה).
   • זה בדרך כלל עובד טוב אם:
   • Python הותקן במשתנה PATH; אוֹ
   • מותקנות גרסאות מרובות של Python, אך ברצונך להתקין את ה-API לגרסה העדכנית ביותר שהתקנת; אוֹ
   • מותקנת רק גרסה בודדת של Python.
   • אם אחד מהתנאים הללו חל, ראה התקנת מודול python על ידי הפעלת האצווה file עַל.
   • בכל שאר המקרים, התקן את מודול Python באמצעות pip. זה חל בדרך כלל אם:
   • גרסאות מרובות של Python מותקנות, אך ברצונך להתקין לגרסה ספציפית; אוֹ
   • מותקנות מספר גרסאות שונות של Python וברצונך להתקין על כולן (במקרה זה, עליך להתקין את המודול עבור כל גרסה); אוֹ
   • רק גרסה בודדת של Python מותקנת, אבל לא התקנת ב-PATH.
   • אם אחד מהתנאים האלה מתקיים, ראה התקנת מודול Python על ידי הפעלת pip.

התקן את מודול Python על ידי הפעלת האצווה file כדי לעשות זאת:

1. נווט אל תיקיית ההתקנה של Python: C:\Program Files\Vicon\Tracker4.x\SDK\Python
2. לחץ פעמיים על install_tracker_api.bat.
   • תהליך ההתקנה מאתחל אוטומטית.

התקן את מודול Python על ידי הפעלת ה-pip

1. נווט אל תיקיית הסקריפטים עבור ה-Python שבו ברצונך להשתמש:
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"
   • הפעל את הפקודה הבאה כדי להתקין את 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: זהו ממשק API של השלט הרחוק הליבה וכולל לקוח לתקשורת עם שרת הטרמינל.
• tracker_api: Services API לגישה לפונקציונליות של אפליקציה ספציפית ל-Tracker.
• כדי לבדוק שמודול Tracker Python מותקן כהלכה, נסה לייבא אחד מהמודולים ב-Python: >>> import vicon_core_api

אם התהליך שלעיל לא מצליח לזהות את המודול, נסה את הפעולות הבאות:

• בדוק בתיקיית site-packages בהתקנת 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
• אם אחת מהתיקיות של המודולים חסרה, ואימתת את הנתיב, הפעל מחדש את תהליך ההתקנה המתואר ב'התקנת מודול Tracker Python ב'.

התחבר לשרת המסוף

• כדי להתחבר לשרת הטרמינל, ייבא תחילה את מודול Vicon Core API: >>> import vicon_core_api
  • >>> מיבוא vicon_core_api
• לאחר מכן, צור לקוח. זה מנסה להתחבר אוטומטית לכתובת המארח הספציפית ביציאת ברירת המחדל (52800) >>> c = Client('localhost')
• בדוק שהלקוח התחבר בהצלחה לשרת: >>> print(c.connected) נכון
• אם התגובה היא False, ודא שיש לך מופע של Tracker שפועל בכתובת המארח שצוינה וחומת האש שלך אינה חוסמת תעבורה ביציאה 52800, לפני יצירת לקוח חדש.
• לאחר שהתחברת בהצלחה, תוכל לגשת לשירותים הניתנים על ידי שרת מסוף Tracker.
• האקסית הזוample משתמש בשירותי אובייקט בסיסיים: >>> ייבוא ​​tracker_api >>> מ-tracker_api ייבוא ​​BasicObjectServices >>> שירותים = BasicObjectServices(c)
• כשהוא מחובר, אתה יכול לקרוא לשיטות במופע Tracker.
  • למשלample, כדי לקבל רשימה של אובייקטים בחלונית Tracking, השתמש ב: >>> result, object_list = services.basic_object_list() >>> print(result)
  • בְּסֵדֶר: הפונקציה הצליחה
  • >>> print(object_list)
  • ['Object1', 'Object2'...]
• כל קריאות ה-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:\Program Files\Vicon\Tracker 4.0\SDK\Python\sample_scripts
• לכל הסקריפטים יש תיעוד ואפשרות עזרה המספקת פרטים על הטיעונים הרלוונטיים.
• לרוץ בתורample script, פתח חלון פקודה או מעטפת כוח בתיקיית scripts למעלה. אתה יכול לעשות זאת באחת משתי דרכים:
• פתח את שורת הפקודה ושנה את הספרייה שלך לתיקיית הסקריפטים: c:\> cd C:\Program Files\Vicon\Tracker
  • 4.0\SDK\Python\sample_scripts
• החזק את SHIFT+לחץ לחיצה ימנית בתיקיית הסקריפטים ובחר פתח חלון פקודה כאן או פתח חלון Powershell כאן.
• מכאן אתה יכול להפעיל את האקסampהתסריט לבחירתך.
• האקס הבאampהשתמש בחלון הפקודה.

camera_calibration_wave.py

• סקריפט זה מדגים כיצד להשתמש בפונקציות API כדי לשלוט בתהליך הכיול של הפעלה ועצירה של גל השרביט.
  • C:\Program 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 רשום לפני הפקדים. כדי לשנות את שם הלכידה, השתמש ב-capture_services וב-SetCaptureName.
• לשאלות על שימוש ב-Tracker API, פנה לתמיכה של Vicon1.
• דואר אחד:support@vicon.com
• מדריך להתחלה מהירה של Vicon Tracker Python API 31 במאי 2023, גרסה 1
• לשימוש עם Tracker 4.0
• © זכויות יוצרים 2020–2023 Vicon Motion Systems Limited. כל הזכויות שמורות.
• גרסה 1. לשימוש עם Tracker 4.0
• Vicon Motion Systems Limited שומרת לעצמה את הזכות לבצע שינויים במידע או מפרטים במסמך זה ללא הודעה מוקדמת.
• חברות, שמות ונתונים המשמשים ב-exampאלה הם פיקטיביים אלא אם צוין אחרת. אין לשכפל, לאחסן במערכת אחזור שום חלק מפרסום זה, או לשדר בכל צורה או בכל אמצעי, אלקטרוני או מכני, בצילום או הקלטה, או בכל דרך אחרת ללא אישור מראש ובכתב מאת 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מדריך למשתמש Tracker Python Api, Tracker, Python Api, Api

הפניות

• מדריך למשתמש