revile

这是一个简单的示例软件包，用于使用推出摄影或缝隙扫描的主体来生成圆柱体表面的2D图像。

该软件包具有两个主要功能：捕获新视频和处理视频流。它也可以以两种形式使用：作为命令行接口（CLI）或python软件包。 CLI脚本显示了如何在您自己的Python脚本中使用它的示例。

0。安装

0.1要求

1. Python 3.6+

该代码仅经过测试并确认可以在Linux OS上使用，但可能对其他OS起作用。

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（可选 - 用于使用新佳能DSLR以外的其他相机）
4. FFMPEG（可选 - 使用新佳能DSLR以外的其他相机）

1.1.2设备要求

1. Arduino Uno
2. 伺服或步进电动机 +驱动器（带有安全的平面以充当转盘）
   • 最初由28ByJ-48步进电机和ULN2003驱动器开发
3. 相机
   • 有些零件只能与较新的佳能数码单反相机一起使用，另一些则可以使用任何连接的网络摄像头的东西

1.2相机设置

1. 设置镜头；例如，将相机指向对象，将其聚焦，等等。
2. 将相机连接到计算机并打开。

1.2.1新佳能数码单反相机

• 插入SD卡，最好是高速卡（可能与低速无效）
• 设置为视频模式
• 在相机上配置所需的视频设置（例如60fps vs 30fps）

1.2.2其他相机

相机需要从A /dev/video设备进行流式传输。所有摄像机都可能不可能。检查您的规格。对于通过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. 通过USB将Arduino插入计算机
3. 将主体牢固地固定在转盘上。

1.4用法

1.4.1佳能模式

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

例如，创建和处理20次视频，然后将其保存在/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

例如，使用设备/dev/video1创建和处理500帧：

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

例如，焦距为100mm，框架宽度为720px，传感器宽度为24mm，宽度为21px的1mm宽度和60fps的Framerate，适用于20mm VIAL：

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