WOLFRAM SYSTEMMODELER TUTORIAL

Installation and Setup

Installation and Setup | Introduction | Multidomain | Components | Custom Components | Hello World | External Functions | Hierarchical Models | Systems

Supported Platforms

Wolfram SystemModeler is available on the platforms listed below.

  • Windows
  • Mac
  • Linux

Note that there are some minor differences between the Windows version, described in this manual, and the Mac and Linux versions.

Keyboard keys: in general, the Ctrl key is mapped to the Command key on Mac, also known as the Apple key, on Macintosh keyboards.

Menus: the locations of the Options and About SystemModeler menu items follow the guidelines for Mac and are found in the SystemModeler menu. The Options menu item is called Preferences on Mac.

Installing SystemModeler

This section contains information on how to install SystemModeler on the supported platforms as well as any prerequisites.

Windows

Run the executable file for SystemModeler you received. This will start the SystemModeler installation wizard. Follow the instructions in the wizard to complete the installation.

Mac

SystemModeler requires Apple's Xcode to be installed. Xcode is available at the Mac App Store.

Mount the disk image you received for SystemModeler. To install SystemModeler, drag and drop the SystemModeler icon into the Applications folder. This completes the installation of SystemModeler.

Linux

Run the executable file for SystemModeler you received. This will start the SystemModeler installation. Follow the instructions in the prompts to complete the installation.

C/C++ Compiler Settings

To use SystemModeler, a C/C++ compiler is needed. Normally SystemModeler will auto detect available compilers and select one; if a different compiler is desired or if the compiler is not auto detected, the compiler settings need to be changed.

To change the compiler settings, open the Options dialog box by choosing Tools Options. The compiler settings are available in the Compiler view. Select the desired compiler from the list of auto-detected compilers or select "custom" if the desired compiler is not auto detected. When configuring a custom compiler, specify the desired compiler type: MinGW, Microsoft Visual C++, G++, or Clang++. The supported compilers depend on your operating system; see the section on supported compilers. Additionally, the following need to be specified:

  • For Microsoft Visual C++, specify version of Visual Studio as well as the location of vcvarsall.bat/VsDevCmd.bat and the arguments to the setup script.
  • For GCC/G++, specify the full path to the g++ executable.
  • For Clang++, specify the full path to the clang++ executable.
  • When using clang++ from Xcode without installing the command-line tools, it is also necessary to specify the path to the platform SDK. The platform SDKs are usually located in /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs.

It is possible to verify that the new compiler settings are working by clicking the Verify button. This will test the compiler settings by building a small test model.

On Windows, SystemModeler may be able to download and install a compiler for you. To check online if there are any compilers available for assisted download and installation, click the Check for Compiler button.

1.gif

The Compiler view in the Options dialog box.

Supported Compilers

Windows

On Windows, SystemModeler has been fully tested with and supports the following compilers:

  • Microsoft Visual C++ 2012 (including the free Express edition).
  • Microsoft Visual C++ 2013 (including the free Express edition).
  • Microsoft Visual C++ 2015 (including the free Express edition).
  • Microsoft Visual C++ 2017 (including the free Visual C++ Build Tools edition).

Mac

On Mac, SystemModeler has been fully tested with Clang from Xcode version 6.2. It is likely that SystemModeler will work with any C++ compiler that is compatible with that version, i.e. any Clang from Xcode >= 6.2 from Apple Inc.

Linux

On Linux, SystemModeler has been fully tested with GCC/G++ 4.4 (32-bit and 64-bit). It is likely that SystemModeler will work with any C++ compiler that is compatible with that version, i.e. any GCC/G++ >= 4.4.

Configuring Wolfram Language Functionality

Wolfram SystemModeler provides functionality that makes it easy to interact with it from the Wolfram Language. When you start SystemModeler for the first time, it will automatically make this functionality available in Mathematica, if Mathematica is installed on the computer.

To configure the Wolfram Language functionality for a specific version of SystemModeler, it is possible to force a configuration. To do so, go to Tools Options in the SystemModeler menu. Then select Mathematica on the left side, under Global. Click Configure SystemModeler Link. For the configuration to succeed, Mathematica cannot be running, so be sure to close it when configuring.

Localization

By default, SystemModeler will use the system default UI-language, with a fallback to English if a translation does not exist for that language. To manually configure the UI-language and override the system settings, go to Tools Options and select General on the left side, under Global. Select the desired language from the Language list, press OK, and restart SystemModeler.

Next Chapter

Get Started with SystemModeler »

Installation and Setup | Introduction | Multidomain | Components | Custom Components | Hello World | External Functions | Hierarchical Models | Systems