Skip to content

Teichlab/bin2cell

Repository files navigation

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.

Label evolution

Installation

pip install bin2cell

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. Function docstrings are available on ReadTheDocs.

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

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}
}

About

Join subcellular Visium HD bins into cells

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published