Install on Mac OS X

Wiki ▸ Install ▸ Install on Mac OS X

DEPRECATED

DEPRECATED

DEPRECATED

THIS PAGE IS FOR OLDER AND DEPRECATED VERSION DO NOT USE

PLEASE USE THIS LINK

DEPRECATED

DEPRECATED

DEPRECATED

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.

Note: Fink/MacPort Fink/MacPort, while useful, confuse our build system. You should remove ALL reference to /sw and /opt/local from your environment. The safest way to proceed is to actually move /sw or /opt/local before building UVCDAT (sudo mv /sw /sw_back or sudo mv /opt/local /opt/local_back). Once you've finished installing, you can safely move the directories back.

Requirements for All Installations

• OSX 10.9 or greater for Binary, OSX10.8.5 or greater for Source
• Xquartz (2.7.8)
• gfortran (4.6 < version < 5.0)
  • Mac gfortran
    • Change directory cd /
    • Run sudo tar xvf ~/Downloads/gfortran-4.9.2-Mac.tar.gz
• Qt (4.8.x)
  • Note that there is no official Qt 4.8.x for Mac 10.11,but fortunately we are providing a Qt 4.8.6 tarball compiled for 10.11

Requirements for Source Install

• CMake (We require version 2.8.12 or greater)
• XCode 6.4 or XCode 7.2.1
  • 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

Installing from Binary

1. Download the most recent release of UV-CDAT
2. Move the binary to /
sudo mv UV-CDAT-2.4.1-Mac.tar.gz /
3. Change directory to /
cd /
4. Extract the binary from the archive
   sudo tar xzf UV-CDAT-2.4.1-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 (e.g. /usr/local/uvcdat/2.4.1):
     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 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)