Installation¶
Install Python 3.6¶
There are many ways to get Python on your system.
- On Mac, Homebrew is a great way to install Python.
- If you just want a clean Python install and nothing else, installers from python.org work great too.
- If you prefer the complete “batteries included” option, Anaconda Python is available for Mac, Windows or Linux.
cadnano will run on Python 3.5 and 3.6, but we only support 3.6. We do not support Python 2.X.
Install cadnano¶
Using python 3.6 pip will install cadnano and all dependencies from PyPi
$ pip3 install cadnano
or from a root of a cloned cadnano2.5 <https://github.com/cadnano/cadnano2.5> repository:
$ python setup.py install
Both of these methods will install key dependencies like:
- PyQt5>=5.8.2 <https://pypi.python.org/pypi/PyQt5/5.8>
- numpy>=1.10.0 <https://pypi.python.org/pypi/numpy/1.11.2>
- pandas>=0.18 <https://pypi.python.org/pypi/pandas/0.19.0>
- pytz>=2011k <https://pypi.python.org/pypi/pytz/2016.7>
- python-dateutil>=2 <https://pypi.python.org/pypi/python-dateutil/2.5.3>
After pip or setup.py installation you can install Windows start menu shortcuts or a MacOS Application of cadanno by running at the commandline:
$ cadnanoinstall
Allowing you to click on the application icon to launch cadnano. otherwise just run at the command line:
$ cadnano
to launch.
Advanced: Building from scratch¶
Should the above not work for you:
- Let us know
- The requirements
PyQt5
andSIP
are available from Riverbank Computing Limited at:
Windows¶
Instructions to come.
Mac and Linux¶
These instructions can work 10.10 Yosemite and 10.11 El Capitan under Xcode 7.0.1 and 6.5. It has also been tested on Debian 7.9 Wheezy Please provide feedback if you have problems running this in issues.
You can run the included getpyqt5.py
which will grab, build and
install Qt5
, SIP
and PyQt5
in your python environment. It is
cleanest using virtualenv
and virtualenvwrapper
creating a
virtualenv with:
mkvirtualenv --always-copy <myvenv>
python pyqttools/install_pyqt_from_src.py
and then running the script, but you can definitely install in your system python if you run:
sudo python pyqttools/install_pyqt_from_src.py
This script only builds required parts of Qt5
and PyQt5
.
Manual installation of PyQt5
is fine too, but you’ll need to troubleshoot on your own.
- Install
Qt5
. download the online installer - Build sip and PyQt5 against this
Qt5
Of course there are many ways to accomplish this feat, but needless to
say OS X and Linux installs of PyQt5
can be painful for some people.