פּיטהאָן ווייכווארג אַנטוויקלונג קיט
באַניצער מאַנואַל

פּיטהאָן ווייכווארג אַנטוויקלונג קיט

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
© קאַפּירייט עקססעליטאַס פּקאָ גאַם
די ווערק איז לייסאַנסט אונטער די Creative Commons צושרייבן-קיין דעריוואַטיווז 4.0 אינטערנאַציאָנאַלער ליסענסע. צו view אַ קאָפּיע פון ​​דעם דערלויבעניש, באַזוכן http://creativecommons.org/licenses/by-nd/4.0/ אָדער שיקן אַ בריוו צו Creative Commons, פּאָבאָקס 1866, Mountain View, CA 94042, USA.

אַלגעמיינע

די Python פּעקל pco אָפפערס אַלע פאַנגקשאַנז פֿאַר ארבעטן מיט פּקאָ קאַמעראַס וואָס זענען באזירט אויף די קראַנט pco.sdk. כל שערד לייברעריז פֿאַר קאָמוניקאַציע מיט די אַפּאַראַט און סאַבסאַקוואַנט בילד פּראַסעסינג זענען אַרייַנגערעכנט.

• גרינג צו נוצן אַפּאַראַט קלאַס
• שטאַרק אַפּי צו pco.sdk
• בילד רעקאָרדינג און פּראַסעסינג מיט pco.recorder

1.1 ינסטאַלירונג
ינסטאַלירן פֿון pypi (רעקאַמענדיד):
$ פּיפּ ינסטאַלירן פּקאָ
1.2 יקערדיק באַניץ
אַרייַנפיר מאַטפּלאָטליב.פּיפּלאָט ווי פּלט
אַרייַנפיר פּקאָ
מיט pco.Camera() ווי קאַם:
cam.record()
בילד, מעטאַ = cam.image()
plt.imshow (בילד, cmap = 'גרוי')
plt.show()1.3 געשעעניש און טעות לאָגינג
צו אַקטאַווייט די לאָגינג רעזולטאַט, שאַפֿן די אַפּאַראַט כייפעץ מיט די דעבוגלעוועל = פּאַראַמעטער.
די דיבאַג מדרגה קענען זיין באַשטימט צו איינער פון די פאלגענדע וואַלועס:

• 'אַוועק' דיסייבאַלז אַלע רעזולטאַט.
• 'טעות' ווייזט בלויז טעות אַרטיקלען.
• 'ווערבאָוס' ווייזט אַלע אַרטיקלען.
• 'עקסטרע ווערבאָוסע' ווייַזן אַלע אַרטיקלען און וואַלועס.

די פעליקייַט דיבוגלעוועל איז 'אַוועק'.
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: גוט.

אַפּי דאַקיומענטיישאַן

די pco.Camera קלאַס אָפפערס די פאלגענדע מעטהאָדס:

• רעקאָרד () דזשענערייץ, קאַנפיגיער און סטאַרץ אַ נייַע רעקאָרדער בייַשפּיל.
• סטאָפּ () סטאַפּס די קראַנט רעקאָרדינג.
• נאָענט () קלאָוזיז די קראַנט אַקטיוו אַפּאַראַט און ריליסיז די פאַרנומען רעסורסן.
• בילד () קערט אַ בילד פון די רעקאָרדער ווי נאַמפּי מענגע.
• בילדער () קערט אַלע רעקאָרדעד בילדער פון די רעקאָרדער ווי אַ רשימה פון נאַמפּי ערייז.
• 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 רעקאָרד
באַשרייַבונג קרעאַטעס, קאַנפיגיער און סטאַרץ אַ נייַע רעקאָרדער בייַשפּיל. די גאנצע אַפּאַראַט קאַנפיגיעריישאַן מוזן זיין שטעלן איידער רופן רעקאָרד (). די set_exposure_time () באַפֿעל איז דער בלויז ויסנעם. די פֿונקציע האט קיין ווירקונג אויף די רעקאָרדער כייפעץ און קענען זיין גערופֿן בעשאַס די רעקאָרדינג.
פּראָוטאַטייפּ דעף רעקאָרד (זיך, נומער_פון_ימאַגעס = 1, מאָדע = 'סיקוואַנס'):
פּאַראַמעטער

