Check the getting started page for a video showing the installation process on Mac.


Prefer to go Legacy?

Last stable release: 2.5.1 (released 16 November, 2015)

Great! Your download should start automatically.

If not, use this link: https://www.stat.auckland.ac.nz/~wild/iNZight/downloads/iNZightVIT-installer.exe https://futurelearn.s3.amazonaws.com/iNZightVIT-installer.exe

To Install

We hope that the iNZightVIT installer is fairly self-explanatory, but just in case, here's a step-by-step guide to help.

  1. Run the iNZightVIT-installer.exe file by double-clicking. By default this will be in Downloads.
    NOTE: We don't have a Microsoft developers account for them to make iNZight a "trusted application", so you'll likely get a security warning (shown above). So long as the download comes from "https://stat.auckland.ac.nz/", you are fine.
  2. Follow the instructions in the installer. We recommend you leave the install location as the default (Documents\iNZightVIT), but you can change if you prefer. Admins, see bottom of page.
  3. That's it! iNZight has been installed on your computer. You'll find shortcuts on your Desktop, as well as a Start Menu folder.


Update

We recommend you keep iNZight up-to-date, as we are frequently fixing bugs and making things better.
To see whats changed, check out the version history.

To update, just go to Start > iNZightVIT > Update.


Installation Note for Admins

If you are an administrator installing iNZight for multiple users, simply Right-click the installer and run as admin, then install to wherever you'd like, e.g., C:\Program Files (x86). Each user will get their own iNZightVIT folder in their Documents folder.

To update, right-click "Update" in the iNZightVIT directory, wherever it was installed, to allow iNZight to update the packages.


OS X 10.8 and earlier

Unfortunately, we no longer support iNZight on OS X 10.8 and earlier.

If you are still running one of these versions of OS X, you'll need to install iNZight version 2.5:

iNZightVIT 2.5 Installer for OS X 10.6–10.8 (236 MB)

Awesome! iNZight is on its way to your Downloads folder.


Next step: Install iNZightVIT on Mac

To install iNZight, just follow these simple steps:

  1. Open iNZightVIT-mac-installer.dmg file in your Downloads folder.
  2. Follow the instructions in the window that opens.

Unknown Developer Warnings
If you are unable to open any of the files due to "Unknown Developer", simply Right-click the file and select Open.

Start iNZight

To run iNZight, just go to Applications > iNZightVIT, and double-click iNZight to begin.

Open with Spotlight

You can quickly open iNZight by using Mac's Spotlight search.

Just click the Search icon in the top-right of your screen, or press + SPACE on your keyboard, and then start typing iNZight.
Press return once Spotlight finds iNZight to launch it.

Create a Dock Shortcut

Use iNZight a lot? Create a lauch icon in the dock!

Go to Applications > iNZightVIT, and click and drag the iNZight icon to the dock.
It should slot into place so you can quickly launch iNZight.

Awesome! The download should be done by now.

If it didn't start automatically, use this link: https://www.stat.auckland.ac.nz/~wild/iNZight/downloads/iNZightVIT-selfinstall.tar.bz2

Once the download completes,

  1. If it hasn't done so automatically, extract the file by double-clicking iNZightVIT-selfinstall.tar.bz2
  2. Drag the iNZightVIT folder to Applications.
  3. Ensure you have the necessary dependencies, listed below.
  4. In Applications > iNZightVIT, start iNZight by double-clicking the icon. The necessary R packages will automatically be installed the first time you run iNZight.

iNZight not yet supported with R 3.4.0 on macOS El Captian or later

Due to significant changes in the latest release of R (3.4.0), the dependency RGtk2 is not yet available to users running macOS El Capitan or later (10.11+). If you have R 3.4, you can install an older version (3.2.4 or earlier), and then download the RSwitch App to change versions of R before running iNZight.

Of course, if you have installed the necessary command line tools to compile R packages with R 3.4.0, you should be OK installing iNZight and it's dependencies.


Dependencies

Get help on Gitter

To run iNZight, you'll need the following dependencies. If you've had iNZight running on your machine before, you'll already have GTK and XQuartz.

