iFDO content fields#
Domain-specific iFDO content fields#
| Field | Type | Description |
|---|---|---|
| image-entropy | number | Information content of an image / frame according to Shannon entropy. |
| image-particle-count | integer | Counts of single particles/objects in an image / frame |
| image-average-color | array | The average colour for each image / frame and the n channels of an image (e.g. 3 for RGB) |
| image-mpeg7-colorlayout | array | An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings. |
| image-mpeg7-colorstatistic | array | An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings. |
| image-mpeg7-colorstructure | array | An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings. |
| image-mpeg7-dominantcolor | array | An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings. |
| image-mpeg7-edgehistogram | array | An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings. |
| image-mpeg7-homogeneoustexture | array | An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings. |
| image-mpeg7-scalablecolor | array | An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings. |
| image-annotation-labels | array | All the labels used in the image-annotations. Specified by an id (e.g. AphiaID), a human-readable name and an optional description. |
| image-annotation-creators | array | All the annotators that created image-annotations. Specified by an id (e.g. ORCID), a human-readable name and an optional type specifying the annotator’s expertise. |
| image-annotations | array | This field stores all annotations as a list of dictionaries of 3-4 fields: shape, coordinates, labels and (optional) frames. See further explanations below. The list of labels specifies the IDs or names of objects and annotators and their confidence. These should be specified in an image-annotation-labels and image-annotation-creators field (see above) to provide more information on the values used in these fields. |
image-entropy#
Type: number
Limits: [0, 1]
Description:
Information content of an image / frame according to Shannon entropy.
image-particle-count#
Type: integer
Limits: [0, ∞)
Description:
Counts of single particles/objects in an image / frame
image-average-color#
Type: array
Min Items: 3
Max Items: 3
Item Type: integer
Item Limits: [0, 256]
Description:
The average colour for each image / frame and the n channels of an image (e.g. 3 for RGB)
image-mpeg7-colorlayout#
Type: array
Item Type: number
Item Limits: (-∞, ∞)
Description:
An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings.
image-mpeg7-colorstatistic#
Type: array
Item Type: number
Item Limits: (-∞, ∞)
Description:
An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings.
image-mpeg7-colorstructure#
Type: array
Item Type: number
Item Limits: (-∞, ∞)
Description:
An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings.
image-mpeg7-dominantcolor#
Type: array
Item Type: number
Item Limits: (-∞, ∞)
Description:
An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings.
image-mpeg7-edgehistogram#
Type: array
Item Type: number
Item Limits: (-∞, ∞)
Description:
An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings.
image-mpeg7-homogeneoustexture#
Type: array
Item Type: number
Item Limits: (-∞, ∞)
Description:
An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings.
image-mpeg7-scalablecolor#
Type: array
Item Type: number
Item Limits: (-∞, ∞)
Description:
An nD feature vector per image / frame of varying dimensionality according to the chosen descriptor settings.
image-annotation-labels#
Type: array
Item Type: object
Description:
All the labels used in the image-annotations. Specified by an id (e.g. AphiaID), a human-readable name and an optional description.
Item Properties:
| Field | Type | Description | Required |
|---|---|---|---|
| id | string | A unique identifier to a semantic label | ✔ |
| name | string | A human-readable name for the semantic label | ✔ |
| info | string | A description on what this semantic label represents |
image-annotation-labels > id#
Type: string
Description:
A unique identifier to a semantic label
image-annotation-labels > name#
Type: string
Description:
A human-readable name for the semantic label
image-annotation-labels > info#
Type: string
Description:
A description on what this semantic label represents
image-annotation-creators#
Type: array
Item Type: object
Description:
All the annotators that created image-annotations. Specified by an id (e.g. ORCID), a human-readable name and an optional type specifying the annotator’s expertise.
Item Properties:
| Field | Type | Description | Required |
|---|---|---|---|
| id | string | A unique identifier to an annotation creator, e.g. orcid URL or handle to ML model | ✔ |
| name | string | A human-readable name for the annotator (identifying the specific human or machine) | ✔ |
image-annotation-creators > id#
Type: string
Description:
A unique identifier to an annotation creator, e.g. orcid URL or handle to ML model
image-annotation-creators > name#
Type: string
Description:
A human-readable name for the annotator (identifying the specific human or machine)
image-annotations#
Type: array
Item Type: object
Description:
This field stores all annotations as a list of dictionaries of 3-4 fields: shape, coordinates, labels and (optional) frames. See further explanations below. The list of labels specifies the IDs or names of objects and annotators and their confidence. These should be specified in an
image-annotation-labelsandimage-annotation-creatorsfield (see above) to provide more information on the values used in these fields.
Item Properties:
| Field | Type | Description | Required |
|---|---|---|---|
| shape | string | The annotation shape is specified by a keyword (allowed values: see enum). | |
| coordinates | array | The pixel coordinates of one annotation. The top-left corner of an image is the (0,0) coordinate. The x-axis is the horizontal axis. Pixel coordinates may be fractional. Coordinates are to be given as a list of lists (only one element for photos, optionally multiple elements for videos). The required number of pixel coordinates is defined by the shape (0 for whole-image, 2 for single-pixel, 3 for circle, 8 for ellipse/rectangle, 4 or more for polyline, 8 or more for polygon). The third coordinate value of a circle defines the radius. The first and last coordinates of a polygon must be equal. Format: [[p1.x,p1.y,p2x,p2.y,…]..] | |
| labels | array | The list of labels assigned to annotations by annotators | |
| frames | array | (only required for video annotations) Frame times (in seconds from the beginning of a video) of a video annotation. Each frame time is linked to one entry in image-annotations:coordinates at the same position in the list, which specifies the current coordinates of the annotation at that frame. Format: [f1,…] |
image-annotations > shape#
Type: string
Must be one of:
| Value | Description |
|---|---|
| single-pixel | Single points in the images were marked |
| polyline | |
| polygon | A detailed outline was drawn around objects of interest |
| circle | |
| rectangle | A bounding box was drawn around objects of interest |
| ellipse | |
| whole-image | The entire image was annotated without defining a region of interest |
Description:
The annotation shape is specified by a keyword (allowed values: see enum).
image-annotations > coordinates#
Type: array
Item Type: array
Description:
The pixel coordinates of one annotation. The top-left corner of an image is the (0,0) coordinate. The x-axis is the horizontal axis. Pixel coordinates may be fractional. Coordinates are to be given as a list of lists (only one element for photos, optionally multiple elements for videos). The required number of pixel coordinates is defined by the shape (0 for whole-image, 2 for single-pixel, 3 for circle, 8 for ellipse/rectangle, 4 or more for polyline, 8 or more for polygon). The third coordinate value of a circle defines the radius. The first and last coordinates of a polygon must be equal. Format: [[p1.x,p1.y,p2x,p2.y,…]..]
image-annotations > labels#
Type: array
Item Type: object
Description:
The list of labels assigned to annotations by annotators
Item Properties:
| Field | Type | Description | Required |
|---|---|---|---|
| label | string | A unique identifier to a semantic label | ✔ |
| annotator | string | A unique identifier to an annotation creator, e.g. orcid URL or handle to ML model | ✔ |
| created-at | string | The date-time stamp of label creation | ✔ |
| confidence | number | A numerical confidence estimate of the validity of the label between 0 (untrustworthy) and 1 (100% certainty) |
image-annotations > labels > label#
Type: string
Description:
A unique identifier to a semantic label
image-annotations > labels > annotator#
Type: string
Description:
A unique identifier to an annotation creator, e.g. orcid URL or handle to ML model
image-annotations > labels > created-at#
Type: string
Description:
The date-time stamp of label creation
image-annotations > labels > confidence#
Type: number
Limits: (-∞, ∞)
Description:
A numerical confidence estimate of the validity of the label between 0 (untrustworthy) and 1 (100% certainty)
image-annotations > frames#
Type: array
Item Type: number
Item Limits: [0, ∞)
Description:
(only required for video annotations) Frame times (in seconds from the beginning of a video) of a video annotation. Each frame time is linked to one entry in
image-annotations:coordinatesat the same position in the list, which specifies the current coordinates of the annotation at that frame. Format: [f1,…]