Differences between revisions 16 and 17
Revision 16 as of 2011-03-08 16:28:25
Size: 2705
Editor: root
Revision 17 as of 2011-03-08 16:31:59
Size: 2898
Editor: root
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== EMEN2 ==
=== Thursday PM Practical ===
= EMEN2 =
== Thursday PM Practical ==
Line 7: Line 7:
=== Installing EMEN2 === == Installing EMEN2 ==
Line 23: Line 23:
If you are using Mac OS X 10.5 or earlier you will need to install a more current Python environment and install the EMEN2 [[EMEN2/Dependencies|dependencies]] and [[EMEN2/Install|source install]].
Line 25: Line 27:
 {{{ {{{
Line 29: Line 31:
Line 30: Line 33:
Line 46: Line 50:
=== EMEN2 Tutorial Data === == EMEN2 Tutorial Data ==
Line 61: Line 65:
=== Running EMEN2 === == Running EMEN2 ==


Thursday PM Practical

EMEN2 is a web-based electronic notebook and object oriented database. While it has so-far been used primarily for cyro-EM, it is completely flexible and can easily be adapted to other disciplines. We are gradually building connectivity between EMEN2 and EMAN2, as will be demonstrated.

Installing EMEN2

EMAN2 provides cryo-EM specific support for EMEN2, so it is recommended to install both systems into the same Python environment. The easiest way to do this is to use the EMAN2 binary release, as we have also included all additional EMEN2 dependencies in this package.

On Linux, assuming EMAN2 is installed in your home directory:

~/EMAN2/Python/bin/python ~/EMAN2/Python/bin/easy-install emen2

On Mac OS X 10.6, we are using the Apple-provided Python:

sudo easy_install emen2

If you are using Mac OS X 10.5 or earlier you will need to install a more current Python environment and install the EMEN2 dependencies and source install.

The procedure on Windows is similar; open the command prompt and run the EMAN2 Python,

C:\EMAN2\Python\Scripts\easy-install emen2

If you compiled EMAN2 from source, rather than using our binary, you will need to:

  • Install
    • Berkeley DB
    • bsddb3
    • Twisted
    • Mako Templates
    • Markdown
    • Matplotlib (optional, for plots)
    • PyQt4 (optional, for the EMDash GUI)

  • Download and install EMEN2
  • If you want to take advantage of some cryo-EM specific features, such as viewing MRC/DM3 images in your web browser, you will need to either install EMEN2 and EMAN2 into the same environment, or perform some careful configuration.

Additional information on dependencies and installation information:

EMEN2 Tutorial Data

I have prepared a tutorial environment based on some of our published data:


Note: this is just the metadata -- including the raw micrographs would have made this file hundreds of gigabytes.

Untar the file:

tar -xvzf emen2-demo.tar.gz
cd emen2-demo

Running EMEN2

In this tutorial, we will use ~/testdb as our EMEN2 database environment

This command will initialize the database and import the data for the workshop tutorial.

cd emen2-demo
python -m emen2.db.load -h ~/testdb

This will prompt you to supply a root password for the database, and an administrator email for notifications and password recovery. You can leave both as the default (just hit enter) for the tutorial.

You can start the EMEN2 web server:

python -m emen2.web.server -h $HOME/test_db

...and connect with your web browser at http://localhost:8080

Ws2011/Emen2 (last edited 2011-03-12 21:54:54 by root)