נאָמען	באַשרייַבונג
נומער_פון_בילדער	שטעלט די נומער פון בילדער אַלאַקייטיד אין די שאָפער. די באַראַן פון די פּיסי לימאַץ די מאַקסימום ווערט.
מאָדע	אין 'סיקוואַנס' מאָדע, דעם פֿונקציע בלאַקינג בעשאַס רעקאָרד. די רעקאָרדער סטאַפּס אויטאָמאַטיש ווען די נומער_פון_ימאַגעס איז ריטשט. אין די "סיקוואַנס ניט בלאַקינג" מאָדע, די פֿונקציע איז ניט בלאַקינג. די סטאַטוס מוזן זיין אָפּגעשטעלט איידער לייענען אַ בילד. דעם מאָדע איז געניצט צו לייענען בילדער בשעת רעקאָרדינג, למשל טאַמנייל. אין 'רינג באַפער' מאָדע, די פֿונקציע איז ניט בלאַקינג. די סטאַטוס מוזן זיין אָפּגעשטעלט איידער לייענען אַ בילד. רעקאָרדער טוט נישט האַלטן די רעקאָרדינג ווען די נומער_פון_ימאַגעס איז ריטשט. אַמאָל דאָס כאַפּאַנז, די אָולדאַסט בילדער זענען אָוווערריטאַן. אין 'פיפאָ' מאָדע, דעם פֿונקציע איז ניט-בלאַקינג. דער סטאַטוס מוזן זיין אָפּגעשטעלט איידער לייענען אַ בילד. ווען די נומער_פון_ימאַדזשאַז אין די פיפאָ איז ריטשט, די פאלגענדע בילדער זענען דראַפּט ביז בילדער זענען לייענען פון די פיפאָ.

2.1.2 האַלטן
באַשרייַבונג סטאַפּס די קראַנט רעקאָרדינג. אין 'רינג באַפער' און 'פיפאָ' מאָדע, די פונקציע מוזן זיין גערופֿן דורך דער באַניצער. אין די "סיקוואַנס" און "סיקוואַנס ניט בלאַקינג" מאָדע, די פֿונקציע איז אויטאָמאַטיש גערופֿן ווען די נומער_פון_ימאַגעס איז ריטשט.
פּראָוטאַטייפּ דעפ האַלטן (זיך):
2.1.3 נאָענט
באַשרייַבונג קלאָוזיז די אַקטיווייטיד אַפּאַראַט און ריליסיז די אפגעשטעלט רעסורסן. דעם פֿונקציע מוזן זיין גערופֿן איידער די אַפּלאַקיישאַן איז טערמאַנייטיד. אַנדערש, די רעסורסן בלייַבן פאַרנומען.
פּראָוטאַטייפּ דעף נאָענט (זיך):
די פֿונקציע איז גערופֿן אויטאָמאַטיש אויב די אַפּאַראַט כייפעץ איז באשאפן דורך די מיט ויסזאָגונג. אַ יקספּליסאַט רופן צו נאָענט () איז ניט מער נייטיק.
מיט pco.Camera() ווי קאַם: # טאָן עטלעכע שטאָפּן
2.1.4 בילד
באַשרייַבונג קערט אַ בילד פון די רעקאָרדער. דער טיפּ פון בילד איז אַ numpy.ndarray. דער מענגע איז שייפּט דיפּענדינג אויף די האַכלאָטע און ראָי פון די בילד.
פּראָוטאַטייפּ דעף בילד (זיך, בילד_נומער = 0, ראָי = קיינער):
פּאַראַמעטער

