C3 Review App

MarineSitu C3 camera data review and annotation tool.

Introduction

This application provides a user-friendly interface to streamline the process of inspecting footage and sensor data from MarineSitu C3 devices. Whether you're working on computer vision projects, robotics, or any field that utilizes the rich data from MarineSitu cameras, the C3 Review App aims to simplify your data interaction workflow.

Key goals of C3 Review App include:

  • Efficient Data Review: Quickly navigate through recorded frames from one, two, or all three cameras, and visualize associated metadata.
  • Precise Annotation: Tools to accurately measure and label objects, events, or regions of interest within your MarineSitu datasets.
  • Streamlined Workflow: An intuitive experience from loading data to exporting your annotations.

This project uses OpenCV for rectification and stereo calculations in conjunction with a luxonis-style device calibration file (see example file in the repository for formatting).

This documentation will guide you through the installation and usage of the C3 Review App.

Installation

There are two ways to run this application: 1. Building and running a docker image 2. Running the python app.py script locally

To run with Docker:

  1. Clone the git directory
  2. Navigate to the directory
  3. Build the docker image:
    docker build -t c3-data-review-app .
  4. Run the docker image

You'll need to change the volume mounts to match your filesystem and platform. It is recommended that you mount the folder that contains all of your datasets. For example, the folder /data/c3-app might contain multiple dataset folders: /data/c3-app/c3-survey-1 and /data/c3-app/c3-survey-2. Note: If you mount a folder with too many subdirectories, it may take a while for the app to load.

Platform Command Example
Linux/macOS docker run -p 8050:8050 -v /data/c3-app:/mnt/data c3-data-review-app
Windows CMD docker run -p 8050:8050 -v C:\data\c3-app:/mnt/data c3-data-review-app
Windows PowerShell docker run -p 8050:8050 -v //c/data/c3-app:/mnt/data c3-data-review-app

The available folders from the mounted directory will be listed in dropdown for data selection. If the desired folder is not shown, please revisit the directory mounting instructions.

  1. Navigate to http://localhost:8050/ or http://127.0.0.1:8050/ to open the app.

To run locally:

  1. Clone the git directory
  2. Navigate to the directory
  3. Navigate to the app/ folder
  4. Create a virtual python environment and install the required packages in requirements.txt, or install the packages with your global python distribution (not recommended).
  5. Run the python file app.py
  6. Navigate to http://localhost:8050/ or http://127.0.0.1:8050/ to open the app.