Augmented Lagrangian Digital Image Correlation and Tracking
AL-DIC(Augmented Lagrangian DIC) is a fast, parallel-computing hybrid DIC algorithm, which combines advantages of local subset DIC method (fast computation speed, and parallel computing) and finite-element-based global DIC method (guarantee global kinematic compatibility and decrease noise).
Welcome to give the ALDIC code ratings and comments in the MATLAB File Exchange community:
- [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] It works well with compressed DIC images and adaptive mesh. See our paper: Yang, J. & Bhattacharya, K. Exp Mech (2019). https://doi.org/10.1007/s11340-018-00459-y;
- [6] Both accumulative and incremental DIC modes are implemented to deal with image sequences, which is especially quite useful for very large deformations.
- [7] ALDIC application example -- uniaxial compression experiment: https://github.com/jyang526843/2D_ALDIC_v3/blob/master/Example_aldic_foam_compression_strain_eyy.gif
- [8] ALDIC is extended with adaptive quadtree mesh to solve complex geometry. Some examples: https://uwmadison.box.com/s/4n5hmf04rzp4la96bt2rcjk4f6o5d5nf
AL-DIC MATLAB code was tested on MATLAB versions later than R2018a. Both single thread and parallel computing features are included in AL-DIC code. Please download and unzip the code to the MATLAB working path. Then, execute the mail file: main_ALDIC.m.
Full size code manual is available at: https://www.researchgate.net/publication/344796296_Augmented_Lagrangian_Digital_Image_Correlation_AL-DIC_Code_Manual
ALDIC Matlab code demo: (Youtube) https://www.youtube.com/watch?v=JctudMfO-7w (Bilibili) https://www.bilibili.com/video/BV1hf4y1i7bK/
I also attach my EASF webinar to introduce AL-DIC/DVC algorithm and review other DIC/DVC methods: (Youtube) https://www.youtube.com/watch?v=-t61WrVagZ4 (Bilibili) https://www.bilibili.com/video/BV1ff4y1B71L/
- [1] For full details, and to use this code, please cite our paper: Yang, J. and Bhattacharya, K. Augmented Lagrangian Digital Image Correlation. Exp.Mech. 59: 187, 2018. https://doi.org/10.1007/s11340-018-00457-0. Full text can be requested at: www.researchgate.net/publication/329456141_Augmented_Lagrangian_Digital_Image_Correlation
- [2] Yang, J. (2019, March 6). 2D_ALDIC (Version 3.3). CaltechDATA. https://data.caltech.edu/records/1443
% ========================================= - [3] Yang, J. and Bhattacharya, K. Combining Image Compression with Digital Image Correlation. Exp.Mech. 59: 629-642, 2019. https://doi.org/10.1007/s11340-018-00459-y. Full text can be requested at: https://www.researchgate.net/publication/330489954_Combining_Image_Compression_with_Digital_Image_Correlation
- [4] Finite-element-based Global DIC code is also available at: https://www.mathworks.com/matlabcentral/fileexchange/82873-2d-finite-element-global-digital-image-correlation-fe-dic
- [5] Besides 2D-DIC, our new code "ALDVC" (augmented Lagrangian Digital Volume Correlation) to track deformations in volumetric images is also available: https://www.mathworks.com/matlabcentral/fileexchange/77019-augmented-lagrangian-digital-volume-correlation-aldvc
Dr. Jin Yang (Caltech majoring in solid mechanics, PhD '19): jin.yang@austin.utexas.edu -or- aldicdvc@gmail.com I appreciate your comments and ratings to help me further improve this code. If you have other questions, feel free to email me.
Cite As
Yang, J. and Bhattacharya, K. Augmented Lagrangian Digital Image Correlation. Exp.Mech. 59: 187, 2018. https://doi.org/10.1007/s11340-018-00457-0.
Yang, Jin. Augmented Lagrangian Digital Image Correlation (2D_ALDIC). CaltechDATA, 2020, doi:10.22002/D1.1443.
MATLAB Release Compatibility
Platform Compatibility
Windows macOS LinuxCategories
- Sciences > Physics > General Physics >
Tags
Community Treasure Hunt
Find the treasures in MATLAB Central and discover how the community can help you!
Start Hunting!Discover Live Editor
Create scripts with code, output, and formatted text in a single executable document.
func
func/rbfinterp
func_quadtree
func_quadtree/refinement
plotFiles
plotFiles/export_fig-d966721
Versions that use the GitHub default branch cannot be downloaded
Version | Published | Release Notes | |
---|---|---|---|
4.2.2 | Fix issues for using radial basis function-based interpolation: some warning & error messages when using "rbf_create" and "rbf_interp". All previous ALDIC releases are available here: https://github.com/jyang526843/2D_ALDIC/releases |
|
|
4.2.1 | (i) Code Section 3 is improved to estimate the initial guess.
|
|
|
4.2 | [IMPORTANT correction]: I correct the way to compute "FSubpb2World". Users who don't use code Sections 8-9 or who don't plot shear strains are not affected. Sorry about the inconvenience. |
|
|
4.1.2 | Fix minor bugs in ./plotFiles/ functions: "Plotstrain0", "Plotstrain", and "Plotdisp" where "Undefined function 'interp' for input arguments of type 'double'". |
|
|
4.1.1 | Fix two bugs in functions "Plotdisp_show.m" and "Plotstrain_show.m" for code ALDIC_v4.1. (Thank Dr. Yunlu Zhang for pointing this out!) |
|
|
4.1 | (i) Sections 8-9 are edited to convert pixel units to physical units. (ii) Fix several bugs in the quadtree mesh computing. (iii) I would like to thank all the ALDIC users in the past year. Thank you for your many helpful suggestions. Happy new year! |
|
|
4.0.1 | (i) Update code logo; (ii) Examples of applying the main_ALDIC_Quadtree.m to solve deformation of complex geometry are summarized here: https://uwmadison.box.com/s/4n5hmf04rzp4la96bt2rcjk4f6o5d5nf |
|
|
4.0 | (i) ALDIC is extended with adaptive quadtree mesh and is able to solve complex geometry. (see updated manual and example videos in results_ALDIC_Quadtree_demo folder); (ii) Improve the accuracy of solving image sequences. (iii) Merry Christmas! |
|
|
3.9 | i) Fix a bug when using a single cluster; ii) All the strain results are saved in the "ResultStrain" structure after Section 8; iii) Add Section 9 to compute stress components and saved in the "ResultStress". |
|
|
3.8 | i) Update Section 3 for computing the initial guess (0-multigrid; 1-whole field search; 2-several clicked seeds search). ii) Extend Section 8 to plot results over the first reference image. Thanks Prof Jose Outeiro for helpful discussions! |
|
|
3.7 | i) Add plots to visualize principal strains and von Mises strain; ii) Update manual and fix several typos; iii) A finite element based global DIC code is also uploaded to compare with the ALDIC code at MATLAB File Exchange. |
|
|
3.6.13 | Add my EASF webinar to introduce AL-DIC/DVC algorithm and review other DIC/DVC methods |
|
|
3.6.12 | Add code manual link |
|
|
3.6.11 | fix video bug |
|
|
3.6.10 | fix video bug |
|
|
3.6.9 | fix video bug |
|
|
3.6.8 | fix video bug |
|
|
3.6.7 | fix video bug |
|
|
3.6.6 | fix video bugs |
|
|
3.6.5 | fix video bugs |
|
|
3.6.4 | fix video bug |
|
|
3.6.3 | fix video bug |
|
|
3.6.2 | fix video bug |
|
|
3.6.1 | Fix video issue which is not showing correctly |
|
|
3.6 | Add code guide video |
|
|
3.5 | Update manual and add recent FAQs; A video demo is available online. |
|
|
3.4 | Minor changes: (i)Fix bugs in Section 8 "ComputeStrain.m" to assign ALDIC-direct-computed F; (ii)Fix possible bugs in Section 8 "Plotdisp, Plotstrain, Plotstrain0" in the special conditions when mesh spatial resolution is very fine (stepsize < 4px). |
|
|
3.3 | Update manual(v3); update Caltech DATA record. |
|
|
3.2 | (i) Correct bugs in Section 3: adaptive initial guess; (ii) Update code licenses; |
|
|
3.1 | Update "initial guess fft search method" in an adaptive way, and no need to manually assign search region anymore |
|
|
3.0 | (1) Include finite element method in Subproblem 2. (2) Include both accumulative and incremental DIC modes. |
|
|
2.2 | Update software filename |
|
|
2.1 | Correct typos. |
|
|
2.0 | 1. Multi-frames image sequence can be loaded automatically. 2. We can Provide output deformation fields with original DIC grayscale images as the background. 3. ALDIC Subproblem 2 can handle both finite difference and finite element scheme. |
|
|
1.6 | Update Manual |
|
|
1.5 | Change logo image. |
|
|
1.4 | Change logo image |
|
|
1.3 | Change logo image |
|
|
1.2 | Add researchgate paper add |
|
|
1.1 | Change folder name. |
|
|
1.0.0 |
|