נאָמען	באַשרייַבונג
בילד_נומער	ספּעציפיצירט די נומער פון די בילד צו לייענען. אין 'סיקוואַנס' אָדער 'סיקוואַנס ניט בלאַקינג' מאָדע, די רעקאָרדער אינדעקס שוועבעלעך די בילד_נומער. אויב בילד_נומער איז באַשטימט צו 0xFFFFFFFF, די לעצטע רעקאָרדעד בילד איז קאַפּיד. דעם אַלאַוז צו שאַפֿן אַ לעבן פאַרview בשעת רעקאָרדינג.
רוי	שטעלט די געגנט פון אינטערעס. בלויז דעם געגנט פון די בילד איז קאַפּיד צו די צוריקקומען ווערט.

Example >>> cam.record (נומער_פון_ימאַגעס = 1, מאָדע = 'סיקוואַנס')
>>> בילד, מעטאַ = cam.image()
>>> טיפּ (בילד) numpy.ndarray
>>> בילד.שאַפּע (2160, 2560)
>>> בילד, מעטאַדאַטאַ = cam.image(roi=(1, 1, 300, 300))
>>> בילד.שאַפּע (300, 300)
2.1.5 בילדער
באַשרייַבונג רעטורנס אַלע רעקאָרדעד בילדער פון די מאַגנעטאָפאָן ווי אַ רשימה פון נאַמפּי ערייז.
פּראָוטאַטייפּ דעף בילדער (זיך, ראָי = גאָרניט, בלאַקסיזע = גאָרניט):
פּאַראַמעטער

נאָמען	באַשרייַבונג
רוי	שטעלט די געגנט פון אינטערעס. בלויז דעם געגנט פון די בילד איז קאַפּיד צו די צוריקקומען ווערט.
בלאָקסייז	דיפיינז די מאַקסימום נומער פון בילדער וואָס זענען אומגעקערט. דער פּאַראַמעטער איז בלויז נוציק אין 'פיפאָ' מאָדע און אונטער ספּעציעל באדינגונגען.

Example >>> cam.record (נומער_פון_ימאַגעס = 20, מאָדע = 'סיקוואַנס')
>>> בילדער, מעטאַדאַטאַס = cam.images()
>>> לענ(בילדער) 20
>>> פֿאַר בילד אין בילדער:
…
print('מיינט: {:7.2f} DN'.format(image.mean()))
…
מיינען: 2147.64 דן
מיינען: 2144.61 דן
…
>>> בילדער = cam.images(roi=(1, 1, 300, 300))
>>> בילדער[0].שאַפּע (300, 300)
2.1.6 בילד_דורכשניטלעך
באַשרייַבונג קערט די דורכשניטלעך בילד. דעם בילד איז קאַלקיאַלייטיד פון אַלע רעקאָרדעד בילדער אין די באַפער.
פּראָוטאַטייפּ def image_average (זיך, ראָי = קיינער):
פּאַראַמעטער

נאָמען	באַשרייַבונג
רוי	דיפיינז די געגנט פון אינטערעס. בלויז דעם געגנט פון די בילד איז קאַפּיד צו די צוריקקומען ווערט.

