While compilation and execution might be possible on other systems, it might not be straightforward. If you encounter a problem, please refer to known and fixed issues. Let us know if something is not working.
At least 2 processors are required to run Xmipp. In some virtual machine tools only one is assigned, please check that at least two processors are assigned to the virtual machine.
Xmipp requires a C++17 compatible compiler. We recommend GCC with G++; we have good experience with GCC/G++-8.4; in any case, a version >= 8.4 is required. If you use GCC/G++-10.3 and CUDA=11 and experience issues, please change the compiler version. If you use GCC-11 and experience issues, please visit this. For more details about the compilation process and installation of gcc, please visit compiler.
Xmipp requires Cmake 3.16 or above. To update it, please visit.
Xmipp supports Cuda 8 through 12.2. CUDA is optional but highly recommended. We recommend you to use the newest version available for your operating system; though Cuda 10.2 has the widest support among other Scipion plugins. Pay attention to the compiler - CUDA compatibility.
To install CUDA for your operating system, follow the official install guide.
CUDA 11.5 is not compatible with GCC - 9, please change one of these.
OpenCV is used for some programs: movie_optical_alignment (with GPU support) and volume_homogenizer; however, it is not required. If you installed OpenCV via apt (
sudo apt install libopencv-dev), it should be automatically picked up by the Xmipp script.
We sometimes see issues regarding the HDF5 dependency. Please visit the HDF5 Troubleshooting wiki.
Full list of dependencies
Before installing Xmipp, you need to ensure that your system meets certain requirements. Here are the necessary packages and dependencies:
libfftw3-dev: FFTW3 library development files.
libopenmpi-dev: OpenMPI development files.
libhdf5-dev: HDF5 library development files.
python3-numpy: NumPy library for Python 3.
python3-dev: Python 3 development headers.
libtiff5-dev: LibTIFF development files.
libsqlite3-dev: SQLite3 development files.
default-jdk: Default Java Development Kit.
git: Version control system for source code management.
cmake: Cross-platform build system.
You can install these packages on Ubuntu-based systems using the following command:
sudo apt install -y libfftw3-dev libopenmpi-dev libhdf5-dev python3-numpy python3-dev libtiff5-dev libsqlite3-dev default-jdk git cmake
Additionally, you need to install scons in the environment where Xmipp will be compiled. If you plan to run Xmipp within Scipion, you should install it in your Scipion3 environment. You can install scons using pip:
pip install scons
Finally, make sure to have a compatible compiler installed. You can install GCC 8 and G++ 8 using the following command:
sudo apt install gcc-8 g++-8
These requirements will ensure that your system is ready for installing and using Xmipp.