al-dvc 0.7.0

Full-field 3-D displacement and strain from volumetric images (micro-CT, confocal, MRI, OCT).

Available in 7 languages

pyALDVC is the Python version of the MATLAB ALDVC code (Yang, Hazlett, Landauer, Franck, Exp. Mech. 2020) and the volumetric sibling of pyALDIC: a desktop application that turns a sequence of 3-D scans into displacement and strain fields.

Why pyALDVC

• Accurate where subset DVC breaks down. Local subsets are coupled to a global smoothness step, so steep gradients, boundaries and noisy scans stay sub-voxel accurate.
• Cracks and holes stay sharp. A subset that meets a boundary keeps only the material on its own side of it, and the smoothing never crosses it, so a displacement jump survives instead of being averaged away.
• Fast. A 1024 x 1024 x 306 micro-CT scan with 79 200 nodes takes 23 s on an NVIDIA GPU, 3.6 min on a 24-core CPU.
• Point and click. Load the scans, draw the region of interest on the slices, run, look, export. No code.
• Knows your data. The texture analysis measures your scan and suggests the subset size and step.
• See it in 3-D. Field slices, the deformed lattice, displacement arrows; animations recorded as GIF or MP4.
• Strain included. Four gradient methods and four strain measures, computed after the run in their own window.
• Every format. TIFF, MATLAB, NumPy, HDF5, NIfTI, NRRD, DICOM in; NumPy, MATLAB, CSV, ParaView and a PDF report out.

Accuracy and speed

Synthetic volumes with a known deformation (subset 16, step 8), displacement error at the interior nodes:

Micro-CT scan of the MATLAB example, 1024 x 1024 x 306 voxels, 79 200 nodes:

Compared with the MATLAB code

Texture analysis

A subset too small drifts, a subset too large blurs the field. pyALDVC measures the texture of your scan and tells you what to use. The same guide is built into the application, under Help.

1. Compare a window with a shifted copy of itself. Inside a region you draw, the window slides and the similarity of the two is traced. The shift at which it has fallen to 1/e is the correlation length: the size of your features.

2. Grow the window until that length stops changing. Below the representative volume element the measurement is noise; above it, every window agrees.

3. The subset follows. Four correlation lengths per axis, stepped by half a subset: a recommended start, not a guarantee. One click writes it into the run.

Case studies

Synthetic rotation

Hydrogel indentation, micro-CT, 306 x 1024 x 1024 voxels

Install

pip install al-dvc            # add "[gpu]" for the NVIDIA backend
al-dvc-gui

No Python? Every release ships a portable Windows bundle: unzip, double-click pyALDVC.exe.

Read the user guide to get started.

Citation

J. Yang, L. Hazlett, A. K. Landauer, C. Franck. Augmented Lagrangian Digital Volume Correlation (ALDVC). Experimental Mechanics 60, 1205-1223 (2020). https://doi.org/10.1007/s11340-020-00607-3

License

BSD 3-Clause. Developed in Dr. Jin Yang's group at The University of Texas at Austin.