Augmented Lagrangian Digital Image Correlation and Tracking

Version 4.2.2 (84.8 MB) by Jin Yang
2D-AL-DIC(Augmented Lagrangian DIC) is a fast, parallel-computing DIC algorithm which also considers global kinematic compatibility.

3.2K Downloads

Updated 25 Sep 2022

From GitHub

View License on GitHub

Augmented Lagrangian Digital Image Correlation (2D_ALDIC)

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:

View Augmented Lagrangian Digital Image Correlation and Tracking on File Exchange

Advantages of AL-DIC 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] 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

Prerequisites & Installation

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.

Code manual

Full size code manual is available at: https://www.researchgate.net/publication/344796296_Augmented_Lagrangian_Digital_Image_Correlation_AL-DIC_Code_Manual

Code demo videos

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/

Citation

Contact and support

Jin Yang (Caltech solid mechanics, PhD '19): jyang526@wisc.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.

View more styles
MATLAB Release Compatibility
Created with R2018b
Compatible with R2017b to R2020a
Platform Compatibility
Windows macOS Linux
Categories

Community Treasure Hunt

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

Start Hunting!

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.
(ii) Matlab file exchange may have some time delay to update. If you cannot find an included manual called "manual_v4.2", please visit this link: https://github.com/jyang526843/2D_ALDIC

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

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.