לוגו EXCELITAS TECHNOLOGIESלוגו EXCELITAS TECHNOLOGIES 1ערכת פיתוח תוכנה של Python
מדריך למשתמשEXCELITAS TECHNOLOGIES ערכת פיתוח תוכנה של Pythonלוגו EXCELITAS TECHNOLOGIES 2

ערכת פיתוח תוכנה של Python

PCO מבקשת ממך לקרוא בעיון את ההוראות במסמך זה ולפעול לפיהן.
לכל שאלה או הערה, אנא אל תהסס לפנות אלינו בכל עת.
טלפון: +49 (0) 9441 2005 50
פקס: +49 (0) 9441 2005 20
כתובת דואר: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, גרמניה
אֶלֶקטרוֹנִי: info@pco.de
web: www.pco.de
pco.python מדריך למשתמש 0.1.7
יצא בדצמבר 2021
©זכויות יוצרים Excelitas PCO GmbH
EXCELITAS TECHNOLOGIES ערכת פיתוח תוכנה של Python - אייקון 1עבודה זו מורשית תחת הרישיון הבינלאומי של Creative Commons Attribution-No Derivatives 4.0. ל view עותק של רישיון זה, בקר http://creativecommons.org/licenses/by-nd/4.0/ או שלח מכתב ל-Creative Commons, PO Box 1866, Mountain View, CA 94042, ארה"ב.

כְּלָלִי

חבילת Python pco מציעה את כל הפונקציות לעבודה עם מצלמות pco המבוססות על הזרם pco.sdk. כל הספריות המשותפות לתקשורת עם המצלמה ועיבוד תמונה לאחר מכן כלולות.

  • כיתת מצלמה קלה לשימוש
  • API רב עוצמה ל pco.sdk
  • הקלטת ועיבוד תמונה עם pco.recorder

1.1 התקנה
התקן מ-pypi (מומלץ):
$ pip להתקין pco
1.2 שימוש בסיסי
ייבא matplotlib.pyplot בתור plt
ייבוא ​​pco
עם pco.Camera() בתור cam:
cam.record()
image, meta = cam.image()
plt.imshow(image, cmap='grey')
plt.show()EXCELITAS TECHNOLOGIES ערכת פיתוח תוכנה Python - שימוש בסיסי1.3 רישום אירועים ושגיאות
כדי להפעיל את פלט הרישום, צור את אובייקט המצלמה עם הפרמטר debuglevel=.
ניתן להגדיר את רמת ניפוי הבאגים לאחד מהערכים הבאים:

  • 'כבוי' משבית את כל הפלט.
  • 'שגיאה' מציג רק הודעות שגיאה.
  • 'verbose' מציג את כל ההודעות.
  • 'extra verbose' מציג את כל ההודעות והערכים.

ברירת המחדל של ניפוי הבאגים היא 'כבוי'.
pco.Camera(debuglevel='verbose')

[][sdk] get_camera_type: בסדר.
הזמן האופציונליamp= פרמטר מפעיל את א tag בפלט המודפס. ערכים אפשריים הם: 'מופעל' ו'כבוי'. ערך ברירת המחדל הוא 'כבוי'.
pco.Camera(debuglevel='verbose', timestamp='על')

[2019-11-25 15:54:15.317855 / 0.016 s] [][sdk] get_camera_type: בסדר.

תיעוד API

מחלקת pco.Camera מציעה את השיטות הבאות:

  • record() יוצר, מגדיר ומתחיל מופע מקליט חדש.
  • stop() עוצר את ההקלטה הנוכחית.
  • close() סוגר את המצלמה הפעילה הנוכחית ומשחרר את המשאבים התפוסים.
  • image() מחזיר תמונה מהמקליט כמערך numpy.
  • images() מחזירה את כל התמונות המוקלטות מהמקליט כרשימה של מערכי numpy.
  • image_average() מחזירה את התמונה הממוצעת. תמונה זו מחושבת מכל התמונות המוקלטות במאגר.
  • set_exposure_time() מגדיר את זמן החשיפה עבור המצלמה.
  • wait_for_first_image() מחכה לתמונה הזמינה הראשונה בזיכרון המקליט.

למחלקה pco.Camera יש את המשתנה הבא:

  • תְצוּרָה

למחלקה pco.Camera יש את האובייקטים הבאים:

  • sdk מציע גישה ישירה לכל הפונקציות הבסיסיות של ה- pco.sdk.
  • מקליט מציע גישה ישירה לכל הפונקציות הבסיסיות של pco.recorder.

