NAG C Library, Mark 26

CLL6I26DV

Linux, 64-bit, Intel C/C++ (64-bit integers, custom MKL), Double Precision

Installer's Note



Contents


1. Introduction

This document provides implementation-specific information relating to the installation of the NAG C Library specified in the title.

Your attention is drawn to the terms and conditions of the Software License Agreement (in file lic_agr.txt, see Section 3.1) regarding the use of NAG software. Requests for information about the availability of other implementations must be referred to NAG.

2. Implementation Provided

2.1. Applicability

This implementation is a compiled, tested, ready-to-use version of the NAG C Library that is considered suitable for operation on the computer systems detailed below:

hardware:          x86_64 systems
operating system:  Linux 2.6.27.41-170.2.117.fc10.x86_64 (GNU C Library stable release version 2.9) and compatible
C compiler:        Intel C Compiler
version 16.0.3.210 and compatible vendor library: Intel MKL version 11.3.3 (the provided custom version only).
This implementation is supplied with a custom version of MKL and the relevant NAG C library is only intended to be used with this specific MKL library.

The definitions and sizes of the Integer and Pointer types used in this implementation are shown in Section 3.3 of the Users' Note.

2.2. Derivation and Additional Test Platforms

This implementation was produced at NAG Ltd., Oxford on the computing system detailed below:

hardware:          Intel(R) Xeon(R) E5405 
operating system:  Linux 2.6.27.41-170.2.117.fc10.x86_64 with GNU C Library stable release version 2.9
(Fedora release 10 (Cambridge)) C compiler: Intel C Compiler
version 16.0.3.210 20160415 OpenMP runtime: None. vendor library: Intel MKL version 11.3.3 compiler options: -O3 -axCORE-AVX2,AVX,SSE2 -no-fma -fp-model precise -fPIC -m64 -w -fexceptions -DPOINTER64 -DINTEGER64 -DRETURN_COMPLEX_PARAM -DLONG_CHARLEN -c
The flags listed above were chosen to be conservative in terms of performance optimization to prioritize consistency of numerical results. However key computational kernels in the NAG Library have been compiled and tested with higher levels of optimization.

For details of any other systems on which this implementation has been tested, please see the Supplementary Information page on our website.

