revile

Este é um pacote de exemplo simples para gerar imagens 2D de superfícies cilíndricas, usando o principal de fotografia de lançamento ou varredura de fenda .

Este pacote possui duas funções principais: capturar novos vídeos e processar fluxos de vídeo. Também pode ser usado em duas formas: como uma interface de linha de comando (CLI) ou como um pacote python. O script da CLI mostra exemplos de como ele pode ser usado em seus próprios scripts Python.

0. Instalação

0,1 requisitos

1. Python 3.6+

O código só foi testado e confirmado para trabalhar em um sistema operacional Linux, mas pode funcionar em outros.

0.2 Configuração

Instale 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 jogar um bipe para sinalizar a extremidade do movimento da plataforma giratória)
3. v4l2loopback (opcional - para usar câmeras que não sejam novas DSLRs Canon)
4. FFMPEG (Opcional - para usar câmeras que não sejam novas DSLRs Canon)

1.1.2 Requisitos de equipamento

1. Arduino Uno
2. Servo ou motor de passo + driver (com superfície plana segura presa para atuar como uma plataforma giratória)
   • Originalmente desenvolvido com um motor de passo 28byj-48 e um motorista ULN2003
3. Câmera
   • Algumas peças funcionam apenas com DSLRs mais recentes da Canon, outras podem usar qualquer coisa conectada como uma webcam

1.2 Configuração da câmera

1. Configurar o tiro; Por exemplo, aponte a câmera no objeto, foco, etc.
2. Conecte a câmera ao computador e ligue -o.

1.2.1 NOVO CANON DSLRS

• Insira um cartão SD, de preferência uma alta velocidade (pode não funcionar com uma velocidade inferior)
• definido para o modo de vídeo
• Defina as configurações de vídeo desejadas na câmera (por exemplo, 60fps vs 30fps)

1.2.2 Outras câmeras

A câmera precisa estar transmitindo a partir de um dispositivo A /dev/video . Isso pode não ser possível com todas as câmeras; Verifique suas especificações. Para uma câmera conectada via USB com um modo de visualização disponível, você pode fazer isso usando v4l2loopback . Depois 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 Configuração do objeto

1. Conecte o servo/motor + driver e arduino
2. Conecte o Arduino ao computador via USB
3. Corrija o assunto com segurança na plataforma giratória.

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 exemplo, para criar e processar um vídeo 20S e salve -o em /data/videos :

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

1.4.2 Modo da webcam

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 exemplo, para criar e processar 500 quadros usando dispositivo /dev/video1 :

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

1.4.3 Utilitário de 'estimativa'

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 exemplo, a uma distância focal de 100 mm, largura da estrutura de 720px, largura do sensor de 24 mm, 1 mm de largura de 21px e quadros de 60fps, para um frasco 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. Processamento

2.1 Requisitos

Não há requisitos adicionais para processar arquivos/fluxos de vídeo.

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 exemplo, para processar examplevideo.mov , filmado na orientação retrato e saída para /data/revile/ :

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