Desktop Install

Install Prerequisites

Ubuntu

$> sudo apt install python3 python3-pip openjdk-8-jre
$> pip3 install setuptools wheel

macOS

For best results install Java JDK-8. If you have a later JDK installed, you'll get an IllegalAccessException warning on startup, and Apache Arrow support will not work.

With Homebrew

$> brew install python 
$> pip3 install setuptools wheel

With MacPorts

$> sudo port install py34-pip
$> pip3 install setuptools wheel

Windows 10

Enable Windows Subsystem for Linux

Install bash

$> sudo apt install python3 openjdk-8-jre-headless
$> ln -s /usr/bin/python3 /usr/local/bin/python
$> curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
$> python get-pip.py

---

Install Vizier

Using coursier

$> coursier install vizier --channel https://vizierdb.info/coursier.json

You may need to add your user bin directory (typically ~/.local/bin) to your PATH environment variable

Or using Bootstrap

$> wget https://maven.mimirdb.info/info/vizierdb/vizier
$> chmod +x vizier
$> mv vizier [your favourite bin directory]

Run

$> vizier

---

FAQ

How do I uninstall Vizier?

$> coursier uninstall vizier
$> rm -r ~/.cache/coursier

Why don't you fully support Java 11?

Spark, which we use for most data processing, has only limited support for Java JRE 9 or later. Vizier is generally usable on Java9+, with a few exceptions (Tested on Java 11):

• Apache Arrow support in Python (i.e., Pandas/Vizier integration via vizierdb.get_dataframe) does not work in Java 9+
• Running on a v9+ JVM, Vizier dumps out an IllegalArgumentException. This is just a warning, you can continue to use Vizier normally.

If necessary, you can download Java JRE 8 from here. Note that Java does allow you to have multiple JREs installed at the same time by setting the JAVA_HOME environment variable.

Why don't you support Python 3?

We're working on it.

I get a bunch of goop saying "java.lang.IllegalArgumentException"

Spark has limited support for Java JRE 9 or later. This message is only a warning and can usually be ignored, however see above as to why we do not support Java 11.