How to start¶
Installation¶
The mpes
package and its main dependencies can be installed in the following ways:
Install from git repository
pip install git+https://github.com/mpes-kit/mpes.git
Install and upgrade to the latest version from git repository, or overwrite an existing version
pip install --upgrade git+https://github.com/mpes-kit/mpes.git
Install the latest packaged version on PyPI
pip install mpes
Install a specific version
pip install mpes==1.0.9 (version 1.0.9 from PyPI)
pip install --upgrade git+https://github.com/mpes-kit/mpes.git@0.9.8 (version 0.9.8 from GitHub)
Dependencies¶
The following are the main dependencies
numpy = 0.13.0 +
scipy = 0.19.0 +
scikit-image = 0.13.0 +
pandas = 0.19.2 +
dask >= 0.18.0
xarray
opencv
Other dependencies essential for loading the submodules are described in the requirements file. There are situations where additional dependencies are needed to execute certain functionalities that are not essential for general use. The users need to install the dependencies separately should they wish to use them, otherwise a warning would be thrown to remind the user. This construct reduces the potential conflicts between dependencies and permits the main functionalities of the package to be run without being affected by minor dependencies.
File formats¶
The main format of the raw data from an MPES experiment is in HDF5, which store the single-electron events as 2D arrays (electron index vs measured axis values) and associated machine parameters. Examples can be found in the repository on Zenodo.
The package also supports file I/O of standard file formats (.pxp and .ibw) from Igor Pro, the “native language” of photoemission data analysis. This allows to use some of the functionalities of the mpes
package for analyzing ARPES data generated from hemispherical analyzers, if needed.