How to Load AI Alias¶

This guide explains how to load the AI-inferred alias table for a factor layer in CartoScope.

Concepts¶

If you want to prepare a dataset with AI-inferred alias, provide AI-inferred alias file in catalog.yaml for each factor set.

How to prepare the AI-inferred alias file

Refer Alias File Format and Example Alias File here

Example catalog.yaml file with AI-inferred alias

assets:
factors:
    - id: celltype
    name: Cell Type
    rgb: factors/celltype/rgb.tsv
    alias_ai: factors/celltype/alias_ai.tsv

In this setup:

alias_ai is the optional AI-generated alias table used as the AI-inferred source.

Availability

AI aliases are available only when the active factor layer provides an alias_ai file in catalog.yaml.
If a Curated alias exists for the same factor layer, CartoScope still keeps Curated as the default alias source.
You can load the AI-inferred alias explicitly from the Factor Drawer when it is available.

Follow the steps below to load the AI-inferred alias:

Open the Factor Drawer and select the factor layer you want to update.
In the factor overview table, click the Alias button and choose Load AI-inferred alias option in the dropdown list.
Now the factor drawer will show the AI-inferred aliases:
- the alias column in the factor table will update
- related factor views will show the loaded aliases
- the alias source will appear as AI-inferred

Tips

If you want to modify a specific AI-inferred alias, double-click this alias in the factor drawer to activate the edit mode and then modify it.
If you want to return to the dataset default aliases, use Reset Alias to switch back to Curated aliases when available.
If AI alias is not available for the active factor layer, the Load AI-inferred alias option will not be available.