Installation#

kikuchipy can be installed with pip, conda, the HyperSpy Bundle, or from source, and supports Python >= 3.7. All alternatives are available on Windows, macOS and Linux.

With pip#

kikuchipy is availabe from the Python Package Index (PyPI), and can therefore be installed with pip. To install, run the following:

pip install kikuchipy

To update kikuchipy to the latest release:

pip install --upgrade kikuchipy

To install a specific version of kikuchipy (say version 0.5.8):

pip install kikuchipy==0.5.8

Optional dependencies#

Some dependencies are optional and available via the following selectors:

  • viz: 3D plot of master patterns using pyvista

Installing optional dependencies:

pip install kikuchipy[viz]

With Anaconda#

To install with Anaconda, we recommend you install it in a conda environment with the Miniconda distribution. To create an environment and activate it, run the following:

conda create --name kp-env python=3.9
conda activate kp-env

If you prefer a graphical interface to manage packages and environments, you can install the Anaconda distribution instead.

To install:

conda install kikuchipy --channel conda-forge

To update kikuchipy to the latest release:

conda update kikuchipy

To install a specific version of kikuchipy (say version 0.5.8):

conda install kikuchipy==0.5.8

With the HyperSpy Bundle#

kikuchipy is available in the HyperSpy Bundle. See HyperSpy’s documentation for instructions.

Warning

kikuchipy is updated more frequently than the HyperSpy Bundle, thus the installed version of kikuchipy will most likely not be the latest version available. See the HyperSpy Bundle repository for how to update packages in the bundle.

From source#

To install kikuchipy from source, clone the repository from GitHub, and install with pip:

git clone https://github.com/pyxem/kikuchipy.git
cd kikuchipy
pip install --editable .

See the contributing guide for how to set up a development installation and keep it up to date.