Installation Instructions Template

Install on X

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)

  • You can obtain an installer for Qt here. (OSX instructions and RedHat/CentOS instructions)
  • sudo apt-get install qt4 (ubuntu instructions)

• gfortran (4.6 or greater)

  • You can obtain an installer for gfortran here.
  • sudo apt-get install gfortran
  • sudo yum install gfortran

Requirements for Source Install

• CMake (2.8.12 or greater)
  • You can obtain an installer for CMake here.
• List
• Of
• Packages

To install all of the listed packages, you can use this command:

sudo apt-get install blah blah blah

Installing from Binary

1. Download the most recent release of UV-CDAT
2. Move the binary to /
sudo mv UV-CDAT-2.2.0-PLATFORM-VERSION-64bit.tar.gz /
3. Change directory to /
cd /
4. Extract the binary from the archive
   sudo tar xzf UV-CDAT-2.2.0-PLATFORM-VERSION-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.2.0/bin/setup_runtime.sh (or setup_runtime.csh, for cshell users)
2. Start UV-CDAT
   uvcdat