Via File → Options in the Backstage area, you get access to all sorts of general settings for SimulationX. During the installation of SimulationX, these options are set to default values which can be changed at any time.


Figure 1: General Settings

Start of the Programm

This section holds various options for the program start including the default action when SimulationX is started:

  • Create New Model
  • Open Recently Used Model
  • No Model at Startup


If you want to use visualizers, Modelica graphic primitives or state charts during a simulation, the setting "Enable Diagram View Animation during Simulation" must be activated. This may increase computation time. The option "Synchronize Animation during Simulation" ensures that a certain frame rate is maintained. Otherwise the animation may not be visible with fast computing models.

Warnings and Errors

Through the "Add ..." button, you can define how SimulationX behaves in case of warnings or errors. In addition to the presets, you can also set up custom evaluations.


Figure 2: Settings for displaying warnings and errors

Help and example models

The settings here determine whether the locally installed resources or their online versions should be used.


Figure 3: Directory settings

In this section, you can change the directories which are created by SimulationX during the installation. If you want to deactivate an existing path only temporarily, it is not necessary to delete this path. Instead, it suffices to add an underscore as the first character of the string. Categories which allow for multiple entries include the following buttons:

Add a new directory

Delete the selected directory

Move the selected directory up or down in the list

Import External Types (libraries which were created with an earlier version of Simulation and were saved under External Types)


Figure 4: Selection of libraries

The section Libraries gives an overview of all available model libraries. You can specify which libraries are loaded when SimulationX is started and whether excluded libraries should be loaded automatically when a model requires them. The table shows the version and directory as well as the current status of the libraries (Load at start, existing license, currently loaded). An overview of all shown states is available by clicking on the Legend button. By excluding individual libraries from being loaded when SimulationX is started, storage space is saved and the program starts up faster. When you open a model with a missing reference at a later point, the corresponding library is loaded automatically provided that the related file and a valid license exist.


Figure 5: Setting of protocol storing location

So far, all data, which was recorded during a simulation run, has been stored in memory. This data can optionally be stored in the file system too. Current hard disk technology and intelligent buffering permit almost equivalent access performance compared to storage in memory. The option can be turned on and off via the menu "File""Options""Storing". You can also select the standard file format for storing (*.ism or *.isx). When the option 'Store Modelica Conform' is selected, models are stored as *. mo files without results and without inclusion of the SimulationX calculation environment. Storing calculated models with results may occasionally lead to large files on the hard disk. This can be avoided selecting the option "Store without Results by default".

The AutoRecover allows protecting your work against power failures or other unwanted program terminations. If the feature is activated, temporary copies of modified models are stored in the specified regular intervals of 5 min (default setting) or longer. With the AutoRecover feature turned on, on the next SimulationX launch after an abnormal termination the models affected are displayed in a recovery dialog. From there they can be restored and saved (cf. Dialog for Recovery of Files ).

Figure 6: Dialog for Recovery of Files

The information in the files reflects the state at the last auto-save. AutoRecover does not replace the manual saving or backing up of your files! If using SVN the storage of backup copies of modified types is not desirable, the creation of backup files can be deactivated by the option "Store backup for models and types".


Figure 7: Modelica Settings in this Register the appearance of the text editor is specified

To perform a transient simulation it is necessary to add the SimulationX calculation environment.


Figure 8: Settings of the Text Editor

Also a special text editor (e.g. Notepad++) for working on the text view can be adjusted by setting a file path.

3D View

Figure 9: 3D view

  • Preferred driver: Here the preferred 3D driver can be selected. The default setting 'Auto' should only be changed when problems occur with the 3D graphics.
  • Camera controls: Defines, which mouse button controls the 3D camera.
    • Middle Mouse Button (Default): 3D Camera is controlled using the middle mouse button.
    • Right Mouse Button: 3D Camera is controlled using the right mouse button.
  • View Alignment: Changes the behavior of the camera align buttons in the toolbar, i.e. which axis should be aligned with the screen axes. By default, the z-axis points up, according to the default value of gravity3D ({0, 0, -gravity}).
    • SimulationX (Default): z-axis points up, y-axis away from the user.
    • StandardX: x-axis points up, y-axis to the user.
    • StandardY: y-axis points up, z-axis to the user.
    • StandardZ: z-axis points up, x-axis to the user.
    • Cyclic: the up axis is changed cyclic.
  • Allow animation during the simulation: Disables the refresh rate of the 3D view during a simulation in order to reduce computation time.
  • Resolution (DPI): Controls the resolution of the exported image. That is, the output is scaled to match the DPI setting. A DPI setting of 96 roughly matches the screen size.
  • White background If enabled, settings for the 3D view’s background are ignored showing a white background instead.


Figure 10: Dialog Fluids

Dialog Fluids shows the available settings for the Fluid selection. For more information see section "FluidDesigner".


Figure 11: Miscellaneous settings in SimulationX

On this tab, the label of the elements as they are shown in the model can be set. Customization of element labels and connection labels is described in section "Labeling of Elements and Connections". Auto-routing for connections can be deactivated/activated, and the workspace of the Diagram View can be changed as required (permitted values: 1000 to 20000). Additional settings for the Model Explorer are also available here. To save the changes to the model, select the corresponding checkbox.


Figure 12: Settings of the connections

Connections can graphically represent their state during the simulation. The default behavior for individual connection types, e.g. Mechanical connection (linear), you can specify on this dialog page. These settings are stored globally and thus apply to all models, as long as no local settings for individual connections were made in the model.

Regional Settings

Figure 13: Regional Settings


This section allows you to change the language in SimulationX. Select a language from the dropdown menu and confirm your selection. The changes are then applied immediately.

System of Units

The following list explains all measurement unit settings available in SimulationX.

SIThe International System of Units or SI is the most widely used system of units for physical quantities. SI is a metric system of units (i.e. a base unit is the meter), which is decimal (i.e. the fractions or multiples of the individual base units differ only by powers of ten) and represents a coherent system of units (i.e. each derived unit is a product of powers of the base units without additional numerical factors).
FPSThe Anglo-American system of measurement exists in several variants and is based on Foot, Pound and Second.
CGSThe CGS system of units is a coherent metric system of units based on the units centimeter, gram and second.

Privacy & Security

Legal Information

With your consent, the information collected during the use of this software is processed electronically for the purpose of analyzing how the software is used and how to avoid crashes. The information collected is intended exclusively for the ESI Group's IT department, engineers and other group employees involved in this process. The data is anonymized and processed on an ESI-hosted server. In accordance with the applicable regulations, you have the right to withdraw your consent. To exercise your rights, please contact the ESI Group's data protection team at the following e-mail address: dataprotection@esi-group.com and the IT team. In the event of a dispute, you have the right to refer the matter to the competent administrative authority. To learn more about our data protection policy, click here.

Abbildung 14: Privacy & Security

Diagnostics and Usage Data

Allow SimulationX to send general software statistics and usage data to ESI anonymously in order to help improve the software. This data is collected in the background and is sent automatically when you close SimulationX.Read more.

Automatic Crash Reports

Allow SimulationX to send automatic crash reports to ESI to help improve the software. Before a crash report is sent, you need to confirm it.Read more.


Figure 15: Maintenance settings

Checking for Updates

Specify if and when SimulationX should check for updates. This feature requires SimulationX to have access to the internet. Before you install any update, we recommend you read the Release Notes first.


Customize your SimulationX installation (e.g. add new libraries) or reset the dialog settings you made for non-licensed or missing features (FEM Import, CAD Import, Order Analysis).


Here you can install additional Add-Ins offering special modeling functionalities.