Installing Ready-Made Packages

Windows

  • Download the latest 64bit openEMS_win

  • Unzip to a folder of your choice e.g. C:/ (zip contains an openEMS folder)

Setup the Octave/Matlab or Python Interfaces

Check Installation

After completing installation, now it’s a good test to verify that the installation is functional according to Check Installation.

FreeBSD

  • Sync FreeBSD Ports tree.

Then:

cd /usr/ports/science/openems
make

Setup the Octave/Matlab or Python Interfaces

Unfortunately, currently Python modules are not automatically installed, they need manual installation.

Check Installation

After completing installation, now it’s a good test to verify that the installation is functional according to Check Installation.

macOS

  • Install Homebrew

  • Tap the openEMS-Project repository and build from source

brew tap thliebig/openems https://github.com/thliebig/openEMS-Project.git
brew install --HEAD openems

Setup Octave/Matlab Interfaces

  • Optional: Install Octave

brew install octave

  • Optional: Add openEMS Matlab files to your Octave/Matlab environment

echo "addpath('$(brew --prefix)/share/openEMS/matlab:$(brew --prefix)/share/CSXCAD/matlab');" >> ~/.octaverc

Setup Python Interfaces

  • Optional: Build Python libraries.

Unfortunately, currently Python modules are not automatically installed, they need manual installation.

First, install the needed dependencies…

pip3 install cython numpy h5py matplotlib --user

Next, go to Homebrew’s cache directory that contains the previously cloned git code:

cd ~/Library/Caches/Homebrew/openems--git/

  1. Build CSXCAD’s Python extension.

cd CSXCAD
cd python
pip3 install . --user

cd ..

  1. Build openEMS’s Python extension:

cd openEMS
cd python
pip3 install . --user

cd ..

Check Installation

After completing installation, now it’s a good test to verify that the installation is functional according to Check Installation.

Troubleshooting

If you see the error:

Couldn't find index page for 'CSXCAD' (maybe misspelled?)
Scanning index of all packages (this may take a while)
Reading https://pypi.org/simple/
No local packages or working download links found for CSXCAD==0.6.2
error: Could not find suitable distribution for Requirement.parse('CSXCAD==0.6.2')

Do NOT use python3 setup.py to install openEMS, it may trigger this bug, seemingly related to search path. Use pip3 install . –user.

Updating

brew upgrade --fetch-HEAD openems

If Python modules are used, they need to be reinstalled (in case that a module has been updated).