Install EMAN2 » History » Version 83
Neil Voss, 05/23/2016 02:45 PM
1 | 1 | Neil Voss | h1. Install EMAN2/SPARX |
---|---|---|---|
2 | |||
3 | 53 | Amber Herold | *Before you begin:* |
4 | 55 | Amber Herold | 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. |
5 | 69 | Neil Voss | This documentation assumes you are using CentOS 6 (written as of CentOS 6.5) |
6 | It is best to install EMAN2/SPARX from source to get MPI working on a cluster or 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. |
||
7 | 6 | Neil Voss | |
8 | |||
9 | 55 | Amber Herold | h2. Install pre-requisite packages for EMAN2 compiling |
10 | 6 | Neil Voss | |
11 | 27 | Neil Voss | h3. yum based packages |
12 | |||
13 | 7 | Neil Voss | * Make sure EPEL is install, if not go here: [[Download additional Software (CentOS Specific)]] |
14 | * Use yum to install devel libraries: |
||
15 | <pre> |
||
16 | 81 | Neil Voss | sudo yum install fftw-devel gsl-devel boost148-python numpy libjpeg-devel \ |
17 | PyQt4-devel cmake ipython hdf5-devel libtiff-devel libpng-devel boost148-devel \ |
||
18 | 78 | Neil Voss | PyOpenGL db4-devel python-argparse openmpi-devel python-pip freeglut-devel |
19 | 1 | Neil Voss | </pre> |
20 | 27 | Neil Voss | |
21 | |||
22 | 77 | Neil Voss | h3. Download and install FLGL |
23 | 76 | Neil Voss | |
24 | |||
25 | download |
||
26 | <pre> |
||
27 | 79 | Neil Voss | wget \ |
28 | 'http://downloads.sourceforge.net/project/ftgl/FTGL%20Source/2.1.3%7Erc5/ftgl-2.1.3-rc5.tar.gz' \ |
||
29 | -O ftgl-2.1.3-rc5.tar.gz |
||
30 | 76 | Neil Voss | </pre> |
31 | |||
32 | unzip |
||
33 | <pre> |
||
34 | 77 | Neil Voss | tar zxvf ftgl-2.1.3-rc5.tar.gz |
35 | 76 | Neil Voss | </pre> |
36 | |||
37 | 77 | Neil Voss | setup, compile, and install |
38 | 76 | Neil Voss | <pre> |
39 | 77 | Neil Voss | cd ftgl-2.1.3~rc5 |
40 | 76 | Neil Voss | ./configure |
41 | make |
||
42 | sudo make install |
||
43 | </pre> |
||
44 | |||
45 | |||
46 | 3 | Neil Voss | h2. Download the source |
47 | |||
48 | # To download the source code go to the link: |
||
49 | #* http://blake.bcm.edu/emanwiki/EMAN2 |
||
50 | 56 | Amber Herold | # Click on *"Main EMAN2 Download Page"* |
51 | 66 | Neil Voss | # Click on *"Download EMAN 2"*, whichever is the latest release of EMAN. |
52 | # Scroll down to *Source* to download the *eman2.1beta3.source.tar.gz* |
||
53 | 3 | Neil Voss | |
54 | h2. Work with the source |
||
55 | |||
56 | # go to the directory with the source code |
||
57 | # extract the archive: |
||
58 | <pre> |
||
59 | 71 | Neil Voss | tar zxvf eman2.12.source.tar.gz |
60 | 1 | Neil Voss | </pre> |
61 | 15 | Neil Voss | # go into directory |
62 | <pre>cd EMAN2/src/build</pre> |
||
63 | 19 | Neil Voss | # start configure script: |
64 | 1 | Neil Voss | <pre>cmake ../eman2/</pre> |
65 | 11 | Neil Voss | #* Note: alternatively you can run @ccmake ../eman2/@ and configure all the parameters |
66 | 75 | Neil Voss | #* I had to disable ftgl (fonts in OpenGL) to get 2.12 to compile. |
67 | 82 | Neil Voss | #* I had to manually set BOOST_LIBRARY=/usr/lib64/boost148/libboost_python.so |
68 | 83 | Neil Voss | #* I had to manually set BOOST_INCLUDE_PATH=/usr/include/boost148 |
69 | 70 | Neil Voss | <pre> |
70 | -- The C compiler identification is GNU 4.4.7 |
||
71 | -- The CXX compiler identification is GNU 4.4.7 |
||
72 | -- Check for working C compiler: /usr/bin/cc |
||
73 | -- Check for working C compiler: /usr/bin/cc -- works |
||
74 | -- Detecting C compiler ABI info |
||
75 | -- Detecting C compiler ABI info - done |
||
76 | -- Check for working CXX compiler: /usr/bin/c++ |
||
77 | -- Check for working CXX compiler: /usr/bin/c++ -- works |
||
78 | -- Detecting CXX compiler ABI info |
||
79 | -- Detecting CXX compiler ABI info - done |
||
80 | -- Looking for fseek64 |
||
81 | -- Looking for fseek64 - not found |
||
82 | -- Looking for fseeko |
||
83 | -- Looking for fseeko - found |
||
84 | -- Looking for ftell64 |
||
85 | -- Looking for ftell64 - not found |
||
86 | -- Looking for ftello |
||
87 | -- Looking for ftello - found |
||
88 | -- Configuring done |
||
89 | -- Generating done |
||
90 | -- Build files have been written to: /emg/sw/EMAN2/src/build |
||
91 | </pre> |
||
92 | 18 | Neil Voss | # start compiling: |
93 | <pre>make</pre> |
||
94 | 3 | Neil Voss | # install to directory: |
95 | 23 | Neil Voss | <pre>sudo make install</pre> |
96 | |||
97 | h2. Set environmental variables |
||
98 | |||
99 | h3. bash |
||
100 | |||
101 | <pre>sudo nano /etc/profile.d/eman2.sh</pre> |
||
102 | 24 | Neil Voss | |
103 | <pre> |
||
104 | export EMAN2DIR=/usr/local/EMAN2 |
||
105 | export PATH=${EMAN2DIR}/bin:${PATH} |
||
106 | 23 | Neil Voss | export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${EMAN2DIR}/lib |
107 | export PYTHONPATH=${EMAN2DIR}/lib:${EMAN2DIR}/bin |
||
108 | </pre> |
||
109 | 16 | Neil Voss | |
110 | 51 | Neil Voss | h3. c shell |
111 | |||
112 | <pre>sudo nano /etc/profile.d/eman2.csh</pre> |
||
113 | |||
114 | <pre> |
||
115 | setenv EMAN2DIR /usr/local/EMAN2 |
||
116 | setenv PATH ${EMAN2DIR}/bin:${PATH} |
||
117 | setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${EMAN2DIR}/lib |
||
118 | setenv PYTHONPATH ${EMAN2DIR}/lib:${EMAN2DIR}/bin |
||
119 | </pre> |
||
120 | |||
121 | |||
122 | 50 | Neil Voss | h2. Install MyMPI |
123 | 42 | Neil Voss | |
124 | 63 | Amber Herold | * First, add the openmpi module so that MyMPI can find it. |
125 | <pre> |
||
126 | module add openmpi-i386 |
||
127 | -or- |
||
128 | module add openmpi-x86_64 |
||
129 | </pre> |
||
130 | |||
131 | 42 | Neil Voss | * Download source: |
132 | 61 | Amber Herold | From the main software page: http://ncmi.bcm.tmc.edu/ncmi/software/software_details?selected_software=counter_222 scroll to *MPI Support*. |
133 | Click on *Download MPI Support* |
||
134 | Click on *pydusa-1.15es.tgz* |
||
135 | 42 | Neil Voss | * Extract: |
136 | 61 | Amber Herold | <pre>tar zxvf pydusa-1.15es.tgz</pre> |
137 | 42 | Neil Voss | * go into directory |
138 | 61 | Amber Herold | <pre>cd pydusa-1.15es</pre> |
139 | 65 | Amber Herold | |
140 | 62 | Amber Herold | If you are on a 64bit machine, you may have problems with the code finding the numpy headers: |
141 | 65 | Amber Herold | |
142 | 34 | Neil Voss | <pre>nano configure</pre> |
143 | 65 | Amber Herold | |
144 | 54 | Neil Voss | find the line: |
145 | 1 | Neil Voss | <pre> |
146 | elif test -d ${PY_PREFIX}/lib/python$PY_VERSION/site-packages/numpy/core/include; then |
||
147 | PY_HEADER_NUMPY="-I${PY_PREFIX}/lib/python$PY_VERSION/site-packages/numpy/core/include" |
||
148 | 54 | Neil Voss | </pre> |
149 | and replace it with: |
||
150 | 65 | Amber Herold | |
151 | 54 | Neil Voss | <pre> |
152 | 1 | Neil Voss | elif test -d ${PY_PREFIX}/lib64/python$PY_VERSION/site-packages/numpy/core/include; then |
153 | PY_HEADER_NUMPY="-I${PY_PREFIX}/lib64/python$PY_VERSION/site-packages/numpy/core/include" |
||
154 | 46 | Neil Voss | </pre> |
155 | * Configure: |
||
156 | <pre> |
||
157 | setenv MPIROOT /usr/lib64/openmpi |
||
158 | setenv MPIINC /usr/include/openmpi-x86_64 |
||
159 | setenv MPILIB ${MPIROOT}/lib |
||
160 | setenv MPIBIN ${MPIROOT}/bin |
||
161 | 1 | Neil Voss | ./configure |
162 | </pre> |
||
163 | <pre> |
||
164 | export MPIROOT=/usr/lib64/openmpi |
||
165 | export MPIINC=/usr/include/openmpi-x86_64 |
||
166 | export MPILIB=${MPIROOT}/lib |
||
167 | 47 | Neil Voss | export MPIBIN=${MPIROOT}/bin |
168 | 46 | Neil Voss | ./configure |
169 | </pre> |
||
170 | 64 | Amber Herold | 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: |
171 | <pre> |
||
172 | configure: error: Unable to find mpicc! mpicc location can be specified with --with-mpicc |
||
173 | </pre> |
||
174 | 65 | Amber Herold | |
175 | 46 | Neil Voss | * compile the source: |
176 | <pre>make</pre> |
||
177 | * copy the mpi.so to site-packages with a different name: |
||
178 | <pre> |
||
179 | 1 | Neil Voss | sudo mkdir /usr/lib64/python2.6/site-packages/mympi/ |
180 | 52 | Neil Voss | sudo touch /usr/lib64/python2.6/site-packages/mympi/__init__.py |
181 | 1 | Neil Voss | sudo cp -v src/mpi.so /usr/lib64/python2.6/site-packages/mympi/mpi.so |
182 | </pre> |
||
183 | 47 | Neil Voss | * create a wrapper around the wrapper: |
184 | 1 | Neil Voss | <pre>sudo nano /usr/lib64/python2.6/site-packages/mpi.py</pre> |
185 | <pre> |
||
186 | import ctypes |
||
187 | mpi = ctypes.CDLL('libmpi.so.1', ctypes.RTLD_GLOBAL) |
||
188 | from mympi.mpi import * |
||
189 | </pre> |
||
190 | 50 | Neil Voss | This needs to be done to avoid the error: |
191 | <pre> |
||
192 | python: symbol lookup error: |
||
193 | /usr/lib64/openmpi/lib/openmpi/mca_paffinity_hwloc.so: |
||
194 | undefined symbol: mca_base_param_reg_int |
||
195 | </pre> |
||
196 | 1 | Neil Voss | |
197 | * test 1: |
||
198 | <pre> |
||
199 | python -c 'import mpi' |
||
200 | python -c 'import sys; from mpi import mpi_init; mpi_init(len(sys.argv), sys.argv)' |
||
201 | </pre> |
||
202 | |||
203 | 50 | Neil Voss | * test 2: |
204 | <pre>sxisac.py start.hdf</pre> |
||
205 | (Note: start.hdf does not need to exist, if it does not exist then it should exit with file not found) |
||
206 | 42 | Neil Voss | |
207 | 50 | Neil Voss | h2. Test to see if code works |
208 | |||
209 | see http://blake.bcm.edu/emanwiki/EMAN2/FAQ/EMAN2_unittest |
||
210 | |||
211 | <pre> |
||
212 | cd EMAN2/test/rt |
||
213 | ./rt.py |
||
214 | </pre> |
||
215 | |||
216 | h2. Install MyMPI for MPI functions |
||
217 | |||
218 | see http://sparx-em.org/sparxwiki/MPI-installation |
||
219 | or https://www.nbcr.net/pub/wiki/index.php?title=MyMPI_Setup |
||
220 | |||
221 | This fixes this problem: |
||
222 | <pre> |
||
223 | from mpi import mpi_init |
||
224 | ImportError: No module named mpi |
||
225 | </pre> |
||
226 | |||
227 | 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. |
||
228 | 34 | Neil Voss | |
229 | 9 | Neil Voss | h2. Documentation |
230 | 3 | Neil Voss | |
231 | 1 | Neil Voss | * http://blake.bcm.edu/emanwiki/EMAN2/Install |
232 | 2 | Neil Voss | * http://blake.bcm.edu/emanwiki/EMAN2/FAQ/eman2BuildFAQ |
233 | 31 | Neil Voss | |
234 | 2 | Neil Voss | ______ |
235 | |||
236 | [[Install EMAN|< Install EMAN 1]] | [[Install SPIDER|Install SPIDER >]] |
||
237 | 1 | Neil Voss | |
238 | ______ |