lauelab

Python and native tools for Laue diffraction analysis at APS beamline 34-ID-E. The package supports indexing, wire-scan reconstruction, simulation, orientation analysis, deviatoric lattice strain, and interactive visualization.

Built on LaueGo, developed by Jon Z. Tischler and collaborators. See acknowledgments and citations.

Note

lauelab is alpha software under active development. Public behavior can change before a stable release.

Read the documentation for installation requirements, indexing workflows, concepts, and API details.

Install

The package builds from source on Linux x86-64. It needs GCC, GSL, HDF5, and Python 3.11, 3.12, or 3.13. The conda environment in environment.yml provides all of them.

git clone https://github.com/AdvancedPhotonSource/lauelab.git
cd lauelab
conda env create -f environment.yml
conda activate laue-analysis
python -m pip install .

See the installation guide for the virtual-environment path and troubleshooting.

Index a frame

from lauelab.indexing import index_frame

result = index_frame(
    "frame.h5",
    geometry="geometry.xml",
    crystal="crystal.xml",
)

print(result.n_peaks, result.n_indexed, result.n_patterns)

Use Indexer to reuse one geometry and crystal configuration across frames. The subprocess-based lauego() function remains available for existing LaueGo workflows.

Test

python -m pytest