Installation

Xianghui Dong

2020-05-10

Installation

Windows Installer

• You can run our windows installer which will guide through these steps in a wizard style:
  • Install R. This could be skipped if you already have R installed. Note it’s possible to have multiple versions of R installed, however that may require more knowledge and tweaks. For example if you had a R 3.6 version Rscript.exe in windows PATH but just installed R 4.0 without uninstall R 3.6, the installer will fail because a R 3.6 Rscript will be used to install the packages. We suggest to always install and keep the latest R version to avoid possible problems.
  • Install ctmmweb package from github.
  • Start ctmmweb app.
  • Shortcuts for the app and a self update script can be created in program menu too.

Install with R

1. Install R

   Download R installer(win, mac, Linux) and install R.

   RStudio is recommended but not a must.

2. Start R

   Start R console from start menu (or RStudio if installed). All code below will run inside it.

3. Install app

   if (!require("remotes")) install.packages("remotes")
   remotes::install_github("ctmm-initiative/ctmmweb")

4. Run app

   ctmmweb::app()

FAQ

• If you met errors in install/upgrade lots of packages, restart R session and install again often can solve the problem.
• The app is started with default browser. Chrome is recommended as some other browsers have known limitations.

Linux

• Following instructions here for installing R (assuming Ubuntu or Linux Mint). Make sure to install r-base-dev too.
• RStudio have installer for Linux.
• Some of the packages needed for the app need extra steps to install properly:

  • We recommend to use remotes instead of devtools as remotes has much less dependencies and often have less package installation problems(because devtools itself need many more packages which cannot be upgraded easily in one session).

  • If you are using devtools, it need libcurl, ssl in linux if it’s not already installed in your system. You can watch error messages to check what is required. I installed them in Linux Mint 18 with

    sudo apt-get install libcurl4-openssl-dev
    sudo apt-get install libssl-dev

  • ctmm need rgdal, which need another two libraries in linux:

    sudo apt-get update && sudo apt-get install libgdal-dev libproj-dev