The Report Node

) contains information about the formatting and defaults for the report. Click the (

) or (

) button to show a preview of the report in the window. Click the button (

) in the toolbar for the window for to create a report. The option is also available by right-clicking any node in the report. Selecting from any report node’s context menu generates the entire report.

This section, which is collapsed by default, contains the setting for the level of detail in the new nodes that are added to the report. It is independent of the level of the template used to create the initial report contents. From the list, select , (the default), or to specify a level of detail for new report nodes that is the same as what the corresponding report templates use.

You can select to create a report in one of the following formats, which you choose from the list:

•

, for creating the report as a docx file for use as a document in Microsoft® Word (version 2007 or later).

When adding a new report, the initial setting for the output format is that of the last report you wrote (or previewed).

The Report Generator stores the report in a file with the chosen name and by default gives it the extension .html or .docx. For HTML reports, it stores images included in the report and the style sheet in a subdirectory with the same name as the report plus the suffix _files. Reports in Microsoft Word format are self contained.

Specify the report’s directory path and filename in the text field or click to launch the dialog box, browse to the desired location, and enter the filename in the text field. If the text field is empty, you will be asked to specify the filename when you click . If you select , the dialog box will always prompt you for a filename; if specified, the current name is the default choice.

When you add a new report, the filename will by default be empty. You can override this behavior by specifying a default report directory in the dialog; see the subsection Edit the Default Report Settings below.

Select to directly open the generated report in a web browser (HTML) or Microsoft Word.

By default, report output data that refers to model contents will be rendered as hyperlinks if there is a report section for the referenced object. For example, in the report section for a solver you can follow a link to get to the section describing the study step that defines the solver. If you want to disable hyperlinks, for example when printing a report, select the check box.

To customize the style of reports in the HTML output format, you can specify the CSS-file to use in the list:

•

Select to use the default style file specified in the dialog (see Edit the Default Report Settings) or the built-in style in COMSOL Multiphysics if no valid default style file has been given.

•

Select if you want to use a custom style sheet for a particular report. If you select , specify a style sheet in the field, or click to locate the style-sheet file (CSS file).

Also for reports in the HTML format, select a level from the list: (the default; one file only), , , or .

For reports in the Microsoft Word format, you can control the layout using the list:

•

Select to use as the style template the default Microsoft Word template (.dotx) or Microsoft Word document (.docx) file specified in the dialog. If no such file has been specified, COMSOL’s built-in template will be used.

•

Select and type a path to the .dotx or .docx file of your choice in the text field or click to navigate to its location on the file system.

From the list, choose the section level at which to start a new page of your report in Microsoft Word format: (no page breaks), (the default), , or .

For both output formats, choose the section level to which the report should enumerate each section from the list: (no enumerated section), , , (the default), , , , or (enumerate all sections).

Once an HTML report is created, it can be published or edited in any HTML editor. If you want to publish a report on the internet or send it to a colleague, also send the HTML file and the folder with the images and style sheet.

From the list, you can select the image size as (240-by-180 pixels for HTML screen output/2.4-by-1.8 inches for print-optimized output), (320-by-240 pixels/3-by-2.4 inches), (480-by-360 pixels/4-by-3 inches), (600-by-450 pixels/6-by-4.5 inches), or (720-by-540 pixels/7.2-by-5.4 inches)). All images have an aspect ratio of 4:3. From the list, select the image file type: (the default), , or (not supported for reports in Microsoft Word format; choosing this option gives PNG images).

	For the best image quality, use PNG images.

There are three options for controlling image generation:

•

(default): Report images are generated in accordance with the settings for the individual report features each time you write the report.

•

: Images are generated if they are not available. Use this option if you want to quickly rewrite the report to include changes that only affect the text.

•

: Images are not generated. This option can be useful, for example, when troubleshooting models with a very large number of nodes.

Using the controls in this section, you can customize how numbers are formatted in report table output. The available settings are:

•

— Numbers in report tables are displayed in the same way as numbers in the Table window in the COMSOL Desktop. In particular, the precision is then controlled by the setting on the page of the dialog.

•

— Choose this option if you want to customize number formatting for your report. You can then specify the as an integer between 1 and 16 (the default is the current preference setting) and the , with the following alternatives:

(default) — display numbers in either scientific or decimal notation depending on their magnitude

For and notation, select the if you want to keep trailing zeros within the chosen precision.

Select the check box to right align table columns with purely numeric data.

You can override the report-wide number format settings for individual report feature nodes that generate table data. The window for such a report feature node contains a section where you can specify the as either (the default) or . The former option gives the number formatting defined in the corresponding section of the parent Report node, whereas the latter allows you to specify dedicated settings.

Open The Preferences Dialog Box and click to control some properties for the report generator.

•

If the refers to an existing directory, the default filename for a new report will be based on the model’s name. When the report directory is set in this way, a nonabsolute path in the text field in the section of the Report window will be interpreted as relative to this directory.

•

In the field, type the full path and filename to a style sheet (.css-file) that you want to use as the default style sheet for reports in HTML format. Click to browse to the file’s location.

•

In the field, type the full path and filename to a Microsoft Word template (.dotx-file) that you want to use as the default style template for reports in Microsoft Word format. Click to browse to the file’s location. You can also use a Microsoft Word document (.docx-file) as your default template.

•

In the field, type the full path and filename for an image file (on PNG or JPEG format) to use as the logotype. Click to browse to the logotype file. If empty, the COMSOL logotype appears in the report.

•

From the list, you can select the default size for report images; choose between , , , and . Similarly, use the list to specify the default type for the report images: , , or .

•

Select the check box to make Microsoft Word ask whether you want to update the table of contents when you first launch a report in this format. Such an update is necessary to generate page numbers in the table of contents, but you can choose to do the update after you have opened the document in Microsoft Word. By default this check box is not selected.