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).

Searching for Asset from their AssetTag is the subject of the next section.

5. Search Asset by AssetTag

Once your AssetTag are attached, three ways let you keep only the Asset you are interested in.

A. With the Select Tags filter

Next to Select Date, above the list, the Select Tags button filters the Asset on their AssetTag without writing any query. Tick the AssetTag you want and choose how they are combined, as detailed here:

• AND keeps the Asset that carry all the selected AssetTag.
• OR keeps the Asset that carry at least one of them, for instance train and val to browse everything that is not held out for the test.
• NOT keeps the Asset that carry none of the selected AssetTag. When AssetTag materialize a split, selecting train, val, and test with NOT lists the Asset that do not belong to any split yet, which is a quick check before launching a Training or an Evaluation.

The number of Asset displayed above the list follows the filter, and the filter is kept in the address of the page, so you can share the filtered list with a teammate by sharing the link.

Once the list displays what you expect, select the Asset and act on them as detailed in Asset selection and actions, for instance to attach or detach other AssetTag.

The Select Tags filter only relates to the AssetTag of the DatasetVersion. The DataTag of the underlying Data are not proposed there; to filter on them, use the Query Language.

B. With the Query Language

A more SQL-like way to create filters, the Query Language lets you build more complex queries than the filters alone, by combining a condition on AssetTag with conditions on other properties related to the Asset. The same search bar reaches the DataTag of the underlying Data with data.tags, as detailed here. It can be used together with the Select Tags filter, which then narrows down the result of your query.

C. From the Details view

Clicking one of the tags displayed in the Details view filters the list on it directly, which is the quickest way to go from the Asset you are looking at to every other Asset that shares its tag.

6. 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.