To allow quick and easy visualisation of an image or an AnnData object, Vitessce can generate a view config automatically, given the URLs to the data files. This page explains how to use this feature and which file formats are supported.
Vitessce currently supports automatic view config generation for the following file formats:
How to use
To use this functionality, go to the App page of this website and paste the URL of the file(s) to visualize, separating multiple URLs with semicolon (
Upon entering URLs, a list of layout options that are available for the respective file types will be displayed. Upon clicking one of the layout options, the JSON editor will be populated with the generated view config. Then, you can either launch Vitessce with the generated configuration directly, or customize the configuration before launching.
This functionality relies on file extensions to infer file formats, so ensure that each data file is of supported format and complies with the requirements.
Note that all files will be treated as part of the same dataset (i.e., one element in
The currently-supported layout options (also referred to as user-provided "hints" to guide the config generation) for each dataset type can be found in
constants.js file under https://github.com/vitessce/vitessce/tree/main/packages/config/src.
NOTE: In some cases, the automatically generated view config might need small manual adjustments. For instance, when using hint
Spatial transcriptomics (with histology image and polygon cell segmentations), you will need to manually adjust the coordination values for the image and the segmentation layer, which are set to
null by default, to match your particular files.
You will need one or more URLs, where each points to a static file to visualize. Each URL must end with one of the supported file extensions listed below.
If you want to view data in OME-TIFF format, make sure that the URL to the file ends with
.ome.tiff. For example:
- https://example.com/my_dataset.ome.tif is a valid URL
- https://example.com/my_dataset.ome.tiff is also a valid URL
If you want to view data in AnnData-Zarr format, make sure that the URL to the root of the Zarr store ends with
.zmetadata file is present in the root of the Zarr store, it will be used for generating the view config.
.zmetadata file can be generated by running the consolidate_metadata function on the Zarr store that results from
For example, a Zarr store located at
https://example.com/my_dataset.h5ad.zarr must have its consolidated metadata file at
https://example.com/my_dataset.h5ad.zarr/.zmetadata. If this returns a
404 Not Found error instead, this means that the
.zmetadata file is either missing or not uploaded at the root folder.
Alternatively, if no
.zmetadata file is found at the root of the Zarr store, the view config will be generated after checking for existence of
<folder> is one of:
X_pca, X_spatial, X_tsne, X_umap, X_segmentations and the contents of
obs/.zattrs. We currently support only
'encoding-type' = 'dataframe' and
If you want to view data in OME-Zarr format, make sure that the URL to the dataset ends with
.ome.zarr. For example:
- https://example.com/my_dataset.1234585s.ome.zarr is a valid URL
- https://example.com/my_dataset.1234585s.zarr is not a valid URL
When generating the view config, Vitessce makes a couple of assumptions, depending on the file format:
For datasets of OME-TIFF format, Vitessce adds
layerController view types by default. You can delete or adjust each of them using the editor. For the
layerController, the sliders for each Channel are removed if RGB is detected. If you don't want this behavoiur, remove the following lines from the view config:
For datasets of AnnData-Zarr format, Vitessce adds a
heatmap and a
featureList view type whenever
X is present. The heatmap is transposed by default. If you don't want it transposed, remove the following lines from the view config:
Vitessce adds linked
spatial view types when
obsm/X_spatial are present.
Vitessce adds one
scatterplot view with
embeddingType equal to
obsm/X_umap are present in the dataset respectively.
Vitessce adds an
obsSets view whenever any of the following are present in
louvain. You can generate these subgroups using the leiden or louvain scanpy functions;
sex, which are some of the conventions used in cellxgene.
For datasets of OME-Zarr format, Vitessce adds
status view types by default.