Example >>> cam.record (נומער_פון_ימאַגעס = 100, מאָדע = 'סיקוואַנס')
>>> avg = cam.image_average()
>>> avg = cam.image_average(roi=(1, 1, 300, 300))
2.1.7 Set_exposure_time
באַשרייַבונג שטעלט די ויסשטעלן צייט פון דער אַפּאַראַט.
פּראָוטאַטייפּ 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 וואַרטן_פֿאַר_ערשטער_בילד
באַשרייַבונג ווארטן פֿאַר דער ערשטער בנימצא בילד אין די רעקאָרדער זכּרון. אין רעקאָרדער מאָדע 'סיקוואַנס ניט בלאַקינג', 'רינג באַפער'. און 'פיפאָ', די פונקציע רעקאָרד () קערט גלייך. דעריבער, די פֿונקציע קענען ווערן גענוצט צו וואַרטן פֿאַר בילדער פֿון דער אַפּאַראַט איידער איר רופן בילד (), בילדער (), אָדער image_average ().
פּראָוטאַטייפּ דעפ wait_for_first_image (זיך):
2.2 וואַריאַבלע קאַנפיגיעריישאַן
די אַפּאַראַט פּאַראַמעטערס זענען דערהייַנטיקט דורך טשאַנגינג די קאַנפיגיעריישאַן בייַטעוודיק.
cam.configuration = {'ויסשטעלן צייט': 10e-3,
'רוי': (1, 1, 512, 512),
צייטamp': 'אַססי',
'פּיקסעל קורס': 100_000_000,
'טריגער': 'אַוטאָ סיקוואַנס',
'אַקווייער': 'אוטאָ',
'מעטאַדאַטאַ': 'אויף',
'בינינג': (1, 1)}
דער בייַטעוודיק קענען זיין פארענדערט בלויז איידער די רעקאָרד () פֿונקציע איז גערופן. עס איז אַ ווערטערבוך מיט אַ זיכער נומער פון איינסן. ניט אַלע מעגלעך עלעמענטן דאַרפֿן צו זיין ספּעסיפיעד. די פאלגענדע זampדער קאָד בלויז ענדערונגען די 'פּיקסעל קורס' און קען נישט ווירקן קיין אנדערע עלעמענטן פון די קאַנפיגיעריישאַן.
מיט pco.Camera() ווי קאַם:
cam.configuration = {'פּיקסעל קורס': 286_000_000}
cam.record()
…
2.3 אָבדזשעקץ
דער אָפּטיילונג באשרייבט אַלע אַבדזשעקץ געפֿינט דורך די pco.Camera קלאַס.
2.3.1 SDK
די כייפעץ sdk אַלאַוז דירעקט אַקסעס צו אַלע די אַנדערלייינג פאַנגקשאַנז פון די pco.sdk.
>>> cam.sdk.get_temperature()
{'סענסאָר טעמפּעראַטור': 7.0, 'אַפּאַראַט טעמפּעראַטור': 38.2, 'מאַכט טעמפּעראַטור': 36.7}
כל צוריקקומען וואַלועס פון sdk פאַנגקשאַנז זענען דיקשאַנעריז. ניט אַלע אַפּאַראַט סעטטינגס זענען דערווייַל באדעקט דורך די קאַמעראַ קלאַס. ספּעציעלע סעטטינגס מוזן זיין באַשטימט גלייַך דורך רופן די ריספּעקטיוו sdk פונקציע.
2.3.2 רעקאָרדער
די כייפעץ רעק אָפפערס דירעקט אַקסעס צו אַלע אַנדערלייינג פאַנגקשאַנז פון די pco.recorder. עס איז ניט נייטיק צו רופן אַ רעקאָרדער קלאַס אופֿן גלייַך. אַלע פאַנגקשאַנז זענען גאָר באדעקט דורך די מעטהאָדס פון די קאַמעראַ קלאַס.

https://www.pco.de/applications/

פּקאָ אייראָפּע +49 9441 2005 50 info@pco.de pco.de

פּקאָ אַמעריקע +1 866 678 4566 info@pco-tech.com pco-tech.com

pco asia +65 6549 7054 info@pco-imaging.com pco-imaging.com

pco china +86 512 67634643 info@pco.cn pco.cn

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

EXCELITAS TECHNOLOGIES Python ווייכווארג אַנטוויקלונג קיט [pdfבאַניצער מאַנואַל פּיטהאָן ווייכווארג אנטוויקלונג קיט, ווייכווארג אנטוויקלונג קיט, אנטוויקלונג קיט, קיט

רעפערענצן

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