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
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.
cd ~/Downloads tar xvzf future-0.14.3.tar.gz cd future-0.14.3 python setup.py build sudo python setup.py install
If you want to generate NetCDF files, you’ll need to get pupynere. This will work with Python 2.7.
cd ~/Downloads tar xvzf pupynere-1.0.15.tar.gz cd pupynere-1.0.15 python setup.py build sudo python setup.py install
Now proceed to the CODAS-specific parts of the installation.