Your attention is drawn to the terms and conditions of the Software License regarding the use of NAG software. Requests for information about the availability of other implementations must be referred to NAG.
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_32 systems operating system: Microsoft Windows 32-bit (XP / Vista / 7 and compatible) C compiler: Intel C++ Compiler (IA-32) version 12.1 and compatible Microsoft 32-bit C/C++ compiler version 16.00 or compatible
This implementation was produced at NAG Ltd., Oxford on the computing system detailed below:
hardware: Intel Core2 Quad 2.4 GHz operating system: Windows Vista Business 32-bit C compiler: Intel C++ Compiler XE for applications running on IA-32 Version 18.104.22.168 Build 20110811
It has also been tested on a similar machine but with another version of the Intel C compiler:
C compiler: Intel C++ Compiler XE for applications running on IA-32 Version 11.1 Build 20100414
It has also been tested on a similar machine with various versions of the Microsoft C compiler:
C compiler: Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 16.00.40219.01 Version 15.00.21022.08 Version 14.00.50727.762
The NAG C Library, Mark 23, was compiled with the highest level of optimization that enabled the functionality provided by the library to be verified and validated.
This library has been tested using the Basic Linear Algebra Subprograms (BLAS) and Linear Algebra PACKage (LAPACK) routines provided by NAG (see the Chapter Introductions for f07, f08 and f16 in the NAG Mark 23 Library Manual, which we will refer to as the Library Manual).
The library has also been tested with MKL Version 10.3 as supplied with the Intel C++ distribution listed above. The MKL Version 10.3 libraries are supplied as a part of this product (see contents).
Please see the Intel web site for further information about MKL (http://www.intel.com/software/products/mkl).
Please check the following URL:
for details of any new information related to the applicability or usage of this implementation.
|- doc -|- in.html (Installer's Note - this document) | |- un.html (Users' Note) | |- lic_agr.txt (licence agreement) | | |- nagc_example_*.bat (Batch files to compile | | and run NAG example programs) |- batch -| | |- envvars.bat (Batch file to set environment | | variables for the NAG C Library) | | |- CLW3223DA_nag.dll (DLL including NAG BLAS/LAPACK) |- bin -|- CLW3223DA_mkl.dll (DLL requiring MKL BLAS/LAPACK) | |- plus various compiler support libraries | | |- source --|- ??????e.c |- examples -|- data ----|- ??????e.d, ??????e.opt | |- results -|- ??????e.r | clw3223dal -|- include -|- *.h | | |- CLW3223DA_nag.lib (DLL import library | | including NAG BLAS/LAPACK) | | | |- CLW3223DA_mkl.lib (DLL import library | | requiring MKL BLAS/LAPACK) | | |- lib -|- nagc_nag_MT.lib (static library including | | NAG BLAS/LAPACK compiled with /MT) | | | |- nagc_mkl_MT.lib (static library requiring | | MKL BLAS/LAPACK compiled with /MT) | | | |- nagc_nag_MD.lib (static library including | | NAG BLAS/LAPACK compiled with /MD) | | | |- nagc_mkl_MD.lib (static library requiring | | NAG BLAS/LAPACK compiled with /MD) | | | |- plus various compiler support libraries | |- diagnostics -|- NAG_C_DLL_info.exe | |- MKL_ia32_10.3 -|- * (Intel Math Kernel Library) | | |- bin -|- * (directories of binaries | | for supported platforms) |- license -|- README.TXT | |- doc -|- * (End User Guide)
The library nagc_nag_MT.lib is a static library that includes NAG BLAS/LAPACK. The library nagc_mkl_MT.lib is a static library that does not include BLAS/LAPACK. Both libraries have been compiled with the /MT option to link with the static multi-threaded C run time library. This option must be used when compiling applications to be linked with either of these libraries to ensure linking to the correct C run time libraries.
The library nagc_nag_MD.lib is an alternate version of the static library that includes NAG BLAS/LAPACK and is compiled with the /MD option. The library nagc_mkl_MD.lib is a static library that does not include BLAS/LAPACK. Both libraries have been compiled with the /MD option to link with the multi-threaded DLL C run time library. The /MD option must be used when compiling applications to be linked with either of these libraries to ensure linking to the correct C run time libraries.
CLW3223DA_nag.lib is a DLL import library that includes NAG BLAS/LAPACK. CLW3223DA_mkl.lib is a DLL import library that does not include BLAS/LAPACK. Both libraries have been compiled with the /MD option to link with the multi-threaded DLL C run time library. This option must be used when compiling applications to be linked with either of these libraries to ensure linking to the correct C run time libraries.
The following shows the directory/file organization of the Library Manual materials as they will be installed.
The files require approximately the following disk space:
Library software: 632 MB Library Manual: 220 MB
If you have the Library materials on CD, insert the CD into your CD
drive to display the NAG CD browser. Click on the
e:\NAG_Installation_browser.exeto run the browser, or run e:\clw3223dal_setup.exe to run the Library installation directly, where e is the drive letter for your CD drive.
If you have downloaded the Library materials from our website, run the self-extracting executable to start the Library installation. The Library Manual materials are available as a separate download.
After installation, you should ensure that the software described in Section 3.1 is present and accessible.
If your machine has more than one processor, then it is recommended that you set the environment variable OMP_NUM_THREADS to the number of available processors, e.g.
set OMP_NUM_THREADS=2This will enable the Intel MKL BLAS to make use of the extra processor(s) and will thus speed up the computation of many of the Library procedures.
The installation procedure will create a shortcut which starts a Command Prompt with the required local environment variables. The default location of this shortcut is in the Start Menu under
Start|All Programs|NAG|CL23|NAG C Library (CLW3223DAL)|CLW3223DAL Command Prompt
The local environment variable NAG_CLW3223DAL is needed by the batch files nagc_example_*.bat (see Section 3.1.1. of the Users' Note (un.html)).
The installation procedure also creates a shortcut on the Start Menu to the Users' Note, which by default is located under
Start|All Programs|NAG|CL23|NAG C Library (CLW3223DAL)|Users' Note
This software is provided with an uninstallation facility via
Control Panel|Add or Remove Programson Windows XP and via
Control Panel|Programs|Programs and Features|Uninstall a Programon Windows Vista or Windows 7.
If you have the Library materials on CD, insert the CD into your CD
drive to display the NAG CD browser. Click on the
e:\NAG_Installation_browser.exeto run the browser, or run e:\setup_cl23_manual.exe to run the Library manual installation directly, where e is the drive letter for your CD drive.
If you have downloaded the Library Manual materials from our website, run the self-extracting executable to start the Library Manual installation.
The installation will create a shortcut to the main index file for the manual. The default location of this shortcut is in the Start Menu under
Start|All Programs|NAG|CL23|NAG C Library Manual
Free copies of Adobe Acrobat Reader can be downloaded from http://www.adobe.com/. Please check this site for availability of a reader for your platform.
Please note that if you are using Adobe Acrobat 4.0 or earlier you might experience some problems when printing documents that contain mathematical characters, such as integral signs, square roots and large brackets.
In order to enable the software, NAG will issue you with a license key. The license key is a simple text file containing details of the software that will be enabled. For evaluation purposes a trial license may be used. Before obtaining a full license you need to know the Kusari hostid of the system on which you intend to use this product. How to do this is described below.
The easiest way to request a license key is to use the Kusari Installer GUI described in the next section. Once you have a key, the same GUI can be used to install it.
The information below covers the most common requirements. For more
complex licensing situations, please see the Kusari documentation
To request a license key, run the Kusari Installer program, which may be accessed at the end of the installation procedure or via the Start Menu shortcut
Start|All Programs|NAG|CL23|NAG C Library (CLW3223DAL)|Request or Install License Keyand click on the
The NAG Response Centre will send you the Kusari license key by email.
A short term (demonstration or trial) license key contains one or more lines like the following:
CLW3223DA TRIAL 2010/11/12 "EMnxidA3oeoj0F1Yvi5ibxPjB7"Specifically, it has a line containing the word TRIAL. Longer term license keys must be locked to a specific computer, i.e. they will enable the software on one computer only. These license keys include the word NODE instead of the word TRIAL above.
Once you have obtained one of the above license keys, the Kusari
Installer program may be used to install the key in the Windows
Registry. Paste the key into the edit box on the main Kusari
Installer dialog and then click on the
The khostid command may be found in the
klreg CLW3223DA license.datOtherwise the key can be installed for the current user,
klreg /current_user CLW3223DA license.dat
The environment variable may be set from the Control Panel.
The a00acc example program may be used to check the license is properly installed or the diagnostic program NAG_C_DLL_info.exe can be used to check both accessibility and licensing.
The following material should also be made accessible to users:
The CL23\manual folder contains the online documentation. This should be made available to users, in addition to the following:
lib\* bin\* MKL_ia32_10.3\lib\* MKL_ia32_10.3\bin\*include files:
include\*.hexample program material:
examples\source\*.c examples\data\*.d examples\data\*.opt examples\results\*.r batch\nagc_example*.batbatch file to set environment variables:
Note that the example material has been adapted, if necessary, from that published in the NAG C Library Manual, so that programs are suitable for execution with this implementation with no further changes (but see Section 3.2 of the Users' Note for comments about possible differences in results obtained). Making the example material directly available to users provides them with easily adaptable templates for their own problems.
Online documentation is bundled with this implementation. Please see Section 4. See Section 3.1 for online help files in HTML and PDF formats.
The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with an annually licensed product or support service.
The Response Centres are open during office hours, but contact is possible by fax, email and phone (answering machine) at all times.
When contacting a Response Centre, it helps us deal with your enquiry quickly if you can quote your NAG site reference or account number and NAG product code (in this case CLW3223DAL).
The NAG websites provide information about implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at the following URLs:
NAG Ltd Wilkinson House Jordan Hill Road OXFORD OX2 8DR NAG Ltd Response Centre United Kingdom email: firstname.lastname@example.org Tel: +44 (0)1865 511245 Tel: +44 (0)1865 311744 Fax: +44 (0)1865 310139 Fax: +44 (0)1865 310139 NAG Inc 801 Warrenville Road Suite 185 Lisle, IL 60532-4332 NAG Inc Response Center USA email: email@example.com Tel: +1 630 971 2337 Tel: +1 630 971 2337 Fax: +1 630 971 2706 Fax: +1 630 971 2706 Nihon NAG KK Hatchobori Frontier Building 2F 4-9-9 Hatchobori Chuo-ku Tokyo 104-0032 Nihon NAG Response Centre Japan email: firstname.lastname@example.org Tel: +81 3 5542 6311 Tel: +81 3 5542 6311 Fax: +81 3 5542 6312 Fax: +81 3 5542 6312 NAG Taiwan Branch Office 5F.-5, No.36, Sec.3 Minsheng E. Rd. Taipei City 10480 NAG Taiwan Response Centre Taiwan email: email@example.com Tel: +886 2 25093288 Tel: +886 2 25093288 Fax: +886 2 25091798 Fax: +886 2 25091798