Install on Mac OS X

Wiki ▸ Install ▸ Install on Mac OS 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, especially 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)
• gfortran (4.6 < version < 5.0)
  • Mac gfortran

Requirements for Source Install

• CMake (We require version 2.8.12 or greater)
• XCode 6.4 or XCode 7.2
  • The above link does not work if you are not logged in as an Apple developer, Apple developer ID required
• XCode Command Line Tools for Xcode 6.4 or XCode 7.2 on 10.10 or XCode 7.2 on 10.11
  • The above link does not work if you are not logged in as an Apple developer, Apple developer ID required
  • Do not use xcode-select --install
• XQuartz

Installing from Binary

1. Download the most recent release of UV-CDAT
2. Move the binary to /
sudo mv UV-CDAT-2.4.0-Mac.tar.gz /
3. Change directory to /
cd /
4. Extract the binary from the archive
   sudo tar xzf UV-CDAT-2.4.0-Mac.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