CODAS+UHDAS Documentation

Navigation

Previous topic

Overview

Next topic

Option #1 – Virtual Computer

This Page

Installation StrategyΒΆ

We are documenting three ways to get a computer set up with CODAS processing software. There are others, for instance Homebrew (on OSX), but choosing one of these three methods will save a great deal of time.

(Option #1) Virtual Computer:

Install virtualization software such as Virtual Box (free virtualization software, runs on OSX, Windows, and Linux), download and “import” the file containing a pre-built CODAS processing computer with everything already installed and set up:

  • advantages:

    • many fewer steps than other options
    • CODAS software is already installed and tested
    • includes topography
    • you can delete it when you don’t want it anymore
    • the virtual machine is Linux
    • actual data are kept on the user’s computer (not inside the virtual computer) so they can be accessed and backed up with familiar tools
  • disadvantages:

    • requires a modern machine (at least 4Gb memory, 20Gb free disk space)
    • the virtual machine is Linux

This is the best way to start out, and probably the best way to go if you have a Windows computer.


(Option #2) Anaconda on your own computer:

Install components on a computer that is already running a compatible operating system (Linux, OSX, Windows) using Anaconda.

Although there are several ways to install the collection of software required for CODAS ADCP processing, we have chosen to document the use of Anaconda, as a good one-stop-shopping mechanism for installing the third party components required. For the time being, this seems like a good approach.

Anyone with OSX, Windows, or a non-ubuntu operating system might consider this. Our documentation for the Virtual Computer (above) should work for any of these operating systems, but the Anaconda documentation is geared towards OSX users. It will be adapted for Windows, once we have time.

  • advantages:

    • you already have a computer and are familiar with the operating system
  • disadvantages:

    • takes a little more time to install than the Virtual Computer
  • To install the CODAS suite on your computer, work your way through these steps to install Anaconda so it will support CODAS processing.
  • Then install and configure CODAS, and your computer will be ready for processing.

(Option #3) Ubuntu:

Install a recommended version of Ubuntu (Linux) and put the components on that new machine (presently Xubuntu 14.04)

  • advantages:

    • concise and tested installation instructions, at least for one version
  • disadvantages:

    • must start by installing the operating system
    • Linux may be unfamiliar

Scenarios

  1. these instructions work for your computer
  2. you want to install it on a new computer
  3. you want to install it on a virtual machine