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 Linux you may wish to install under
/MyMatlab
rather than
under /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 toolbox/NAG/mex.a64
directory
(e.g., if you installed under /MyMatlab
, add
LD_LIBRARY_PATH=/MyMatlab/toolbox/NAG/mex.a64:$LD_LIBRARY_PATHin the
bin/matlab
file or the equivalent LDPATH_PREFIX
setting in your .matlab7rc.sh
file) 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 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. /MyMatlab/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 the unzip
command.
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.