revile

Este es un paquete de ejemplo simple para generar imágenes 2D de superficies cilíndricas, utilizando el principal de la fotografía de despliegue o el escaneo de hendiduras .

Este paquete tiene dos funciones principales: capturar nuevos videos y procesar transmisiones de video. También se puede usar en dos formas: como interfaz de línea de comandos (CLI), o como un paquete Python. El script CLI muestra ejemplos de cómo se puede usar en sus propios scripts de Python.

0. Instalación

0.1 requisitos

1. Python 3.6+

El código solo ha sido probado y confirmado para trabajar en un sistema operativo Linux, pero puede funcionar en otros.

0.2 Configuración

Instalar usando PIP:

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

1. Captura

1.1 requisitos

1.1.1 Requisitos de software

1. gphoto2
2. SOX (opcional: para jugar un pitido para señalar el extremo del movimiento de la plataforma giratoria)
3. v4l2loopback (opcional: para usar cámaras distintas de las nuevas dslrs canon)
4. FFMPEG (opcional: para usar cámaras distintas de las nuevas DSLR de Canon)

1.1.2 Requisitos de equipo

1. Arduino Uno
2. Motor de servo o paso a paso + controlador (con superficie plana segura unida para actuar como un tocadiscos)
   • Originalmente desarrollado con un motor paso a paso 28BYJ-48 y un controlador ULN2003
3. Cámara
   • Algunas piezas solo funcionarán con las nuevas DSLR canon más recientes, otras pueden usar cualquier cosa conectada como cámara web

Configuración de la cámara 1.2

1. Configurar el disparo; por ejemplo, apunte la cámara al objeto, enfócalo, etc.
2. Conecte la cámara a la computadora y actúe.

1.2.1 Nuevas dslrs canon

• Inserte una tarjeta SD, preferiblemente una de alta velocidad (puede que no funcione con una de menor velocidad)
• Establecer en modo de video
• Configure la configuración de video deseada en la cámara (por ejemplo, 60 fps frente a 30 fps)

1.2.2 Otras cámaras

La cámara debe transmitirse desde un dispositivo /dev/video . Esto puede no ser posible con todas las cámaras; Verifique sus especificaciones. Para una cámara conectada a través de USB con un modo de vista previa disponible, puede hacerlo utilizando v4l2loopback . Después de instalar 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 Configuración de objetos

1. Conecte el servo/motor + controlador y Arduino
2. Conecte el Arduino a la computadora a través de USB
3. Arregle el sujeto de forma segura en el plato giratorio.

1.4 Uso

1.4.1 Modo 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

por ejemplo, para crear y procesar un video de 20S, luego guárdelo en /data/videos :

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

1.4.2 Modo de cámara web

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

por ejemplo, para crear y procesar 500 cuadros utilizando dispositivos /dev/video1 :

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

1.4.3 utilidad 'estimar'

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

por ejemplo, a una distancia focal de 100 mm, ancho de marco de 720px, ancho del sensor de 24 mm, 1 mm de ancho de 21px y fotograma de 60 fps, para un vial de 20 mm:

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

2.1 requisitos

No hay requisitos adicionales para procesar archivos/transmisiones de video.

2.2 Uso

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

Por ejemplo, procesar examplevideo.mov , filmado en orientación de retrato y salida a /data/revile/ :

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