Skip to main content

Tools for analyzing X-ray absorbance spectroscopy data

Project description

Build status Test coverage status Documentation status

Xanespy is a library for analyzing X-ray absorbance spectroscopy data for materials science, chemistry and similar fields. The major focus is on X-ray microscopy frames collected at multiple energies and over multiple timesteps. However, a design goal is for most (if not all) of the calculation routines to be applicable to bulk XAS data as well.

Motivation & Features

  • Importing and analysis of transmission X-ray microscopy framesets

  • Analysis of X-ray spectroscopy data (K-edge XANES and L-edge)

  • Efficient analysis of large operando datasets

Installation

Xanespy can be installed from the python package index (PyPI) using pip

$ pip install xanespy

Usage

Each beamline generally has its own importer in the xanespy.importers module, which will process the data and create an HDF5 file ready for the rest of xanespy to use

import xanespy

# Example for importing from SSRL 6-2c
xanespy.import_ssrl_frameset('<data_dir>',
                             hdf_filename='imported_data.h5')

# Load a pre-defined XAS edge or create your own subclass xanespy.Edge
edge = xanespy.k_edges['Ni_NCA']
# Now load the newly created HDF5 file and the X-ray absorbance edge
fs = xanespy.XanesFrameset(filename='imported_data.h5', edge=edge)

# Perform automatic frame alignment
fs.align_frames(passes=5)
# Fit the absorbance spectra and extract the edge position (SLOW!)
fs.fit_spectra()

# Inspect the result with the built-in Qt5 GUI
fs.qt_viewer()

Beamlines

We currently have importers for data from the following beamlines. If you would like support a beamline that is not listed and are willing to share some test data publicly, please open an issue.

  • 8-BM-B - Advanced Photon Source

  • 6-2c - Stanford Synchrotron Radiation Lightsource

  • 5.3.2.1 - Advanced Light Source (ptychography)

Ptychography

Xanespy has support for ptychography data from ALS beamline 5.3.2.1. Use xanespy.import_nanosurveyor_frameset to import the .cxi files and xanespy.PtychoFrameset to load the data.

Extended X-ray Absorbance Fine Structure (EXAFS)

Currently EXAFS analysis is NOT supported. While it would be nice to someday include this, this technique generally requires heavy user involvement and does not lend itself to batch processing; if you have expertise in automated analysis of EXAFS data, please get in touch.

License

This project is released under the GNU General Public License version 3.

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.

Acknowledgement

This work was supported as part of the NorthEast Center for Chemical Energy Storage (NECCES), an Energy Frontier Research Center funded by the U.S. Department of Energy, Office of Science, Basic Energy Sciences under Award # DE-SC0012583.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xanespy-0.1.4.tar.gz (93.8 kB view details)

Uploaded Source

Built Distribution

xanespy-0.1.4-py3-none-any.whl (108.4 kB view details)

Uploaded Python 3

File details

Details for the file xanespy-0.1.4.tar.gz.

File metadata

  • Download URL: xanespy-0.1.4.tar.gz
  • Upload date:
  • Size: 93.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for xanespy-0.1.4.tar.gz
Algorithm Hash digest
SHA256 bc1905090fb6cf973d6f1916c958fea275fbae30e617b5583d580cae1408e16d
MD5 8218a5e1fa4fff7234346de7451ae0b4
BLAKE2b-256 02283970ff0456e951851ca82d1dc19a525d6be98fc823bb839aea75ea8ea448

See more details on using hashes here.

File details

Details for the file xanespy-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for xanespy-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 50c7550522c63e5c97cdecccd7c79d5386307a3b91e18f343802960214fc73eb
MD5 30a007e91995d9f6bef8b9e12c260ebb
BLAKE2b-256 84ba4cf6d1fdbda4ab8a7e3bc89eae07b916d31fc83af5dd55a8704da945dc93

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page