Комплект для разработки программного обеспечения Python
Руководство пользователя
Комплект для разработки программного обеспечения Python
PCO просит вас внимательно прочитать и следовать инструкциям в этом документе.
По любым вопросам или комментариям, пожалуйста, не стесняйтесь обращаться к нам в любое время.
телефон: +49 (0) 9441 2005 50
факс: +49 (0) 9441 2005 20
почтовый адрес: Excelitas PCO GmbH Donaupark 11 93309 Kelheim, Germany
электронная почта: info@pco.de
web: www.pco.de
Руководство пользователя pco.python 0.1.7
Выпущено в декабре 2021 г.
©Авторское право Excelitas PCO GmbH
Эта работа находится под лицензией Creative Commons Attribution-No Derivatives 4.0 International License. К view копию этой лицензии, посетите http://creativecommons.org/licenses/by-nd/4.0/ или отправьте письмо в Creative Commons, PO Box 1866, Mountain View, Калифорния 94042, США.
Общий
Пакет Python pco предлагает все функции для работы с камерами pco, основанные на текущей pco.sdk. Включены все общие библиотеки для связи с камерой и последующей обработки изображений.
- Простой в использовании класс камеры
- Мощный API для pco.sdk
- Запись и обработка изображений с помощью pco.recorder
1.1 Установка
Установить из pypi (рекомендуется):
$ pip установить pco
1.2 Основное использование
импортировать matplotlib.pyplot как plt
импорт ПКО
с pco.Camera() в качестве камеры:
камера.запись()
изображение, мета = cam.image()
plt.imshow(изображение, cmap='серый')
plt.show()
1.3 Регистрация событий и ошибок
Чтобы активировать вывод журнала, создайте объект Camera с параметром debuglevel=.
Уровень отладки может быть установлен на одно из следующих значений:
- 'off' Отключает весь вывод.
- 'error' Показывает только сообщения об ошибках.
- 'verbose' Показывает все сообщения.
- 'дополнительно подробный' Показывает все сообщения и значения.
Уровень отладки по умолчанию выключен.
pco.Camera(debuglevel='подробный')
…
[][sdk] get_camera_type: ОК.
Необязательное времяamp= параметр активирует tag в печатном виде. Возможные значения: «включено» и «выключено». Значение по умолчанию — «выключено».
pco.Camera(debuglevel='подробный', времяamp= 'вкл.')
…
[2019-11-25 15:54:15.317855 / 0.016 с] [][sdk] get_camera_type: OK.
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() является единственным исключением. Эта функция не влияет на объект рекордера и может вызываться во время записи.
Прототип Запись защиты (я, number_of_images = 1, режим = 'последовательность'):
Параметр
| Имя | Описание |
| количество_изображений | Устанавливает количество образов, выделенных в драйвере. Оперативная память ПК ограничивает максимальное значение. |
| режим | В режиме «sequence» эта функция блокируется во время записи. Рекордер останавливается автоматически, когда достигается число_изображений. В режиме «последовательность без блокировки» эта функция не блокируется. Статус должен быть проверен перед чтением изображения. Этот режим используется для чтения изображений во время записи, например миниатюр. В режиме «кольцевой буфер» эта функция не блокируется. Статус должен быть проверен перед чтением изображения. Рекордер не останавливает запись при достижении number_of_images. Как только это происходит, самые старые изображения перезаписываются. В режиме 'fifo' эта функция не блокируется. Статус должен быть проверен перед чтением изображения. Когда число_изображений в fifo достигнуто, следующие изображения удаляются до тех пор, пока изображения не будут прочитаны из fifo. |
2.1.2 Stop
Описание Останавливает текущую запись. В режимах «кольцевой буфер» и «fifo» эта функция должна вызываться пользователем. В режимах «последовательность» и «последовательность без блокировки» эта функция автоматически вызывается при достижении числа_изображений.
Прототип деф стоп(сам):
2.1.3 Закрыть
Описание Закрывает активированную камеру и освобождает заблокированные ресурсы. Эта функция должна быть вызвана до закрытия приложения. В противном случае ресурсы остаются занятыми.
Прототип защита близко (я):
Эта функция вызывается автоматически, если объект камеры создается оператором with. Явный вызов close() больше не нужен.
с pco.Camera() как cam: # делаем кое-что
2.1.4 Изображение
Описание Возвращает изображение с рекордера. Тип изображения — numpy.ndarray. Этот массив формируется в зависимости от разрешения и ROI изображения.
Прототип def image (я, image_number = 0, roi = None):
Параметр
| Имя | Описание |
| номер_изображения | Задает номер изображения для чтения. В режиме «последовательность» или «последовательность без блокировки» индекс рекордера соответствует номеру_изображения. Если для image_number установлено значение 0xFFFFFFFF, копируется последнее записанное изображение. Это позволяет создать живую предварительнуюview во время записи. |
| рентабельность | Устанавливает интересующую область. Только эта область изображения копируется в возвращаемое значение. |
Example >>> cam.record(number_of_images=1, режим='последовательность')
>>> изображение, мета = cam.image()
>>> введите (изображение) numpy.ndarray
>>> изображение.форма (2160, 2560)
>>> изображение, метаданные = cam.image(roi=(1, 1, 300, 300))
>>> изображение.форма (300, 300)
2.1.5 XNUMX изображений
Описание Возвращает все записанные изображения с рекордера в виде списка пустых массивов.
Прототип def images(self, roi=None,blocksize=None):
Параметр
| Имя | Описание |
| рентабельность | Устанавливает интересующую область. Только эта область изображения копируется в возвращаемое значение. |
| размер блока | Определяет максимальное количество возвращаемых изображений. Этот параметр полезен только в режиме 'fifo' и при особых условиях. |
Example >>> cam.record(number_of_images=20, режим='последовательность')
>>> изображения, метаданные = cam.images()
>>> Лен(изображения) 20
>>> для изображения в изображениях:
…
print('Среднее значение: {: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 (я, roi = нет):
Параметр
| Имя | Описание |
| рентабельность | Определяет область интереса. Только эта область изображения копируется в возвращаемое значение. |
Example >>> cam.record(number_of_images=100, режим='последовательность')
>>> среднее = 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(я):
2.2 Конфигурация переменных
Параметры камеры обновляются путем изменения переменной конфигурации.
cam.configuration = {'время экспозиции': 10e-3,
'рои': (1, 1, 512, 512),
времяamp': 'аски',
'скорость пикселей': 100_000_000,
«триггер»: «автоматическая последовательность»,
«приобрести»: «авто»,
«метаданные»: «включено»,
'биннинг': (1, 1)}
Переменная может быть изменена только до вызова функции record(). Это словарь с определенным количеством статей. Не обязательно указывать все возможные элементы. Следующие сampФайловый код изменяет только «скорость пикселей» и не влияет на другие элементы конфигурации.
с pco.Camera() в качестве камеры:
cam.configuration = {'скорость пикселей': 286_000_000}
камера.запись()
…
2.3 объектов
В этом разделе описаны все объекты, предлагаемые классом pco.Camera.
2.3.1 SDK
Объект sdk обеспечивает прямой доступ ко всем базовым функциям pco.sdk.
>>> cam.sdk.get_temperature()
{'температура датчика': 7.0, 'температура камеры': 38.2, 'температура питания': 36.7}
Все возвращаемые значения из функций SDK являются словарями. Не все настройки камеры в настоящее время охватываются классом Camera. Специальные настройки необходимо задавать напрямую, вызывая соответствующую функцию SDK.
2.3.2 Регистратор
Объект rec предлагает прямой доступ ко всем базовым функциям pco.recorder. Нет необходимости вызывать метод класса рекордера напрямую. Все функции полностью покрываются методами класса Camera.
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 азия +65 6549 7054 info@pco-imaging.com pco-imaging.com |
ПКо Китай +86 512 67634643 info@pco.cn pco.cn |
Документы/Ресурсы
 |
EXCELITAS TECHNOLOGIES Комплект для разработки программного обеспечения Python [pdf] Руководство пользователя Комплект для разработки программного обеспечения Python, Комплект для разработки программного обеспечения, Комплект для разработки, Комплект |
