Work with Your Own Data

CartoScope isn't just for public data — it's also designed to help you visualize and analyze your own spatial omics experiments with the same high quality. This guide walks you through the workflow from raw data to interactive visualization.

Workflow Overview

To bring your data into CartoScope, the process generally involves three steps:

1. Process: Convert your raw data into the optimized format using CartLoader.
2. Host: Store your processed data on an accessible server (AWS S3, Zenodo, or CartoStore).
3. Explore: Load the data URL into CartoScope to visualize and analyze.

---

Step-by-Step Tutorial

1. Prepare Data

To visualize your spatial omics data in CartoScope, you first need to convert the raw files (from platforms like Visium, Xenium, or Stereo-seq) into an optimized, multi-scale format. Our dedicated tool, CartLoader, handles this conversion efficiently.

CartLoader streamlines the preparation process by harmonizing data from various platforms, inferring spatial factors with FICTURE, and aligning morphology images. It also processes segmentation and bin-based analysis results, ensuring all outputs are formatted for high-performance visualization in CartoScope.

• Tool: CartLoader
• Goal: Generate a catalog.yaml and associated tiles/data.
• Key Capabilities:
  • Harmonize diverse formats into a unified schema.
  • Infer spatial factors using FICTURE.
  • Align morphology images with ST data.
  • Process cell segmentation-based analysis results.
  • Process bin-based analysis results.
  • Prepare all above data as multi-resolution map tiles.
• Documentation: CartLoader Documentation

2. Host Your Data

Once processed, your data needs to be accessible via HTTP/HTTPS.

Currently, CartoScope supports the following hosting methods. Please choose the hosting method that best fits your needs, and follow the instructions below.

Hosting Option	Why choose this	Things to pay attention to	How to host
AWS S3	• Scalability: Handles datasets of any size. • Control: Offers fine-grained access control (public or private). • Performance: High availability and fast download speeds globally.	• Cost: You pay for storage. • Setup: Requires configuring permissions and CORS policies correctly.	How to Host on AWS S3
Zenodo	• Free: No cost for storage. • Academic Friendly: Assigns a DOI, perfect for citing. • Long-term Archival: Guarantees data preservation.	• Public Access: Generally intended for open data. • Immutability: Once published, files cannot be easily changed or deleted. • Size Limits: 50GB limit and 100 files per record.	How to Host on Zenodo
CartoStore	• Fully Managed: Provided by CartoScope team, removing maintenance burden. • Reliable Infrastructure: Runs on AWS S3.	• Access by Request: Not self-serve; you must reach out to us. • Coordination: Uploads and updates are handled through the CartoScope team.	Please contact us at cartostore@umich.edu.

3. Explore Your Data in CartoScope

With your data hosted, you can now load it into CartoScope to visualize and analyze.

1. Load External Data: Launch CartoScope and load your dataset from the URL.

2. Visual Exploration:

   • Add Layers: Create a multi-layer map by adding layers of your interest.
   • Orient View: Adjust the map perspective (rotation, flip).

3. In-Depth Analysis:

   • Explore factors: Identify spatial patterns by examining factor layers, their distributions, marker genes, and UMAP embeddings.
   • Create ROIs: Define regions of interest (ROIs) to investigate specific biological features.
   • Compare 2 ROIs: Perform differential expression (DE) analysis between ROIs.
   • Inspect a Spot: View detailed molecular profiles for specific locations.

4. Share Your Results

Collaborate with others by sharing your findings directly.

Sharing Option	Why choose this	Things to pay attention to	How to use
Share Link	• Fast: Instantly copy the URL for the current dataset. • Direct: Points to the original dataset source.	• No State: Does not save your zoom level, active layers, or colors. • Raw View: Recipient sees the default view of the dataset.	How to Share via Link
Bookmark	• Full Context: Saves exact workspace state (zoom, layers, colors). • Reproducible: Ensures collaborators see exactly what you see.	• New URL: Generates a unique bookmark link. • Visibility: Choose between Public (catalog) or Unlisted.	How to Create a Bookmark
Export Map	• Visual: Captures the current view as a high-quality image. • Presentation Ready: Ideal for slides, papers, or static reports.	• Static: Non-interactive image. • Snapshot: Captures only the current visible area.	How to Export Map View
Export Data	• Analytical: Download raw data (CSV, JSON, ZIP, IMAGE) for reuse or external analysis. • Flexible: Process data in tools like Excel, R, or Python.	• No Visuals: Contains only data values, not the map visualization. • Granular: Separate exports required for different data types.	How to Export Data for: • Gene, • Factor, • ROI

Reference

You can find more detailed instructions on specific features in the following documents:

• User Manual: A comprehensive guide to all interface elements and features.
• How-To Guides: Step-by-step instructions for common tasks.