R package for users of data from https://motus.org
See the Motus R book for detailed usage information
If you are updating your version of
motus from a version <1.5.0 to >= 1.5.0 (i.e. from when
motusClient was a separate package), you will have best results if you first remove
motusClient and reinstall from scratch:
Now you can install v1.5.0+ as follows.
Users: the 'master' branch is what you want. You can install it from R by doing:
install.packages("remotes") ## if you haven't already done this remotes::install_github("motusWTS/motus@master") ## the lastest stable version
Developers: the 'staging' branch is for work-in-progress. Install it with
install.packages("remotes") ## if you haven't already done this remotes::install_github("motusWTS/motus@staging") ## the development version
If you run into any installation errors, please ensure that your R packages are up-to-date:
Some known installation problems are listed below. If all else fails, uninstalling R and/or R Studio, and reinstalling the latest R version typically works. Depending on how much customization you have made to your R configuration, this may be the quickest option available.
cannot remove prior installation of package
If you get errors "cannot remove prior installation of package ..." (e.g. dplyr) while trying to install motus, this could be due to having multiple R sessions active. You can try the following:
- find out your R package library location:
- close any session of R and/or R Studio
- in the library folder, manually delete the package that failed to remove (e.g. dplyr)
- restart R and manually install the package again e.g.
Another possible cause of this problem relates to file permissions in your library folders (e.g. libraries installed in c:\program files\R\R-3.x.x\library). To confirm this, you can try running R "as administrator" (right-clicking the R icon), or use
SUDO R (Linux/Ubuntu) and trying installation again. If this resolves your problem, you should consider setting your libraries in a new folder where your logged in user has full access:
# confirm the libPaths location(s) .libPaths() # add a new libPaths default location .libPaths("c:/users/myusername/R/win-libraries")
If you get a certificate error using the tagme() function, please ensure that your httr package is up-to-date, as there was a problem reported with one of the recent version that now appears fixed: