The view

•

Creating a new view

You can create an empty view in the Model Explorer panel on the left by right clicking on the node of a module item and choosing View from the Add… list in the context popup menu. You can also create a view in the Views environment by using the panel on the right side next to the view canvas and clicking either the default view A picture containing objectDescription automatically generated , new view A close up of a logoDescription automatically generated or duplicate the current view A picture containing objectDescription automatically generated (if one is being viewed) button.

All created views of a module can also be seen listed on this right side below the view creation buttons. As mentioned before, each module contains its own set of views which you can explore below the Views node in the Model Explorer. You can build or customize an existing view page in a similar way to creating a model on the model canvas ( Adding new items to the canvas ).

•

The default view

With this view you get an overview of all the parameters in this module scope listed in input and output items, and a solution explorer item. By running a view you can create an empty solution set ( Starting a view ) and you can enter any necessary input in the input lists ( Providing input ) before starting a calculation ( Starting a calculation ).

•

Adding text or an image to the view

You can add these elements to the design view canvas by following same steps as adding them to the model canvas ( Adding text ) ( Adding an image )

•

Creating a line plot

You can create a line plot by following these steps:

  1. Drag the Line plot item from the toolbox to the canvas or double click it.
  2. The line plot editor popup appears.
  3. Change the type of plot you want to insert. The default plot type uses y(x) expressions. Click the check box to change the plot type to using y(t), x(t) expressions.
    • y(x): you can define a y-axis expression using knowledge from your model and the increment variable x_val.
    • y(t), x(t): you can define a y- and x-axis expression using knowledge from your model and the increment variable t_val.
  4. Customize the axes by providing a label and unit (this unit is only used as a display label). You can also select whether an axis should be displayed logarithmic and customize the axes range that is used when displaying the lines when viewing the solutions.
  5. For each line definition you can do the following things
    • Change the name of the line
    • Select the line width, style and color.
    • Choose the range of the increment variable and the number steps within than range to calculate the line with, separate these with an “;” in the input field.
A trick to prevent a line from showing in the legend is to clear the name of the line. This way the line will not be included in the legend. This can be useful when you want to create a graph line that actually is constructed using multiple lines: Name only the first line segment and clear the names of the connected line segments while keeping the line color and style the same.
You can also use parameters as start and/or end value of the increment variable.
    • Enter your expressions for the axes. You can see the visualization of your expression in the bottom panel of the edit window. If there are any errors in the expression, the text of the expressions will turn red and the error is described in the error tab page.
Clicking the function or symbol button at in the line definitions toolbar to get a popup menu with available (built-in and user added library) functions and symbols. See the expression syntax section for more information.
See the Array syntax section for more information on how to use arrays in line plots.
  1. Add or remove a line with the Add button at the bottom or the Delete button in the top left corner of each line definition.
  2. Click the OK button to add the line plot to the canvas.
You can reorder the lines by dragging and dropping them around to change the order in the line legend. If a line does not have a name if will not show as an item in the line legend.

•

Adding a solution plot

You can add a solution plot to the canvas by following these steps:

  1. Drag the Solution plot item from the toolbox to the design view canvas or double click it.
  2. The solution plot item appears on the view canvas and has two drop down items without an item selected.
  3. Select the axes parameter you want to use for this fixed axis solution plot from the dropdown list.

•

Adding an input field item

You can create an input field by following these steps:

  1. Drag the Input field A close up of a logoDescription automatically generated item from the toolbox to the design view canvas or double click it.
  2. The input field editor popup appears.
  3. You can add any parameter that should be shown in the input field by selecting it from the Available parameters list and clicking the Add button or double clicking the parameter.
  4. The order in which the parameters will be shown in the input field can be seen in the Selected parameters list. You can change the order of those parameters by selecting a parameter and using the up A close up of a logoDescription automatically generated and down buttons to move it
  5. You can remove a parameter from the Selected parameters list by selecting it in the list and clicking the Remove button or by double clicking the parameter.
  6. For the selected parameters you can:
    • Specify whether the value is required to be entered in the run view and what the initial value should be.
    • Override the a table parameter and enable entering a non-table value by  checking the last checkbox to override.
    • Specify a display unit for this specific parameter item if a calculation unit was assigned in the model.
      • To assign a display unit you type the desired unit symbol or symbols. The pop up on the right side of the unit cell will display the understood unit, the SI powers of this unit and provides a shortcut link to select and insert a know unit from a list and to create a new custom unit. See the unit syntax section for more information.
