3 Installation

3.1 Install R

Note: R is a statistical environment / programming language used by Hourglass. R must be installed for the application to work, but working knowledge of R programming is not necessary.

For step-by-step installation instructions:

  • Install R & rtools for Windows link.
  • Install R for Mac link.

For shorter installation instructions:

  • Install R
    • Follow download link on website for your operating system.
    • For Windows, install both R from base folder and Rtools from Rtools folder.
  • Install RStudio (optional)
    • RStudio is an integrated development environment (IDE) for R that provides an alternative interface to R.
    • Download community/open-source version for free on website link.

3.2 Install Desktop Application

This step is for users who prefer to use Hourglass as a standalone application for a graphical user interface.

Windows
i. Click here.
ii. Download the exe file.
iii. Open in your local Downloads folder and run the file installer by double clicking on it.
iv. Select Desktop shortcut option to have it appear on the desktop.

MacOS
i. Click here.
ii. Download the dmg file.
iii. Drag contents of dmg file to Applications folder.

When you run Hourglass for the first time in the desktop application, it will install the R package.

3.3 Install R package (optional)

If you are familiar with R programming, Hourglass can be used as an R package independently. Note: It will be installed when running Hourglass application the first time.

  1. Open up R console.
  2. Copy and paste these commands to install the package in R.
install.packages("devtools")
devtools::install_github("kazeera/Hourglass")

See How to Use the R Package for more information. Click here for source code on Github.

3.4 Uninstall

Follow instruction if you would like to uninstall Hourglass:

Uninstall application on Windows:
Option 1. Go to Add or Remove programs. Search for Hourglass. Press uninstall.
Option 2. Open folder where Hourglass was installed (usually in Program Files). Double-click on file called “unins000.exe” to uninstall.

Uninstall application on MacOS:
Delete Hourglass application by clicking on icon and “Move to Trash”.

Uninstall R package:
Open R console and enter the following command:

remove.packages("Hourglass")

3.5 Troubleshooting

  • Error: package or namespace load failed for ‘stats’ in inDL(x, as.logical(local), as.logical(now), …): LoadLibrary failure: The specified module could not be found.
  • Solution: Go to where R is located and delete the .Renviron file.