2.1 שיטות
סעיף זה מתאר את כל השיטות המוצעות על ידי מחלקת pco.Camera.
2.1.1 הקלטה
תֵאוּר יוצר, מגדיר ומתחיל מופע מקליט חדש. יש להגדיר את כל תצורת המצלמה לפני קריאת record(). הפקודה set_exposure_time() היא החריגה היחידה. לפונקציה זו אין השפעה על אובייקט המקליט וניתן לקרוא אותה במהלך ההקלטה.
אַב טִיפּוּס def record(self, number_of_images=1, mode='sequence'):
פָּרָמֶטֶר

שֵׁם תֵאוּר
מספר_התמונות מגדיר את מספר התמונות שהוקצו במנהל ההתקן. זיכרון ה-RAM של המחשב מגביל את הערך המרבי.
מצב במצב 'רצף', פונקציה זו חוסמת במהלך ההקלטה. המקליט עוצר אוטומטית כאשר מספר_התמונות מגיע. במצב 'רצף לא חוסם', פונקציה זו אינה חוסמת. יש לבדוק את המצב לפני קריאת תמונה. מצב זה משמש לקריאת תמונות בזמן ההקלטה, למשל תמונה ממוזערת.
במצב 'מאגר צלצולים' פונקציה זו אינה חוסמת. יש לבדוק את המצב לפני קריאת תמונה. מקליט לא עוצר את ההקלטה כאשר מגיע מספר_התמונות. ברגע שזה קורה, התמונות הישנות ביותר יוחלפו.
במצב 'fifo', פונקציה זו אינה חוסמת. יש לבדוק את המצב לפני קריאת תמונה. כאשר מגיעים למספר_ה_תמונות ב-fifo, התמונות הבאות נשמטות עד לקריאת התמונות מה-fifo.

2.1.2 עצור
תֵאוּר מפסיק את ההקלטה הנוכחית. במצב 'חיפר צלצול' ו'fifo', פונקציה זו חייבת להיקרא על ידי המשתמש. במצב 'רצף' ו'רצף לא חוסם', פונקציה זו נקראת אוטומטית כאשר מגיעים למספר_התמונות.
אַב טִיפּוּס def stop(self):
2.1.3 סגור
תֵאוּר סוגר את המצלמה הפעילה ומשחרר את המשאבים החסומים. יש לקרוא לפונקציה זו לפני סיום היישום. אחרת, המשאבים נשארים תפוסים.
אַב טִיפּוּס def close(self):
פונקציה זו נקראת באופן אוטומטי אם אובייקט המצלמה נוצר על ידי ההצהרה with. קריאה מפורשת לסגור() אינה נחוצה עוד.
עם pco.Camera() בתור cam: # תעשה כמה דברים
2.1.4 תמונה
תֵאוּר מחזיר תמונה מהמקליט. סוג התמונה הוא numpy.ndarray. מערך זה מעוצב בהתאם לרזולוציה והחזר ה-ROI של התמונה.
אַב טִיפּוּס def image(self, image_number=0, roi=None):
פָּרָמֶטֶר

שֵׁם תֵאוּר
image_number מציין את מספר התמונה שיש לקרוא. במצב 'רצף' או 'רצף לא חוסם', אינדקס המקליט מתאים ל-image_number. אם image_number מוגדר ל-0xFFFFFFFF, התמונה המוקלטת האחרונה מועתקת. זה מאפשר ליצור קדם חיview בזמן ההקלטה.
רועי מגדיר את אזור העניין. רק אזור זה של התמונה מועתק לערך ההחזרה.

Example >>> cam.record(number_of_images=1, mode='sequence')
>>> תמונה, meta = cam.image()
>>> הקלד(תמונה) numpy.ndarray
>>> image.shape (2160, 2560)
>>> תמונה, מטא נתונים = cam.image(roi=(1, 1, 300, 300))
>>> image.shape (300, 300)
2.1.5 תמונות
תֵאוּר מחזירה את כל התמונות המוקלטות מהמקליט כרשימה של מערכי numpy.
אַב טִיפּוּס def images(self, roi=None, blocksize=None):
פָּרָמֶטֶר

שֵׁם תֵאוּר
רועי מגדיר את אזור העניין. רק אזור זה של התמונה מועתק לערך ההחזרה.
גודל בלוק מגדיר את המספר המרבי של תמונות שיוחזרו. פרמטר זה שימושי רק במצב 'fifo' ובתנאים מיוחדים.

Example >>> cam.record(number_of_images=20, mode='sequence')
>>> תמונות, מטא נתונים = cam.images()
>>> לן(תמונות) 20
>>> לתמונה בתמונות:

print('Mean: {:7.2f} DN'.format(image.mean())))

ממוצע: 2147.64 DN
ממוצע: 2144.61 DN

