Why Are No Labels Automatically Created in My Session?

Multi-Sample Session Specific

This feature is only available in multi-sample sessions.

CartoScope automatically creates metadata-derived sample labels only when a metadata field has at least two distinct values across loaded samples (tissue, organism, disease, or platform).

No labels are automatically created if:

• Metadata is uniform: All samples share the exact same value (e.g., all samples have organism: Human or tissue: Kidney).
• Metadata is missing: The multi-catalog.yaml or sample catalogs do not define tissue, organism, disease, or platform values.
• Only one sample is loaded: At least two samples are needed to form distinct comparison groups.
• Non-standard metadata keys are used: Fields other than tissue, organism, disease, or platform (e.g., condition or batch) are ignored by auto-labeling.

Solution

• Add Custom Labels Manually: Open Sample Drawer > Sample Label tab and click + Add Label to create custom sample labels (e.g., Control vs. Treated).
• Update Catalog Metadata: Specify varying tissue, organism, disease, or platform values in your dataset catalog files.

---

Related Pages

Concepts

• Sample Label
• Sample Comparison

How-to Guides

• How to Create Labels
• How to Compare Samples