revile

Dies ist ein einfaches Beispielpaket zum Erzeugen von 2D -Bildern von zylindrischen Oberflächen unter Verwendung des Prinzipals der Rollout -Fotografie oder des Schlitzscannings .

Dieses Paket hat zwei Hauptfunktionen: Erfassung neuer Videos und Verarbeitung von Video -Streams. Es kann auch in zwei Formen verwendet werden: als Befehlszeilenschnittstelle (CLI) oder als Python -Paket. Das CLI -Skript zeigt Beispiele dafür, wie es in Ihren eigenen Python -Skripten verwendet werden kann.

0. Installation

0,1 Anforderungen

1. Python 3.6+

Der Code wurde nur getestet und bestätigt, dass er unter einem Linux -Betriebssystem arbeitet, kann jedoch bei anderen funktionieren.

0,2 Setup

Mit PIP installieren:

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

1.

1.1 Anforderungen

1.1.1 Softwareanforderungen

1. gphoto2
2. SOX (optional - zum Spielen eines Pieps bis zum Signalende der Plattenspieler))
3. V4L2Loopback (optional - für andere Kameras als neue Canon DSLRs)
4. FFMPEG (optional - für die Verwendung anderer Kameras als neuer Canon -DSLRs)

1.1.2 Ausrüstungsanforderungen

1. Arduino uno
2. Servo- oder Stepper -Motor + Treiber (mit sicherer flacher Oberfläche, um als Plattenspieler zu fungieren)
   • Ursprünglich mit einem 28BYJ-48-Steppermotor und einem ULN2003-Fahrer entwickelt
3. Kamera
   • Einige Teile funktionieren nur mit neueren Canon -DSLRs, andere können alles verwenden, was als Webcam verbunden ist

1.2 Kamera -Setup

1. Den Schuss einrichten; ZB die Kamera auf das Objekt zeigen, sie fokussieren usw.
2. Schließen Sie die Kamera mit dem Computer an und schalten Sie sie ein.

1.2.1 Neue Canon DSLRs

• Fügen Sie eine SD-Karte ein, vorzugsweise eine Hochgeschwindigkeit (es funktioniert möglicherweise nicht mit einer niedrigeren Geschwindigkeit)
• Setzen Sie den Videododus
• Konfigurieren Sie die gewünschten Videoeinstellungen auf der Kamera (z. B. 60fps gegenüber 30fps).

1.2.2 Andere Kameras

Die Kamera muss vom A /dev/video -Gerät streamen. Dies kann bei allen Kameras nicht möglich sein; Überprüfen Sie Ihre Spezifikationen. Für eine über USB verbundene Kamera mit einem Vorschau -Modus können Sie dies mit v4l2loopback tun. Nach der Installation 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 Objektaufbau

1. Schließen Sie den Servo/Motor + Treiber und Arduino an
2. Schließen Sie den Arduino über USB an den Computer an
3. Beheben Sie das Thema sicher auf den Plattenspieler.

1.4 Nutzung

1.4.1 Canon -Modus

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

zB zum Erstellen und Verarbeiten eines 20S -Videos zu erstellen und zu verarbeiten, speichern Sie es in /data/videos :

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

1.4.2 Webcam -Modus

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

EG zum Erstellen und Verarbeiten von 500 Frames mithilfe von Geräte /dev/video1 :

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

1.4.3 'Schätzung' Dienstprogramm

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

zB bei einer Brennweite von 100 mm, Rahmenbreite von 720px, Sensorbreite von 24 mm, 1 mm Breite von 21px und Framerate von 60 fps für eine 20 -mm -Fläschchen -Fläschchen:

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. Verarbeitung

2.1 Anforderungen

Es gibt keine zusätzlichen Anforderungen an die Verarbeitung von Videodateien/Streams.

2.2 Nutzung

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

z. B. um examplevideo.mov zu verarbeiten, in der Porträtorientierung und Ausgabe an /data/revile/ :

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