Size: 9115
Comment:
|
Size: 14899
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
## page was renamed from EMAN2/install/SourceInstall ## page was renamed from EMAN2/COMPILE_EMAN2_ANACONDA ## page was renamed from EMAN2/COMPILE_EMAN2_ANACONDA/2.9 ## page was renamed from EMAN2/COMPILE_EMAN2_ANACONDA ## page was renamed from EMAN2/COMPILE_EMAN2_ANACONDA-DRAFT {{{#!html <h1 style="margin-bottom:5px;"> Building EMAN2/SPARX/SPHIRE from Source </h1> <p style="font-size:110%; text-align:center; margin-top:5px; margin-left:20px; margin-right:20px;"> <i> Standard instructions for establishing a build and runtime environment for EMAN/SPARX/SPHIRE on Linux, macOS and WSL2 (Windows): </i> </p> }}} * While the instructions look long, in reality it should only take 10-15 minutes to complete the entire process (with a decent network connection). * We use [[https://docs.conda.io/en/latest/|Conda]] for a working environment and most of the dependencies. [[https://www.anaconda.com/distribution/|Anaconda distribution]] has become ubiquitous for Python and R-based scientific computing and education over the last decade. While it may be possible to build the system without using Conda, we do not recommend doing this, and cannot provide support for a non-conda approach. If you follow the instructions below, you should have a painless source build very quickly. * We make use of the [[https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html|environment]] system in [[https://docs.conda.io/en/latest/|conda]], the package manager, to isolate EMAN2 dependencies from other conda packages you may have installed. If you need to install other packages you wish to use in concert with EMAN2, you will need to install them within the EMAN2 environment. Be warned that sometimes installing another package may trigger a version change in one of EMAN2's dependencies, which may or may not be a problem, depending on which dependency it is. We strongly suggest getting the base EMAN2 installed and working first, before trying to install any additional packages within the same conda environment. * Note that even with a source build it may be difficult to get this working on systems with very old operating system installs. We normally try to support OS versions as much as 5-7 years old. Please report any problems. * '''GPU Support (Linux Only!):''' For features which support the GPU, please complete the standard source install instructions below, then follow the [[EMAN2/Install/BinaryInstallAnaconda/2.31#Using_the_GPU|GPU instructions]] from the binary installation page. * '''NOTE: Instructions Changed May 2023:''' In May 2023 we changed how the dependencies for EMAN2 were handled to allow for more flexible updating/changing of dependent packages without breaking the whole install. You may consider starting from scratch if your Anaconda setup predates May 2023. |
|
Line 3: | Line 32: |
= Anaconda based Build, All Platforms (except Windows) = EMAN2 source lives on [[https://github.com/cryoem/eman2|GitHub]], downloading the source is part of the instructions below. Do not check it out yet. EMAN2 has a number of dependencies, the most important of which is Python, and some of these dependencies require specific versions. Rather than struggling with system library incompatibilities and other issues, EMAN2 has adopted Anaconda as its install environment. This (FOSS) system provides a cross-platform compatible environment in which specific library versions can be installed without interfering with anything else on the system, and can support multiple such environments within one Anaconda installation. While it ''may'' still be possible to compile EMAN2 without Anaoconda, this is an unsupported approach, and you should anticipate a fair amount of effort. If you follow the instructions below, you should have a painless source build (Linux/Mac only) very quickly. Note that even with a source build it may be difficult to get this working on systems with very old operating system installs. We normally try to support OS versions as much as 5-7 years old. Please report any problems. === GPU Support === For features which support the GPU, please complete the standard source install instructions below, then follow the [[EMAN2/Install/BinaryInstallAnaconda/2.31#Using_the_GPU|GPU instructions]] from the binary installation page. == Installing EMAN2/SPHIRE/SPARX from source == Anaconda comes in two flavors ''Anaconda'' which is a full featured system with many libraries and capabilities built in, and ''Miniconda'' which is a stripped down version of the system. Both systems are the same, it is just a question of which packages come preinstalled. These instructions are based on the smaller Miniconda install. You may also have success with Anaconda, but a better approach may be to install Miniconda, then add in any extra packages you actually need. We make use of the [[https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html|environment]] system in Anaconda to isolate EMAN2 dependencies from other Anaconda packages you may have installed. If you need to install other packages you wish to use in concert with EMAN2, you will need to install them within the EMAN2 environment. Be warned that sometimes installing another package may trigger a version change in one of EMAN2's dependencies, which may or may not be a problem, depending on which dependency it is. We strongly suggest getting the base EMAN2 installed and working first, before trying to install any additional packages within the same Anaconda environment. === Initial Setup === 1. If you do not have Anaconda/Miniconda (or another copy of EMAN2/SPARX/SPHIRE) already installed in your account, skip to the next step. If you DO have Anaconda or Miniconda installed in your account, these instructions will be installing a new complete copy of Miniconda, so you must insure that any existing install you have is not active in your shell (not in PATH, no LD_LIBRARY_PATH or PYTHONPATH set). While it may also be possible to set up an environment for EMAN2 in your existing install, you would need to adapt these instructions to your own situation yourself to do that. |
== Initial Setup == This section only needs to be completed once. If you have a working EMAN2 source installation and just wish to update, skip ahead to [[#daily_build|Build and Install]]. 1. '''Check your account for possible problems''' * IF you have Anaconda installed in your account already, and wish to try setting up EMAN2 as a new environment skip ahead to [[#update_conda|Configure and update conda]]. This may or may not work without some effort, depending on the age of your Anaconda install. * Otherwise: |
Line 34: | Line 47: |
1. Download and install this version of '''Miniconda''' for [[https://repo.continuum.io/miniconda/Miniconda3-4.6.14-Linux-x86_64.sh|Linux]] or [[https://repo.continuum.io/miniconda/Miniconda3-4.6.14-MacOSX-x86_64.sh|MacOSX]]. | <<Anchor(install_miniconda)>> 1. '''Download and install''' '''Miniconda''': [[https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh|Linux]] or [[https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh|macOS (intel)]] or [[https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh|MacOS (ARM/M1/M2)]] |
Line 44: | Line 58: |
1. Initialize conda for shell interaction. These instructions will depend on what shell you use. The default on most systems is ''bash''. If you use a different shell ( ''tsch'', ''zsh'', ... ), you will need to take this into account: | 1. '''Initialize conda for shell interaction.''' These instructions will depend on what shell you use. The default on most systems is ''bash''. If you use a different shell ( ''tsch'', ''zsh'', ... ), you will need to take that into account: |
Line 55: | Line 69: |
# we suggest the following, meaning you will need to use ''conda activate'' after logging in before using EMAN2 |
}}} As it says after you run this command, you will need to close and reopen your shell/terminal for it to take effect. This command modified your shell initialization so the ''conda activate'' command can be used properly. For more information on conda-init and activation, see [[https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#activating-an-environment|Environment Activation]]. {{{#!wiki caution '''macOS''' Users (bash only) On macOS, this modifies ''~/.bash_profile''. If you have a ''~/.profile'' startup file, creation of ''~/.bash_profile'' will prevent ''~/.profile'' from being read. A simple solution is to ''source .profile'' within ''.bash_profile''. For differences between login- and non-login shells and order of reading the startup files on macOS, see, [[https://www.anintegratedworld.com/basics-of-osx-bashrc-v-profile-v-bash_profile/]]. }}} <<Anchor(update_conda)>> 1. '''Configure and update conda.''' {{{#!highlight bash # We suggest the following, meaning you will need to use ''conda activate'' after logging in before using EMAN2 |
Line 58: | Line 86: |
}}} As it says after you run this command, you will need to close and reopen your shell/terminal for it to take effect. This command modified your shell initialization so the ''conda activate'' command can be used properly. For more information on conda-init and activation, see [[https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#activating-an-environment|Environment Activation]]. {{{#!wiki caution '''MacOS''' Users (bash only) On MacOS, this modifies ''~/.bash_profile''. If you have a ''~/.profile'' startup file, creation of ''~/.bash_profile'' will prevent ''~/.profile'' from being read. A simple solution is to ''source .profile'' within ''.bash_profile''. For differences between login- and non-login shells and order of reading the startup files on Mac OSX, see, [[https://www.anintegratedworld.com/basics-of-osx-bashrc-v-profile-v-bash_profile/]]. }}} 1. Configure conda. {{{#!highlight bash # Automatic Anaconda/Miniconda updates may cause things to break, so we suggest making all package upgrades explicitly # The current version verified to work with EMAN is '''conda 4.6.14''' |
# Automatic conda updates may cause things to break, so we suggest making all package upgrades explicitly |
Line 76: | Line 89: |
}}} 1. Create a new environment with EMAN2 dependencies. {{{#!highlight bash conda create -n eman eman-deps=15.1 cmake=3.14 -c cryoem -c defaults -c conda-forge }}} If you wish to see the [[https://github.com/cryoem/eman-deps-feedstock/blob/v15.1/recipe/meta.yaml#L9-L53|list of conda dependencies]] that '''eman-deps''' is built from, look [[https://github.com/cryoem/eman-deps-feedstock/blob/v15.1/recipe/meta.yaml#L9-L53|here]]. |
# Install mamba (Not as necessary as it once was. Conda has improved. Mamba installation may be difficult now) conda install mamba -c conda-forge # Update base environment to get the latest conda mamba update --all -n base # Mac M1/M2/... users, if you get an error in the previous step see Troubleshooting below }}} 1. '''Create a new environment''' with EMAN2 dependencies. ''eman2'' below is the name of the environment. You may make this whatever you like, as long as you remember to use the same name when doing ''conda activate''. Note that this name will appear as part of your prompt when activated, so you may want to keep it short. {{{#!highlight bash mamba create -n eman2 eman-dev --only-deps -c cryoem -c conda-forge }}} To get the '''non-GUI''' variant which will not have pyqt and pyopengl, and can be installed on machines that do not provide GUI support and do not have any OpenGL packages installed, run one of the commands below: {{{#!highlight bash mamba create -n eman2 'eman-dev=*=nogui_*' --only-deps -c cryoem -c conda-forge }}} '''List of dependencies: '''If you wish to see the list of conda dependencies that '''eman-deps''' is built from, look [[https://github.com/cryoem/eman-deps-feedstock/blob/master/recipe/meta.yaml|here]]. Some of the dependency versions are listed in the appropriate file under [[https://github.com/cryoem/eman-deps-feedstock/tree/master/.ci_support|.ci_support]]. {{{{#!wiki caution '''macOS Big Sur Users''' The new Big Sur macOS release (fall 2020) broke some things in Python, which are only now (Dec 2020) getting fixed. These fixes have not yet made their way into Anaconda. If you experience an error similar to "Unable to load OpenGL library", install a patched pyopengl package from cryoem channel (as of 1/13/2021). {{{#!shell conda install pyopengl -c cryoem }}} '''OR''' This quick fix seems to provide a temporary solution until Anaconda gets the necessary updates: You need to go into your miniconda3 or anaconda3 folder and find this file (the path may be slightly different on your install, but you should be able to find it): ''~/anaconda3/envs/eman2/lib/python3.7/site-packages/OpenGL/platform/ctypesloader.py'' Around line 80 you should find a line like: '' fullName = util.find_library( name )'' change this line to: '' fullName = '/System/Library/Frameworks/' + name + '.framework/' + name '' (important to use 8 spaces before fullName, not a <tab>) }}}} 1. Ensure you have '''OpenGL''': EMAN2 uses OpenGL (via !PyQt) for all of its graphics. OpenGL installation depends on OS variant and, for example, whether you are using proprietary NVidia drivers under Linux. You will need to have OpenGL set up on your machine as a whole before continuing. On Mac, you should already have this with XCode. On Linux with an NVidia driver you will likely also need to install the Mesa header files. If you aren't sure how to set up OpenGL, Google can probably help. |
Line 95: | Line 158: |
== EMAN Daily Development == 1. '''Activate''' your environment. {{{#!highlight bash conda activate eman }}} 1. '''Checkout source code''' and pull from the remote. {{{#!highlight bash cd <source-directory> # <path-where-you-want-eman2-source>/eman2 git checkout <branch> git pull --rebase }}} 1. '''Build EMAN''' |
<<Anchor(daily_build)>> == Build and Install: Daily development, Update code, etc. == When you start a new shell, these are the steps you will need to take before running EMAN programs or compiling the system: 1. '''Activate''' your environment. If you used a different name above, use it here too. {{{#!highlight bash conda activate eman2 }}} 1. '''Update and Checkout source code'''. Periodically you should update your source using standard git techniques. {{{#!highlight bash cd <source-directory> # <path-where-you-want-eman2-source>/eman2 git fetch --all --prune # get remote branches and cleanup non-existing remote branches from local repo git checkout master # to make sure you are building from the current master build rather than a branch someone is working on git pull # This is what actually updates your local copy of the code }}} 1. '''CMake''' |
Line 113: | Line 179: |
cmake <source-directory> # - eg $HOME/src/eman2. On linux, also add -DENABLE_OPTIMIZE_MACHINE=ON }}} * If you use '''cmake-gui''', since conda is not in PATH anymore, cmake will fail to find the environment directory. In that case set CONDA_PREFIX to your conda environment directory manually. * Make sure to delete any cmake variables that cmake already found, variables like *_LIBRARY or similar, *_INCLUDE_PATH or similar, CONDA_EXECUTABLE, CMAKE_INSTALL_PREFIX and any variables that are expected to contain conda environment related values. * Configure and generate in cmake. {{{#!highlight bash |
# on Mac: cmake <source-directory> # - eg $HOME/src/eman2, optionally add -DCMAKE_VERBOSE_MAKEFILE # on Linux: cmake <source-directory> -DENABLE_OPTIMIZE_MACHINE=ON # - eg $HOME/src/eman2, optionally add -DCMAKE_VERBOSE_MAKEFILE }}} * '''cmake-gui''' * If you use '''cmake-gui''', since conda is not in PATH anymore, cmake will fail to find the environment directory. In that case set CONDA_PREFIX to your conda environment directory manually. * Make sure to delete any cmake variables that cmake already found, variables like *_LIBRARY or similar, *_INCLUDE_PATH or similar, CONDA_EXECUTABLE, CMAKE_INSTALL_PREFIX and any variables that are expected to contain conda environment related values. * Configure and generate. * '''ccmake''' * If you use '''ccmake''', you may get an error related to OpenGL. If this happens try quitting ccmake and running it again. 1. '''Make''' {{{#!highlight bash make -j 8 make install # To install sphire make install-sphire }}} Note that the '''make -j 8''' above will compile using 8 threads. On some machines omitting the 8 will compile faster and cause no problems, and if you have more than 8 threads on your machine, you can increase the number. == Test install == * e2version.py * e2speedtest.py * e2display.py (not for clusters without GUI environments configured) * note: "make test" is not recommended for individual installs, this tool is primarily aimed at developers making changes in the core of the system. It is not uncommon for one or more tests to fail, and there is no need to report such failures. In most cases this is a problem with the test, not a problem with the system. 1. '''Other Environments'''. To switch to another conda environment (stop working with EMAN2), first deactivate your current environment. {{{#!highlight bash conda deactivate }}} === Troubleshooting === Solutions to potential known problems will be listed here. If these don't help, please report your problem (http://groups.google.com/group/eman2): * On ARM Macs (M1/M2/...) Anaconda/Miniconda still has some minor issues in 2023. Here are some workarounds * If running mamba produces an error related to '''libarchive.13.dylib''', you can try: * ln -s /Users/<username>/miniconda3/lib/libarchive.dylib /Users/<username>/miniconda3/lib/libarchive.13.dylib # replace <username> * - or - * if you have HomeBrew on your machine, you can: * brew install libarchive * ln -s /opt/homebrew/opt/libarchive/lib/libarchive.13.dylib $HOME/miniconda3/lib * If using a newer C compiler on Linux, you may encounter an error like: {{{ /home/steve/miniconda3/envs/eman2/lib/libstdc++.so.6: version `GLIBCXX_3.4.29' not found }}} Simply removing the offending libstdc++.so file will normally resolve this issue. * Compilers on CentOS 6 and 7, do not support gcc's dual ABI feature which is needed to compile EMAN2's modern C++ code. On our build machine, devtools-7 and devtools-11 have been tested and confirmed to fail to compile EMAN2 code. <<Anchor(debug_and_report)>> == Reporting Problems == Please, provide the output of the following commands when reporting a problem. Record the session via '''script''' command. This, also, records the commands. 1. {{{#!highlight bash script filename.txt conda activate eman2 conda info -a conda list conda list --explicit cd <source-dir> git status git log -1 cd <build-dir> rm CMakeCache.txt cmake <source-dir> cmake . -LA make clean |
Line 122: | Line 260: |
}}} 1. You may also wish to run {{{#!highlight bash make test # if everything passes you are fine, if there are failures, you are welcome to ask make test-verbose # verbose test output to help to identify specific failures }}} 1. To switch to another conda environment, first deactivate your current environment. {{{#!highlight bash |
make test-verbose |
Line 133: | Line 263: |
}}} | exit # or Ctrl+D }}} 1. Send '''filename.txt'''. |
Line 138: | Line 273: |
The approach above will install EMAN with a precompiled version of OpenMPI, which may or may not work with the batch queuing system on your cluster. If it does not work, the symptom will be that MPI parallel jobs will use only a single node, no matter how many you have allocated in your job. If this happens please see the linux cluster installations on the [[EMAN2/Install/BinaryInstallAnaconda/2.31#Linux_Clusters|binary install page]]. Those instructions should also work with either of the source-based installations below. | The approach above will install EMAN with a precompiled version of OpenMPI, which may or may not work with the batch queuing system on your cluster. If it does not work, the symptom will be that MPI parallel jobs will use only a single node, no matter how many you have allocated in your job. Currently, we do not have alternative OpenMPI installation instructions. |
Building EMAN2/SPARX/SPHIRE from Source
Standard instructions for establishing a build and runtime environment for EMAN/SPARX/SPHIRE on Linux, macOS and WSL2 (Windows):
- While the instructions look long, in reality it should only take 10-15 minutes to complete the entire process (with a decent network connection).
We use Conda for a working environment and most of the dependencies. Anaconda distribution has become ubiquitous for Python and R-based scientific computing and education over the last decade. While it may be possible to build the system without using Conda, we do not recommend doing this, and cannot provide support for a non-conda approach. If you follow the instructions below, you should have a painless source build very quickly.
We make use of the environment system in conda, the package manager, to isolate EMAN2 dependencies from other conda packages you may have installed. If you need to install other packages you wish to use in concert with EMAN2, you will need to install them within the EMAN2 environment. Be warned that sometimes installing another package may trigger a version change in one of EMAN2's dependencies, which may or may not be a problem, depending on which dependency it is. We strongly suggest getting the base EMAN2 installed and working first, before trying to install any additional packages within the same conda environment.
- Note that even with a source build it may be difficult to get this working on systems with very old operating system installs. We normally try to support OS versions as much as 5-7 years old. Please report any problems.
GPU Support (Linux Only!): For features which support the GPU, please complete the standard source install instructions below, then follow the GPU instructions from the binary installation page.
NOTE: Instructions Changed May 2023: In May 2023 we changed how the dependencies for EMAN2 were handled to allow for more flexible updating/changing of dependent packages without breaking the whole install. You may consider starting from scratch if your Anaconda setup predates May 2023.
Contents
Initial Setup
This section only needs to be completed once. If you have a working EMAN2 source installation and just wish to update, skip ahead to Build and Install.
Check your account for possible problems
IF you have Anaconda installed in your account already, and wish to try setting up EMAN2 as a new environment skip ahead to Configure and update conda. This may or may not work without some effort, depending on the age of your Anaconda install.
- Otherwise:
1 echo $PATH 2 # make sure no Anaconda/Miniconda/EMAN2 entries 3 echo $LD_LIBRARY_PATH 4 echo $PYTHONPATH 5 # ideally, both return nothing. If it set to something it is possible that it may interfere with Anaconda 6 # strongly suggest at least during the install, ''unset'' both of these. After installation you can test 7 # to see if they cause any issues 8
Download and install Miniconda: Linux or macOS (intel) or MacOS (ARM/M1/M2)
and follow the prompts. When you see Do you wish the installer to initialize Miniconda3 by running conda init?, say no, then move on to the next step.
Initialize conda for shell interaction. These instructions will depend on what shell you use. The default on most systems is bash. If you use a different shell ( tsch, zsh, ... ), you will need to take that into account:
As it says after you run this command, you will need to close and reopen your shell/terminal for it to take effect. This command modified your shell initialization so the conda activate command can be used properly. For more information on conda-init and activation, see Environment Activation.
macOS Users (bash only)
On macOS, this modifies ~/.bash_profile. If you have a ~/.profile startup file, creation of ~/.bash_profile will prevent ~/.profile from being read. A simple solution is to source .profile within .bash_profile.
For differences between login- and non-login shells and order of reading the startup files on macOS, see, https://www.anintegratedworld.com/basics-of-osx-bashrc-v-profile-v-bash_profile/.
Configure and update conda.
1 # We suggest the following, meaning you will need to use ''conda activate'' after logging in before using EMAN2 2 conda config --set auto_activate_base False 3 4 # Automatic conda updates may cause things to break, so we suggest making all package upgrades explicitly 5 conda config --set auto_update_conda False 6 7 # Install mamba (Not as necessary as it once was. Conda has improved. Mamba installation may be difficult now) 8 conda install mamba -c conda-forge 9 10 # Update base environment to get the latest conda 11 mamba update --all -n base 12 13 # Mac M1/M2/... users, if you get an error in the previous step see Troubleshooting below 14
Create a new environment with EMAN2 dependencies. eman2 below is the name of the environment. You may make this whatever you like, as long as you remember to use the same name when doing conda activate. Note that this name will appear as part of your prompt when activated, so you may want to keep it short.
1 mamba create -n eman2 eman-dev --only-deps -c cryoem -c conda-forge
To get the non-GUI variant which will not have pyqt and pyopengl, and can be installed on machines that do not provide GUI support and do not have any OpenGL packages installed, run one of the commands below:
1 mamba create -n eman2 'eman-dev=*=nogui_*' --only-deps -c cryoem -c conda-forge
List of dependencies: If you wish to see the list of conda dependencies that eman-deps is built from, look here. Some of the dependency versions are listed in the appropriate file under .ci_support.
macOS Big Sur Users
The new Big Sur macOS release (fall 2020) broke some things in Python, which are only now (Dec 2020) getting fixed. These fixes have not yet made their way into Anaconda. If you experience an error similar to "Unable to load OpenGL library", install a patched pyopengl package from cryoem channel (as of 1/13/2021).
conda install pyopengl -c cryoem
OR
This quick fix seems to provide a temporary solution until Anaconda gets the necessary updates:
You need to go into your miniconda3 or anaconda3 folder and find this file (the path may be slightly different on your install, but you should be able to find it):
~/anaconda3/envs/eman2/lib/python3.7/site-packages/OpenGL/platform/ctypesloader.py
Around line 80 you should find a line like:
fullName = util.find_library( name )
change this line to:
fullName = '/System/Library/Frameworks/' + name + '.framework/' + name
(important to use 8 spaces before fullName, not a <tab>)
Ensure you have OpenGL:
EMAN2 uses OpenGL (via PyQt) for all of its graphics. OpenGL installation depends on OS variant and, for example, whether you are using proprietary NVidia drivers under Linux. You will need to have OpenGL set up on your machine as a whole before continuing. On Mac, you should already have this with XCode. On Linux with an NVidia driver you will likely also need to install the Mesa header files. If you aren't sure how to set up OpenGL, Google can probably help.
Get EMAN code from GitHub:cryoem/eman2.
Create a build directory (out-of-source builds are recommended).
Build and Install: Daily development, Update code, etc.
When you start a new shell, these are the steps you will need to take before running EMAN programs or compiling the system:
Activate your environment. If you used a different name above, use it here too.
1 conda activate eman2
Update and Checkout source code. Periodically you should update your source using standard git techniques.
1 cd <source-directory> # <path-where-you-want-eman2-source>/eman2 2 git fetch --all --prune # get remote branches and cleanup non-existing remote branches from local repo 3 git checkout master # to make sure you are building from the current master build rather than a branch someone is working on 4 git pull # This is what actually updates your local copy of the code 5
CMake
cmake-gui
If you use cmake-gui, since conda is not in PATH anymore, cmake will fail to find the environment directory. In that case set CONDA_PREFIX to your conda environment directory manually.
- Make sure to delete any cmake variables that cmake already found, variables like *_LIBRARY or similar, *_INCLUDE_PATH or similar, CONDA_EXECUTABLE, CMAKE_INSTALL_PREFIX and any variables that are expected to contain conda environment related values.
- Configure and generate.
ccmake
If you use ccmake, you may get an error related to OpenGL. If this happens try quitting ccmake and running it again.
Make
Note that the make -j 8 above will compile using 8 threads. On some machines omitting the 8 will compile faster and cause no problems, and if you have more than 8 threads on your machine, you can increase the number.
Test install
- e2version.py
- e2speedtest.py
- e2display.py (not for clusters without GUI environments configured)
- note: "make test" is not recommended for individual installs, this tool is primarily aimed at developers making changes in the core of the system. It is not uncommon for one or more tests to fail, and there is no need to report such failures. In most cases this is a problem with the test, not a problem with the system.
Other Environments. To switch to another conda environment (stop working with EMAN2), first deactivate your current environment.
1 conda deactivate
Troubleshooting
Solutions to potential known problems will be listed here. If these don't help, please report your problem (http://groups.google.com/group/eman2):
- On ARM Macs (M1/M2/...) Anaconda/Miniconda still has some minor issues in 2023. Here are some workarounds
If running mamba produces an error related to libarchive.13.dylib, you can try:
ln -s /Users/<username>/miniconda3/lib/libarchive.dylib /Users/<username>/miniconda3/lib/libarchive.13.dylib # replace <username>
- - or -
if you have HomeBrew on your machine, you can:
- brew install libarchive
- ln -s /opt/homebrew/opt/libarchive/lib/libarchive.13.dylib $HOME/miniconda3/lib
- If using a newer C compiler on Linux, you may encounter an error like:
/home/steve/miniconda3/envs/eman2/lib/libstdc++.so.6: version `GLIBCXX_3.4.29' not found
Simply removing the offending libstdc++.so file will normally resolve this issue. - Compilers on CentOS 6 and 7, do not support gcc's dual ABI feature which is needed to compile EMAN2's modern C++ code. On our build machine, devtools-7 and devtools-11 have been tested and confirmed to fail to compile EMAN2 code.
Reporting Problems
Please, provide the output of the following commands when reporting a problem. Record the session via script command. This, also, records the commands.
1 script filename.txt 2 3 conda activate eman2 4 5 conda info -a 6 conda list 7 conda list --explicit 8 9 cd <source-dir> 10 11 git status 12 git log -1 13 14 cd <build-dir> 15 16 rm CMakeCache.txt 17 cmake <source-dir> 18 cmake . -LA 19 20 make clean 21 make -j 22 make install 23 make test-verbose 24 25 conda deactivate 26 27 exit # or Ctrl+D 28
Send filename.txt.
Linux Clusters
The approach above will install EMAN with a precompiled version of OpenMPI, which may or may not work with the batch queuing system on your cluster. If it does not work, the symptom will be that MPI parallel jobs will use only a single node, no matter how many you have allocated in your job. Currently, we do not have alternative OpenMPI installation instructions.