The typed unit should only contain unit symbols either with power raises and should not contain any numeric conversion factor or shifts. For those things a custom unit should be defined.
If a parameter from the Selected parameters list is removed at some point while it is kept in the view the parameters will show up as a ??? in the input field list. Remove this unknown parameter from the Selected parameters list to remove the view error.

•

Adding an output field item

You can add the Output field A screenshot of a cell phoneDescription automatically generated item to the design view canvas by applying the same steps as adding the input field item using to output field item ( Adding an input field ).

You can also define and add a custom parameter with the Manage custom parameters button in the Available parameters list toolbar.

•

Adding a solution explorer

You can create a solution explorer in two flavors:

  • The standard solution explorer which displays all calculated solutions as point in a plot. You can explore the results for selected axes parameters by selecting the desired parameters on the axes and selecting a solution point.
  • A solution explorer list which display all calculated solutions in a long list. You can view the results of the selected parameter in the parameter columns that are displayed to the right of the solution ID column.

You can add a solution explorer by following these steps:

  1. Drag the Solution explorer item from the toolbox to the canvas or double click it.
  2. The solutions explorer editor popup appears.
  3. You can add any parameter that should be available for axes selection by selecting it from the Available parameters list and clicking the Add button or double clicking the parameter.
You can also define and add a custom parameter with the Manage custom parameters button in the Available parameters list toolbar.
  1. The order in which the parameters and will be shown and the group they belong to can be seen in the Selected parameters list. You can change the order of those items by dragging the item in this list to another position in the list.
  2. You can add a group header to the Selected parameters list by clicking the Add header button. The parameters that are listed below a group header belong to that group.
  3. You can remove a parameter or header from the Selected parameters list by selecting it in the list and clicking the Remove button or by double clicking the parameter.
  4. For the selected parameters you can:
    • Specify whether the parameter should be displayed on a logarithmic axis in the plot by checking the last checkbox.
    • Specify a display unit for this specific parameter item if a calculation unit was assigned in the model.
      • To assign a display unit you type the desired unit symbol or symbols. The pop up on the right side of the unit cell will display the understood unit, the SI powers of this unit and provides a shortcut link to select and insert a know unit from a list and to create a new custom unit. See the unit syntax section for more information.
The typed unit should only contain unit symbols either with power raises and should not contain any numeric conversion factor or shifts. For those things a custom unit should be defined.

You can add a Solution explorer list item by following the same steps as adding an input field item using a solution explorer list item ( Adding an input field ).

A solution controller is necessary to enable exploring the individual solutions. When a view has no solution controller of any kind a general view warning is given is given when you try to run the view.

•

Adding a custom parameters

For an output field or solution explorer you can define and add a custom parameter with the Manage custom parameters button in the Available parameters list toolbar. In the Define a new parameter window, you can type your expression do define a new parameter. You can press “CTRL + Space” while inside the text box to get a list of available parameters and functions. Finally, click the add button to create your new custom parameter. Unlike regular parameter, you cannot specify the symbol of this new parameter, you can only define its value. The parameter symbol in the results for this parameter will in this case be the typed expression text. To remove a custom parameter, you can select the parameter in the overview of existing ones and click the delete button or use the clear button to remove all custom parameters.

To use parameters from other module in your custom parameter you will need to use the syntax “ModuleSymbol.ParameterSymbol” to access this parameter.

•

Default display units

You can define a default display unit for each calculation unit in your model in the Default display units tab page. This calculation unit to display unit mapping is unique to each created view and only carries over to another view when you duplicate the view. You can set the default display unit for a calculation unit by defining a unit in the cell next to the calculation unit. Once you set a default display unit for a calculation unit, this unit will automatically be set as the display unit when you add a parameter with a matching calculation to a view element. You can also apply an existing mapping to any parameter already present in the view using the  Apply all… and Apply selected… buttons in the toolbar to either apply all default units or only the selected rows.