Documentation

Troubleshooting Report Generation Issues

Memory Usage

The Report Generator™ software has two converters for generating documents. One uses Java® heap memory and the other does not.

To avoid Java heap memory issues, you can generate your report using the converter that does not use Java heap memory. To do so, under the Report Options for the report, set File format to one of the (from template) options, for example, HTML (from template).

If you select one of the other options, you are using the converter that uses Java heap memory and you might have memory issues. By default, MATLAB® sets a limit of 384 MB on the amount of memory the Oracle® 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, you can try increasing the amount of memory that the software can allocate by:

  • Running MATLAB without a desktop

  • Increasing the memory allocation limit

Run MATLAB Without a Desktop

To run the MATLAB software without a desktop, start MATLAB using the -nodesktop option. In this case, you must generate the report from the command line using the report command.

Increase the MATLAB JVM Memory Allocation Limit

To increase the amount of JVM memory available by increasing the MATLAB JVM memory allocation limit, from the MATLAB Toolstrip, in the Home tab, in the Environment section, click Preferences. Use the General > Java Heap Memory pane to increase the memory.

HTML Report Display on UNIX Systems

HTML reports might not display in the Report Generator™ Web viewer on some UNIX® platforms. If this happens, configure the Report Generator software to launch an external browser.

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

  2. Enter this command in the View command field, where file name is the name of your report setup file:

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

Was this topic helpful?