Installing iNZight on Linux

Get help on Gitter

iNZight runs on most common Linux systems, including all Debian-based distributions (Ubuntu, Linux Mint) and any others on which you can install R. The installer shown below only works on Ubuntu and perhaps some other debian-based systems; if you have another distribution, you'll need to install R yourself and install iNZight as an R package.


Dependencies

You'll first need to make sure you have the necessary dependencies. Exactly what these are depends on your specific version of linux.

  • GTK2+ — use your package manager (Google should be able to help)

    Ubuntu 14.04 or later, Linux Mint: apt-get install libgtk2.0-dev

  • XOrg Windowing System — package manager (and/or Google) again (Note: this may be installed already)

    Ubuntu 14.04 or later, Linux Mint: apt-get install xorg-dev

  • R (>= 3.2) — the bash installer assumes R is installed and can be run using R
  • Some other libraries that may be required (dependending on your system):
    libxml2-dev, r-cran-rodbc, r-cran-rgtk2

Install

You can choose between cloning a repository and building iNZight automatically (Ubuntu, Debian only), install iNZight manually as an R package, or install under WINE.

The iNZightVIT Installer for Linux will create a directory on your machine and install the required packages there, as well as provide executables that will allow you to start iNZight or VIT easily.

  1. Clone the repository
    • If you have git installed, just run

      git clone https://github.com/iNZightVIT/linux.git iNZightVIT

      This will create an iNZightVIT directory.
    • If you don't have git, you'll need to download the zipped archive. For example, using curl

      curl -fsSL https://github.com/iNZightVIT/linux/archive/master.zip -o iNZightVIT.zip

      Then unzip it (setting the name to iNZightVIT) and delete the ZIP file:

      unzip iNZightVIT.zip && rm iNZightVIT.zip && mv linux-master iNZightVIT

  2. Enter the iNZightVIT directory and run make

    cd iNZightVIT
    make

    Now, to run iNZight or VIT, simply navigate to the directory and start it:

    cd iNZightVIT
    ./inzight  # to start iNZight
    ./vit      # to start VIT
    ./update   # to update iNZightVIT

  3. (Optional) Install iNZight to /usr/local/bin

    sudo make install
    
    # to undo this, run
    sudo make uninstall

    This allows you to run iNZight from anywhere on your computer, simply by running inzight or vit from the command line, without having to navigate to the iNZightVIT folder.
  4. To uninstall iNZightVIT just delete the iNZightVIT folder (if you ran make install, be sure to make uninstall first).

Disclaimer: Still in testing

The install script has been tested on Ubuntu 16.04. I don't think there's anything harmful in it, but feel free to check the source first.

If you have any issues, do let me know at inzight_support@stat.auckland.ac.nz. If you are clever and can make the script better, feel free to submit a pull request.

Getting error messages?

Missing certificates: curl: (77) error setting certificate verify locations
You need to install ca-certificates (using apt-get install on debian-based OS).
On some distros (such as Elementary OS) you may need to tell curl where to find them. Run this in a terminal:

export CURL_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt

If you use R yourself, you may prefer to install iNZight yourself.

install.packages(c('iNZight', 'vit'), dependencies = TRUE,
                 repos = c('http://r.docker.stat.auckland.ac.nz/R', 'https://cran.rstudio.com'),
                 Ncpus = 1) # if you have cores to spare, increase this to speed up install time

The dependencies = TRUE argument is recommended, as it will ensure you get the full set of iNZight packages (Depends, Imports, and Suggests), some of which include colour palettes and add-on modules.

You may also switch https://cran.rstudio.com with your preferred CRAN mirror.

To run iNZight:

library(iNZight)
iNZight()

To run VIT:

library(vit)
iNZightVIT()

You can install and run iNZight for Windows via WINE, without needed any additional dependencies (except for WINE, of course). If you don't have WINE installed already, follow the instructions on their website.

Once you have WINE installed, download the iNZightVIT Windows Installer and run it with WINE, and follow the Windows installation instructions.