Note: this repository contains generated scripts (created with AI assistance during an interactive Codex CLI session) and may need adjustments for your specific workflow/data.

Tools for parsing and visualizing *.sce files (Klippel 3D Scanner).

• Python 3.x
• Packages: numpy, pandas, matplotlib

Install (example):

python -m pip install -r requirements.txt

All usage goes through the main.py CLI.

python main.py --sce path\to\your_measurement.sce --freq 100

python main.py --sce path\to\your_measurement.sce --j 14

python main.py --sce path\to\your_measurement.sce --mean-only

The animation is shown in 2D (displacement as a colormap on the (x,z) plane). The matplotlib window is interactive (zoom/pan in the toolbar). Additionally:

• Space pauses/resumes the animation (useful for zoom/pan)
• Esc / q closes the window

If you have outliers (single points with very different values), you can enable spatial smoothing of the displacement field (neighbor-based filtering on the triangulation).

Example:

python main.py --sce path\to\your_measurement.sce --freq 1400 --smooth 0.3 --smooth-iters 5

More robust smoothing for outliers:

python main.py --sce path\to\your_measurement.sce --freq 1400 --smooth 0.5 --smooth-iters 5 --smooth-method median

Or distance-weighted smoothing (more local):

python main.py --sce path\to\your_measurement.sce --freq 1400 --smooth 0.4 --smooth-iters 5 --smooth-method gaussian --smooth-sigma 4

Tasks are defined in .vscode/tasks.json:

• Run: animation (prompted)
• Run: mean amplitude (prompted)

Run them via: Terminal -> Run Task....

• main.py — CLI entrypoint (recommended way to run the app).
• animate_membrane.py — matplotlib animation + mean amplitude plot implementation (invoked by main.py).
• sce_parser.py — .sce parser utilities (geometry, frequency blocks, response blocks).