Commit 252eb57a authored by Timm Schoening's avatar Timm Schoening
Browse files

Update MareHub_AGVI_pFDO.md

parent e97473a0
......@@ -4,12 +4,13 @@ Image data is inherently unstructured and obtaining a glimpse of its content is
## 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.
# 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.
# Types of pFDO proxies
- Core **(Required)**: a set of 9 structured values (see table below from image-set-acquisition-type to image-set-spectral-resolution) required to specify the type of image set
- Entropy (Optional): a 1D time series constructed of single entropy values for each image / frame
- Particle count (Optional): a 1D time series constructed of single particle/object count values for each image / frame
- Average color (Optional): 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 (Optional): 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 (Optional): a group of nD feature vectors per image / frame of varying dimensionality according to the chosen MPEG7 descriptors.
# pFDO Fields
......@@ -30,7 +31,7 @@ All proxy metadata shall be stored in one proxy FAIR digital object (pFDO) file.
| 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 |
| 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 |
## Optional pFDO fields (depending on imaging domain and pFDO types used)
......
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