Commit 91f96f40 authored by Timm Schoening's avatar Timm Schoening
Browse files

Update README.md

parent 711e2746
......@@ -36,7 +36,7 @@ All metadata fields can be part of the image-set block in case they are static (
| image-set-type | String | Video, Photo, Microscopy, ... |
| image-set-creator | **Orcid** | Orcid (or Name, E-Mail) |
| image-set-license | CC-BY-NC / **CC-BY** / CC-0 | Copyright sentence / contact person or office |
| image-set-coordinate-uncertainty | Float (m) | Average/static uncertainty of coordinates in this dataset, given in meters |
| image-set-coordinate-uncertainty | Float [m] | Average/static uncertainty of coordinates in this dataset, given in meters |
### Optional (domain-specific)
| Field | Format / Values / Unit | Comment |
......@@ -49,3 +49,92 @@ All metadata fields can be part of the image-set block in case they are static (
| image-set-acquisition-settings | **yaml**/json, free keys | Camera and lens settings (e.g. f number, acquisition time) |
| image-set-camera-intrinsics | **yaml**/json, free keys | focal lengths etc. |
| image-set-camera-extrinsics | **yaml**/json, free keys | x,y,z position offsets of the camera on the deployment frame and yaw, pitch, roll offsets of the camera mounting on the frame |
## Image information (Frequency: per image or per second of video):
### Required
| Field | Format / Values / Unit | Comment |
| ----- | ---------------------- | ------- |
| image-uuid | UUID | UUID (**version 4 - random**) for the image file (still or moving) |
| image-filename | `<project>_<event>_<sensor>_<datetime>.[jpg,png,tif,raw,...]` | A filename string to identify the image data on disk (no absolute path!) |
| image-datetime | UTC: YYYY-MM-DD HH:MM:SS.SSSSS+0000 | |
| image-longitude | longitude [deg] | Decimal degrees: D.DDDDDDD |
| image-latitude | latitude [deg] | Decimal degrees: D.DDDDDDD |
| image-depth | Float [m] | Use when camera below water, then it has positive values |
| image-altitude | Float [m] | Use wenn camera above water, then it has positive values |
### Optional (domain-specific)
| Field | Format / Values / Unit | Comment |
| ----- | ---------------------- | ------- |
| image-pixel-per-millimeter | Float [px/mm^2 = MPx/m^2] | Resolution of the imagery in pixels / millimeter which is identical to megapixel / square meter |
| image-meters-above-ground | Float [m] | Distance of the camera to the seafloor |
| image-coordinate-uncertainty | Float [m] | Optional, only needed when no static value is given for the image-set |
| image-acquisition-settings | **yaml**/json, free keys | Optional, only needed when no static value is given for the image-set |
| image-camera-intrinsics | **yaml**/json, free keys | Optional, only needed when no static value is given for the image-set |
| image-camera-extrinsics | **yaml**/json, free keys | Optional, only needed when no static value is given for the image-set |
# Example:
File name: SO268-1_021-1_GMR_CAM-23_iFDO.yaml:
`
image-set-name: SO268-1_21-1_GMR_CAM-23
image-set-context: SO268-1
image-set-event: 21-1
image-set-platform: SO_OFOS-1
image-set-sensor: GMR_CAM-23
image-set-uuid: 2a2360e9-a5ec-4ad2-be04-0ea0b4cbdc58
image-set-crs: EPSG:4326
image-set-type: photo
image-set-creator: Y. Bodur
image-set-license: CC-BY
image-set-coordinate-uncertainty: 13.42
image-set-event-information: Towed camera deployment to assess the health status of the eastern part of the Foobar reef.
image-set-reference-calibration: Checkerboard with 3cm box length imaged before deployment.
image-set-time-synchronisation: Camera set to UTC over RS232 before the deployment. No offset occured after post-deployment check.
image-set-item-identification-scheme: PROJECT_EVENT_SENSOR_DATETIME.jpg
image-set-curation-protocol: Navigation data smoothed and splined (see navigation sensor protocol for details), and assigned to imagery by timestamp. Coordinate uncertainty is given by standard deviation from navigation smoothing. Imagery without content (all black) due to lamp failure were removed manually.
image-set-acquisition-settings: Camera set to auto mode for ISO, f-number and exposure time
image-item-data:
SO268-1_21-1_GMR_CAM-23_20190513_131415.jpg:
image-uuid: 9999ba88-1a20-4efe-a0ac-6b4233490ad6
image-datetime: 2019-05-13 13:14:15+0000
image-longitude: -123.854637
image-latitude: 42.133426
image-depth: 4230.3
image-pixel-per-millimeter: 12.1
image-meters-above-ground: 1.3
image-coordinate-uncertainty: 4.2
SO268-1_21-1_GMR_CAM-23_20190513_131416.jpg:
image-uuid: 1c266c00-33e7-4e69-bc9a-f90fb1bce6d0
image-datetime: 2019-05-13 13:14:16+0000
image-longitude: -123.854638
image-latitude: 42.133427
image-depth: 4230.4
image-pixel-per-millimeter: 12.1
image-meters-above-ground: 1.4
SO268-1_21-1_GMR_CAM-23_20190513_131417.jpg:
...
alternative for videos:
SO268-1_21-1_GMR_CAM-23_20190513_111213.mp4:
image-uuid: 9999ba88-1a20-4efe-a0ac-6b4233490ad6
image-seconds:
0:
image-datetime: 2019-05-13 13:14:15+0000
image-longitude: -123.854637
image-latitude: 42.133426
image-depth: 4230.3
image-pixel-per-millimeter: 12.1
image-meters-above-ground: 1.3
image-coordinate-uncertainty: 4.2
1:
image-datetime: 2019-05-13 13:14:16+0000
image-longitude: -123.854638
image-latitude: 42.133427
image-depth: 4230.4
image-pixel-per-millimeter: 12.1
image-meters-above-ground: 1.4
SO268-1_21-1_GMR_CAM-23_20190513_131419.mp4:
image-uuid: 7cf53535-c80c-4eac-94d4-30fe4a521fd9
image-seconds:
0: ...
`
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment