Metadata-Version: 2.2
Name: xraylarch
Version: 2025.1.0.post0+g4c4d0de0.d20250112
Summary: Synchrotron X-ray data analysis in python
Home-page: https://xraypy.github.io//xraylarch
Author: Matthew Newville and the xraylarch development team
Author-email: newville@cars.uchicago.edu
License: MIT License
Project-URL: Source, https://github.com/xraypy/xraylarch
Project-URL: Documentation, https://xraypy.github.io/xraylarch/
Project-URL: Tracker, https://github.com/xraypy/xraylarch/issues
Keywords: X-ray,XAS,XRF
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: numpy<2,>=1.23
Requires-Dist: scipy>=1.13
Requires-Dist: lmfit>=1.3.1
Requires-Dist: asteval>=1.0.4
Requires-Dist: uncertainties>=3.2.1
Requires-Dist: pyshortcuts>=1.9.5
Requires-Dist: xraydb>=4.5.5
Requires-Dist: larixite
Requires-Dist: silx>=0.15.2
Requires-Dist: matplotlib>=3.5
Requires-Dist: sqlalchemy>=2.0
Requires-Dist: sqlalchemy_utils
Requires-Dist: h5py>=3.2
Requires-Dist: hdf5plugin
Requires-Dist: pillow>=8.3.2
Requires-Dist: numdifftools>=0.9.41
Requires-Dist: pandas
Requires-Dist: packaging
Requires-Dist: pip
Requires-Dist: pyyaml
Requires-Dist: toml
Requires-Dist: termcolor
Requires-Dist: dill
Requires-Dist: imageio
Requires-Dist: charset-normalizer
Requires-Dist: requests
Requires-Dist: scikit-image
Requires-Dist: scikit-learn
Requires-Dist: psutil
Requires-Dist: pymatgen>=2024.8.9
Requires-Dist: mp_api
Requires-Dist: fabio
Requires-Dist: pyfai
Requires-Dist: numexpr>=2.8.7
Provides-Extra: wxgui
Requires-Dist: wxpython>=4.2; extra == "wxgui"
Requires-Dist: wxutils>=0.3.0; extra == "wxgui"
Requires-Dist: wxmplot>=0.9.57; extra == "wxgui"
Provides-Extra: qtgui
Requires-Dist: PyQt5; extra == "qtgui"
Requires-Dist: pyqtwebengine; extra == "qtgui"
Requires-Dist: pyqtgraph; extra == "qtgui"
Provides-Extra: epics
Requires-Dist: pyepics>=3.5.6; extra == "epics"
Requires-Dist: psycopg2-binary; extra == "epics"
Provides-Extra: jupyter
Requires-Dist: jupyter_core>=5.0; extra == "jupyter"
Requires-Dist: jupyter_client; extra == "jupyter"
Requires-Dist: jupyter_server; extra == "jupyter"
Requires-Dist: notebook; extra == "jupyter"
Requires-Dist: nbformat; extra == "jupyter"
Requires-Dist: ipywidgets; extra == "jupyter"
Requires-Dist: plotly; extra == "jupyter"
Requires-Dist: bokeh; extra == "jupyter"
Requires-Dist: py3dmol; extra == "jupyter"
Provides-Extra: doc
Requires-Dist: sphinx; extra == "doc"
Requires-Dist: numpydoc; extra == "doc"
Requires-Dist: sphinxcontrib-bibtex; extra == "doc"
Requires-Dist: sphinxcontrib-argdoc; extra == "doc"
Requires-Dist: pycairo; platform_system == "Windows" and extra == "doc"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: coverage; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: twine; extra == "dev"
Provides-Extra: larix
Requires-Dist: wxpython>=4.2; extra == "larix"
Requires-Dist: wxutils>=0.3.0; extra == "larix"
Requires-Dist: wxmplot>=0.9.57; extra == "larix"
Requires-Dist: jupyter_core>=5.0; extra == "larix"
Requires-Dist: jupyter_client; extra == "larix"
Requires-Dist: jupyter_server; extra == "larix"
Requires-Dist: notebook; extra == "larix"
Requires-Dist: nbformat; extra == "larix"
Requires-Dist: ipywidgets; extra == "larix"
Requires-Dist: plotly; extra == "larix"
Requires-Dist: bokeh; extra == "larix"
Requires-Dist: py3dmol; extra == "larix"
Provides-Extra: all
Requires-Dist: pytest; extra == "all"
Requires-Dist: pytest-cov; extra == "all"
Requires-Dist: coverage; extra == "all"
Requires-Dist: build; extra == "all"
Requires-Dist: pre-commit; extra == "all"
Requires-Dist: twine; extra == "all"
Requires-Dist: sphinx; extra == "all"
Requires-Dist: numpydoc; extra == "all"
Requires-Dist: sphinxcontrib-bibtex; extra == "all"
Requires-Dist: sphinxcontrib-argdoc; extra == "all"
Requires-Dist: pycairo; platform_system == "Windows" and extra == "all"
Requires-Dist: wxpython>=4.2; extra == "all"
Requires-Dist: wxutils>=0.3.0; extra == "all"
Requires-Dist: wxmplot>=0.9.57; extra == "all"
Requires-Dist: PyQt5; extra == "all"
Requires-Dist: pyqtwebengine; extra == "all"
Requires-Dist: pyqtgraph; extra == "all"
Requires-Dist: jupyter_core>=5.0; extra == "all"
Requires-Dist: jupyter_client; extra == "all"
Requires-Dist: jupyter_server; extra == "all"
Requires-Dist: notebook; extra == "all"
Requires-Dist: nbformat; extra == "all"
Requires-Dist: ipywidgets; extra == "all"
Requires-Dist: plotly; extra == "all"
Requires-Dist: bokeh; extra == "all"
Requires-Dist: py3dmol; extra == "all"
Requires-Dist: pyepics>=3.5.6; extra == "all"
Requires-Dist: psycopg2-binary; extra == "all"

