Topic
Prev Next

Configure SysML Simulation Window

The Configure SysML Simulation window is the interface through which you can provide run-time parameters for executing the simulation of a SysML model.  The simulation is based on a simulation configuration defined in a SysMLSimConfiguration Artifact element.

Access

Ribbon

Simulate > SysMLSim > Manage > SysMLSim Configuration Manager

Other

Double-click on an Artifact with the SysMLSimConfiguration stereotype.

Toolbar Options

Option

Description

See also

Click on the drop-down arrow and select from these options:

  • Select Artifact - Select and load an existing configuration from an Artifact with the SysMLSimConfiguration stereotype (if one has not already been selected)
  • Create Artifact - Create a new SysMLSimConfiguration or select and load an existing configuration artifact
  • Select Package - Select a Package to scan for SysML elements to configure for simulation
  • Reload - Reload the Configuration Manager with changes to the current Package
  • Configure Modelica Solver - Display the 'Modelica Solver Path' dialog, in which you type or browse for the path to the Modelica solver to use

Click on this button to save the configuration to the current Artifact.

Click on this button to generate, compile and run the current configuration, and display the results.

After simulation, the result file is generated in either plt, mat or csv format. That is, with the filename:

  • ModelName_res.plt
  • ModelName_res.mat    or
  • ModelName_res.csv

Click on this button to specify a directory into which Enterprise Architect will copy the result file.

Click on this button to select from these options:

  • Generate Modelica Code - Generate the code without compiling or running it
  • Open Modelica Simulation Directory - Open the directory into which Modelica code will be generated
  • Edit Modelica Templates - Customize the code generated for Modelica, using the Code Template Editor

Simulation Artifact and Model Selection

Field

Meaning

See also

Artifact

Click on the icon and either browse for and select an existing SysMLSimConfiguration Artifact, or create a new Artifact.

Select Dialog

Package

If you have specified an existing SysMLSimConfiguration Artifact, this field defaults to the Package containing the SysML model associated with that Artifact.

Otherwise, click on the icon and browse for and select the Package containing the SysML model to configure for simulation. You must specify (or create) the Artifact before selecting the Package.

Package Objects

This table discusses the types of object from the SysML model that will be listed under the 'Name' column in the Configure SysML Simulation window, to be processed in the simulation. Each object type expands to list the named objects of that type, and the properties of each object that require configuration in the 'Value' column.

Many levels of the object types, names and properties do not require configuration, so the corresponding 'Value' field does not accept input. Where input is appropriate and accepted, a drop-down arrow displays at the right end of the field; when you click on this a short list of possible values displays for selection. Certain values (such as 'SimVariable' for a Part) add further layers of parameters and properties, where you click on the button to, again, select and set values for the parameters. For datasets, the input dialog allows you to type in or import values, such as initial or default values; see the Model Analysis using Datasets topic.

Element Type

Behavior

See also

ValueType

ValueType elements either generalize from a primitive type or are substituted by SysMLSimReal for simulation.

Block

Block elements mapped to SysMLSimClass or SysMLSimModel elements support the creation of data sets. If you have defined multiple data sets in a SysMLSimClass (which can be generalized), you must identify one of them as the default (using the context menu option 'Set as Default Dataset').

As a SysMLSimModel is a possible top level element for a simulation, and will not be generalized, if you have defined multiple datasets the dataset to use is chosen during the simulation.

Properties

Properties within a Block can be configured to be either SimConstants or SimVariables. For a SimVariable, you configure these attributes:

  • isContinuous - determines whether the property value varies continuously ('True', the default) or discretely ('False')
  • isConserved - determines whether values of the property are conserved ('True') or not ('False', the default); when modeling for physical interaction, the interactions include exchanges of conserved physical substances such as electrical current, force or fluid flow
  • changeCycle - specifies the time interval at which a discrete property value changes; the default value is '0'
         -  changeCycle can be set to a value other than 0 only when isContinuous = 'False'
         -  The value of changeCycle must be positive or equal to 0

Port

No configuration required.

SimFunction

Functions are created as operations in Blocks or Constraint Blocks, stereotyped as 'SimFunction'.

No configuration is required in the Configure SysML Simulation window.

Generalization

No configuration required.

Binding Connector

Binds a property to a parameter of a constraint property.

No configuration required.

Connector

Connects two Ports.

No configuration required in the Configure SysML Simulation window. However, you might have to configure the properties of the Port's type by determining whether the attribute isConserved should be set as 'False' (for potential properties, so that equality coupling is established) or 'True' (for flow/conserved properties, so that sum-to-zero coupling is established).

Constraint Block

No configuration required.

Simulation Tab

This table describes the fields of the 'Simulation' tab on the Configure SysML Simulation window.

Field

Meaning

See also

Model

Click on the drop-down arrow and select the top level node (a SysMLSimModel element) for the simulation. The list is populated with the names of the Blocks defined as top-level, model nodes.

Creating a Parametric Model

Data Set

Click on the drop-down arrow and select the dataset for the selected model.

Model Analysis using Datasets

Start

Type in the initial wait time before which the simulation is started, in seconds (default value is 0).

Stop

Type in the number of seconds for which the simulation will execute.

Format

Click on the drop-down arrow and select either 'plt', 'csv' or 'mat' as the format of the result file, which could potentially be used by other tools.

Parametric Plot

  • Select this checkbox to plot Legend A on the y-axis against Legend B on the x-axis.
  • Deselect the checkbox to plot Legend(s) on the y-axis against time on the x-axis

Note: With the checkbox selected, you must select two properties to plot.

Dependencies

Lists the types that must be generated to simulate this model.

Properties to Plot

Provides a list of variable properties that are involved with the simulation. Select the checkbox against each property to plot.