Morpheus 2.4.0

Thu, 01 May 2025 12:00:00 +0200

We announce Morpheus 2.4.0 to be immediately available.

The new release caters a gradually improved MorpheusML version and fixes:

Diffusion rates are now specified in the respective differential equation.
Configuration options of motility components were unified, as agreed upon in the OpenVT standardisation project.
Directed Motion now knows a oriented mode, providing nematic alignment to the given direction.
Skewness, kurtosis and median have been added as new scalar statistics. Older models created former Morpheus versions will be automaticall converted by both, the GUI and the CLI. Note: Conversion back to former version will be added in a future release.

Furthermore, the GUI learned better dark mode support, the random seed can be overridden from command line, and noise scaling in the stochastic solver was fixed.

Note: The GUI temporarily falls back to minimal layout rendering in the documentation panel due to a regression in homebrew’s Qt5 support and full graphics support for the in-app documentation will be restored in a future release.

For a detailed list of all changes, please visit the corresponding changelog.

Downloads

Table of Contents

Linux

APT Package Manager

Download the appropriate package for your distribution:

Ubuntu:
Debian:
- Debian 12 ‘Bookworm’
- Debian 13 ‘Trixie’
Static:
- Static Linux binary (simulator w/o GUI)

Use APT to install with dependencies:

sudo apt install ./morpheus_2.4.0.deb

Use Alien to convert to non-debian packages.

Build from Source

Run the following commands to build Morpheus from source:

git clone https://gitlab.com/morpheus.lab/morpheus.git morpheus
cd morpheus
mkdir build
cd build
cmake ..
make && sudo make install

For dependencies and further build instructions, see the README.md in our GitLab repository.

macOS

Homebrew Package Manager

Morpheus is available for macOS 12 ‘Monterey’ and above via Homebrew.

Install

Install Homebrew.
Install Morpheus and the Gnuplot runtime dependency from the Homebrew Core Tap by pasting the following line in a macOS Terminal:
```
brew install morpheus gnuplot
```
Start the Morpheus GUI with the command:
```
morpheus-gui
```
Recommended: To access Morpheus conveniently from your Mac’s ‘Applications’ folder, add a Morpheus.app shortcut by typing:
```
ln -sf $(brew --prefix)/opt/morpheus/Morpheus.app /Applications
```

Detailed instructions and other available Homebrew installation options are provided in the FAQ section.

Please note that the current version has the SBML import feature disabled by default, as we’re currently experiencing problems with some macOS SDKs failing to build libSBML.

If you need SBML support on macOS, you can add the --with-sbml option in the brew install step (see above) which will build Morpheus including libSBML if your machine is not experiencing the macOS SDK issue. For this, you will also need to add our own morpheus Homebrew Tap as shown below (see the FAQ for more information on Taps):

brew tap morpheus-lab/morpheus
brew install morpheus-lab/morpheus/morpheus --with-sbml

If you currently have Morpheus installed via Homebrew and want to upgrade to a newer version of Morpheus with SBML import, please temporarily remove Morpheus with brew uninstall morpheus first (all simulation results already on your system will be preserved), as it’s not possible to pass the --with-sbml install option along with brew upgrade morpheus (see below), and proceed with the brew install command shown here.

Upgrade

If you have already installed Morpheus with Homebrew in the past, simply upgrade to the latest version with:

brew upgrade morpheus

Build from Source

Run the following commands to build Morpheus from source:

git clone https://gitlab.com/morpheus.lab/morpheus.git morpheus
cd morpheus
mkdir build
cd build
cmake ..
make && sudo make install

For dependencies and further build instructions, see the README.md in our GitLab repository.

Windows

Windows Installer

On Windows, Morpheus is made available through a Windows installer:

64-bit Intel/AMD:
- Morpheus-2.4.0.exe

If you get the message ‘Windows protected your PC’ and Microsoft Defender SmartScreen is preventing the Morpheus installer from starting as an ‘unrecognized app’, click ‘More info’ and then ‘Run anyway’ and you’re good to go.

Please note that Morpheus for Windows is currently not supported on ARM-based systems.

macOS 26 ‘Tahoe’ | Morpheus

Morpheus 2.4.0

Downloads

Linux

APT Package Manager

Build from Source

macOS

Homebrew Package Manager

Install

Upgrade

Build from Source

Windows

Windows Installer