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