README.md 3.06 KB
Newer Older
Timm Schoening's avatar
Timm Schoening committed
1
2
> **Preamble:** We strive to make marine image data [FAIR](https://www.go-fair.org/fair-principles/). We maintain - here in this repository - data profiles to establish a common language of marine imagery, we develop best-practice [operating procedures](https://gitlab.hzdr.de/datahub/marehub/ag-videosimages/standard-operating-procedures) for handling marine images and we develop [software tools](https://gitlab.hzdr.de/datahub/marehub/ag-videosimages/software/mar-iqt) to apply the vocabulary and procedures to marine imagery.

Timm Schoening's avatar
Timm Schoening committed
3
# Introduction
Timm Schoening's avatar
Timm Schoening committed
4
Achieving FAIRness and Openness of (marine) image data requires structured and standardized metadata on the image data itself and the visual and semantic image data content. This metadata shall be provided in the form of FAIR digital object (FDOs). The following definitions describe how the image data itself shall be enriched by iFDOs, the visual content of the images by Proxy-FDOs (pFDOs) and the semantic content of the image data by sFDOs.
Timm Schoening's avatar
Timm Schoening committed
5

Timm Schoening's avatar
Timm Schoening committed
6
## Version
Timm Schoening's avatar
Timm Schoening committed
7
Continuous versioning of the FDOs is given by the commit hashes. Releases with numerical versioning will be created upon major changes.
Timm Schoening's avatar
Timm Schoening committed
8

Timm Schoening's avatar
Timm Schoening committed
9
## Metadata vocabulary terms
Timm Schoening's avatar
Timm Schoening committed
10
The following wording will be used throughout the documents.
Timm Schoening's avatar
Timm Schoening committed
11
12
13
14
- images: photos (still images) and videos (moving images) acquired by cameras, recording the optical spectrum of light (http://purl.org/dc/dcmitype/Image)
- still image: A static visual representation (http://purl.org/dc/dcmitype/StillImage)
- moving image: A series of visual representations imparting an impression of motion when shown in succession (http://purl.org/dc/dcmitype/MovingImage)
- image set: a collection of at least one, but usually many, images (http://purl.org/dc/dcmitype/Collection)
Timm Schoening's avatar
Timm Schoening committed
15
- `<tag>`: represent various placeholders for information (like variables)
Timm Schoening's avatar
Timm Schoening committed
16
17
18
19
- `<project>`: the project, expedition or cruise acronym
- `<event>`: part of a project, this refers to the station number in marine sciences
- `<sensor>`: a unique, human-readable identifier (or nickname) for the data acquisition device / camera

Timm Schoening's avatar
Timm Schoening committed
20
21
# FDOs (FAIR Digital Objects)
- [iFDO](https://gitlab.hzdr.de/datahub/marehub/ag-videosimages/metadata-vocabulary-profile/-/blob/master/MareHub_AGVI_iFDO.md) (image FAIR Digital Objects)
Timm Schoening's avatar
Timm Schoening committed
22
- [pFDO](https://gitlab.hzdr.de/datahub/marehub/ag-videosimages/metadata-vocabulary-profile/-/blob/master/MareHub_AGVI_pFDO.md) (proxy FAIR Digital Objects)
Timm Schoening's avatar
Timm Schoening committed
23
- [pFDO core proxy vocabulary](https://gitlab.hzdr.de/datahub/marehub/ag-videosimages/metadata-profiles-fdos/-/blob/master/MareHub_AGVI_pFDO_core-proxy-vocabulary.yaml): the set of allowed terms to be used in creating core proxies for pFDOs.
Timm Schoening's avatar
Timm Schoening committed
24
- sFDO (semantic FAIR Digital Object - TODO)
Timm Schoening's avatar
Timm Schoening committed
25
26
27

## Examples:
- [iFDO example](https://gitlab.hzdr.de/datahub/marehub/ag-videosimages/metadata-vocabulary-profile/-/blob/master/SO268-1_021-1_GMR_CAM-23_example-iFDO.yaml): SO268-1_021-1_GMR_CAM-23_example-iFDO.yaml
Timm Schoening's avatar
Timm Schoening committed
28
- [pFDO example](https://gitlab.hzdr.de/datahub/marehub/ag-videosimages/metadata-vocabulary-profile/-/blob/master/SO268-1_021-1_GMR_CAM-23_example-pFDO.yaml): SO268-1_021-1_GMR_CAM-23_example-pFDO.yaml
Timm Schoening's avatar
Timm Schoening committed
29
- sFDO example (TODO)