Skip to content

How to Load AI Alias

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

1. (Optional) Prepare Your Dataset with AI-Inferred Alias

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

See the Alias File Format and Example Alias File sections.

Example catalog.yaml file with AI-inferred alias

1
2
3
4
5
6
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.

2. Check whether AI alias is available

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.

3. Load the AI alias via Factor Drawer

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

  1. Open the Factor Drawer and select the factor layer you want to update.
  2. In the Overview Table, click the Alias button and choose the Load AI-inferred alias option in the dropdown list.
  3. The Factor Drawer now shows the AI-inferred aliases:
    • The Alias column in the Overview Table updates.
    • Related factor views show the loaded aliases.
    • The alias source appears as AI-inferred.

Tips

  • If you want to modify a specific AI-inferred alias, double-click that alias in the Factor Drawer to activate edit mode, 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 is disabled.

Related Pages

Concepts

Manual Pages

How-to Guides