tissue is a model repository in a single python package for the manuscript Fischer, D. S., Ali, M., Richter, S., Etrürk, A. and Theis, F. "Graph neural networks learn emergent tissue properties from spatial molecular profiles."
You can install Tissue via :
$ git clone tissue
$ cd tissue
$ pip install -e .You can install the requirements via:
$ pip install -r requirements.txtThe repository consists of different components
I. Data loading: datasets can be defined under data/datasets.py and pytorch geometric dataloaders are adjusted accordingly in data/loading.py
II. Models: graph neural networks and baseline models as described in the paper, the following models can be found under modules/:
- Graph convolutional network (GCN)
- Graph isomorphism network (GIN)
- Graph attention network (GAT)
1. Spatial Tissue Architecture
- Graph-based models (GIN, GCN)
2. Graph statistics
- Density-based models
3. Single Cell
- Multiple-instance models
4. Bulk
- Multilayer Perceptron (MLP)
- Logistic Regression
- Random Forest
The models can be trained using the training scripts provided under train/.
III. Summary and evaluation of models: model evaluation and plotting functions are defined in train/summaries.py
IV. Model interpretation: interpretation methods on graph and node embedding levels are implemented under interpretation/
Contributions are very welcome. To learn more, see the Contributor Guide.
Distributed under the terms of the MIT license, Tissue is free and open source software.
If you encounter any problems, please file an issue along with a detailed description.
This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.