Installation¶
Snap¶
Installation¶
The easiest way to get Mesmerize is through the Snap Store
Command line snap installation:
sudo snap install mesmerize
Launch¶
After installation simply run mesmerize
in the terminal and the application will launch in ~10-30 seconds. Make sure your PYTHONPATH environment variable is empty otherwise it might conflict with the snap.:
export PYTHONPATH=
You can also open an ipython console in the snap environment:
mesmerize.ipython
Note
You might get the following warnings when you launch the snap, this is normal. Just be patient and wait a few minutes:
Requirements¶
Make sure you have snapd
installed, which is required for running snap apps.
Ubuntu 16.04 and later usually come pre-installed with snapd.
You should be able to install snapd
through apt for most Debian based distros:
sudo apt update
sudo apt install snapd
Installing snapd
on Fedora:
sudo dnf install snapd
To install snapd
on other distros please see: https://docs.snapcraft.io/installing-snapd
If you have trouble installing Mesmerize via snap you might need to install core18 first:
sudo snap install core18
Limitations¶
The snap installation has several limitations, most importantly you will not be able to access arbitrary filesystems. If you need this you will have to install directly from the repo (see From GitHub). If you are able to mount your external filesystem in /media (or wherever your distro places removeable media) then you should be able to access these filesystems if you do the following:
sudo snap connect mesmerize:removable-media
Alternatively you can install the snap in devmode (gives that snap broad access to the system):
sudo snap install mesmerize --devmode
Warning
Analysis graphs do not work in the snap version at the moment.
From GitHub¶
Easy¶
This installation method should work on Linux and Mac.
First, make sure you have compilers & python.
For Debian & Ubuntu based distros
Get build tools and other things:
sudo apt-get install build-essentialFor other distros look for the equivalent meta-package that contains gcc, glibc, etc.
If you don’t have python3.6:
sudo apt-get install python3.6For other distros lookup how to install python3.6 through their package manager.
Install dependencies:
sudo apt-get install qt5-default tcl graphviz gitFor other distros these packages probably have the same or similar names.
For Mac OSX
Install Xcode:
xcode-select --installThis might take a while.
Install brew:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"Install python 3.6.5:
brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/f2a764ef944b1080be64bd88dca9a1d80130c558/Formula/python.rb
Install Mesmerize
Create a virtual environment:
# Choose a path to house the virtual environment python3.6 -m venv /path/to/venv
Activate the virtual environment:
source /path/to/venv/bin/activate
Clone the repo:
git clone https://github.com/kushalkolar/MESmerize.git
cd & switch to the snap branch:
cd MESmerize git checkout snap
Install some build dependencies:
pip install Cython numpy python-dateutil
Install remaining dependencies:
pip install -r requirements.txt
Build some things:
python setup.py build_ext -i
Add to PYTHONPATH environment variable:
export PYTHONPATH=$PWD:$PYTHONPATH
You will always need to add the path to MESmerize to the PYTHONPATH environment varible before launching.
Launch:
python ./mesmerize