NAG Toolbox for MATLAB®

MBL6A23DML

x86-64 Linux, MATLAB R2010b - R2012a

Post Release Information

This implementation is applicable to computer systems described in section 2.1 of the Installer's Note (see Installer's Note, Applicability).

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

  1. 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.

  2. 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 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_PATH
    
    in 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.

    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. /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.