With Homebrew on OSX¶
Homebrew is a package manager for Mac OS X (macOS). It can be installed in OSX with a single Ruby command:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Note
Homebrew requires XCode and the command line tools to be installed.
Installing MORSE¶
Download Blender and copy the apps to
/Applications
. Blender is not currently available as a recipe in Homebrew.Note
MORSE_BLENDER
should be added to your .bashrc file and must point to the actual executable, not to the app directory, e.g.:MORSE_BLENDER=/Applications/Blender.app/Contents/MacOS/blender
Check which version of Python is used by Blender. This can be done in a console,
echo 'import sys; print("VERSION %s" % sys.version.split()[0]); sys.exit(0)' > /tmp/version.py ${MORSE_BLENDER} -y -P /tmp/version.py 2>&1 | grep VERSION
Once you get the version used by Blender, grab the exact same version from the python website <http://www.python.org> and install it.
Install MORSE using Homebrew:
brew tap morse-simulator/morse brew install morse-simulator
Note
If you have multiples version of Python 3 installed in /usr/local/bin
,
please specify the right one with --with-python=/usr/local/bin/python3.x.y
.
Formula Options¶
The default the Homebrew formula configures and installs MORSE with support for only the sockets middleware. The following formula options are available to enable support for other middlewares:
--with-ros
--with-moos
--with-pocolibs
--with-yarp2
Additionally, generating documentation and HLA support can be enabled with the following flags:
--with-doc
--with-hla
Pymorse bindings can be enabled with the flag:
--with-pymorse
E.g. to install MORSE with generated documentation and support for ROS:
brew install morse-simulator --with-doc --with-ros
Updating¶
To update to the latest version of MORSE after installation:
brew update
brew install --upgrade morse-simulator
ROS Installation¶
ROS for OSX can be installed from source using Homebrew with the instructions.
Once installed, ROS should work out-of-the-box in MORSE.