softw_inst.Rmd

# Installing the EMU-SDMS

1. R
    - Download the R programming language from  [https://cran.r-project.org/](https://cran.r-project.org/)
    - Install the R programming language by executing the downloaded file and following the on-screen instructions.

2. `emuR`
    - Start up R.
    - Enter `install.packages("emuR")` after the `>` prompt to install the package. (You will only need to repeat this if package updates become available.)
    - As the `wrassp` package is a dependency of the `emuR` package, it does not have to be installed separately.

3. `EMU-webApp` (prerequisite)
    - The only thing needed to use the `EMU-webApp` is a current HTML5 compatible browser (Chrome/Firefox/Safari/Opera/...). However, as most of the development and testing is done using Chrome we recommend using it, as it is by far the best tested browser.

## Version disclaimer

This document describes the following versions of the software components:

- `wrassp`
    - Package version: `r packageVersion("wrassp")`
    - Git tag name: `r jsonlite::fromJSON("https://api.github.com/repos/IPS-LMU/wrassp/releases")[1,]$tag_name` (on master branch)

- `emuR`
    - Package version: `r packageVersion("emuR")`
    - Git tag name: `r jsonlite::fromJSON("https://api.github.com/repos/IPS-LMU/emuR/releases")[1,]$tag_name` (on master branch)

- `EMU-webApp`
    - Version: `r jsonlite::fromJSON("https://raw.githubusercontent.com/IPS-LMU/EMU-webApp/master/package.json")$version`
    - Git SHA1: `r jsonlite::fromJSON("https://api.github.com/repos/IPS-LMU/EMU-webapp/branches/master")$commit$sha`

As the development of the EMU Speech Database Management System is still ongoing, be sure you have the correct documentation to go with the version you are using.

## For developers and people interested in the source code

The information on how to install and/or access the source code of the developer version including the possibility of accessing the versions described in this document (via the Git tag names mentioned above) is given below.

- `wrassp`
    - Source code is available here: [https://github.com/IPS-LMU/wrassp/](https://github.com/IPS-LMU/wrassp/)
    - Install developer version in R: `install.packages("devtools");` `library("devtools");` `install_github("IPS-LMU/wrassp")`
    - Bug reports: [https://github.com/IPS-LMU/wrassp/issues](https://github.com/IPS-LMU/wrassp/issues)

- `emuR`
    - Source code is available here: [https://github.com/IPS-LMU/emuR/](https://github.com/IPS-LMU/emuR/)
    - Install developer version in R: `install.packages("devtools");` `library("devtools");` `install_github("IPS-LMU/emuR")`
    - Bug reports: [https://github.com/IPS-LMU/emuR/issues](https://github.com/IPS-LMU/emuR/issues)

- `EMU-webApp`
    - Source code is available here: [https://github.com/IPS-LMU/EMU-webApp/](https://github.com/IPS-LMU/EMU-webApp/)
    - Bug reports: [https://github.com/IPS-LMU/EMU-webApp/issues](https://github.com/IPS-LMU/EMU-webApp/issues)

<!-- The data carrier that accompanies this documentation contains a cloned version of all three Git repositories of the software components described here. -->