Install on Ubuntu

There are two ways to install UV-CDAT on your system; method 1 is to download a binary release of the application (available here), and method 2 is to do a full build from source. We strongly recommend the binary installation; it's a lot faster and easier to do if you're not comfortable with the command line. It also requires a lot fewer pieces of software to be installed; almost everything gets bundled with the binary installation. This guide will walk you through installation on your system using both methods (binary and source).

System Requirements

First, let's start with the bare minimum you need to actually be able to install UV-CDAT.

Requirements for All Installations

• Qt (4.8.x)

  • sudo apt-get install libqt4-dev

• gfortran (4.6 <= version < 5.0)

  • sudo apt-get install gfortran

Requirements for Source Install

If you want to just install everything in one go, the apt-get command is here:

sudo apt-get install -y libqt4-dev gfortran cmake g++ git m4 zlib1g-dev libpng-dev libjpeg-dev libxt-dev libssl-dev libexpat-dev libsqlite3-dev automake libcurl4-openssl-dev

• CMake (2.8.12 or greater)
  • sudo apt-get install cmake
• g++
  • sudo apt-get install g++
• git
  • sudo apt-get install git
• m4
  • sudo apt-get install m4
• zlib
  • sudo apt-get install zlib1g-dev
• libpng
  • sudo apt-get install libpng-dev
• libjpeg
  • sudo apt-get install libjpeg-dev
• libxt
  • sudo apt-get install libxt-dev
• libssl
  • sudo apt-get install libssl-dev
• libexpat
  • sudo apt-get install libexpat-dev
• sqlite
  • sudo apt-get install libsqlite3-dev
• automake
  • sudo apt-get install automake
• libcurl
  • sudo apt-get install libcurl4-openssl-dev

Installing from Binary

1. Download the most recent release of UV-CDAT
2. Move the binary to /
sudo mv UV-CDAT-2.4.1-Ubuntu-15.04-64bit.tar.gz /
3. Change directory to /
cd /
4. Extract the binary from the archive
   sudo tar xzf UV-CDAT-2.4.1-Ubuntu-15.04-64bit.tar.gz
5. That's it! You're all done installing. Skip on down to Run UV-CDAT.

Installing from Source

1. Go to the directory you want to download UV-CDAT's source code to
   cd ~
2. Clone UV-CDAT
   git clone git://github.com/UV-CDAT/uvcdat
3. Create a build directory
   mkdir build-uvcdat
4. Change directory to the build directory
   cd build-uvcdat
5. Initialize the build scripts using CMake
   cmake ../uvcdat
   • To install to a specific location, you can use cmake ../uvcdat -DCMAKE_INSTALL_PREFIX="/path/to/install/uvcdat"
   • Other build options are documented here
6. Run make
make -j4
7. Once it finishes building, you're all done! UV-CDAT will be installed either in the build-uvcdat/install folder or at whatever path you provided in the -DCMAKE_INSTALL_PREFIX argument to cmake.

Run UVCDAT

1. Set up the UV-CDAT environment for your current shell session
   source /usr/local/uvcdat/2.4.1/bin/setup_runtime.sh (or setup_runtime.csh, for [t]cshell users)
2. Start UV-CDAT
   uvcdat

Restore your environment to its pre-uvcdat state

source /usr/local/uvcdat/2.4.1/bin/reset_runtime.sh (or reset_runtime.csh, for cshell users)