Skip to content

How to Upload Alias

This guide explains how to prepare an alias file and upload it to a factor layer in CartoScope.

Concepts

1. Prepare Your Alias File

Alias File Format

  • The file must be a tab-separated file (.tsv) with one row per factor.
  • It should contains two columns:
    • 1st column (header: either index or name): numeric factor indices.
    • 2nd column (header: alias): aliases names.

Example Alias File

1
2
3
4
index   alias
1   Tumor
2   Stroma
3   Immune

2. Upload Your Alias File via Factor Drawer

Follow the steps below to upload your alias file:

  1. Open the Factor Drawer and select the factor layer you want to update.
  2. In the factor overview table, click the Alias button and choose Upload Alias option in the dropdown list.
  3. In the file picker, select your prepared .tsv file.
  4. Now factor drawer will show the uploaded alias:
    • the alias column in the factor table will update
    • related factor views will show the uploaded aliases
    • the alias source will appear as Upload

Tips

  • If you want to modify a specific uploaded 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 you want to clean the uploaded aliases, use Clear Alias to remove all aliases in the factor drawer.