The Results Table (
) form object adds a results table that can display numerical results in a table. You typically specify the source of the results data as a Global Evaluation in a COMSOL model. When you add an Evaluate Global Evaluation command for a button, for example, you can provide the name of the Results Table object that you want to update with the new results. You can also specify a Boolean value to specify if the Results Table should be cleared (true; the default) or not cleared (false). Enter the Result Table object’s name in the Name field.
) form object adds a results table that can display numerical results in a table. You typically specify the source of the results data as a Global Evaluation in a COMSOL model. When you add an Evaluate Global Evaluation command for a button, for example, you can provide the name of the Results Table object that you want to update with the new results. You can also specify a Boolean value to specify if the Results Table should be cleared (true; the default) or not cleared (false). Enter the Result Table object’s name in the Name field.The Include standard results table toolbar check box is selected by default, which includes the toolbar in a Table window that you see on the COMSOL Desktop. Clear the check box to remove it. The toolbar includes buttons for precision and notation of the table data, a button for copying the table and headers to the clipboard, and a button for exporting the table data to a file. The file types that you can save table data to include text files (.txt), CSV files (.csv), data files (.dat), and, if the license includes LiveLink™ for Excel®, Microsoft Excel® files (,xlsx).
In addition, the Settings window has the following sections:
In this section you specify the source of the results data. The section contains a tree with a filtered view of the trees in the Application Builder and Model Builder windows. The nodes either represent some sort of output or have children that do. When you select a node that represents an output, the Use as source toolbar button (
) below the tree becomes enabled. You can also right-click the node and choose Use as source. After selecting a node as the source, the node appears as the selected source underneath Selected source. All nodes in the Derived Values and Tables branches under Model>Results and are valid output nodes. Click the Edit Node toolbar button (
) below the tree to move to the corresponding node. If necessary, the program switches to the Model Builder.
) below the tree becomes enabled. You can also right-click the node and choose Use as source. After selecting a node as the source, the node appears as the selected source underneath Selected source. All nodes in the Derived Values and Tables branches under Model>Results and are valid output nodes. Click the Edit Node toolbar button () below the tree to move to the corresponding node. If necessary, the program switches to the Model Builder.|
•
|
From the Horizontal alignment list, choose Left, Center, Right, or Fill, which automatically expands the form object to fill the cell in the horizontal or vertical direction (where applicable).
|
|
•
|
From the Vertical alignment list, choose Middle, Top, Bottom, or Fill, which automatically expands the form object to fill the cell in the horizontal or vertical direction (where applicable).
|
The need to specify the alignment is most obvious when working in the grid mode, as it controls how the form object is aligned in its grid cell. Aligning the form object can be useful in the sketch mode too, and you can then use the alignment tools on the Arrange menu in the Form toolbar’s Sketch section. When running the application in any client other than the Windows client, the form objects may not be positioned exactly as seen in the form windows. This is because the form objects may have a different size in other clients, giving them a slightly different positioning. Specifying the alignment ensures that the form objects are aligned as you want them to be in all clients.
You can also specify the width and height of the results table. To adjust the width, enter a width (in points) in the Width field. If you have chosen Fill from the Horizontal alignment list, you can instead specify a Minimum width. Choose Automatic to compute the minimum width automatically (typically this means a minimum size of 0), or choose Manual to specify a minimum width in the text field underneath. To adjust the height, enter a height (in points) in the Height field. If you have chosen Fill from the Vertical alignment list, you can instead specify a Minimum height. Choose Automatic to compute the minimum height automatically (typically this means a minimum size of 0), or choose Manual to specify a minimum height in the text field underneath.
Additionally, in the sketch mode, you can specify the form object’s absolute position using the Position x and Position y fields. In the grid mode, you can position the object in the grid and see the grid position as the Row, Column, Row span, and Column span values.
 |
Under Cell margin (in grid mode only), you can control the margins around the form object. By default, the margins are taken from the parent form. From the Cell margin list, choose:
|
•
|
None, to use no margin around the form object.
|
|
•
|
From parent form (the default), to use the margins set for the parent form.
|
|
•
|
|
•
|
From the Text color list, select a color to use for the text: Inherit (the default; the form object then uses the setting from the Form it is located in), any of the predefined basic colors, or Custom, which makes it possible to select a custom color from a color palette that opens.
|
|
•
|
The font and the font size for the results table use the font settings from the Forms node by default. Select a font from the Font list: Default font or any of the available fonts. If needed, choose or enter a font size (in points) in the Font size combo box. The default font size is Default size.
|
|
•
|
Select the Bold check box to use a boldface font.
|
|
•
|
Select the Italic check box to use italics (an italic font).
|
Under State, you can control the initial state of the results table when users run the application. By default, the results table is visible and enabled. Clear the Visible or Enabled check box if you want to make the initial state so that the results table is hidden or unavailable. You can then make it visible or enable it using a method.