clearml-docs/docs/hyperdatasets/custom_metadata.md

40 lines
1.1 KiB
Markdown
Raw Normal View History

2021-06-20 22:00:16 +00:00
---
title: Custom Metadata
---
Metadata can be customized as needed using: **meta** dictionaries:
* As a top-level key for metadata applying to entire frame
* In `rois` dictionaries, for metadata applying to individual ROIs.
## Usage
### Adding Frame metadata
When instantiating a Frame, metadata that applies for the entire frame can be
added as an argument.
```python
from allegroai import SingleFrame
# create a frame with metadata
frame = SingleFrame(
source='https://allegro-datasets.s3.amazonaws.com/tutorials/000012.jpg',
preview_uri='https://allegro-datasets.s3.amazonaws.com/tutorials/000012.jpg',
# insert metadata dictionary
metadata={'alive':'yes'},
)
# add metadata to the frame
frame.metadata['dangerous'] = 'no'
```
### Adding ROI metadata
Metadata can be added to individual ROIs when adding an annotation to a `frame`, using the [`add_annotation`](google.com)
method.
```python
frame.add_annotation(box2d_xywh=(10, 10, 30, 20), labels=['tiger'],
# insert metadata dictionary
metadata={'dangerous':'yes'})
```