xARPES

xARPES

Repository for the code xARPES – extraction of the self-energy and Eliashberg function from angle-resolved photoemission spectroscopy. The documentation can be found on Read the Docs, while the code is maintained on GitHub. Instructions for installing the code and downloading the code are found below. An extensive description of the functionalities and examples is found at the arXiv preprint.

Warning

This project is currently undergoing beta testing. Some of the functionalities are in the process of being implemented. If you encounter any bugs, you can open an issue.

Contributing

Contributions to the code are most welcome. xARPES is intended to co-develop alongside the increasing complexity of experimental ARPES data sets. Contributions can be made by forking the code and creating a pull request. Importing of file formats from different beamlines is particularly encouraged. For development of the examples, the following scripts in /dev_tools could be useful:

  • The Rmd2ipynb.py file, to generate the .ipynb from which the examples can conveniently be developed; to be executed after cloning/pulling updated .Rmd and .py files, or if you prefer developing with .Rmd files.

  • The ipynb2Rmd2py.py file, to synchronise the .Rmd and .py files from the .ipynb file; to be executed right before pushing modifications to the repository. Note that this script resets some metadata in the .Rmd to prevent the tracking of their changes due to local virtual environments, etc. This scripts also places the .ipynb files inside the /doc folder, such that documentation for them can be generated.

Installation

xARPES installation can be divided into graphical package manager instructions, and command-line instructions for either conda or pip. With command-line instructions, an editable installation of xARPES can be created; on Windows, we strongly recommend Windows Powershell to do so. Here is a summary for the three options:

  • via a graphical package manager (Anaconda Navigator, VS Code, PyCharm, Spyder, JupyterLab)

  • via conda-forge, out-of-the-box or editable installation, sourcing the conda-forge package.

  • via Pip, out-of-the-box or editable installation, sourcing the PyPI package.

We strongly recommend installing xARPES in a (conda/pip) virtual environment, and to activate the environment each time before activating xARPES.

Graphical package manager installation

Most IDEs and scientific Python distributions include a GUI-based package manager.
These typically install from conda-forge (for conda environments) or PyPI (for venv/system Python).

Anaconda Navigator

  1. Open Anaconda Navigator

  2. Select or create an environment

  3. Set the package channel to conda-forge

  4. Search for “xarpes”

  5. Click Install

This installs the latest stable release from conda-forge.

PyCharm, VS Code, Spyder, or JupyterLab

These IDEs install from the active environment’s package source:

  • conda environment → installs from conda-forge

  • venv/system Python → installs from PyPI

Installation steps (generic)

  1. Open your IDE

  2. Select or create a Python environment

  3. Open the environment/package manager panel

  4. Search for “xarpes”

  5. Click Install

Conda Forge installation

Install xARPES inside a conda environment, either out of the box or as an editable.

Setting up a conda environment

Download and install Miniconda (see the Miniconda installation page).

Example for Linux:

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh  
bash Miniconda3-latest-Linux-x86_64.sh

Answer y to questions. Create and activate a new environment:

conda create -n <my_env> -c conda-forge  
conda activate <my_env>

Where <my_env> must be replaced by your desired name. Package compatibility issues may arise if conda installs from different channels. This can be prevented by appending --strict-channel-priority to the creation command.

Installing xARPES

Option A — Out-of-the-box installation (from conda-forge)

conda install conda-forge::xarpes

Option B — Editable installation (GitHub)

First, clone the repository:

git clone git@github.com:xARPES/xARPES.git  
cd xARPES

Then perform editable installation (this mixes conda and pip):

pip install -e .

Pip installation

Install xARPES using pip, either out of the box or as an editable.

Setting up a virtual environment

Install venv if necessary:

sudo apt install python3-venv

Create and activate a virtual environment:

python3 -m venv <my_env>  
source <my_env>/bin/activate

Upgrade pip:

python3 -m pip install --upgrade pip

Installing xARPES

Option A — Out-of-the-box installation (PyPI)

python3 -m pip install xarpes

Option B — Editable installation (GitHub)

First, clone the repository:

git clone git@github.com:xARPES/xARPES.git  
cd xARPES

Then perform editable installation:

pip install -e .

Examples

After installation of xARPES, the examples/ folder can be downloaded from the terminal into the current directory:

xarpes_download_examples

This attempts to download the examples from the version corresponding encountered in __init__.py. If no corresponding tagged version can be downloaded, the code attempts to download the latest examples instead.

The examples can also be installed by executing .pyor .ipynb executable files containing the following:

import xarpes
xarpes.download_examples()

Execution

It is recommended to use JupyterLab to analyse data. JupyterLab is launched using:

jupyter lab

Citation

If you have used xARPES for your research, please cite the following preprint:
arXiv preprint 2508.13845.

License

Copyright (C) 2025 xARPES Developers

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 3, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.