2. CODAS Installation

CODAS processing works on UHDAS data and VmDAS data. UHDAS and VmDAS are acquisition programs. This installation guide will not set up your computer to acquire ADCP data, but it should set up your computer for ADCP processing using CODAS tools.

CODAS software is designed to run on most common platforms. Executables are written in C, and scripts run in Python. Please see this table to see whether your data can be processed with Python.

We are no longer maintaining CODAS Matlab processing, but we will continue to support the programs used to read CODAS Matlab output files, raw ADCP datafiles, rbins.

Note

We have moved to Python3. CODAS software no longer makes any attempt to be compatible with Python2. The old Python2 documentation still exists here

Although the CODAS processing code can be updated using Mercurial, there are enough other changes to the installation procedure that it is sometimes better to just throw away the old version and start over – it all depends on how old your installation is. The most recent example of that is the change from distutils to setuptools for “installation” of the the main two Python libraries (Jan 2020).

If you have a question about this, please email us and we’ll help you figure out the best way forward. Contact uhdas@hawaii.edu for help.

Note that the easiest installation mechanisms below to “uninstall” are the Virtual Computer and Anaconda.

---

Contents:

• 2.1. Overview
• 2.2. Installation Strategy
• 2.3. Option #1 – Virtual Computer
  • 2.3.1. VBox Introduction
  • 2.3.2. VBox part 1a: Importing the Virtual Computer
  • 2.3.3. VBox part 1b: Warnings and Errors when Starting Up
  • 2.3.4. VBox part 2: CODAS Virtual Computer Navigation
  • 2.3.5. VBox Part 3: Configuring the Virtual Computer
• 2.4. Option #2 – Anaconda
  • 2.4.1. Installing Anaconda and external packages
• 2.5. Option #3 – Ubuntu
  • 2.5.1. Installing Ubuntu and external packages
• 2.6. CODAS packages
  • 2.6.1. Getting CODAS Mercurial Components
  • 2.6.2. Compiling and installing in the Anaconda environment
  • 2.6.3. Compiling and Installing in a Linux environment
  • 2.6.4. Getting CODAS non-Mercurial Components
  • 2.6.5. Installing Topography
• 2.7. Test the CODAS Python Installation
• 2.8. Appendix
  • 2.8.1. Description of External Packages
  • 2.8.2. A note about PATHs
  • 2.8.3. updating Topography for CODAS

---

Let us know (uhdas@hawaii.edu) if you are installing CODAS programs and want to be informed if there are updates or bug fixes.