Welcome to LaueTools's DOCUMENTATION!

Last revision (Sept. 2026)

LaueTools information on BM32 beamline website:

https://www.esrf.fr/UsersAndScience/Experiments/CRG/BM32/Microdiffraction

1- Download LaueTools code

• It is highly recommended to create a conda (or pip) environment. See INSTALL.readme

• the very last version of the code running with python3 is now on github (you are also welcome to fork this project):

  https://github.com/BM32ESRF/lauetools

• last (or older releases) with repository on pypi

  https://pypi.org/project/LaueTools/

  if pip is installed:

   pip install lauetools
  

• optional features need extra packages, installed by adding their name in brackets:

   pip install "lauetools[daxm]"   depth-resolved Laue analysis (DAXM, daxmgui): numba, photutils, pypubsub
   pip install "lauetools[hdf5]"   .hdf5 summary files (buildsummary), EIGER stacked hdf5 images: tables
   pip install "lauetools[all]"    all optional features
  

  Without them, LaueTools works normally; only these features are disabled (a message tells which package is missing).

2a- Launch Graphical User Interfaces of LaueTools

• start Lauetools GUIs from command line :

Normally, in a command window (if environment variables are well set) several GUIs can be launched:

> lauetools   for the main GUI, simulation, complex Laue pattern calibration, teaching the concepts

> peaksearch  for batch Laue pattern peak search processing
> indexrefine   for batch Laue pattern indexing and unit cell (strain) refinement
> buildsummary    to compile all results from indexrefine analysis
> plotmap    to plot 2D map of structural quantities from file built previously

> plotmeshgui   to plot 2D map from counters values in (spec) logfile

> daxmgui   for depth-resolved Laue analysis with wire scans (needs: pip install "lauetools[daxm]")

2b- Use LaueTools module as a library

With pip installation, LaueTools package will be included to python packages. Therefore any module will be callable as the following:

-In [1] : import LaueTools.readmccd as rmccd

-In [2] : rmccd.readCCDimage(‘myimage.tif’)

Some useful notebooks workflow to treat images dataset

The notebooks are installed with LaueTools. To copy them (with their YAML configuration files, the tutorials notebooks and the scripts) to a folder of your choice:

lauetools-copy -d my_folder          (default folder: ./lauetools_examples)
lauetools-copy-gui                   (choose the folder in a dialog, no terminal needed)
lauetools-copy -d my_folder -w notebooks   (only the quickstart, peaksearch and indexation notebooks)
lauetools-copy -d my_folder --download     (also download the example images from GitHub to my_folder/LaueImages)

Files already present in the folder are not overwritten (option --force to overwrite them). Then start with jupyter lab my_folder/notebooks/quickstart/laue_maps_quickstart.ipynb.

• PixelMonitoring.ipynb: Mosaic plot (map of 2D ROI centered on user-defined Laue spot) and GrainImaging plots (maps of scattering signal derived from ROI quantities). PixelMonitoring.html

• PeakSearch_Multiprocessing.ipynb: Peak search and write .dat and .cor files.

• Indexing_Multiprocessing.ipynb: Index Laue pattern (find UB and refine lattice parameters or strain) and write .fit file.