Any additional information related to this implementation, that came to light after the release of this product, is described below.
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.
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 not under the MATLAB R2012b
(For example on Linux you may wish to install under
/MyMatlab rather than
/usr/local/MATLAB.) 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:
/MyMatlab/toolbox/NAG/mex.a64 /MyMatlab/help/toolbox/NAG /MyMatlab/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.
The LD_LIBRARY_PATH setting in your MATLAB script must also be
updated to include the
(e.g., if you installed under
bin/matlabfile or the equivalent LDPATH_PREFIX setting in your
.matlab7rc.shfile) as described in Section 4.1 of the Installer's Note.
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
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
Further documentation is available in the NAG Toolbox help files.
which appear at the end of the documentation returned by the MATLAB
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.
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
should be a directory containing the subdirectories
NAGToolboxDemos both of which need to be on the
NAG directory, you will find a
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
contents can then be extracted via the
The destination of the extracted files must
be the folder originally containing
You need to rename, move or
help.jar so that MATLAB does not try to use it,
and then restart MATLAB.