Size: 2327
Comment:
|
Size: 2318
Comment: add build documentation
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
= Compiling and Installing EMAN2 = '''Most users, even 'advanced' users should select a binary install.''' If the binaries don't work for you for some reason (please [[mailto:sludtke@bcm.edu|let us know]], or if you need to write new low-level image processing functions, then you can resort to a source-based installation.) |
= Installing EMAN2 = The new EMAN2.2 binaries for recent OS versions are more heavily optimized than previous releases (and less backwards compatible). Still, it may be possible to achieve a 10-20% additional speedup if you setup GCC6 and compile with optimize-machine on a recent Linux version. Compiling from source on Linux is much easier than the other platforms. For Mac and Windows users, we strongly suggest using a binary. |
Line 6: | Line 6: |
EMAN2 uses an increasingly popular approach of writing all of the main computationally intensive image processing operations in C++, but writing all of the user programs, including those with GUIs (graphical user interfaces) in a scripting language called [[http://www.python.org|Python]]. All of these Python level programs can be edited by the end-user WITHOUT requiring a C++ development environment. Note that most users won't want or need even this level of customization. === Before Installing a New Version === * Run 'e2bdb.py -c' * Check [[EMAN2/ChangeLog|the ChangeLog]] for important update info === Binary Installation === * [[EMAN2/Install/BinaryInstall|Installing EMAN2 binaries]] |
=== Binary Installation (most users should do this) === * [[EMAN2/Install/BinaryInstallAnaconda|Installing EMAN2 binaries, EMAN2.2 and later (NEW)]] * [[EMAN2/Install/BinaryInstall|Installing EMAN2 binaries, pre 2.2]] |
Line 16: | Line 11: |
* [[EMAN2/COMPILE_EMAN2_MAC_OS_X|Compile EMAN2 on OS X]] | * To get EMAN2 source, please go to GitHub: http://github.com/cryoem/eman2 |
Line 18: | Line 14: |
* [[EMAN2/COMPILE_EMAN2_WINDOWS|Compile EMAN2 with Visual Studio .NET 2005 on Windows XP]] | * [[EMAN2/COMPILE_EMAN2_MAC_OS_X|Compile EMAN2 on OS X with Anaconda]] (recommended) * [[EMAN2/COMPILE_EMAN2_ANACONDA|Compile EMAN2 on All Platforms with Anaconda]] (NEW) * [[EMAN2/BREW_EMAN2_MAC_OS_X|Compile EMAN2 on OS X with Homebrew]] (not recommended) |
Line 20: | Line 18: |
* [[EMAN2/ExternalLibraries|External libraries needed for EMAN2 compilation]] | * [[EMAN2/COMPILE_EMAN2_WINDOWS|Compile EMAN2 with Visual Studio .NET 2005 on Windows XP (OBSOLETE)]] === Build System Documentation (Work-In-Progress) === * [[EMAN2/BUILD_SYSTEM_ANACONDA|Build, Package, Distribute with Conda, Constructor, Anaconda]] |
Line 25: | Line 26: |
* [[EMAN2/FAQ/Py_initModule4_64|I try to run eman2 script, got error like "ImportError: ....libboost....: undefined symbol: Py_InitModule4_64", what does that mean?]] * [[EMAN2/FAQ/EMAN2Mandriva2009Segfault|I compiled EMAN2 on Mandriva 2009, everything looks OK, but I got segmentation fault when I try to run e2display.py or e2boxer.py.]] * More installation FAQs can be found on the [[EMAN2/FAQ|FAQs]] page. |
* [[EMAN2/FAQ/International|Does EMAN2 support Internationalization/other language conventions ?]] * [[EMAN2/FAQ/ClusterInstall|Why is EMAN2 distributed as an 'EMAN2' directory rather than Linux RPM's, etc. ?]] * [[EMAN2/FAQ/UseEman2_OSX|EMAN2 installed under OSX doesn't work properly. Any suggestions?]] * [[EMAN2/FAQ/UseEman2_Windows|EMAN2 installed under Windows doesn't work properly. Any suggestions?]] |
Installing EMAN2
The new EMAN2.2 binaries for recent OS versions are more heavily optimized than previous releases (and less backwards compatible). Still, it may be possible to achieve a 10-20% additional speedup if you setup GCC6 and compile with optimize-machine on a recent Linux version. Compiling from source on Linux is much easier than the other platforms. For Mac and Windows users, we strongly suggest using a binary.
Binary Installation (most users should do this)
Compiling from Source and Setting Up a C++ Development Environment
To get EMAN2 source, please go to GitHub: http://github.com/cryoem/eman2
Compile EMAN2 on Linux | EMAN2's non-wiki installation instructions
Compile EMAN2 on OS X with Anaconda (recommended)
Compile EMAN2 on OS X with Homebrew (not recommended)
Compile EMAN2 with Visual Studio .NET 2005 on Windows XP (OBSOLETE)
Build System Documentation (Work-In-Progress)
FAQ
How do I know my EMAN2 installation or compilation is successful?
Does EMAN2 support Internationalization/other language conventions ?
Why is EMAN2 distributed as an 'EMAN2' directory rather than Linux RPM's, etc. ?
EMAN2 installed under OSX doesn't work properly. Any suggestions?
EMAN2 installed under Windows doesn't work properly. Any suggestions?