Installation

Installation from PyPI or conda

Stable versions of icet are provided via PyPi and as part of conda-forge. This implies that icet can be installed using pip via:

pip install icet --user

or using conda via:

conda install -c conda-forge icet

The PyPI package is provided as a source distribution. As a result, the C++ core library has to be compiled as part of the installation, which requires a C++11 compliant compiler to be installed on your system, e.g., GCC 4.8.1 and above or Clang 3.3 and above. By contrast the conda package contains pre-compiled binaries.

Installing the development version

If you want to use the most recent (development) version you can install directly from the git repository:

pip install --user git+https://gitlab.com/materials-modeling/icet.git

Testing

To test that your installation works as expected, you can run the icet test suite, which can be accomplished as follows:

curl -O https://icet.materialsmodeling.org/tests.zip
unzip tests.zip
python3 tests/main.py

Dependencies

icet is based on Python3 and invokes functionality from other Python libraries, including ase, pandas, numpy, scipy, and spglib. The icet C++ core library depends on Eigen, boost, and pybind11, which are included in the distribution as third-party libraries.