10x
Support
Search Support
Contact us
10x Genomics Support/Xenium Ranger/Analysis/

Input Overview

The following output files from Xenium Onboard Analysis (XOA) are required as inputs for Xenium Ranger:

  1. transcripts.zarr.zip or transcripts.zarr
  2. cells.zarr.zip or cells.zarr
  3. morphology.ome.tif
  4. morphology_mip.ome.tif
  5. morphology_focus.ome.tif
  6. experiment.xenium
  7. analysis_summary.html
  8. gene_panel.json (only required for XOA v1.0 - 1.4)

These files should be located in one directory, which will be specified by the --xenium-bundle argument. For descriptions of these files, see the Xenium Onboard Analysis documentation.

The following file formats are compatible for use with the import-segmentation pipeline:

  • Labeled mask in TIFF (32-bit) or NumPy NPY format
  • Polygons in GeoJSON format (FeatureCollection type)
  • Baysor output CSV and GeoJSON file formats

This pipeline has been tested using segmentation files generated by Cellpose v2.2.2, QuPath v0.4, and Baysor v0.6.

The polygon GeoJSON should be exported as a FeatureCollection. Features have geometry of type Polygon. The cells and nuclei should be saved in separate GeoJSON files and the format should look similar to this example:

{ "type": "FeatureCollection", "features": [ { "type": "Feature", "id": "12059192-3b27-4438-96dc-97b41ca84717", "geometry": { "type": "Polygon", "coordinates": [ [ [3418.94, 2], [3414.62, 3.85], [3414.12, 22.65], [3415.06, 27.26], [3420.1, 35.15], [3428.03, 40.22], [3437.01, 42.94], [3440.69, 45.87], [3445.32, 46.71], [3468.85, 46.71], [3477.88, 44.35], [3534.35, 44.31], [3546.79, 37.83], [3552.28, 30.11], [3552.94, 25.45], [3552.93, 6.63], [3550.68, 2.49], [3546, 2], [3418.94, 2] ] ] } } ] }

Segmentation results from QuPath are compatible with Xenium Ranger and have these specifications:

  • The feature objectType should be cells, as features with a non-cell objectType will be ignored.
  • The --nuclei argument will use the nucleusGeometry polygon if it exists in the GeoJSON, otherwise it will use the geometry polygon. The --cells argument will use the geometry polgyon.
  • The same GeoJSON file should be used for both --cells and --nuclei.

Segmentation results from Baysor are compatible with Xenium Ranger and have these specifications:

  • Baysor segmentation GeoJSON should be of type GeometryCollection, where each geometry is of type Polygon.
  • The Polygon should contain an extra field called cell to identify which cell the polygon corresponds to.

Here is an example of the format:

{ "geometries": [ { "coordinates": [ [ [15.891722, 21.441122], [13.95383, 21.565407], [14.233208, 25.427168], [15.927658, 26.113512], [17.464699, 25.211208], [16.642977, 22.83285], [15.891722, 21.441122] ] ], "type": "Polygon", "cell": 5 } ], "type": "GeometryCollection" }