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
NCAR Graphics 6.1.2
Intel® C++ Compiler for Linux* 2013 SP1 Update 2
Intel® Fortran Compiler for Linux* 2013 SP1 Update 2
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.
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 ia32source <compiler_install_dir>/bin/compilervars.sh intel64
Source Code Changes
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.0cp config/LINUX.64.INTEL config/LINUX./Configuremake Infomake 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:$PATHexport MANPATH=$NCARG_ROOT/man:$MANPATH
The following commands will run an example program that uses NCAR Graphics:
ncargex cpex08ctrans -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.
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.