Installation

1. Get an EMode License

  • Create an EMode account, and verify your account via the confirmation email.

  • Purchase a subscription license through the EMode store. This is required, even for a free EMode2D license.

2. Setup the Python Interface

  • See the Python Interface page for instructions to install Python.

  • Follow the Setup instructions to install the emodeconnection package.

3. Download and Install EMode

System requirements: 840 MB free disk space

  • Windows 10 or higher

  • Linux, Ubuntu 22.04 or higher, x86-64

  • macOS 13 Ventura or higher

There are two installation methods:

The emode-install command-line tool is included with the emodeconnection Python package. It handles downloading, installing, and updating EMode. After installing emodeconnection via pip, you can run the installer. You will be prompted to accept the EMode EULA and log in with your EMode account credentials. For additional options, see the EMode Install instructions or run emode-install --help.

emode-install

  1. Login to your EMode account.

  2. Select your operating system and version from the dropdown menus.

  3. Accept the EMode End User License Agreement.

  4. Click Download EMode to download the file for your platform.

Windows

Unzip the downloaded .zip file and double-click the installer (.exe). Follow the on-screen prompts to complete installation. EMode will be added to your PATH automatically.

macOS

Double-click the downloaded .pkg file and follow the installer prompts. Administrator access may be required. EMode will be installed to /usr/local/bin/emode.

Linux

Unzip the downloaded .zip file and run the install.sh script:

unzip EMode-VERSION-Linux.zip
sh install.sh

Tip

On macOS with Apple silicon, EMode runs via Rosetta 2, which you may be prompted to install on the first run.

4. Run an EMode Example Script

  • Copy and run the Basic: SOI example in your scripting environment.

  • A login window will open when EMode is first initialized. To subsequently access this window, see EMode Login.

If you have any issues, please contact our support team.