|
Size: 1864
Comment:
|
Size: 2705
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| EMEN2 is a comprehensive database and electronic notebook with a primary focus on TEM data. More generally it is a broad-purpose object oriented database which can be applied to a wide range of different problems. |
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. |
| Line 10: | Line 9: |
| If you are using the EMAN2 binaries, the simplest way to install EMEN2 is to install it into that Python environment, as it already has several of the dependencies installed. | 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. |
| Line 12: | Line 11: |
| You will need to use the "easy_install" script provided by that environment. On Linux, it will be "...." On Mac OS X, it will be the system default "easy_install" script. First, install the remaining EMEN2 dependencies: |
On Linux, assuming EMAN2 is installed in your home directory: |
| Line 17: | Line 14: |
| sudo easy_install mako sudo easy_install twisted sudo easy_install Markdown |
~/EMAN2/Python/bin/python ~/EMAN2/Python/bin/easy-install emen2 |
| Line 22: | Line 17: |
| Then install EMEN2 itself: | On Mac OS X 10.6, we are using the Apple-provided Python: |
| Line 28: | Line 23: |
| If you are not using one of our EMEN2 binaries, you will need to take care of installing Berkeley DB, bsddb3, and Matplotlib (optional) yourself. If you want to take advantage of some cryo-EM specific features, such as viewing MRC/DM3 images in your web browser, it is easiest if EMEN2 and EMAN2 can be loaded into the same Python environment. | 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. |
| Line 31: | Line 42: |
| http://blake.bcm.edu/emanwiki/EMEN2/Dependencies http://blake.bcm.edu/emanwiki/EMEN2/Install |
* http://blake.bcm.edu/emanwiki/EMEN2/Dependencies * http://blake.bcm.edu/emanwiki/EMEN2/Install |
| Line 34: | Line 45: |
=== EMEN2 Tutorial Data === I have prepared a tutorial environment based on some of our published data: [[attachment:emen2-demo.tar.gz|emen2-demo.tar.gz|&do=get]] 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 }}} |
|
| Line 37: | Line 63: |
| You can import the current database schema from NCMI and initialize a simple database with the command: | 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. |
| Line 40: | Line 68: |
| python -m emen2.db.clone -h $HOME/test_db -- --defs | cd emen2-demo python -m emen2.db.load -h ~/testdb |
| Line 43: | Line 72: |
| This will prompt you to supply a root password for the database, and an administrator email for notifications and password recovery. | 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. |
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
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