revile

นี่เป็นแพ็คเกจตัวอย่างง่ายๆสำหรับการสร้างภาพ 2D ของพื้นผิวทรงกระบอกโดยใช้หลักการของ การถ่ายภาพการเปิดตัว หรือ การสแกนร่อง

แพ็คเกจนี้มีสองฟังก์ชั่นหลัก: การจับ วิดีโอใหม่และ การประมวล ผลสตรีมวิดีโอ นอกจากนี้ยังสามารถใช้ในสองรูปแบบ: เป็นอินเตอร์เฟสบรรทัดคำสั่ง (CLI) หรือเป็นแพ็คเกจ Python สคริปต์ CLI แสดงตัวอย่างของวิธีการใช้ในสคริปต์ Python ของคุณเอง

0. การติดตั้ง

0.1 ข้อกำหนด

1. Python 3.6+

รหัสได้รับการทดสอบและยืนยันว่าจะทำงานกับ Linux 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 (เป็นทางเลือก - สำหรับการใช้กล้องอื่นนอกเหนือจาก Canon DSLRs ใหม่)
4. FFMPEG (ไม่บังคับ - สำหรับการใช้กล้องอื่นนอกเหนือจาก Canon DSLRs ใหม่)

1.1.2 ข้อกำหนดของอุปกรณ์

1. Arduino uno
2. เซอร์โว หรือ มอเตอร์สเต็ป
   • เดิมทีพัฒนาด้วยมอเตอร์สเต็ปเปอร์ 28BYJ-48 และไดรเวอร์ ULN2003
3. กล้อง
   • บางส่วนจะใช้งานได้กับ Canon DSLR รุ่นใหม่เท่านั้นส่วนอื่น ๆ สามารถใช้สิ่งที่เชื่อมต่อเป็นเว็บแคมได้

1.2 การตั้งค่ากล้อง

1. ตั้งค่าช็อต; เช่นชี้กล้องที่วัตถุโฟกัส ฯลฯ
2. เชื่อมต่อกล้องเข้ากับคอมพิวเตอร์แล้วเปิดเครื่อง

1.2.1 Canon DSLR ใหม่

• ใส่การ์ด SD โดยเฉพาะอย่างยิ่งการ์ดความเร็วสูง (อาจไม่ทำงานกับการ์ดความเร็วต่ำ)
• ตั้งค่าเป็นโหมดวิดีโอ
• กำหนดค่าการตั้งค่าวิดีโอที่ต้องการบนกล้อง (เช่น 60fps เทียบกับ 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. เสียบ Arduino เข้ากับคอมพิวเตอร์ผ่าน USB
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

เช่นในการสร้างและประมวลผลวิดีโอ 20s จากนั้นบันทึกใน /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

เช่นในการสร้างและประมวลผล 500 เฟรมโดยใช้อุปกรณ์ /dev/video1 :

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

เช่นที่ความยาวโฟกัส 100 มม. ความกว้างเฟรม 720px ความกว้างของเซ็นเซอร์ 24 มม. ความกว้าง 1 มม. 21px และเฟรมของ 60fps สำหรับขวด 20 มม.:

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