.. _Mpes-Structure:

=======================================
Photoemission & core-level spectroscopy
=======================================

.. index::
   IntroductionMpes
   MpesAppDef
   MpesBC
   MpesCommonBC
   MpesExtendedBC


.. _IntroductionMpes:

Introduction
############

Set of data storage objects to describe photoemission experiments including x-ray photoelectron spectroscopy (XPS), ultraviolet photoelectron spectroscopy (UPS),
hard x-ray photoelectron spectroscopy (HAXPES), angle-resolved photoemission spectroscopy (ARPES), two-photon photoemission (2PPE) 
and photoemission electron microscopy (PEEM). Also includes descriptors for advanced specializations, such as spin-resolution, time resolution, 
near-ambient pressure conditions, dichroism etc.

.. _MpesAppDef:

Application Definitions
#######################

:ref:`NXmpes`:
   A general appdef with minimalistic metadata requirements, apt to describe all photemission experiments.

.. _MpesBC:

Base Classes
############

:ref:`NXelectronanalyser`:
   A base class to describe electron kinetic energy analizers. Contains the collective characteristics of the instrument such as energy resolution, and includes the following subclasses:

      :ref:`NXcollectioncolumn`:
         Base class to describe the set of electronic lenses in the electron collection column (standard, PEEM, momentum-microscope, etc.).

      :ref:`NXenergydispersion`:
         Base class to describe the energy dispersion sytem (hemispherical, time-of-flight, etc.).

      :ref:`NXspindispersion`:
         Base class to describe the set of electronic lenses in the electron collection column.

:ref:`NXmanipulator`:
   A base class to describe the complex manipulators used in photoemission experiments, often with > 4 degrees of freedom, 
   cryogenic cooling and other advanced features.

Three base classes to describe data processing, which can be used as subclasses of :ref:`NXprocess` if describing post-processing or as subclasses of :ref:`NXdetector` if describing live, electronics level processing:

    :ref:`NXcalibration`:
       A base class to describe the 1D calibration of an axis, with a function mapping a raw data scale to a calibrated scale with the same number of points.

    :ref:`NXdistortion`:
       A base class to describe the 2D distortion correction of an axis, with a matrix mapping a raw data image to a undistorted image.

    :ref:`NXregistration`:
       A base class to describe the rigid transformations that are applied to an image. May be redundant as they can be described with :ref:`NXtransformations`.

.. _MpesCommonBC:

Common Base Classes
###################

There are two related base classes that are common to other techniques:

    :ref:`NXlens_em`:
       A class to describe all types of lenses. Includes electrostatic lenses for electron energy analysers.

    :ref:`NXdeflector`
       A class to describe all kinds of deflectors, including electrostatic and magnetostatic deflectors for electron energy analysers.