<!-- README.md is generated from README.Rmd. Please edit that file -->
<!-- badges: start -->
<!-- badges: end -->
The goal of spaSim (**spa**tial **Sim**ulator) is to facilitate tissue
image simulations! It simulates cells with 2D locations (point data) and
cell types in a tissue. The available patterns include background cells,
cell clusters, immune cell rings and vessels. It also enables
simulations that generate a set of images in one run!
As quantitative tools for spatial tissue image analysis have been
developed and need benchmarking, simulations from spaSim can be applied
to test and benchmark these tools and metrics. The output of spaSim are
images in `SpatialExperiment` object format and can be used with SPIAT.
SPIAT (**Sp**atial **I**mage **A**nalysis of **T**issues) is also
developed by our team.
To install this package, start R and enter:
if (!require("BiocManager", quietly = TRUE))
You can install the development version of spaSim like so:
The vignette with an overview of the package can be accessed from the
top Menu under Articles or clicking
This is a basic example which shows how to simulate background cells
with multiple cell types of different proportions.
mix_background <- TIS(n_cells = 5000, width = 2000, height = 2000,
bg_method = "Hardcore", min_d = 10,
names_of_bg_cells = c("Tumour","Immune","Others"),
proportions_of_bg_cells = c(0.1, 0.2, 0.7),
plot_image = TRUE)
!(man/figures/README-example-1.png)<!-- -->!(man/figures/README-example-2.png)<!-- -->
spaSim was created, designed and implemented by Yuzhou Feng. Anna Trigos
provided supervision and guidance.
## Paper reference
Please check our latest paper for more information!
Yuzhou Feng et al, Spatial analysis with SPIAT and spaSim to
characterize and simulate tissue microenvironments, Nature
Communications (2023). DOI: 10.1038/s41467-023-37822-0