Please see the Intel web site for further information about MKL (https://software.intel.com/intel-mkl).

2.3. Supplementary Information

Please check the following URL:

http://www.nag.co.uk/doc/inun/cl26/l6idv/supplementary.html

for details of any new information related to the applicability or usage of this implementation. Details of any other systems on which it has been tested may also be found on this page.

3. Distribution

By agreement from NAG, the software may be downloaded from our secure website.

3.1. Contents

The following shows the directory and file organization of the implementation materials after installation.
                    |- in.html  (Installer's Note - this document)
            |- doc -|- un.html  (Users' Note)
            |       |- lic_agr.txt  (license agreement)
            |
            |       |- libnagc_nag.a     (static self-contained library
            |       |                     including NAG BLAS/LAPACK)
            |       |- libnagc_nag.so.26 (shareable self-contained library
            |       |                     including NAG BLAS/LAPACK)
            |       |- libnagc_nag.so    (symbolic link pointing at
            |- lib -|                     libnagc_nag.so.26)
            |       |- libnagc_mkl.a     (static library requiring
            |       |                     MKL BLAS/LAPACK)
            |       |- libnagc_mkl.so.26 (shareable library requiring
            |       |                     MKL BLAS/LAPACK)
            |       |- libnagc_mkl.so    (symbolic link pointing at
            |                             libnagc_mkl.so.26)
cll6i26dv  -|
            |- include -|- *.h
            |
            |            |- source --|- ??????e.c
            |            |
            |- examples -|- data ----|- ??????e.d
            |            |           |- ??????e.opt
            |            |
            |            |- results -|- ??????e.r
            |
            |- scripts -|- nagc_example*  (scripts to compile and run
            |                              NAG example programs)
            |
            |- mkl_intel64_11.3.3  -|- *  (Intel Math Kernel Library)
            |
            |- rtl -|- *  (Intel compiler run-time libraries)

The following shows the directory and file organization of the Library Manual materials after installation.

nagdoc_cl26 -|- index.html
             |
             |- examples -|- baseresults -|- *.r.html
             |            |- source      -|- *.c.html (syntax highlighted
             |            |               |            source files)
             |            |- data        -|- *.d.html
             |            |               |- *.opt.html
             |            |- replaced    -|- *.c.html
             |
             |- html  -|- frontmatter -|- manconts.html  (main HTML index)
             |         |               |- copyright.html (copyright notice)
             |         |
             |         |- genint -|- *.html  (general introductory material)
             |         |
             |         |- [a00-x07] -|- *conts.html  (chapter contents)
             |         |             |- *intro.html  (chapter introduction)
             |         |             |- *c.html      (routine documents)
             |         |
             |         |- figures -|- *.png  (figures and plotfiles)
             |         |
             |         |- styles -|- libdoc.css  (CSS stylesheets)
             |                    |- *.js        (JavaScript)
             |
             |- pdf   -|- frontmatter -|- manconts.html (main contents page)
                       |               |- manconts.pdf  (main contents page)
                       |               |- copyright.pdf (NAG copyright page)
                       |
                       |- genint -|- *.pdf  (general introductory material)
                       |
                       |- [a00-x07] -|- *conts.html   (chapter contents)
                       |             |- *conts.pdf    (chapter contents)
                       |             |- *intro.pdf    (chapter introduction)
                       |             |- *c.pdf        (routine documents)
                       |
                       |- styles -|- libdoc.css  (CSS stylesheets)
                                  |- *.js        (JavaScript)

Details of the software are given in the Users' Note (un.html).

4. Installation

4.1. Installation of Library Software and Manual

Assuming you have downloaded the Library materials from our website as a tar gzip file (cll6i26dv.tgz), cd to the directory where the file is located and extract the installation materials using the following command:

  tar xvzf cll6i26dv.tgz
This will extract the files install.sh, cl26.tgz, lic_agr.txt, in.html and un.html.

If you have downloaded the Library Manual as a tar gzip file (cl26_doc.tgz) run the command

  gunzip cl26_doc.tgz
to extract the file cl26_doc.tar into the same location as the Library materials. You can then install the materials from the download directory by executing the shell script install.sh in a command window as:
  ./install.sh
By default, the materials will be installed under $HOME/NAG/, or if the directory $HOME does not exist, under /opt/NAG/. However, you may choose a different location. In this document we refer to the directory $HOME/NAG/cll6i26dv or /opt/NAG/cll6i26dv as [INSTALL_DIR]. This convention is also used in the Users' Note.

The install script can install the Library Manual in the same location as the NAG Library material or at some other location of your choice. Alternatively, the Library Manual may be viewed from the NAG website (http://www.nag.co.uk/content/nag-c-library-manual).

4.1.1. Silent Installation

It is also possible to run install.sh in unattended or silent modes. The installer takes command line switches for this purpose:

4.2. Further Information

4.2.1. Checking the Installation

Access to the Library materials can be checked by running a few example programs following the advice given in the Users' Note, Section 3.1; a suitable sample would be d01sjc, f07adc and g05sjc. The installation can also be tested using the batch files nagc_example* (see Users' Note, Section 3.2).

5. Support from NAG

Please see

http://www.nag.co.uk/content/nag-technical-support-service

for information about the NAG Technical Support Service, including details of the NAG Technical Support Service contact points. We would also be delighted to receive your feedback on NAG's products and services.

6. Contact Addresses

Please see

http://www.nag.co.uk/content/worldwide-contact-information

for worldwide contact details for the Numerical Algorithms Group.