bin2cell 0.3.4

Join subcellular Visium HD bins into cells

Bin2cell

Visium HD captures gene expression data at a subcellular 2um resolution. It should be possible to use this data to reconstruct cells more accurately than just using the next resolution up (8um), especially if additionally using the available high resolution morphology images.

Bin2cell proposes 2um bin to cell groupings based on segmentation, which can be done on the morphology image and/or a visualisation of the gene expression. The package also corrects for a novel technical effect in the data stemming from variable bin dimensions. The end result is an object with cells, created from grouped 2um bins assigned to the same object after segmentation, carrying spatial information and sharper morphology images for visualisation. More details in the demo notebook.

Installation

pip install bin2cell

For b2c.stardist() to work, StarDist needs to be installed. Bin2cell comes with a dependency group to handle this:

pip install bin2cell[stardist]

Additionally, TensorFlow needs to be installed for StarDist to perform segmentation. The CPU version (installed via pip install tensorflow) should suffice for the scale of work performed here.

Usage and Documentation

Please refer to the demo notebook (also viewable on GitHub). Function docstrings are available on ReadTheDocs. An additional notebook comparing destriped and non-destriped expression data can be accessed here.

The repository also has notebooks comparing bin2cell output to standard 8um SpaceRanger output:

• Mouse brain bin2cell and downstream analysis
• Human colorectal cancer bin2cell and downstream analysis

Using bin2cell output from R

Write out your objects as .h5ads and use schard to read them.

Citation

Please cite our paper.

@article{polanski2024bin2cell,
  title={Bin2cell reconstructs cells from high resolution Visium HD data},
  author={Pola{\'n}ski, Krzysztof and Bartolom{\'e}-Casado, Raquel and Sarropoulos, Ioannis and Xu, Chuan and England, Nick and Jahnsen, Frode L and Teichmann, Sarah A and Yayon, Nadav},
  journal={Bioinformatics},
  volume={40},
  number={9},
  pages={btae546},
  year={2024},
  publisher={Oxford University Press}
}