EMEN2 Dependencies

For basic client usage, no dependencies are required beyond the basic Python environment; the GUI clients require PyQt4. See EMEN2/EMDash for more information.

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 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 or 2.7
  • Note: do not use Python 3.0+

  • http://www.python.org

Core Database

• Berkeley DB 5.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.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"
• dateutil
  • A library for accurate manipulation of dates and times

  • http://labix.org/python-dateutil

  • "easy_install dateutil"

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 (highly recommended)
  • EMAN2 is optionally used to generate browsable micrograph previews.

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

• ImageMagick (recommended)

  • Thumbnail and document preview support for "normal" image formats (jpg, png, etc.)
  • Commonly installed on Linux

  • http://www.imagemagick.org/

• pyOpenSSL
  • Network encryption
  • "easy_install pyOpenSSL"