AMR/README.md

89 lines
5.7 KiB
Markdown
Raw Normal View History

2019-01-02 23:24:07 +01:00
# `AMR` (for R) <img src="man/figures/logo.png" align="right" height="120px" />
2018-02-21 11:52:31 +01:00
2019-01-02 23:24:07 +01:00
*NOTE: the original source code is on GitLab (https://gitlab.com/msberends/AMR), so you can report a bug at https://gitlab.com/msberends/AMR/issues. There is a mirror repository on GitHub (https://github.com/msberends/AMR). As the mirror process is automated by GitLab, both repositories always contain the latest changes.*
2018-02-21 12:10:00 +01:00
2019-01-02 23:24:07 +01:00
## Development source
2019-01-05 21:40:04 +01:00
This is the **development source** of `AMR`, a free and open-source [R package](https://www.r-project.org) to simplify the analysis and prediction of Antimicrobial Resistance (AMR) and to work with microbial and antimicrobial properties by using evidence-based methods.
2019-01-02 23:24:07 +01:00
**Not a developer? Then our website https://msberends.gitlab.io/AMR is probably a better place to read about this package.** It contains documentation about all of the included functions and also a comprehensive tutorial about how to conduct AMR analysis.
2018-06-27 10:44:24 +02:00
## Authors
Matthijs S. Berends <a href="https://orcid.org/0000-0001-7620-1800"><img src="https://cran.r-project.org/web/orcid.svg" height="16px"></a> <sup>1,2,a</sup>,
Christian F. Luz <a href="https://orcid.org/0000-0001-5809-5995"><img src="https://cran.r-project.org/web/orcid.svg" height="16px"></a> <sup>1,a</sup>,
2018-08-03 09:59:39 +02:00
Erwin E.A. Hassing<sup>2</sup>,
Corinna Glasner <a href="https://orcid.org/0000-0003-1241-1328"><img src="https://cran.r-project.org/web/orcid.svg" height="16px"></a> <sup>1,b</sup>,
Alex W. Friedrich <a href="https://orcid.org/0000-0003-4881-038X"><img src="https://cran.r-project.org/web/orcid.svg" height="16px"></a> <sup>1,b</sup>,
2018-12-23 21:26:21 +01:00
Bhanu N.M. Sinha <a href="https://orcid.org/0000-0003-1634-0010"><img src="https://cran.r-project.org/web/orcid.svg" height="16px"></a> <sup>1,b</sup>
2018-06-27 10:44:24 +02:00
2018-08-10 15:01:05 +02:00
<sup>1</sup> Department of Medical Microbiology, University of Groningen, University Medical Center Groningen, Groningen, the Netherlands - [rug.nl](http://www.rug.nl) [umcg.nl](http://www.umcg.nl)<br>
<sup>2</sup> Certe Medical Diagnostics & Advice, Groningen, the Netherlands - [certe.nl](http://www.certe.nl)<br>
2018-08-13 23:05:53 +02:00
<sup>a</sup> R package author and thesis dissertant<br>
2018-08-03 09:59:39 +02:00
<sup>b</sup> Thesis advisor
2018-06-27 10:44:24 +02:00
<a href="https://www.rug.nl"><img src="man/figures/logo_rug.png" height="60px"></a>
<a href="https://www.umcg.nl"><img src="man/figures/logo_umcg.png" height="60px"></a>
<a href="https://www.certe.nl"><img src="man/figures/logo_certe.png" height="60px"></a>
<a href="http://www.eurhealth-1health.eu"><img src="man/figures/logo_eh1h.png" height="60px"></a>
<a href="http://www.eurhealth-1health.eu"><img src="man/figures/logo_interreg.png" height="60px"></a>
2018-02-21 12:10:00 +01:00
2019-01-02 23:24:07 +01:00
## How to get this package
All stable versions of this package [are published on CRAN](https://CRAN.R-project.org/package=AMR), the official R network with a peer-reviewed submission process.
2018-02-22 20:48:48 +01:00
### Install from CRAN
2019-01-02 23:24:07 +01:00
[![CRAN_Badge](https://www.r-pkg.org/badges/version/AMR)](https://CRAN.R-project.org/package=AMR) [![CRAN_Downloads](https://cranlogs.r-pkg.org/badges/grand-total/AMR)](https://CRAN.R-project.org/package=AMR)
2018-07-09 14:02:58 +02:00
2018-08-01 08:03:31 +02:00
(Note: Downloads measured only by [cran.rstudio.com](https://cran.rstudio.com/package=AMR), this excludes e.g. the official [cran.r-project.org](https://cran.r-project.org/package=AMR))
2018-07-08 22:14:55 +02:00
2018-07-29 22:14:51 +02:00
- <img src="http://www.rstudio.com/favicon.ico" alt="RStudio favicon" height="20px"> Install using [RStudio](http://www.rstudio.com) (recommended):
- Click on `Tools` and then `Install Packages...`
- Type in `AMR` and press <kbd>Install</kbd>
2018-03-22 13:45:04 +01:00
2018-07-29 22:14:51 +02:00
- <img src="https://cran.r-project.org/favicon.ico" alt="R favicon" height="20px"> Install in R directly:
2018-03-22 13:45:04 +01:00
- `install.packages("AMR")`
### Install from Zenodo
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1305355.svg)](https://doi.org/10.5281/zenodo.1305355)
This package was also published on Zenodo (stable releases only): https://doi.org/10.5281/zenodo.1305355
2018-10-23 16:49:40 +02:00
### Install from GitLab
2018-02-22 20:48:48 +01:00
2018-09-01 21:19:46 +02:00
This is the latest **development version**. Although it may contain bugfixes and even new functions compared to the latest released version on CRAN, it is also subject to change and may be unstable or behave unexpectedly. Always consider this a beta version. All below 'badges' should be green:
2018-09-01 21:19:46 +02:00
Development Test | Result | Reference
--- | :---: | ---
2018-10-31 13:42:35 +01:00
All functions checked on Linux | [![pipeline status](https://gitlab.com/msberends/AMR/badges/master/pipeline.svg)](https://gitlab.com/msberends/AMR/commits/master) | GitLab CI [[ref 1]](https://gitlab.com/msberends/AMR/pipelines)
2018-10-23 16:49:40 +02:00
All functions checked on Windows | [![AppVeyor_Build](https://ci.appveyor.com/api/projects/status/gitlab/msberends/AMR?branch=master&svg=true)](https://ci.appveyor.com/project/msberends/amr-svxon) | Appveyor Systems Inc. [[ref 2]](https://ci.appveyor.com/project/msberends/amr-svxon)
Percentage of syntax lines checked | [![Code_Coverage](https://codecov.io/gl/msberends/AMR/branch/master/graph/badge.svg)](https://codecov.io/gl/msberends/AMR) | Codecov LLC [[ref 3]](https://codecov.io/gl/msberends/AMR)
If so, try it with:
2018-08-22 00:02:26 +02:00
```r
install.packages("devtools")
2018-11-02 10:27:57 +01:00
devtools::install_gitlab("msberends/AMR")
2018-08-15 11:12:38 +02:00
```
2018-02-22 20:48:48 +01:00
2018-02-21 11:52:31 +01:00
## Copyright
2018-03-13 14:34:10 +01:00
2018-10-23 16:49:40 +02:00
This R package is licensed under the [GNU General Public License (GPL) v2.0](https://gitlab.com/msberends/AMR/blob/master/LICENSE). In a nutshell, this means that this package:
2018-02-21 11:52:31 +01:00
- May be used for commercial purposes
- May be used for private purposes
2018-04-20 13:45:34 +02:00
- May **not** be used for patent purposes
2018-02-21 11:52:31 +01:00
- May be modified, although:
- Modifications **must** be released under the same license when distributing the package
- Changes made to the code **must** be documented
- May be distributed, although:
- Source code **must** be made available when the package is distributed
- A copy of the license and copyright notice **must** be included with the package.
- Comes with a LIMITATION of liability
- Comes with NO warranty