Any additional information related to this implementation, that came to light after the release of this product, is described below.

### MATLAB R2012b & R2013a Suitability

This implementation has been tested with MATLAB versions 8.0 (R2012b) and 8.1 (R2013a) and is considered suitable for use with those versions. However, please see the note below with regard to installation of the NAG Toolbox under R2012b and R2013a.

### Installation under MATLAB R2012b & R2013a

MATLAB version 8.0 (R2012b) introduces a new help system which has an impact on the installation and use of the NAG Toolbox for MATLAB.

Documentation for toolboxes not distributed by MathWorks may no longer be installed under the MATLAB installation directory. If the documentation for the NAG Toolbox is installed under the MATLAB root (which is the default location suggested by the installation procedure) then the Toolbox functions will operate as normal but no help will be displayed.

Thus on installation, the Toolbox should be installed at any suitable location which is

under the MATLAB R2012b (or R2013a) installation directory. (For example on Windows you may wish to install under*not*`\Program Files\NAG\R2012b`

rather than under`\Program Files\MATLAB\R2012b`

.) After installation of the Toolbox the MATLAB path will need to be updated to include the mex directory, help directory and demo directory. For example if the installation was as above the following items would need to be added to the path:C:\Program Files\NAG\R2012b\toolbox\NAG\mex.w32 C:\Program Files\NAG\R2012b\help\toolbox\NAG C:\Program Files\NAG\R2012b\help\toolbox\NAGToolboxDemos

in that order.

The path may be altered in several ways for example by setting the

`MATLABPATH`

environment variable or using the path edit tool within the MATLAB system.Once the help has been added to the path, a new

**Supplemental Software**tab will appear at the bottom of the Doc Center home page (next to the existing tab**PDF Documentation**). This will link to a version of the old MATLAB help system in which the NAG documentation may be viewed.Unfortunately, due to changes implemented within MATLAB, in these releases neither the

`doc`

nor`docsearch`

matlab commands can be used to search third party toolboxes; however if the help system is reached as described above the NAG documentation may be searched using the search box in the supplemental software browser.The lack of

`docsearch`

facility means that the links of the form

`Further documentation is available in the NAG Toolbox help files.`

which appear at the end of the documentation returned by the MATLAB`help`

function**do not work**in MATLAB R2012b or R2013a. This has been raised as an issue with MathWorks and hopefully this functionality will be restored in later MATLAB releases.#### Additional workaround required for MATLAB R2013a

At MATLAB version 8.1 (R2013a), the Java "jar" archives previously used for the old MATLAB help system no longer work.

Fortunately, there is a workaround, as follows:

Navigate to where you have installed the toolbox help e.g.

`C:\Program Files\NAG\R2013a\help\toolbox`

. This should be a directory containing the subdirectories`NAG`

and`NAGToolboxDemos`

both of which need to be on the MATLAB path.In the

`NAG`

directory, you will find a file`help.jar`

. You need to unzip this in place so that all the HTML files are unpacked. (The easiest way to do this is to rename the extension from`.jar`

to`.zip`

; the contents can then be extracted via Windows Explorer without the need of additional software. The destination of the extracted files must be the folder originally containing`help.jar`

.) You need to rename, move or remove`help.jar`

so that MATLAB does not try to use it, and then restart MATLAB.