Project

General

Profile

Install EMAN2 » History » Revision 65

Revision 64 (Amber Herold, 11/25/2013 10:46 AM) → Revision 65/87 (Amber Herold, 11/25/2013 10:48 AM)

h1. Install EMAN2/SPARX 

 *Before you begin:* 
 Please note that Appion 2.2, Appion 2.2-redux and any earlier releases do not include any features that require EMAN2/SPARX to be installed. Appion 3.0, the development trunk and future releases will require this software. 
 This documentation assumes you are using CentOS 6 (written as of CentOS 6.4) 
 It is best to install EMAN2/SPARX from source, to avoid conflicts with having two different versions of python on your system. Binaries of EMAN2/SPARX all come with their own python pre-installed. 


 h2. Install pre-requisite packages for EMAN2 compiling 

 h3. yum based packages 

 * Make sure EPEL is install, if not go here: [[Download additional Software (CentOS Specific)]] 
 * Use yum to install devel libraries: 
 <pre> 
 sudo yum install fftw-devel gsl-devel boost-python numpy \ 
  PyQt4-devel cmake ipython hdf5-devel libtiff-devel libpng-devel \ 
  PyOpenGL ftgl-devel db4-devel python-argparse openmpi-devel 
 </pre> 

 h3. bsddb3 

 Additionally you need to install the python-bsddb3 library (not available via YUM). I just use the pypi easy_installer, yum will never know. 
 <pre> 
 sudo easy_install bsddb3 
 </pre> 

 h2. Download the source 

 # To download the source code go to the link: 
 #* http://blake.bcm.edu/emanwiki/EMAN2 
 # Click on *"Main EMAN2 Download Page"* 
 # Click on *"Download EMAN 2.0x"*, whichever is the latest minor release of 2.0.  
 # Scroll down to *Source* to download the *eman2.07.source.tar.gz*  

 h2. Work with the source 

 # go to the directory with the source code 
 # extract the archive: 
 <pre> 
 tar zxvf eman2.07.source.tar.gz 
 </pre> 
 # go into directory 
 <pre>cd EMAN2/src/build</pre> 
 # start configure script: 
 <pre>cmake ../eman2/</pre> 
 #* Note: alternatively you can run @ccmake ../eman2/@ and configure all the parameters 
 # start compiling: 
 <pre>make</pre> 
 # install to directory: 
 <pre>sudo make install</pre> 

 h2. Set environmental variables 

 h3. bash 

 <pre>sudo nano /etc/profile.d/eman2.sh</pre> 

 <pre> 
 export EMAN2DIR=/usr/local/EMAN2 
 export PATH=${EMAN2DIR}/bin:${PATH} 
 export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${EMAN2DIR}/lib 
 export PYTHONPATH=${EMAN2DIR}/lib:${EMAN2DIR}/bin 
 </pre> 

 h3. c shell 

 <pre>sudo nano /etc/profile.d/eman2.csh</pre> 

 <pre> 
 setenv EMAN2DIR /usr/local/EMAN2 
 setenv PATH ${EMAN2DIR}/bin:${PATH} 
 setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${EMAN2DIR}/lib 
 setenv PYTHONPATH ${EMAN2DIR}/lib:${EMAN2DIR}/bin 
 </pre> 


 h2. Install MyMPI 

 * First, add the openmpi module so that MyMPI can find it. 
 <pre> 
 module add openmpi-i386 
 -or- 
 module add openmpi-x86_64 
 </pre> 

 * Download source:  
 From the main software page: http://ncmi.bcm.tmc.edu/ncmi/software/software_details?selected_software=counter_222 scroll to *MPI Support*. 
 Click on *Download MPI Support* 
 Click on *pydusa-1.15es.tgz* 
 * Extract: 
 <pre>tar zxvf pydusa-1.15es.tgz</pre> 
 * go into directory 
 <pre>cd pydusa-1.15es</pre> 
 &nbsp; 
 

 If you are on a 64bit machine, you may have problems with the code finding the numpy headers: 
 &nbsp; 
 

 <pre>nano configure</pre> 
 &nbsp; 
 

 find the line: 
 <pre> 
 elif test -d ${PY_PREFIX}/lib/python$PY_VERSION/site-packages/numpy/core/include; then 
    PY_HEADER_NUMPY="-I${PY_PREFIX}/lib/python$PY_VERSION/site-packages/numpy/core/include" 
 </pre> 
 and replace it with: 
 &nbsp; 
 

 <pre> 
 elif test -d ${PY_PREFIX}/lib64/python$PY_VERSION/site-packages/numpy/core/include; then 
    PY_HEADER_NUMPY="-I${PY_PREFIX}/lib64/python$PY_VERSION/site-packages/numpy/core/include" 
 </pre> 
 * Configure: 
 <pre> 
 setenv MPIROOT /usr/lib64/openmpi 
 setenv MPIINC /usr/include/openmpi-x86_64 
 setenv MPILIB ${MPIROOT}/lib 
 setenv MPIBIN ${MPIROOT}/bin 
 ./configure 
 </pre> 
 <pre> 
 export MPIROOT=/usr/lib64/openmpi 
 export MPIINC=/usr/include/openmpi-x86_64 
 export MPILIB=${MPIROOT}/lib 
 export MPIBIN=${MPIROOT}/bin 
 ./configure 
 </pre> 
 Please ensure mpicc was found. If it is not found, a version of MPI will be installed that may cause errors. Look for the following error and correct this issue before moving on: 
 <pre> 
 configure: error: Unable to find mpicc! mpicc location can be specified with --with-mpicc 
 </pre> 
 &nbsp; 
 

 * compile the source: 
 <pre>make</pre> 
 * copy the mpi.so to site-packages with a different name: 
 <pre> 
 sudo mkdir /usr/lib64/python2.6/site-packages/mympi/ 
 sudo touch /usr/lib64/python2.6/site-packages/mympi/__init__.py 
 sudo cp -v src/mpi.so /usr/lib64/python2.6/site-packages/mympi/mpi.so 
 </pre> 
 * create a wrapper around the wrapper: 
 <pre>sudo nano /usr/lib64/python2.6/site-packages/mpi.py</pre> 
 <pre> 
 import ctypes 
 mpi = ctypes.CDLL('libmpi.so.1', ctypes.RTLD_GLOBAL) 
 from mympi.mpi import * 
 </pre> 
 This needs to be done to avoid the error: 
 <pre> 
 python: symbol lookup error:  
   /usr/lib64/openmpi/lib/openmpi/mca_paffinity_hwloc.so:  
     undefined symbol: mca_base_param_reg_int 
 </pre> 

 * test 1:  
 <pre> 
 python -c 'import mpi' 
 python -c 'import sys; from mpi import mpi_init; mpi_init(len(sys.argv), sys.argv)' 
 </pre> 

 * test 2:  
 <pre>sxisac.py start.hdf</pre> 
 (Note: start.hdf does not need to exist, if it does not exist then it should exit with file not found) 

 h2. Test to see if code works 

 see http://blake.bcm.edu/emanwiki/EMAN2/FAQ/EMAN2_unittest 

 <pre> 
 cd EMAN2/test/rt 
 ./rt.py 
 </pre> 

 h2. Install MyMPI for MPI functions 

 see http://sparx-em.org/sparxwiki/MPI-installation 
 or https://www.nbcr.net/pub/wiki/index.php?title=MyMPI_Setup 

 This fixes this problem: 
 <pre> 
     from mpi import mpi_init 
 ImportError: No module named mpi 
 </pre> 

 This module was very difficult to get working, it seems to be a poorly supported python wrapper for MPI. So, what we are going to do is compile the module, rename it, and create a wrapper. So, essentially we are creating a wrapper around the wrapper. We can only hope they switch to [http://mpi4py.scipy.org/ mpi4py] in the future. 

 h2. Documentation 

 * http://blake.bcm.edu/emanwiki/EMAN2/Install 
 * http://blake.bcm.edu/emanwiki/EMAN2/FAQ/eman2BuildFAQ 

 ______ 

 [[Install EMAN|< Install EMAN 1]] | [[Install SPIDER|Install SPIDER >]] 

 ______