-
Notifications
You must be signed in to change notification settings - Fork 10
/
README.Rmd
89 lines (60 loc) · 3.45 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
# Microbiome data simulation with miaSim <img src="man/figures/mia_logo.png" align="right" width="120" />
<!-- badges: start -->
[![Codecov test coverage](https://codecov.io/gh/microbiome/miaSim/branch/master/graph/badge.svg)](https://codecov.io/gh/microbiome/miaSim?branch=master)
[![Gitter](https://badges.gitter.im/microbiome/mia.svg)](https://gitter.im/microbiome/miaverse)
[![Watch on GitHub][github-watch-badge]][github-watch]
[![Star on GitHub][github-star-badge]][github-star]
[![R-CMD-check](https://github.com/microbiome/miaSim/workflows/R-CMD-check/badge.svg)](https://github.com/microbiome/miaSim/actions)
<!-- badges: end -->
## miaSim
This R/Bioconductor package provides tools to simulate (longitudinal)
time series data from popular models in microbial ecology. The
[homepage](https://microbiome.github.io/miaSim/) provides tutorials
and references for the [implemented
models](https://microbiome.github.io/miaSim/reference/index.html):
* Self-organised instability (SOI)
* Hubbell's neutral model
* generalized Lotka-Volterra (gLV)
* Ricker model (discrete gLV)
* Stochastic logistic model
* Consumer-resource model
These methods can be used for _in silico_ studies of microbial
community dynamics or multi-omic or host-microbiome interactions. The
miaSim package supports the Bioconductor [multi-assay data science
framework](https://microbiome.github.io/OMA) for multi-omic data
integration and time series analysis, and utilizes the
`(Tree)SummarizedExperiment` data container.
[Getting started](https://microbiome.github.io/miaSim/articles/miaSim.html).
### miaSimShiny
The accompanying
[miaSimShiny](https://github.com/gaoyu19920914/miaSimShiny) package
allows users to explore the parameter space of their models in
real-time in an intuitive graphical interface.
You can experiment with miaSimShiny
[online](https://gaoyu.shinyapps.io/shiny_rep/).
### Contributions and acknowledgments
You can find us online from [Gitter](https://gitter.im/microbiome/miaverse).
Contributions are very welcome through issues and pull requests at the
[development site](https://github.com/microbiome/miaSim). We follow a git
flow kind of approach. Development version should be done against the
`main` branch and then merged to `release` for release.
(https://guides.github.com/introduction/flow/)
We are grateful to all
[contributors](https://github.com/microbiome/miaSim/graphs/contributors).
This research has received funding from
* the Horizon 2020 Programme of the European Union within the [FindingPheno project](https://www.findingpheno.eu/) under grant agreement No 952914.
* Research Council of Finland (grant 330887)
<img src="man/figures/FindingPheno2.jpg" alt="FindingPheno logo" style="height: 50px"/>
### Citing the package
**Kindly cite this work** as follows:
Gao _et al._ (2023). Methods in Ecology and Evolution. DOI:
[10.1111/2041-210X.14129](https://doi.org/10.1111/2041-210X.14129)
For citation details, see R command `citation("miaSim")`.
**Code of conduct** Please note that the project is released with a
[Bioconductor Code of
Conduct](https://bioconductor.github.io/bioc_coc_multilingual/). By
contributing to this project, you agree to abide by its terms.
[github-watch-badge]: https://img.shields.io/github/watchers/microbiome/miaSim.svg?style=social
[github-watch]: https://github.com/microbiome/miaSim/watchers
[github-star-badge]: https://img.shields.io/github/stars/microbiome/miaSim.svg?style=social
[github-star]: https://github.com/microbiome/miaSim/stargazers