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
  

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

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

• 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.