Distributed data processing routines for multidimensional photoemission spectroscopy (MPES)
Project description
mpes
Distributed data processing routines for multidimensional photoemission spectroscopy (MPES), an upgrade of the angle-resolved photoemission spectroscopy (ARPES) to achieve parallel data acquisition on multiple parameters by the use of a time-of-flight tube and a multichannel delay-line detector.
In a photoemission process, an extreme UV or X-ray photon liberates an electron from the confines of the electronic potential within the material. ARPES directly measures the electronic energy and momentum parallel to the surface of the sample under study to infer the electronic states of the material. For a tutorial review on ARPES and its applications in physics and material science, see here. The data structure of ARPES is a stack of 2D images measured at different sample geometries, which are used to reconstruct the full static 3D band structure of the material.
The MPES instrument enables sampling of the multidimensional parameter space associated with the electronic band structure at an elevated speed. At the minimum, it measures the two parallel momenta and the energy of photoelectrons simultaneously. The measurement procedure can be extended with recording of varying external parameters such as the temperature, photon polarization, dynamical time delay as in a time-resolved ARPES (trARPES) experiments using a ultrafast laser system (~ fs resolution), etc. These different flavors of momentum-resolved photoemission experiment together yield a complete understanding of the electronic properties of materials under equilibrium and nonequilibrium conditions for realistic design and simulation of electronic devices.
Installation
-
Install from scratch
pip install git+https://github.com/mpes-kit/mpes.git
-
Upgrade or overwrite an existing installation
pip install --upgrade git+https://github.com/mpes-kit/mpes.git
-
PyPI installation
pip install mpes
-
Install a specific version
# version 1.0.9 from PyPI pip install mpes==1.0.9 # version 0.9.8 from GitHub pip install --upgrade git+https://github.com/mpes-kit/mpes.git@0.9.8
Documentation and tutorials
Documentation on the usage is posted here and examples are provided in Jupyter notebooks.
List of current tutorials are viewable using nbviewer via the links
- Tutorial_01_HDF5 File Management
- Tutorial_02_Data Binning
- Tutorial_03_Rebinning Artefacts
- Tutorial_04_Distortion Correction
- Tutorial_05_Axes Calibration
- Tutorial_06_MPES_Workflow
The size of the single-event datasets used in the tutorial notebooks are in the GB to TB range each, which reflect the actual examperimental setting and the light source configuration (see here for technical details). Example datasets are made available publicly in a Zenodo repository. Please always use the latest version of the datasets.
Reference
If you want to refer the software in your work, please cite the following paper.
R. P. Xian, Y. Acremann, S. Y. Agustsson, M. Dendzik, K. Bühlmann, D. Curcio, D. Kutnyakhov, F. Pressacco, M. Heber, S. Dong, T. Pincelli, J. Demsar, W. Wurth, P. Hofmann, M.Wolf, M. Scheidgen, L. Rettig, R. Ernstorfer, An open-source, end-to-end workflow for multidimensional photoemission spectroscopy, Sci. Data 7, 442 (2020).
Specifically, for the symmetry distortion correction, please cite
R. P. Xian, L. Rettig, R. Ernstorfer, Symmetry-guided nonrigid registration: The case for distortion correction in multidimensional photoemission spectroscopy, Ultramicroscopy 202, 133 (2019).
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.