Differences between revisions 18 and 19
Revision 18 as of 2017-02-12 20:39:51
Size: 4747
Editor: SteveLudtke
Comment:
Revision 19 as of 2017-02-12 20:44:32
Size: 5293
Editor: SteveLudtke
Comment:
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
 1. Obviously you will need to have XCode installed on your Mac as well  1. XCode is required!
  * If you can successfully run 'g++ --version' from the command line, you should be all set and can skip to the next step.
  * XCode is free and available from the App Store. It includes the command-line C++ compiler for the Mac.
  * The first time you ever try and use the C++ compiler from the command-line it will complain if you have not run the XCode GUI, since it requires a click-through user agreement.
  * You may need to download additional tools from within XCode to get the command-line compiler working. See: http://osxdaily.com/2014/02/12/install-command-line-tools-mac-os-x/

Installing EMAN2.2 on OSX from source with Anaconda

These instructions worked for me on Sierra (10.12). I expect they would also work on versions back several years, but cannot guarantee it.

This approach uses a Python distribution called Anaconda for all of the messy dependencies EMAN2 requires, including the Python interpreter itself. In addition, this means that if you want to use EMAN2 from Python with other Python libraries, you have a rich Anaconda environment where you can install any additional packages you like. Anaconda is cross-platform and we have found it to be a MUCH better choice than Mac-specific package managers like MacPorts.

PLEASE report any problems or update the page!

  1. Completely remove any previous eman2 source folders, and check out a fresh copy of the source from GitHub:

    git clone https://github.com/cryoem/eman2.git
  2. Install current Python2.x Anaconda from https://www.continuum.io/downloads (remember EMAN is Python2 not Python3).

    • Download the command-line installer, not the graphical installer, since this gives you a choice of where to put the installed folder.
    • Install Anaconda to $HOME/anaconda2
    • If you use a different location, you will need to update that in all of the subsequent instructions.
  3. XCode is required!
    • If you can successfully run 'g++ --version' from the command line, you should be all set and can skip to the next step.
    • XCode is free and available from the App Store. It includes the command-line C++ compiler for the Mac.
    • The first time you ever try and use the C++ compiler from the command-line it will complain if you have not run the XCode GUI, since it requires a click-through user agreement.
    • You may need to download additional tools from within XCode to get the command-line compiler working. See: http://osxdaily.com/2014/02/12/install-command-line-tools-mac-os-x/

  4. configure account to use this anaconda. I have a "useconda2" alias which does this (I just reset the entire PATH to avoid building up redundancies):
    useconda2='export PYTHONPATH=$HOME/EMAN2/lib:$HOME/EMAN2/bin; export EMAN2DIR=$HOME/EMAN2; export PATH=.:$HOME/anaconda2/bin:$HOME/EMAN2/bin:$HOME/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Developer/usr/bin:/Applications/Chimera.app/Contents/MacOS'
  5. Install other necessary Anaconda modules. This includes specific versions for a few. I don't recall how many of these were already installed and how many I had to do. Note that some need a specific version, eg:
    conda install qt=4 pyqt=4
    and a couple are from other channels, eg:
    conda install -c conda-forge boost boost-cpp fftw
    conda install -c jmbell ftgl
    The rest:
    conda install bsddb freetype gsl hdf5 ipython jpeg libpng libtiff matplotlib numpy=1.11 pyopengl scikit-learn scipy theano tk cmake
  6. Once all of this is done, all you have to do is get your CMake configuration to point at all of the right files. CMake should find everything automatically with 3 exceptions, as long as you put a directory called anaconda2 in your home directory. Replace $HOME below with your actual home directory:
    PYTHON_INCLUDE_PATH=$HOME/anaconda2/include/python2.7
    PYTHON_LIBRARY=$HOME/anaconda2/lib/libpython2.7.dylib
    ZLIB_LIBRARY=$HOME/anaconda2/lib/libz.dylib

Once this was done (it really didn't take very long to do), everything works for me, including the GUI. While I haven't tested absolutely everything, I did go through a lot of the tutorial and everything seemed fine.

Troubleshooting

  • Here is the list of packages (installed above) with versions known to work in Feb, 2017. You shouldn't need to do anything with this, if you installed above. If you are having problems, you can do a conda list and check for these:

    boost                     1.63.0                   py27_4    conda-forge
    boost-cpp                 1.63.0                        1    conda-forge
    fftw                      3.3.5                         0    conda-forge
    bsddb                     1.0                      py27_1  
    cmake                     3.6.3                         0  
    freetype                  2.5.5                         2  
    ftgl                      2.1.3                         2    jmbell
    gsl                       2.2.1                         0  
    hdf5                      1.8.17                        1  
    ipython                   5.1.0                    py27_0  
    ipython_genutils          0.1.0                    py27_0  
    jpeg                      9b                            0  
    libpng                    1.6.27                        0  
    libtiff                   4.0.6                         3  
    matplotlib                1.5.3               np111py27_0  
    numpy                     1.11.1                   py27_0  
    pyopengl                  3.0.2                    py27_0  
    pyqt                      4.11.4                   py27_4  
    qt                        4.8.7                         4  
    scikit-learn              0.17.1              np111py27_2  
    scipy                     0.18.1              np111py27_0  
    theano                    0.8.2                    py27_0  
    tk                        8.5.18                        0  

EMAN2/COMPILE_EMAN2_MAC_OS_X (last edited 2017-03-16 18:58:44 by SteveLudtke)