EMEN2 Dependencies

For basic client usage, no dependencies are required beyond the basic Python environment; the GUI clients require PyQt4.

On the database server side, Berkeley DB and bsddb3 are required for basic functionality. If you want to run the web server, you will also need Twisted, Markdown, and Mako. Additional server features, such as thumbnails and plotting, are provided by EMAN2, matplotlib, and ImageMagick.

Please note that we include all EMEN2 dependencies in the EMAN2 binary distribution's Python environment. This is the recommended installation, and generally how we run it ourselves.

Python Environment

• Python 2.6+
  • Note: do not use Python 3.0+

  • http://www.python.org

Core Database

• Berkeley DB 5.0.x
  • BDB is the storage and transactional backend for EMEN2
  • Note: Relatively recent 4.8.2x release are probably OK as well

  • http://www.oracle.com/technology/software/products/berkeley-db/index.html

• bsddb3 5.0.x
  • Python bindings for Berkeley DB
  • Note: Relatively recent 4.8.2x release are probably OK as well

  • http://www.jcea.es/programacion/pybsddb.htm

  • "easy_install bsddb3"

Web Server

• Mako Templates (latest)
  • A simple, fast templating system for Python

  • http://www.makotemplates.org/

  • "easy_install mako"
• Twisted 10.x+
  • An event-driven networking engine written in Python

  • http://twistedmatrix.com/trac/

  • "easy_install twisted"
• Markdown
  • Simplified rich-text editing
  • "easy_install Markdown"

Web Server: Optional

• EMAN2 (recommended)
  • EMAN2 is optionally used to generate browsable micrograph previews.

  • http://ncmi.bcm.edu/ncmi/software/counter_222/software_86

• Matplotlib (recommended)
  • Plotting support
  • Note: commonly installed with EMAN2
  • "easy_install matplotlib"

• ImageMagick (recommended)

  • Thumbnail and document preview support
  • Commonly installed on Linux

  • http://www.imagemagick.org/

• pyOpenSSL
  • Network encryption
  • "easy_install pyOpenSSL"

GUI Client

• PyQt4

  • Python bindings for Nokia's Qt toolkit
  • You will want to install this as a binary, unless you are a masochist.
  • On Windows, there is a simple to use binary installer.
  • Like matplotlib, this is commonly included in EMAN2 binary packages (useful on Mac OS X)

  • http://www.riverbankcomputing.co.uk/software/pyqt/download