Your attention is drawn to the terms and conditions of the Software License Agreement regarding the use of NAG software.
This implementation is a compiled, tested, ready-to-use version of the NAG Toolbox for MATLAB that is considered suitable for use on the computer systems detailed below:
hardware: x86-64 systems and compatible operating system: Linux 2.6.12 and compatible MATLAB Version: 7.4 (R2007a), 7.5 (R2007b), 7.6 (R2008a), 7.7 (R2008b)
The user needs to have MATLAB installed. This implementation will not work with later versions of MATLAB such as 7.8 (R2009a).
Please check the following URL:
for details of any new information related to the applicability or usage of this implementation.
Help material 26Mb Toolbox files 55Mb
mkdir nagtmp cd nagtmp tar -xzf ../mbl6a22dgl.tgzIf you received the product on CD then simply insert it in your CD drive and, if necessary, mount the CD device (normally this will happen automatically).
If you are upgrading an existing installation of the toolbox you are strongly advised to uninstall it using the UNINSTALL.a64 script which can be found in the directory toolbox/NAG, using the command
sh UNINSTALL.a64If you are unsure where the existing installation is installed, then type which a00aa at the MATLAB prompt. This should return a string like:
/usr/local/matlab/toolbox/NAG/mex.a64/a00aa.mexa64which indicates that the UNINSTALL.a64 script can be found in
Run the INSTALL script by typing "sh INSTALL". This will prompt you for the location in which you wish to install the product, which typically should be under your existing MATLAB installation. It is possible to install the product elsewhere but if you do so you will need to update your MATLAB path manually, as described in Section 4.1.
After installation, you should ensure that the software described in Section 4.1 is present and accessible.
If you have installed the help material, then on starting the MATLAB Help browser you should see the entry NAG (32 bit) Toolbox in the Contents list.
A quick test that the software has been correctly installed is to type a00aa at the MATLAB prompt, which should print some implementation details.
If you choose to have your MATLAB path updated during installation, the file toolbox/local/pathdef.m will be modified. If you install the toolbox under /MyMatlab then this file will have the lines:
'/MyMatlab/toolbox/NAG/mex.a64:' ... '/MyMatlab/help/toolbox/NAG:' ... '/MyMatlab/help/toolbox/NAGToolboxDemos:' ...inserted. If you choose not to have your path modified then there are a number of ways by which this may be done by hand. Search for "matlab path" in the MATLAB online help system for one method, and for pointers to several others. If updating by hand then it is essential to ensure that the directory containing the help files appears after that containing the executable files. For example, if you installed the toolbox under /MyMatlab then your MATLAB path should contain the directories:
If you choose to modify your MATLAB script during installation then the file bin/matlab in the MATLAB distribution will have the lines:
# Inserted during installation of NAG Toolbox for 64 bit Linux LD_LIBRARY_PATH=/MyMatlab/toolbox/NAG/mex.a64:$LD_LIBRARY_PATHadded to it. If you decide to modify your LD_LIBRARY_PATH by hand then a good approach is to edit the definition of LDPATH_PREFIX in the .matlab7rc file. The main reason that this is not the approach taken by the installation script is that MATLAB allows a user to over-ride the system-wide version with their own version(s) and so it is not possible reliably to install the toolbox for all users this way. The MATLAB documentation contains more information about the use of the .matlab7rc file.
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.
To request a license key, run the program khostid located in MyMatlab/toolbox/NAG/license/bin/linux/. This utility must be run from a command prompt. Return the information that it displays by e-mail (or FAX) to NAG.
A short term (demonstration or trial) license key contains one or more lines like the following:
MBL6A22DGL TRIAL 2009/11/12 "EMnxidA3oeoj0F1Yvi5ibxPjB7"Specifically, it has a line containing the word TRIAL and is referred to here as an uncounted license key. Longer term uncounted 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. Other types of keys may also be issued.
Once you have obtained the license key, store the text of it in a file, say MyMatlab/toolbox/NAG/license.lic.
For an uncounted license, the location of the license file must be made known to the NAG Toolbox by setting the environment variable NAG_KUSARI_FILE to the full pathname of the file before MATLAB is started.
For example, in the C-shell, type:
setenv NAG_KUSARI_FILE MyMatlab/toolbox/NAG/license.licor in the Bourne shell, type:
NAG_KUSARI_FILE=MyMatlab/toolbox/NAG/license.lic export NAG_KUSARI_FILENo other actions are required to install an uncounted license.
To check that the license has been correctly installed, start MATLAB and type a00ac. If this returns 1 then the license has been installed successfully and a license is available.
Further details about Kusari and how it may be configured to suit your local circumstances can be found in MyMatlab/toolbox/NAG/license/doc.
On-line documentation, accessible via the standard MATLAB help facilities, is bundled with this implementation. Please see Section 4.
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 and NAG product code (in this case MBL6A22DGL).
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:
http://www.nag.co.uk/, http://www.nag.com/ or http://www.nag-j.co.jp/
NAG Ltd Wilkinson House Jordan Hill Road OXFORD OX2 8DR NAG Ltd Response Centre United Kingdom email: email@example.com 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: firstname.lastname@example.org 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 Japan email: email@example.com Tel: +81 (0)3 5542 6311 Fax: +81 (0)3 5542 6312