Image Export

Core Feature

This feature is available in all MATISSE Explorer deployments.

Capture your visualizations as PNG images for presentations, publications, or documentation.

Map Viewer Export

The Map Viewer in the Explorer workspace allows you to capture the current view as a PNG image.

Accessing Export

1. In the Explorer workspace, locate the toolbar in the top-right corner
2. Click the Export button (download icon)
3. A popover menu appears with export options

Export Popover

The export popover provides two sections:

Capture as PNG

Captures the current map view including all visible layers.

1. Click Capture PNG
2. The image downloads automatically

Export Data as CSV

Also available in this popover:

• Download All Data - Export current projection coordinates for all points
• Download Selected Data Only - Export coordinates for subset points only (requires active subset)

What's Included in Map Capture

Element	Included
Data points	✓ All visible points with colors
Background image	✓ Tissue/histology image (if visible)
Legend	✓ Color legend (if color mapping applied)
Image adjustments	✓ Brightness, contrast, saturation settings

Not included:

• UI elements (toolbar, sidebar, subset panel)
• Mode switcher controls

File Naming

Map captures are named based on the current projection:

• {projection_name}_1x.png

Examples:

• Spatial_1x.png
• UMAP_1x.png
• t-SNE_1x.png

Scatter Plot Export

The Scatter Plot in the Plot extension provides PNG capture functionality.

Accessing Export

1. Open the Plot extension
2. Configure your scatter plot (X axis, Y axis, color mapping)
3. Click the Export button (download icon) in the top-right toolbar

Export Popover

1. Click Capture PNG
2. The image downloads automatically

What's Included in Scatter Plot Capture

Element	Included
Data points	✓ All visible points with colors
Axes	✓ X and Y axis lines
Axis labels	✓ Tick marks and values
Axis titles	✓ Column names
Grid lines	✓ Background grid
Legend	✓ Color legend (if color mapping applied)

File Naming

Scatter plot captures are named based on the axis columns:

• scatter_plot_{x_axis}_vs_{y_axis}.png

Examples:

• scatter_plot_UMAP_x_vs_UMAP_y.png
• scatter_plot_CD3E_vs_CD4.png

DEG Heatmap Export

InSilicoLab Feature

This feature is exclusive to Portrai InSilicoLab.

DEG analysis heatmaps can be exported from the DEG Analysis workspace. See DEG Analysis - Heatmap Image Export for details.

File naming format: DEG_Heatmap_{date}_{metric}_{direction}_FDR_{threshold}_Top{n}.png

When axis swap is enabled, the filename includes a _Transposed suffix.

Image Resolution

Exported images are captured at your device's pixel ratio:

Display Type	Resolution
Standard (1x)	Screen resolution
Retina/HiDPI (2x)	2x screen resolution

TIP

For higher resolution exports, zoom in on the area of interest before capturing. The exported image will contain more detail for that region.

Tips for Better Exports

Before Capturing

1. Frame your view - Zoom and pan to the area of interest
2. Apply colors - Set up the color mapping you want to show
3. Adjust point size - Ensure points are visible at export size
4. Check the legend - Verify it displays correctly

For Presentations

• Zoom to fill the frame with relevant data
• Use high contrast colors for visibility
• Adjust background image opacity if it obscures data points

For Publications

• Verify resolution meets journal requirements
• Use colorblind-friendly palettes when possible
• Ensure the legend is readable
• Consider post-processing in image editing software if needed

Troubleshooting

Capture Button Not Responding

• Wait for all data to fully load
• Ensure the map/plot has finished rendering
• Try refreshing the page

Image Missing Elements

• Check that layers are visible in Layer Settings
• Verify color mapping is applied
• Wait for the legend to render before capturing

Low Resolution Output

• Export on a higher resolution display if available
• Zoom in on the area of interest for more detail

Large File Size

• Complex views with many points produce larger files
• Background images increase file size
• Consider subsetting to reduce point count

Related Topics

• CSV Export - Export data to CSV format
• Color Mapping - Configure colors before export
• Layer Settings - Control layer visibility
• Scatter Plot - Scatter plot configuration
• DEG Analysis - DEG heatmap export