revile

Это простой пример пакета для генерации двухмерных изображений цилиндрических поверхностей, используя принцип распущенного фотографирования или сканирования щелей .

Этот пакет имеет две основные функции: захват новых видео и обработку видеопотоков. Его также можно использовать в двух формах: в качестве интерфейса командной строки (CLI) или в качестве пакета Python. Сценарий CLI показывает примеры того, как его можно использовать в ваших собственных сценариях Python.

0. Установка

0,1 требования

1. Python 3.6+

Код был протестирован и подтвержден работать над ОС Linux, но он может работать над другими.

0,2 установка

Установите с помощью PIP:

pip install git+git://github.com/NaturalHistoryMuseum/revile.git#egg=revile

1. Захват

1.1 Требования

1.1.1 Требования к программному обеспечению

1. GPHOTO2
2. Sox (необязательно - для игры в звуковой сигнал, чтобы сигнализировать о конце перемещения поворотного стола)
3. v4l2loopback (необязательно - для использования камер, отличных от новых зеркальных зеркал)
4. FFMPEG (необязательно - для использования камер, отличных от новых зеркальных зеркальных зеркал)

1.1.2 Требования к оборудованию

1. Arduino Uno
2. Серво или шаговый двигатель + драйвер (с безопасной плоской поверхностью, прикрепленной к повороту)
   • Первоначально разработан с шаговым двигателем 28byj-48 и драйвером ULN2003
3. Камера
   • Некоторые части будут работать только с более новыми зеркалами Canon, другие могут использовать все, что связано в качестве веб -камеры

1.2 Установка камеры

1. Установите выстрел; Например, укажите камеру на объект, сосредоточьтесь на нем и т. Д.
2. Подключите камеру к компьютеру и включите ее.

1.2.1 Новые зеркальные зеркалки Canon

• Вставьте SD-карту, предпочтительно высокоскоростной (она может не работать с более низкой скоростью)
• установить в режим видео
• Настройте нужные настройки видео на камере (например, 60 кадров в секунду против 30 кадров в секунду)

1.2.2 Другие камеры

Камера должна транслироваться с A /dev/video Device. Это может быть невозможно со всеми камерами; Проверьте свои спецификации. Для камеры, подключенной через USB с доступным режимом предварительного просмотра, вы можете сделать это с помощью v4l2loopback . После установки v4l2loopback :

modprobe v4l2loopback
find /dev -name ' video* ' | sort | tail -n 1  # to find the device
gphoto2 --stdout --capture-movie | ffmpeg -i - -vcodec rawvideo -pix_fmt yuv420p -threads 8 -r 60 -f v4l2 /dev/video[DEVICE NUMBER HERE]

1.3 Настройка объекта

1. Подключите сервопривод/двигатель + драйвер и Arduino
2. Подключите Arduino к компьютеру через USB
3. Безопасно исправить субъект на проигрыватель.

1.4 Использование

1.4.1 Режим Canon

revile video --help

Usage: revile video [OPTIONS]

  Takes a video and spins the motor at the same time, then processes the
  frames of the video file.

Options:
  -l, --length INTEGER    The length of the video/rotation (in seconds).
  --servo                 Use a servo instead of a stepper motor
  -o, --outputdir TEXT
  -r, --rotation INTEGER  angle (in degrees clockwise) of the camera from
                          horizontal ; will be rounded to the nearest multiple
                          of 90

Например, чтобы создать и обработать видео 20S, затем сохранить его в /data/videos :

revile video --length 20 --outputdir /data/videos

1.4.2 Режим веб -камеры

revile stream --help

Usage: revile stream [OPTIONS]

  Uses the preview frames from a camera connected in USB mode to create the
  image.

Options:
  -f, --frames INTEGER   The number of frames to capture (also ; the width of
                         the final image).
  --stream-port INTEGER  The /dev/video device to read from.
  --servo                Use a servo instead of a stepper motor

Например, создать и обработать 500 кадров с использованием устройства /dev/video1 :

revile stream --frames 500 --stream-port 1

1.4.3 «Оценка» утилита

revile estimate --help

Usage: revile estimate [OPTIONS] DIAMETER

  Estimate the optimum length of rotation in frames and seconds.

Options:
  -l, --focal-length INTEGER  Focal length in mm
  -x, --frame-x INTEGER       Size of the image/frame across the x axis of the
                              vial (i.e. width if shooting landscape, height
                              if portrait) in pixels
  -s, --sensor-x INTEGER      Size of the sensor across the x axis of the vial
                              (i.e. width if shooting landscape, height if
                              portrait) in mm
  -w, --ppmm INTEGER          Approximate width of 1mm, in pixels, at the
                              centre of rotation
  -r, --fps INTEGER           Stream/video framerate

Например, на фокусном расстоянии 100 мм ширина рамы 720px, ширина датчика 24 мм, ширина 1 мм 21px и кадре 60 кадров в секунду, для 20 -миллиметрового флакона:

revile estimate -l 100 -x 720 -s 24 -w 21 -r 60 20

    Try 23.6 seconds or 1419 frames:
    
    revile video --length 23.6
    revile stream --frames 1419

2. Обработка

2.1 Требования

Нет никаких дополнительных требований к обработке видеофайлов/потоков.

2.2 Использование

revile process --help

Usage: revile process [OPTIONS] FILEPATH

Options:
  -r, --rotate INTEGER  angle (in degrees clockwise) of the image from
                        horizontal ; will be rounded to the nearest multiple of
                        90

  -o, --outputdir TEXT  A directory to save the files to

Например, обработать examplevideo.mov , снятый в ориентации на портрету и вывода в /data/revile/ :

revile process examplevideo.mov -r 270 -o /data/revile