Introduction

This guide is intended to help Intel® C++ Compiler and Intel® Fortran Compiler customers build the NCAR Graphics* library. NCAR Graphics is an open source library for drawing maps, graphs, and plots. More information about NCAR Graphics can be found at http://ngwww.ucar.edu

Version information

NCAR Graphics 6.1.0
Intel® C++ Compiler for Linux* Update 1
Intel® Fortran Compiler for Linux* Update 1

Obtaining the Source Code

The source code for NCAR Graphics can be found at: http://www.ncl.ucar.edu/Download/.

Obtaining the Latest Version of the Intel® compilers

Licensed users of the Intel® compilers may download the most recent versions of the compiler from the Intel® Software Development Products Registration Center. Evaluation versions of the Intel® compilers may be found at the Intel® Software Evaluation Center.

Prerequisites

Additional software packages may be required when building NCAR Graphics. Please check the NCAR Graphics website for more information.

Configuration and Setup Information

In order to use this guide, you will need to have the Intel® C++ Compiler for Linux and the Intel® Fortran Compiler for Linux installed on your build system. After installing the compilers, you will need to execute one of the following commands below, depending on your architecture, to set the environment variables.

source <compiler_install_dir>/bin/compilervars.sh ia32

source <compiler_install_dir>/bin/compilervars.sh intel64

Source Code Changes

None required.

Building NCAR Graphics*

To build NCAR Graphics, first choose a directory where it will be installed. If that directory does not exist, you will need to create it. Then execute the following commands from the directory where decompressed the source code. Replace <install_dir> with the directory where you would like to install NCAR Graphics. The configuration script is interactive. It will ask questions about where and how to install NCAR Graphics. After the configuration script is finished, verify that the configuration options are correct and then build the software.

mkdir <install_dir>

cd ncarg-6.1.0

cp config/LINUX.64.INTEL config/LINUX$

./Configure

make Info

make Everything

When the build has completed successfully, you should see a message that says:

Finished making and Installing <Everything>.

Note:If you would like to include HDF support, the following document about building HDF5 with the Intel compilers may be useful, Building HDF5* with Intel® compilers.

Running NCAR graphics

Before using NCAR Graphics, you will need to set the NCAR_ROOT environment variable to the installation directory (use the full absolute path) and add the executable files directory to the PATH variable.

export NCARG_ROOT=<install_dir>

export PATH=$NCARG_ROOT/bin:$PATH

export MANPATH=$NCARG_ROOT/man:$MANPATH

The following commands will run an example program that uses NCAR Graphics:

ncargex cpex08 

ctrans -d X11 cpex08.ncgm

The first of the two commands above compiles and executes the example, which writes its results to a graphics metafile. The second command reads that metafile and displays it in an X11 window. You should see a blank window. If you click in the window, you will see the first frame, which is a contour plot overlaid on a world map. Clicking again will display the second (last) frame, which looks similar to the first one. Clicking a third time will close the window.

Verifying Correctness

NCAR Graphics has no built-in test for correctness, but you may verify that it is working correctly by running one of the example programs described in the section above.

Known Issues and Limitations

At this time, there are no known issues with using the Intel compilers to build NCAR Graphics. Please see the NCAR Graphics website for all known issues and limitations.