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
(or R2013a)
installation directory.
(For example on Windows you may wish to install under
\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.w64 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.
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.