Setting up a development installation

You need a fork of the repository in order to make changes to orix.

Make a local copy of your forked repository and change directories:

git clone https://github.com/your-username/orix.git
cd orix

Set the upstream remote to the main orix repository:

git remote add upstream https://github.com/pyxem/orix.git

We recommend installing in a conda environment with the Miniconda distribution:

conda create --name orix-dev
conda activate orix-dev

Then, install the required dependencies while making the development version available globally (in the conda environment):

pip install --editable ".[dev]"

This installs all necessary development dependencies, including those for running tests and building documentation.