Metadata-Version: 2.4
Name: rixsviewer
Version: 0.2.3
Summary: A tool for visualizing and analyzing RIXS (Resonance Inelastic X-ray Scattering) data
Author-email: Miaoqi Chu <mqichu@anl.gov>, Mary Upton <mhupton@anl.gov>
License: Apache-2.0
Project-URL: Homepage, https://github.com/AZjk/rixsviewer
Project-URL: Documentation, https://github.com/AZjk/rixsviewer/blob/main/README.md
Project-URL: Repository, https://github.com/AZjk/rixsviewer
Project-URL: Bug Tracker, https://github.com/AZjk/rixsviewer/issues
Keywords: RIXS,X-ray scattering,spectroscopy,visualization,analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PySide6>=6.0.0
Requires-Dist: silx>=1.0.0
Requires-Dist: numpy>=1.20.0
Requires-Dist: scipy>=1.0.0
Requires-Dist: pyqtgraph
Requires-Dist: tifffile
Requires-Dist: pandas
Requires-Dist: matplotlib
Provides-Extra: epics
Requires-Dist: pyepics; extra == "epics"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=4.0.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=6.0.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
Requires-Dist: numpydoc>=1.5.0; extra == "docs"
Dynamic: license-file

<!-- Copyright © UChicago Argonne LLC -->
<!-- See LICENSE file for details -->
# RixsViewer

A PySide6-based GUI application for visualizing and analyzing RIXS (Resonance Inelastic X-ray Scattering) spectroscopy data.

## Features

- Load and display SPEC scan files and Lambda detector TIFF stacks
- Rowland-circle geometry binning of 2D detector images into 1D energy spectra
- Real-time auto-update mode for live data monitoring during beam time
- Calibration tools for pixel size and crystal tilt angle optimization
- Export binned spectra to SPEC-format files
- EPICS PV integration for live instrument parameter readback (optional)

## Installation

```bash
pip install rixsviewer
```

With EPICS PV support (APS beamline systems):

```bash
pip install rixsviewer[epics]
```

## Usage

```bash
rixsviewer --specfile /path/to/scan.spec --tiff-folder /path/to/tiffs/
```

Or launch without arguments and use the file browser buttons in the GUI.

## Requirements

- Python >= 3.8
- PySide6, numpy, scipy, pyqtgraph, silx, tifffile, pandas, matplotlib

## License

Apache-2.0 — Copyright © 2026 UChicago Argonne, LLC