>>> תמונות = cam.images(roi=(1, 1, 300, 300))
>>> תמונות[0].shape (300, 300)
2.1.6 תמונה_ממוצע
תֵאוּר מחזירה את התמונה הממוצעת. תמונה זו מחושבת מכל התמונות המוקלטות במאגר.
אַב טִיפּוּס def image_average(self, roi=None):
פָּרָמֶטֶר

שֵׁם תֵאוּר
רועי מגדיר את אזור העניין. רק אזור זה של התמונה מועתק לערך ההחזרה.

Example >>> cam.record(number_of_images=100, mode='sequence')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 הגדר_זמן_חשיפה
תֵאוּר מגדיר את זמן החשיפה של המצלמה.
אַב טִיפּוּס def set_exposure_time(עצמי, זמן_חשיפה):
פָּרָמֶטֶר

שֵׁם תֵאוּר
זמן חשיפה חייב להינתן כערך צף או שלם ביחידה 'שני'. הערכים הבסיסיים עבור הפונקציה sdk.set_delay_exposure_time(0, 'ms', time, timebase) יחושבו באופן אוטומטי. זמן ההשהיה מוגדר ל-0.

Example >>> cam.set_exposure_time(0.001)
>>> cam.set_exposure_time(1e-3)
2.1.8 המתן_לתמונה_ראשונה
תֵאוּר ממתין לתמונה הזמינה הראשונה בזיכרון המקליט. במצב מקליט 'רצף לא חוסם', 'מאגר צלצולים'. ו-'fifo', הפונקציה record() מחזירה מיד. לכן, ניתן להשתמש בפונקציה זו כדי להמתין לתמונות מהמצלמה לפני שקוראים ל-image(), images() או image_average().
אַב טִיפּוּס def wait_for_first_image(self):
2.2 תצורת משתנה
פרמטרי המצלמה מתעדכנים על ידי שינוי משתנה התצורה.
cam.configuration = {'זמן חשיפה': 10e-3,
'roi': (1, 1, 512, 512),
'זמניתamp': 'ascii',
'קצב פיקסלים': 100_000_000,
'trigger': 'רצף אוטומטי',
'acquire': 'אוטומטי',
'metadata': 'on',
'binning': (1, 1)}
ניתן לשנות את המשתנה רק לפני קריאת הפונקציה record() . זהו מילון עם מספר מסוים של ערכים. לא צריך לציין את כל האלמנטים האפשריים. הס' הבאותampקוד le משנה רק את 'קצב הפיקסלים' ואינו משפיע על רכיבים אחרים של התצורה.
עם pco.Camera() בתור cam:
cam.configuration = {'קצב פיקסלים': 286_000_000}
cam.record()

2.3 חפצים
סעיף זה מתאר את כל האובייקטים המוצעים על ידי מחלקת pco.Camera.
2.3.1 SDK
האובייקט sdk מאפשר גישה ישירה לכל הפונקציות הבסיסיות של ה- pco.sdk.
>>> cam.sdk.get_temperature()
{'tempera sensor': 7.0, 'camera temperature': 38.2, 'power temperature': 36.7}
כל ערכי ההחזרה מפונקציות sdk הם מילונים. לא כל הגדרות המצלמה מכוסות כרגע על ידי מחלקת המצלמה. יש להגדיר הגדרות מיוחדות ישירות על ידי קריאה לפונקציית sdk המתאימה.
2.3.2 מקליט
האובייקט rec מציע גישה ישירה לכל הפונקציות הבסיסיות של ה- pco.recorder. אין צורך לקרוא ישירות לשיטת הקלטה. כל הפונקציות מכוסות במלואן על ידי השיטות של מחלקת המצלמה.

EXCELITAS TECHNOLOGIES ערכת פיתוח תוכנה Python - QR cotehttps://www.pco.de/applications/

pco אירופה
+49 9441 2005 50
info@pco.de
pco.de
pco אמריקה
+1 866 678 4566
info@pco-tech.com
pco-tech.com
pco אסיה
+65 6549 7054
info@pco-imaging.com
pco-imaging.com
pco סין
+86 512 67634643
info@pco.cn
pco.cn

לוגו EXCELITAS TECHNOLOGIESלוגו EXCELITAS TECHNOLOGIES 1

מסמכים / משאבים

EXCELITAS TECHNOLOGIES ערכת פיתוח תוכנה של Python [pdfמדריך למשתמש
ערכת פיתוח תוכנה של Python, ערכת פיתוח תוכנה, ערכת פיתוח, ערכה

הפניות

השאר תגובה

כתובת האימייל שלך לא תפורסם. שדות חובה מסומנים *