Skip to content

Install

Jump to bottom
davis278 edited this page Aug 26, 2019 · 92 revisions

Wiki ▸ Documentation ▸ Install

CDAT is installed via Conda

We offer an installation for conda users under linux-64 or osx-64. Support for Windows is also available via the Windows Subsystem for Linux.

All Platforms System Requirements

  • Anaconda or Miniconda
  • If you didn't let Anaconda or Miniconda prepend the Anaconda<2 or 3> install location to PATH, make sure conda is in your PATH (for more information see the Anaconda Documentation). Assuming Ananconda is installed in ${HOME}/anaconda:
    • export PATH=${HOME}/anaconda/bin:${PATH} # for [ba]sh
    • setenv PATH ${HOME}/anaconda/bin:${PATH} # for [t]csh
  • Make sure you have nothing left over from an old CDAT installation in your PATH/PYTHONPATH,LD_LIBRARY_PATH etc...

Windows Specific Requirements

  • Windows is supported via the Windows Subsystem for Linux which comes with Windows 10.
  • You will need to set things up as instructed here and then follow the regular instructions for Linux.

Bypassing firewalls

  • If your institution has tight ssl certificate/security issues try:
    • conda config --set ssl_verify false
    • binstar config --set ssl_verify False

Installing from an environment file

The easiest way to install an official stable release of CDAT is to download the corresponding conda environment.

We provide env files for both Mac and Linux and for Python2 and Python3.

For each of these we also provide a mesalib-enabled version which is especially useful for users running batch jobs remotely on "headless" machines that do not have a graphics card or display attached. In the mesalib-enabled version plot will NOT require a X11 connection and images will be rendered in memory rather than onscreen. A user will not see any results until he or she saves the output to a .png file.

Python 2

Linux (and Windows)

Mac OSX

Python 3

Linux (and Windows)

Mac OSX

Once downloaded simply run:

conda env create -n cdat81 -f [YOUR_DOWNLOADED_FILE_HERE].yaml

conda activate cdat81

On older conda versions you might need:

source activate cdat81

Earlier Releases

Earlier Releases (UV-CDAT)

Installing from conda channels

Alternatively, you can use regular conda commands to generate the environment.

Creating the environment

conda create -n cdat81 -c cdat/label/v81 -c conda-forge python=3.6 cdat

conda activate cdat81

For Python 2 use:

conda create -n cdat81 -c cdat/label/v81 -c conda-forge python=2.7 cdat

conda activate cdat81

On older versions of anaconda you might need:

source activate cdat81

If you wish to obtain the mesalib-enabled version (headless display) simply add mesalib at the end of the install line:

conda create -n cdat81 -c cdat/label/v81 -c conda-forge python=3.6 cdat mesalib

For Python 2 use:

conda create -n cdat81 -c cdat/label/v81 -c conda-forge python=2.7 cdat mesalib

or simply install it after the fact.

conda install -c cdat/label/v81 -c conda-forge mesalib vtk-cdat

To Test Your CDAT Installation

To test that CDAT was installed correctly make sure your environment has been activated:

conda activate [your_env]

Next enter the following line of code:

python -c "import vcs, MV2; x=vcs.init();x.open();x.plot(MV2.array([[1,2,3],[4,5,6]])); input('Press Enter to continue...')"

If CDAT has been installed correctly, you should see the following graph:

For more installation details see:

For installation instructions for older releases see:

Clone this wiki locally