FAQ¶
How do I merge a single dive?¶
You will need to have docker or podman installed.
docker pull portal.shore.mbari.org:5000/mbari/m3-merge-rov
docker run -it portal.shore.mbari.org:5000/mbari/m3-merge-rov /bin/bash
merge_rov <ROV Name> <Dive Number>
How do I generate time-code reports to identify issues before I ship tapes to Iron Mountain?¶
You will need to have docker or podman installed. In the docker run command, you will need to mount a local directory that you want to write to as a docker volume. The format to do this is -v host_dir:container_dir. In the example below, -v /Users/brian/Downloads/data:/data means "Mount my local directory /Users/brian/Downloads/data inside the docker container as /data.
To see the help for dive_timecode_reports, run dive_timecode_reports -h. For IMES, we usually want all reports between a start and end data. Use the -s flag to set the start date and the -e flag for the end data.
docker pull portal.shore.mbari.org:5000/mbari/m3-merge-rov
docker run -it -v /Users/brian/Downloads/data:/data portal.shore.mbari.org:5000/mbari/m3-merge-rov /bin/bash
dive_timecode_reports -s 2013-01-01T00:00:00Z -e 2018-12-31T23:59:59Z /data
This will generate one report per dive. The contents will look something like:
Doc Ricketts 138-report.txt
# Doc Ricketts 138 (aka Doc Ricketts 138)
# === EXPD ===================================
Chief Scientist: Charlie Paull
Dates: 2010-03-28T21:04:45Z to 2010-03-28T23:03:45Z
Duration: 1:59:00
Mission: Push Cores and rock sampling
All systems operational
Dive complete
Lat/Lon: 33.52778409N -118.10769905E
# === Camera Log =============================
Dates: 2010-03-28T21:05:51Z to 2010-03-28T22:54:37Z
Expected Duration: 1:48:46
Actual Duration: 1:40:02
Number rows in log: 3001
Row interval (secs): 2.0
Timecode Resets: 0
Alt Timecode Resets: 1
# === Alternate Timecodes Resets
02:07:46:29 2010-03-28T21:15:10Z (46 of 3001)
00:00:01:18 2010-03-28T21:15:40Z (47 of 3001)
# === Alternate Timecodes Gaps
02:06:15:04 2010-03-28T21:05:57Z (3 of 3001)
02:06:18:27 2010-03-28T21:08:27Z (4 of 3001) 0:02:30
02:06:22:28 2010-03-28T21:08:31Z (6 of 3001)
02:06:26:19 2010-03-28T21:11:25Z (7 of 3001) 0:02:54
02:07:04:18 2010-03-28T21:12:03Z (26 of 3001)
02:07:06:24 2010-03-28T21:13:41Z (27 of 3001) 0:01:38
# === Alternate Timecodes vs Time Delta > 2 seconds
02:06:15:04 2010-03-28T21:05:57Z (3 of 3001)
02:06:18:27 2010-03-28T21:08:27Z (4 of 3001) 3.77 vs 150.00 secs
02:06:22:28 2010-03-28T21:08:31Z (6 of 3001)
02:06:26:19 2010-03-28T21:11:25Z (7 of 3001) 3.70 vs 174.00 secs
02:07:04:18 2010-03-28T21:12:03Z (26 of 3001)
02:07:06:24 2010-03-28T21:13:41Z (27 of 3001) 2.20 vs 98.00 secs
How do I watermark images for external KB¶
Watermarking crontab on quasar:
# Replication runs on 1st Monday of month. Update images on first tuesday
0 0 8 * * /u/brian/Applications/m3-merge/bin/watermark_kb /mbari/VideoLab/VARS_Images/external /u/brian/Applications/m3-merge/etc/overlay.png > /u/brian/Library/Logs/quasar-watermark_kb.log 2>&1
0 12 8 * * /u/brian/Applications/m3-merge/bin/watermark_anno /mbari/framegrabs_watermarked /u/brian/Applications/m3-merge/etc/overlay.png > /u/brian/Library/Logs/quasar-watermark_anno.log 2>&1
First, mount smb://atlas.shore.mbari.org/VideoLab. Then run the following:
sbt pack
cd target/pack/bin
watermark_kb /Volumes/VideoLab/VARS_Images/external ../etc/overlay.png