Dataset - Tagging system

Already available in the Datalake as detailed here, the DatasetVersion also embeds its own dedicated tagging system.

1. Introducing AssetTag by Picsellia

A tag is an object you can name and attach to one or more Picsellia objects, mainly to structure and easily retrieve them among others. As there are tagging systems related to different objects on Picsellia (Datalake, DatasetVersion, ...), any tag related to a DatasetVersion is called an AssetTag.

Any Asset can have as many AssetTag attached to it as you need.

This additional level of abstraction lets you build your own Asset structure inside your DatasetVersion, so you can retrieve and browse Asset by searching for the ones having one or several AssetTag attached.

It is important to note that each DatasetVersion has its own independent tagging system: an AssetTag created in one DatasetVersion is not shared with its other DatasetVersion, nor with the DataTag of the underlying Datalake.

You are free to use AssetTag however you want, to organize your DatasetVersion the way that suits you. For example, a common use of AssetTag is to materialize a split of the DatasetVersion (e.g. train/test/val), independently of the Version Type and Labelmap covered here.

2. Creating, Editing, and Deleting AssetTag

For creating, modifying, or removing an AssetTag, you can access the Settings of your DatasetVersion and go to the Asset Tags page.

To create a new AssetTag, simply click on + Add new asset tag. This adds a new entry to the AssetTag list, where you can provide a name and description for the new AssetTag.

You can also change the name and description of an existing AssetTag, or delete it using the trash icon after selecting it.

3. Attach AssetTag to your Asset

Tagging your Asset is quite easy: from the Assets overview, select the Asset to be tagged and click on Tag > Attach.

Then choose the AssetTag to attach to the selected Asset from the list of existing AssetTag, and click on Attach.

You can also create a new AssetTag that will be attached directly to the selected Asset, from that same attachment modal.

4. Visualize AssetTag on your Asset

Now that you know how to create and attach AssetTag to structure and organize your DatasetVersion, let's see how to leverage them to easily access the Asset you need.

You can visualize the AssetTag attached to each Asset from the Table view (in its own asset tags column) or the Details view (in a Tags field).

By using the search bar, you can also filter to only the Asset with one or several given AssetTag attached.

5. Detach AssetTag

If you need to detach one or several AssetTag from a batch of Asset in your DatasetVersion, select the Asset the AssetTag need to be detached from and click on Tag > Detach.

A modal opens, listing all AssetTag attached to any of the selected Asset. Click on the AssetTag you want to detach from the selected Asset, then click on the Detach button.