Augmented Lagrangian Digital Volume Correlation (ALDVC)

Version 1.1 (151 MB) by Jin Yang
Adaptive Lagrangian Digital Volume Correlation - volumetric displacement and strain measurement based on a hybrid local-global approach
1.9K Downloads
Updated 9 Mar 2024
Augmented Lagrangian Digital Volume Correlation (ALDVC): volumetric displacement and strain measurement based on a hybrid local-global approach. ALDVC is a fast, parallel-computing hybrid DVC algorithm, which combines advantages of local subset method (fast computation speed, and parallel computing) and finite-element-based global method (guarantee global kinematic compatibility and decrease noise).
% ===================================
Reference paper:
For full details, and to use this code, please cite our paper:
Yang, J., Hazlett, L., Landauer, A., Franck, C. Augmented Lagrangian Digital Volume Correlation. Experimental Mechanics, 2020 (https://link.springer.com/article/10.1007/s11340-020-00607-3).
Or request full text at:
https://www.researchgate.net/publication/343676441_Augmented_Lagrangian_Digital_Volume_Correlation_ALDVC
Code manual is available at:
https://www.researchgate.net/publication/343676916_Augmented_Lagrangian_Digital_Volume_Correlation_ALDVC_Code_Manual
% ===================================
Advantages of ALDVC algorithm
[1] It’s a fast algorithm using distributed parallel computing.
[2] Global kinematic compatibility is added as a global constraint in the form of augmented Lagrangian, and solved using Alternating Direction Method of Multipliers scheme.
[3] Both displacement fields and affine deformation gradients are correlated at the same time.
[4] No need of much manual experience about choosing displacement smoothing filters.
[5] Being able to compute image sequence with multiple image frames, which is especially quite useful for measuring very large deformations.
% ===================================
% ****** ATTENTION ******
% The "x,y,z" or "1-,2-,3-" coordinates in the ALDVC code always correspond to the 1st, 2nd and 3rd indices of Matlab workspace variable. For example, p_meas(:,1) and p_meas(:,2) are the x- & y-coordinates of scattered points.
%
% This is a little different from some MATLAB image processing functions. % For example, if a 3D image has size MxNxL, in this code, we always have the image size_x=M, size_y=N, size_z=L. If you use some Matlab computer vision/image post-processing function, for example, 'imagesc3D', or 'imshow3D', or 'surf', it will reads size_x=N, size_y=M, size_z=L.
%
% Please pay attention to this difference.
% ==================================================
ALDVC example dataset
Contact and support
I appreciate your comments and ratings to help me keep improving this code! Please feel free to follow this code, then you will be notified with all the important updates/corrections in the future.
% ==================================================
References
[1] regularizeNd. https://www.mathworks.com/matlabcentral/fileexchange/61436-regularizend
[2] https://www.mathworks.com/matlabcentral/fileexchange/24049-streamcolor

Cite As

Jin Yang (2024). Augmented Lagrangian Digital Volume Correlation (ALDVC) (https://github.com/FranckLab/ALDVC), GitHub. Retrieved .

Yang, J., Hazlett, L., Landauer, A., Franck, C. Augmented Lagrangian Digital Volume Correlation. Experimental Mechanics, 2020 (https://link.springer.com/article/10.1007/s11340-020-00607-3).

MATLAB Release Compatibility
Created with R2018a
Compatible with R2018a and later releases
Platform Compatibility
Windows macOS Linux
Categories
Find more on Statics and Dynamics in Help Center and MATLAB Answers

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Versions that use the GitHub default branch cannot be downloaded

Version Published Release Notes
1.1

1. Dataset links have been updated. 2. Incremental mode has been added to track large DVC deformations.

1.0.4

Fix/improve the ROI crop issue in the initial guess section (code section 3). The MATLAB file exchange may need 1-2 days to update to the newest version. Please also follow our github repository: https://github.com/FranckLab/ALDVC

1.0.3

Update code manual: add a section to describe the image pre-processing procedure to transform 3D image stacks to ALDVC input files.

1.0.2

Fix bugs in streamline plotting

1.0.1

Add "./DVC_images/GenerateVolMatfile.m" to transform 3D image stacks to volumetric matlab matfiles in ALDVC code; Add extensions to plot solved displacements and strains in body plot, cone plot, streamline, quiver plots.

1.0.0

To view or report issues in this GitHub add-on, visit the GitHub Repository.
To view or report issues in this GitHub add-on, visit the GitHub Repository.