CODAS+UHDAS Documentation


Previous topic

Option #2 – Anaconda

Next topic

CODAS packages

This Page

Option #3 – Ubuntu

Installing Ubuntu and external packages

If you are using the Virtual Computer, you can skip this step.

These instructions were written for Xubuntu 14.04 (Trusty Tahr), and will probably work for versions of a similar age. Check this page for a description of packages and required versions.

Although you can install regular ubuntu desktop we are very unhappy with the desktop interface they are using. It is moving towards phones and tablets, and not as useful for running CODAS software.

We recommend Xubuntu, because it has a more suitable desktop environment, which is adequate (but not flashy)

Using the instructions below, CODAS Python processing has been thoroughly tested with 14.04. It may work with newer versions.

(1) Download and install an Ubuntu version.

Download and install Xubuntu

(2) Boot the new system, log in and connect to the network.

  • install the “Synaptic Package Manager”. Type
sudo apt-get install synaptic

Using sudo allows a regular user to run one command with administrative privileges (as “root”). You must type your own password to get a “sudo” command to run.

Synaptic is a graphical tool to manage software packages on the computer. The example below uses a command-line interface but if something does not work (eg. you want to add a package to improve your virtual machine) you can use Synaptic to try to identify the new name.

(3) Install various additional external packages

The Xubuntu 14.04 installation already has these

  • gcc (C-compiler)
  • python 2.7


We need to stick to Python 2.7 because the graphical editor for CODAS data was written in wx-python, and requires wx2.8 (which only runs under python 2.7). We hope this will change in the near future and allow us to migrate to python 3.4.

Install these additional packages by typing:

sudo apt-get install ipython
sudo apt-get install python-dev
sudo apt-get install mercurial
sudo apt-get install python-matplotlib
sudo apt-get install python-mpltoolkits.basemap
sudo apt-get install python-wxmpl

(4) Additional packages

The CODAS processing python code is in a transitional state, allowing it to run under either Python 2.7 or 3.4 but we need another package to support the compatibility later. This package is python-future. The version provided with Xubuntu 14.04 is not mature enough. You can get the tarball for a modern version at this web site. Any version 0.14.xx should work.

  • get the tarball
  • unpack and install (example for 0.14.3):
cd ~/Downloads
tar xvzf future-0.14.3.tar.gz
cd  future-0.14.3
python build
sudo python install

(5) NetCDF

If you want to generate NetCDF files, you’ll need to get pupynere. This will work with Python 2.7.

  • get the tarball
  • unpack and install:
cd ~/Downloads
tar xvzf pupynere-1.0.15.tar.gz
cd pupynere-1.0.15
python build
sudo python install

Now proceed to the CODAS-specific parts of the installation.