Layer Drawer¶
The Layer Drawer is the central hub for managing all visualization layers in CartoScope. It is located on the left side of the screen and can be toggled using the Layer Icon in the top bar.
Functionality¶
- Layer List: Displays all currently loaded layers.
- Reordering: Drag and drop layers to change their rendering order.
- Layer Controller: Rename layers and adjust settings such as visibility, opacity, color, and scale.
Layer Groups
See What types of layers can I add? for details on available layer groups.
Typical Layer Naming Scheme
See the following FAQs for naming conventions:
Interface¶

1. Load Layers Button¶
Click to choose one layer type to load. This will open a dialog to select the layer file.
2. Layer List¶
The list displays all currently loaded layers, including the active layers and the hidden layers.
Components within the layer list
The following example shows four layers from top to bottom: a ROI layer, a gene layer, a factor layer, and a background layer.

1) Layer Information fields
- Layer Group: The category of the layer ("ROI", "Gene", "Factor", or "BG").
- Color: The representative color (applies to Gene and ROI layers).
- Layer Name: The display name of the layer. In the example, "#63617", "Apoe", "t18-f48...", and "H&E histology staining" identify an ROI, a gene, a factor result, and a background image, respectively.
2) Control fields
- Delete Button: Remove the layer from the session.
- Settings Button: Open the configuration panel for the layer:
- Color: Set a specific color or assign a random one.
- Opacity: Adjust the layer transparency.
- Order: Move the layer to the front or back.
- Visibility: Toggle the Eye Icon to show/hide the layer without deleting it.
- Move Up/Down: Change the layer's position in the rendering stack.
3) (Factor Layer Only) Factor Layer Type.
4) (Factor Layer Only) Factor View Button. Click to open the factor view drawer for this factor layer or display the information of this factor layer in the opened factor view drawer.
5) (Background Layer Only) Scale Button. Scales the background layer to fit the current viewport.
3. Map View Summary¶
The map view summary provides real-time information about the current viewport settings.
- Zoom: The current zoom level of the map.
- Subsampling rate: (Conditional) The approximate rate of data thinning when viewing large datasets.
- Rotation: The rotation angle of the map in degrees.
- Pitch: The tilt angle of the map in degrees.
- Flip: Indicates if the map is flipped horizontally (On/Off).
- X: The minimum and maximum X coordinates of the current view
[min, max]. - Y: The minimum and maximum Y coordinates of the current view
[min, max].
Tip
Most values can be double-clicked to edit directly.
Usage¶
For step-by-step instructions, please refer to: