Skip to content
/ mpes Public

Distributed data processing routines for multidimensional photoemission spectroscopy (MPES)

License

Notifications You must be signed in to change notification settings

mpes-kit/mpes

Repository files navigation

mpes

Build Status License Downloads

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.

Banner

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

  1. Install from scratch

     pip install git+https://github.com/mpes-kit/mpes.git
     
  2. Upgrade or overwrite an existing installation

     pip install --upgrade git+https://github.com/mpes-kit/mpes.git
     
  3. PyPI installation

     pip install mpes
     
  4. 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/[email protected]
     

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

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).