Commit e97473a0 authored by Timm Schoening's avatar Timm Schoening
Browse files

Update MareHub_AGVI_pFDO.md

parent ec1df7ac
......@@ -2,18 +2,16 @@
Image data is inherently unstructured and obtaining a glimpse of its content is hard to achieve for humans as well as machines. pFDOs are a mechanism to encode the content of image data by means of proxies. These can take various forms as described below. Simple examples are thumbnails for images or the average intensity along a video. Some proxies are specified here for the purpose of visualizing the content of imagery in the MareHub data portal and in other context. This collection of proxies is expected to grow with time, as additional (marine) imaging domains make use of this concept.
## File format
All proxy metadata shall be stored in one proxy FAIR digital object (pFDO) file. The file should be human and machine-readable, hence *.yaml format is recommended. The file name should be: <project>_<event>_<sensor>_pFDO.yaml. Bold: suggested best-practice.
All proxy metadata shall be stored in one proxy FAIR digital object (pFDO) file. The file should be human and machine-readable, hence *.yaml format is recommended. The file name should be: `<project>_<event>_<sensor`_pFDO.yaml. Bold: suggested best-practice.
# Types of pFDOs
- Entropy: a 1D time series constructed of single entropy values for each image / frame
- Particle count: a 1D time series constructed of single particle/object count values for each image / frame
- Average color: a set of `n` 1D time series constructed of the average colour for each image / frame and the `n` channels of an image (e.g. 3 for RGB)
- Sequence Image: a 2D image with the pixel dimension of `<number of images / frames> x <height of one image / frame>` containing one column of each image /frame in the image set, stacked along the horizontal of the sequence image according to the acquisition time.
- MPEG7 feature vectors: a group of nD feature vectors per image / frame of varying dimensionality according to the chosen MPEG7 descriptors.
## pFDO Vocabulary terms
- photo
- video
- scan
- raw
- processed
- product
# pFDO Fields
## Required pFDO fields:
......@@ -29,7 +27,7 @@ All proxy metadata shall be stored in one proxy FAIR digital object (pFDO) file.
| image-set-deployment-type | mapping, stationary, survey, exploration, experiment, sampling | mapping: planned path execution along 2-3 spatial axes, stationary: fixed spatial position, survey: planned path execution along free path, exploration: unplanned path execution, experiment: observation of manipulated environment, sampling: ex-situ imaging of samples taken by other method |
| image-set-navigation | satellite, transceiver, transponder, reconstructed | satellite: GPS/Galileo etc., transceiver: USBL etc., transponder: LBL etc., reconstructed: position estimated from other measures like cable length and course over ground |
| image-set-scale-reference | 3D camera, calibrated camera, laser marker, optical flow | 3D camera: the imaging system provides scale directly, calibrated camera: image data and additional external data like object distance provide scale together, laser marker: scale information is embedded in the visual data, optical flow: scale is computed from the relative movement of the images and the camera navigation data |
| image-set-illumination | sunlight, artificial light, mixed light | |
| image-set-illumination | sunlight, artificial light, mixed light | sunlight: the scene is only illuminated by the sun, artificial light: the scene is only illuminated by artificial light, mixed light: both sunlight and artificial light illuminate the scene |
| image-set-resolution | km, hm, dam, m, cm, mm, µm | size of one pixel of an image |
| image-set-terrain | seafloor, water column, sea surface, atmosphere, laboratory | seafloor: images taken in/on/right above the seafloor, water column: images taken in the free water without the seafloor or the sea surface in sight, sea surface: images taken right below the sea surface, atmosphere: images taken outside of the water, laboratory: images taken ex-situ |
| image-set-spectral resolution | grayscale, rgb, multi-spectral, hyper-spectral | grayscale: single channel imagery, rgb: three channel imagery, multi-spectral: 4-10 channel imagery, hyper-spectral: 10+ channel imagery |
......@@ -38,3 +36,8 @@ All proxy metadata shall be stored in one proxy FAIR digital object (pFDO) file.
## Optional pFDO fields (depending on imaging domain and pFDO types used)
| Field | Format / Values / Unit | Comment |
| ----- | ---------------------- | ------- |
| image-set-proxy-entropy | **yaml** | `<image filename 1>: <entropy 1>\n<image filename 2>: <entropy 2\n...>` |
| image-set-proxy-particle-count | **yaml** | `<image filename 1>: <particle count 1>\n<image filename 2>: <particle count 2\n...>` |
| image-set-proxy-average-color | **yaml** | `<image filename 1>:\n\t<channel 0>: <value>\n\t<channel 1>: <value>\n<image filename 2>:\n\t<channel 0>: <value>\n...>` |
| image-set-proxy-sequence-image | Handle | Handle URL to an image |
| image-set-proxy-mpeg7-features | **yaml** | `<image filename 1>:\n\t<descriptor 0>: [<value>,<value>,...]\n\t<descriptor 1>: [<value>,<value>,...]\n<image filename 2>:\n\t<descriptor 0>: [<value>,<value>,...]\n...>` |
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