A free, standalone desktop tool to explore operando X-ray diffraction series: stack hundreds of patterns into a contour plot or a waterfall, play them as an animation, and show the electrochemical cycling curve next to them, aligned on the same axis.
Website: https://jeannoelchotard.github.io/OperandoViewer/
- Contour plot (2θ / time / intensity as colour) with an intensity-scale control (linear, square root, gamma, logarithmic, percentile clipping, min/max) so a few very intense peaks do not flatten the weak ones. Zoom on 2θ with the mouse or by typing a range.
- Waterfall view, 2D or interactive 3D, with horizontal/vertical offsets, a "1 curve out of N" filter, and highlighted curves (one colour per chosen pattern, thicker lines).
- Single animation (one pattern at a time) and cumulative animation (patterns pile up as the experiment progresses), both exportable as MP4.
- Electrochemistry panel (EC-Lab
.mptor generic.csv) next to every view. In the animations, a marker follows the current pattern on the curve, and you can drag it along the curve to scrub through the patterns. - Exports: PDF / SVG (vector) and PNG for figures, MP4 for animations, and CSV / Excel files of the data (patterns as columns, intensity matrix, electrochemistry) to re-plot in Origin or Excel.
| Waterfall with highlighted curves | Cumulative animation |
|---|---|
![]() |
![]() |
Get OperandoViewer_vX.Y.Z.exe (the file name carries the version) from the latest release
and double-click it. No Python installation is needed.
The executable is not code-signed, so Windows SmartScreen may show a warning the first time: click More info → Run anyway. The first start can take a few seconds.
macOS and Linux users: run the script with Python (see below).
You can also run (or read) the Python script itself. Three ways to get it, no git knowledge needed:
- A specific version: open the latest release
and, in the Assets list at the bottom, click
operando_viewer_vX.Y.Z.py(the file name carries the version). - Just the file: open
operando_viewer.pyin this repository and click the Download raw file icon (the downward arrow, top right of the code box). - The whole project (script, example data, requirements): click the green Code button, then Download ZIP.
Then install the requirements and run it, as explained below.
Requires Python 3 with Tkinter (included in the standard Windows/macOS installers; on Debian/Ubuntu:
sudo apt install python3-tk). Developed and tested with Python 3.14.
pip install numpy matplotlib openpyxl
python operando_viewer.py(pip install -r requirements.txt does the same if you downloaded the whole project.)
For MP4 export you also need ffmpeg available in your PATH
(Windows: winget install ffmpeg, macOS: brew install ffmpeg, Linux: sudo apt install ffmpeg).
The examples/ folder contains a small synthetic dataset (not a real measurement):
- Data tab → From a .buf file → choose
examples/synthetic_series.buf(or Select files… and pick the.xyfiles inexamples/synthetic_series/). - Data tab → Load .csv… → choose
examples/synthetic_echem.csv(the Voltage and Test_Time columns are selected automatically). - Switch between the Contour, Waterfall and animation tabs.
| Data | Format |
|---|---|
| Diffraction patterns | Plain-text files with two numeric columns (2θ, intensity): .xy, .dat, .uxd… Header and comment lines are skipped. Select the files directly (natural sort order), or give a .buf file listing one path per line (relative to the .buf file or absolute). |
| Time / Y axis of the series | Linear (start + step), a one-value-per-line CSV, or automatically aligned on the chosen electrochemistry column. |
| Electrochemistry | EC-Lab .mpt (header length, encoding and decimal comma handled), or a generic .csv (comma, semicolon or tab separated, with or without header). Any numeric column can be used for the X and Y axes. Columns that oscillate with charge/discharge (capacity, x in Lix…) can be "unwrapped" into a steadily increasing axis. |
pip install pyinstaller
python -m PyInstaller --onefile --windowed --name OperandoViewer operando_viewer.pyThe executable is created in dist/.
Questions, bug reports or ideas for changes are welcome:
- open an issue on GitHub, or
- write to Jean-Noël Chotard — jean-noel.chotard@u-picardie.fr
If this software helps your research, please cite it (see CITATION.cff; GitHub's
"Cite this repository" button gives ready-made BibTeX and APA entries).
MIT © 2026 Jean-Noël Chotard


