Learn more about MATLAB Report Generator

Troubleshooting

On this page…
Managing Memory Usage Displaying HTML Reports on UNIX Systems

Managing Memory Usage

By default, the MATLAB software sets a limit of 100 MB on the amount of memory the Sun Java Virtual Machine (JVM™) software can allocate. The memory that the report generation process uses to build a document must fit within this limit. If you are having trouble processing large reports, it might be helpful to increase the amount of memory that MATLAB Report Generator and Simulink Report Generator software can allocate. See the following sections for more information.

Running the MATLAB Software Without a Desktop

One way to increase the amount of JVM memory available to the MATLAB Report Generator and Simulink Report Generator software is to run the MATLAB software with -nodesktop mode enabled.

Note   This option is available on UNIX® platforms only. (UNIX is a registered trademark of The Open Group in the United States and other countries.)

Increasing the MATLAB JVM Memory Allocation Limit

Increase the amount of JVM memory available by increasing the MATLAB JVM memory allocation limit.

1. Create a file named java.opts. In this file, include the -Xmx option, specifying the amount of memory you want to allocate to the JVM software. For example, to increase the JVM memory allocation limit to 128 MB, use the following syntax in the java.opts file:

   -Xmx128m

   Caution   To avoid virtual memory thrashing, never set the -Xmx option to more than 66% of available physical RAM.

2. Put the java.opts file into the appropriate folder. Where you put the file depends on what operating system you are running.

   • On UNIX systems, put the java.opts file in the folder where you intend to start the MATLAB software session, and navigate to that folder before doing so.

   • On Microsoft Windows^® systems:

     1. Put the java.opts file in a folder where you intend to start the MATLAB software session.

     2. Create a shortcut to the MATLAB software.

     3. Right-click the shortcut and select Properties.

     4. In the Properties dialog box, specify the MATLAB startup folder for the name of the folder in which you created the java.opts file.

   • On Apple^® Mac OS^® systems, put the java.opts file into the /Applications/matlab folder.

Back to Top

Displaying HTML Reports on UNIX Systems

HTML reports may not automatically display on some UNIX platforms. To work around this issue, configure the MATLAB Report Generator software to launch an external browser:

1. In the Report Explorer, click File > Preferences.

2. Enter the following text in the View command field:

   web(rptgen.file2urn('%file name'), '-browser')

   Where file name is the name of your report template file.

You may also need to modify the docopt.m file to specify which Web browser you want to use. For more information, see the docopt function in the MATLAB documentation.

Back to Top

Working with Legacy Report Templates

Working with Components

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS