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. Set Up the Python Interface

Follow the Python Interface instructions to install Python and the emodeconnection package.

3. Download and Install EMode

System requirements: Windows 10+, Linux Ubuntu 22.04+ (x86-64), macOS 13 Ventura+

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. Log in 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

macOS Apple silicon: EMode runs via Rosetta 2 and you may be prompted to install it on the first run.

4. Run an EMode Example Script

  • Run the Basic: SOI example in Python to verify your installation.

  • 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.