There is a newer version of the record available.

Published September 18, 2019 | Version 0.4.0
Software Open

mbari-media-management/annosaurus: annosaurus 0.4.0

Authors/Creators

Description

annosaurus 0.4.0

Add a /windowrequest endpoint to find annotations in a set of videos near an existing one. The expected workflow to use this endpoint is as follows:

1. Fetch videos of interest

In general, these are videos from the same camera deployment. You can retrieve these from vampire-squid using http://myserver.org/vam/v1/media/concurrent/{video_reference_uuid}. This will return an array of media objects that overlap with the one you provided (via it's video_reference_uuid). For example:

[
  {
    "video_sequence_uuid": "28d1c03e-723e-4d78-9705-9b973a768c66",
    "video_reference_uuid": "e3005de7-2c0a-4a3f-80ad-79e5e79ee4b8",
    "video_uuid": "db0c3d6a-9849-4ff4-bc18-fd134337d114",
    "video_sequence_name": "Ventana 3009",
    "camera_id": "Ventana",
    "video_name": "V3009-01",
    "uri": "urn:tid:mbari.org:V3009-01",
    "start_timestamp": "2007-05-25T15:28:39Z",
    "duration_millis": 3600000,
    "container": "tape",
    "width": 1920,
    "height": 1080,
    "frame_rate": 29.97,
    "size_bytes": 0,
    "description": "Tape loaded from VARS on 2019-01-09T16:30:23.971Z. 86/86 valid dates"
  }
]
2. Use windowrequest

You will need:

  • The video_reference_uuids of the videos you want to query from
  • The imaged_moment_uuid of the existing annotation, it's recordedTimestamp will be the center of the time window
  • the window width in milliseconds
POST /anno/v1/imagedmoments/windowrequest
Content-Type: application/json

{
  video_reference_uuids: [
    "e3005de7-2c0a-4a3f-80ad-79e5e79ee4b8",
    "9be0daeb-d303-46a9-b3fa-699d7d40591e"
  ],
  imaged_moment_uuid: "0557b59b-60d5-44d0-acb3-71bf4acddf0a",
  window: 10000
}

Files

mbari-media-management/annosaurus-0.4.0.zip

Files (762.5 kB)

Name Size Download all
md5:b9d0c304e95e7aaf46fc9467ace416c0
762.5 kB Preview Download

Additional details