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.

Metadata

Release files for lauetools 3.2.18

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lauetools 3.2.18
File	Size	Uploaded
lauetools-3.2.18.tar.gz	13.1 MB	Oct 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for lauetools 3.2.18
File	Interpreter	ABI	Platform	Reset
lauetools-3.2.18-py3-none-any.whl 6.6 MB Oct 16, 2026	Python 3	none	any	Details

Total release size: 19.7 MB

Release files / lauetools-3.2.18.tar.gz

Download URL	lauetools-3.2.18.tar.gz
Size	13.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`2564a98f0f57efcba16dc905533ab55bb51237889e90a55e63ccfbfed4b34e93`
BLAKE2b-256 checksum How to use checksums	`f11e5f9d280ab85cb1e172162b71110023cb1b998a96e567151cf7bec574aafc`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.15`

Release files / lauetools-3.2.18-py3-none-any.whl

Download URL	lauetools-3.2.18-py3-none-any.whl
Size	6.6 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`0c7f43cc51d225e7f6d7c4e93af3af1b27c03edfac76df0c5cda6a5180371b88`
BLAKE2b-256 checksum How to use checksums	`ba0d83b763ca1ce7e7de1f07c8c4fb05eee3c6e63ea3ae9436f846e03787dace`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.15`