NAG Toolbox for MATLAB


Microsoft Windows x64, MATLAB R2015a - R2016a

Installer's Note


1. Introduction

This Installer's Note is essential reading for whoever is responsible for the installation of this implementation of the NAG Toolbox for MATLAB.

Your attention is drawn to the terms and conditions of the Software License Agreement (in file lic_agr.txt) regarding the use of NAG software. Any request to use this software other than on the licensed computer must be referred to NAG, as should requests for information about the availability of other implementations.

2. Implementation Provided

2.1. Applicability

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:     Microsoft Windows
MATLAB version:       64-bit: 8.5 (R2015a), 8.5.1 (R2015aSP1), 8.6 (R2015b), 9.0 (R2016a)

The user needs to have MATLAB installed. This implementation may work with later versions of MATLAB. More details may be available on the supplementary information page (see Section 2.3).

Note that this implementation will not work with 32-bit versions of MATLAB; please use an appropriate 32-bit NAG Toolbox instead.

2.2. Precision

For compatibility with MATLAB, this implementation uses 64-bit integers.

2.3. Supplementary Information

Please check the following URL:

for details of any new information related to the applicability or usage of this implementation.

3. Distribution

The software is available to download from any of the NAG websites (see Section 7 for contact details).

3.1. Contents

The following shows the folder and file organization of the implementation materials as they will be installed.

                        |- ?????.mexw64  (MEX-files, short function names)
                        |- nag_*.mexw64  (MEX-files, long function names)
                        |- nag_int*.m    (Helper function source files)
mbw6i25ddl -|- mex.w64 -|
            |           |- MBW6I25DD.dll (NAG Library DLL)
            |           |
            |           |- *.dll         (Supporting run-time libraries)
            |           |
            |           |- *             (Other support files)
            |- help -|- NAG -|- * (Help files and demo materials)
            |- doc -|- in.html (Installer's Note (this document))
                    |- lic_agr.txt (Licence Agreement)

By default these files are installed under C:\Program Files\NAG\MB25 . Note that due to changes in MATLAB from version 8.0 (R2012b), we no longer recommend installing the NAG files within the MATLAB hierarchy.

4. Installation

You must have Administrator privileges to install this software.

Assuming you have downloaded the toolbox materials from our website, run the self-extracting executable (mbw6i25ddl_setup.exe) to start the installation.

Note that we recommend that you install a separate instance of the toolbox for each version of MATLAB that you wish to use it with. However, if you install a new release of MATLAB and wish to use an existing installation of the toolbox with it, then this is possible by following the instructions in Section 4.1.1.

After installation, you should ensure that the software described in Section 3.1 is present and accessible.

You should access the toolbox documentation as follows. On starting the MATLAB documentation browser you should see a link labelled Supplemental Software. Clicking on that should open a browser with the entry NAG 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 this does not work correctly and you see messages such as "The referenced assembly is not installed on your system." then it may be necessary to reboot your computer so that MATLAB picks up the correct support libraries.

To test that a valid license is available, type a00ac at the MATLAB prompt. This will return 1 if a valid license is found, or 0 otherwise.

This software is provided with an uninstallation facility via

  Control Panel|Programs|Uninstall a Program
  Control Panel|Programs and Features|Uninstall or change a program
(depending on which view is displayed).

Running the setup program again will allow you to install another instance of the toolbox to a different location (e.g. for use with a different release of MATLAB).

4.1. Installation Options

4.1.1. Updating the MATLAB path

If you choose to have your MATLAB path updated during installation, the file toolbox\local\pathdef.m in your MATLAB installation will be modified. If you choose not to have your path modified, or you wish to use an existing toolbox installation with a new installation of MATLAB, then there are a number of ways by which this may be done by hand. The easiest is to use the Set Path button on the MATLAB GUI, but if you search for "matlab path" in the MATLAB online help system you will find pointers to several others. If updating by hand then it is essential to ensure that the folder containing the help files appears after that containing the executable files. For example, if you installed the toolbox under C:\Program Files\NAG\MB25\mbw6i25ddl then your MATLAB path should contain the folders:

in that order.

4.2. Silent Installation

This product may be installed in silent (unattended) mode by running
  mbw6i25ddl_setup.exe /SILENT
  mbw6i25ddl_setup.exe /VERYSILENT
from a Command Prompt. With the first version, the user sees what is happening on the screen as the installation procedure progresses, whereas with the second, nothing is displayed. The files will be installed to the default location and the MATLAB path file (pathdef.m) for the most recent version of MATLAB found will be modified. The default location may be overridden by using the /DIR flag, e.g. /DIR="C:\my folder". To prevent the MATLAB path being updated, the /TYPE=nopathdef option may be used.

4.3. License Management

The use of this product is controlled by the Kusari license management system. This release uses version 2.2-72 of Kusari.

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. To get a trial license contact the NAG Response Centre. Before obtaining a full license you need to know the Kusari hostid of the system on which you intend to use this product and how to do this is described below.

The easiest way to request a license key is to use the 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 contact us.

4.3.1. The GUI license key request and key installation program
The recommended way to request a license key is to use the GUI program provided. This will help you to build a standard message requesting either a trial key or a full key which can be pasted into an email to the NAG Technical Support Service. In the case of a full key, the message contains the Kusari hostid.

Once you have your license key, the same GUI can be used to install the key in the registry.

You can execute this GUI via the Start Menu/All apps shortcut NAG MBW6I25DDL Licence, Request or Install.

This GUI can also be run from the installation procedure.

4.3.2. USB key licenses (subject to availability and commercial agreement)
Simply insert the USB key in any spare USB socket on the machine on which you wish to run this product.

5. Documentation

On-line documentation, accessible via the standard MATLAB help facilities, is bundled with this implementation. Please see Section 3.1.

6. Support from NAG

NAG will provide free support for this product for a period of 90 days from the date of purchase. Beyond that period, support will continue to be provided for users who have an appropriate support agreement. Please see

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.

7. Contact Addresses

Please see

for worldwide contact details for the Numerical Algorithms Group.