Larch:  Data Analysis Tools for X-ray Spectroscopy and More
============================================================

.. image:: https://github.com/xraypy/xraylarch/actions/workflows/test-ubuntu.yml/badge.svg
   :target: https://github.com/xraypy/xraylarch/actions/workflows/test-ubuntu.yml
.. image::  https://github.com/xraypy/xraylarch/actions/workflows/test-windows.yml/badge.svg
   :target: https://github.com/xraypy/xraylarch/actions/workflows/test-windows.yml

.. _scipy: https://scipy.org/
.. _numpy: https://numpy.scipy.org/
.. _matplotlib: https://matplotlib.org/
.. _h5py: https://code.google.com/p/h5py/
.. _Demeter: https://bruceravel.github.io/demeter/

* Documentation: http://xraypy.github.io/xraylarch
* Code: http://github.com/xraypy/xraylarch

Larch is an open-source library and set of applications for processing and
analyzing X-ray absorption and fluorescence spectroscopy data and X-ray
fluorescence and diffraction image data from synchrotron beamlines.  It is
especially focussed on X-ray absorption fine-structure spectroscopy (XAFS)
including X-ray absorption near-edge spectroscopy (XANES) and extended
X-ray absorption fine-structure spectroscopy (EXAFS). It also supports
visualization and analysis tools for X-ray fluorescence (XRF) spectra and
XRF and X-ray diffraction (XRD) images as collected at scanning X-ray
microprobe beamlines.

Larch is written in Python, making heavy use of the excellent scientific
python libraries (`numpy`_, `scipy`_, `h5py`_, `matplotlib`_, and many
more). Larch can be used as a Python library for processing and analyzing
X-ray spectroscopy and imaging data. In addition, the applications built
with it also use a built-in Python-like macro language for interactive and
batch processing.  This embedded "miniPython" language is intended to be very
easy to use for novices while also being complete enough to automate data
processing and analysis and to encourage and facilitate a gentle transition
to transition from GUI-only analyses to scripted and programmatic analysis
of larger data sets, and allows Larch to be run as a
service, interacting with other processes or languages via XML-RPC, and so
be used by the popular `Demeter`_ XAFS application suite.


Larch is distributed under an open-source license that is nearly identical
to the BSD license.  It is under active and open development centered at
the GeoScoilEnviroCARS sector of the Center for Advanced Radiation Sources at
the University of Chicago has been supported by the US National Science
Foundation - Earth Sciences (EAR-1128799), and Department of Energy
GeoSciences (DE-FG02-94ER14466).  In addition, funding specifically for
Larch was granted by the National Science Foundation - Advanced
CyberInfrastructure (ACI-1450468).

The best citable reference for Larch is M. Newville, *Larch: An Analysis
Package For XAFS And Related Spectroscopies*. Journal of Physics:
Conference Series, 430:012007 (2013).

Larch Applications
-----------------------

These applications installed with Larch, in addition to a basic Python
library. Here, GUI = Graphical User Interface, CLI = Command Line
Interface, and `beta` indicates a work in progress.


+-------------------+------------+---------------------------------------------------------+
| Application Name  | GUI/CLI    | Description                                             |
+===================+============+=========================================================+
| larch             | CLI        | simple shell command-line interface                     |
+-------------------+------------+---------------------------------------------------------+
| Larch GUI         | GUI        | enhanced command-line interface with data browser       |
+-------------------+------------+---------------------------------------------------------+
| Larix             | GUI        | XAFS Processing and Analysis: XANES pre-edge peak       |
| (was XAS Viewer)  |            | fitting, linear analysis, PCA/LASSO, EXAFS processing,  |
|                   |            | Running Feff, fitting EXAFS data to Feff paths.         |
+-------------------+------------+---------------------------------------------------------+
| GSE Map Viewer    | GUI        | XRF Map Viewer for GSECARS X-ray microprobe data.       |
+-------------------+------------+---------------------------------------------------------+
| larch_xrf         | GUI        | Display and analyze XRF Spectra.                        |
+-------------------+------------+---------------------------------------------------------+
| larch_xrd1d       | GUI        | Display and work with 1-D XRD patterns, integrate XRD   |
|                   |            | images, search for XRD patterns of known structures     |
+-------------------+------------+---------------------------------------------------------+
| feff6l            | CLI        | Feff 6 EXAFS calculations                               |
+-------------------+------------+---------------------------------------------------------+
| feff8l            | CLI        | Feff 8 EXAFS calculations (no XANES)                    |
+-------------------+------------+---------------------------------------------------------+
| qtrixs            | GUI `beta` | Display RIXS planes, take profiles                      |
+-------------------+------------+---------------------------------------------------------+
