Warning

These installation instructions are pending the release of the first version of eXSpy. In the meantime, you will need to install the development version, see instructions below.

Installation#

To install eXSpy, you have the following options (independent of the operating system you use):

  1. eXSpy is included in the HyperSpy Bundle, a standalone program that includes a python distribution and all relevant libraries (recommended if you do not use python for anything else).

  2. Installation using conda (recommended if you are also working with other python packages).

  3. Installation using pip.

  4. Installing the development version from GitHub. Refer to the appropriate section in the HyperSpy user guide (replacing hyperspy by exspy).

Installation using conda#

Follow these 3 steps to install eXSpy using conda and start using it.

1. Creating a conda environment#

eXSpy requires Python 3 and conda – we suggest using the Python 3 version of Miniforge.

We recommend creating a new environment for the eXSpy package (or installing it in the HyperSpy environment, if you have one already). To create a new environment:

  1. Load the miniforge prompt.

  2. Run the following command:

(base) conda create -n exspy -y

2. Installing the package in the new environment#

Now activate the eXSpy environment and install the package from conda-forge:

(base) conda activate exspy
(exspy) conda install -c conda-forge exspy -y

Required dependencies will be installed automatically.

Installation is completed! To start using it, check the next section.

Note

If you run into trouble, check the more detailed documentation in the HyperSpy user guide.

3. Getting Started#

To get started using eXSpy, especially if you are unfamiliar with Python, we recommend using Jupyter notebooks. Having installed eXSpy as above, a Jupyter notebook can be installed and opened using the following commands entered into an anaconda prompt (from scratch):

(base) conda activate exspy
(exspy) conda install -c conda-forge jupyterlab -y
(exspy) jupyter lab

Installation using pip#

Alternatively, you can also find eXSpy in the Python Package Index (PyPI) and install it using (requires pip):

pip install exspy

Required dependencies will be installed automatically.

Optional dependencies#

Optional dependencies can be installed using the extras. To install all optional dependencies:

pip install exspy[all]

The list of extras:

Extra

Dependencies

Usage

speed

numexpr

To speed up fitting with components supporting numexpr

gui-jupyter

hyperspy_gui_ipywidgets

To use the ipywidgets user interface

gui-traitsui

hyperspy_gui_traitsui

To use the qt user interface

And for development, the following extras are available (see pyproject.toml for more information):

  • tests

  • doc

  • dev

Updating the package#

Using conda:

conda update exspy -c conda-forge

Using pip:

pip install exspy --upgrade

Note

If you want to be notified about new releases, please Watch (Releases only) the eXSpy repository on GitHub (requires a GitHub account).