/MultiDIC

Matlab 3D Digital Image Correlation Toolbox

Primary LanguageMATLABApache License 2.0Apache-2.0

MultiDIC: a MATLAB Toolbox for Multi-View 3D Digital Image Correlation

Summary

This is the official repository associated with the paper: MultiDIC: an Open-Source Toolbox for Multi-View 3D Digital Image Correlation (DOI: 10.1109/ACCESS.2018.2843725).
MultiDIC is an open-source MATLAB toolbox by Dana Solav. Three-dimensional (stereo) Digital Image Correlation (3D-DIC) is an important technique for measuring the mechanical behavior of materials. MultiDIC was developed to allow fast calibration and data merging even for a large number of cameras, and to be easily adaptable to different experimental requirements. If you're interested in using only 2 cameras, you should check out DuoDIC. MultiDIC integrates the 2D-DIC subset-based software Ncorr with several camera calibration algorithms to reconstruct 3D surfaces from multiple stereo image pairs. Moreover, it contains algorithms for merging multiple surfaces, and for computing and visualizing 3D displacement, deformation and strain measures. High-level scripts allow users to perform 3D-DIC analyses with minimal interaction with MATLAB syntax, while proficient MATLAB users can also use stand-alone functions and data-structures to write custom scripts for specific experimental requirements. Comprehensive documentation, instruction manual, and sample data are included.
Check out this short video for a quick demonstration of MultiDIC's capabilities:

Installation

System Requirements

MultiDIC was developed and tested on 64-bit Windows 10 and has not yet been tested on other platforms.

MATLAB

MultiDIC was developed on MATLAB versions R2017a and R2017b, and has not yet been tested on prior versions.

MATLAB toolbox dependencies:

  • Image Processing Toolbox
  • Computer Vision System Toolbox
  • Statistics and Machine Learning Toolbox

Installation Instructions

To install MultiDIC simply follow these two steps:

1. Get a copy of MultiDIC

Use one of these two options:
a. Download and unzip the latest zip file.
b. Clone MultiDIC using: git clone https://github.com/MultiDIC/MultiDIC/.git.

2. Install (or add to path)

Use one of these two options:
a. In MATLAB, navigate to the unzipped MultiDIC folder, type installMultiDIC in the command window, and hit Enter.
b. In MATLAB, Add the MultiDIC folder (with subfolders) to the path and save the path definitions.

Getting started

Check out the instruction manual. It should have all the information you need to get started.

Citing

This is the official repository for:

MultiDIC: an Open-Source Toolbox for Multi-View 3D Digital Image Correlation
Dana Solav, Kevin M. Moerman, Aaron M. Jaeger, Katia Genovese, Hugh M. Herr
DOI: 10.1109/ACCESS.2018.2843725

Please cite this paper if you use the toolbox.

Contributing

If you wish to contribute code/algorithms to this project, or to propose a collaboration study, please send an email to danask (at) mit (dot) edu.

Application Highlights

These are some examples of figures obtained using MultiDIC:

Shape change and skin deformation induced by joint movement and muscle contraction

Shape change and skin deformation induced by indentation

Publications

MultiDIC has been used in the following publications:

  1. Solav, Dana, et al. "MultiDIC: An open-source toolbox for multi-view 3D digital image correlation." IEEE Access 6 (2018): 30520-30535.
  2. Solav, Dana, et al. "A framework for measuring the time-varying shape and full-field deformation of residual limbs using 3-D digital image correlation." IEEE Transactions on Biomedical Engineering 66.10 (2019): 2740-2752.
  3. Sun, Tao, et al. "Decoding of facial strains via conformable piezoelectric interfaces." Nature biomedical engineering 4.10 (2020): 954-972.
  4. Cabrera, Isaac A., et al. "Seeing the Big Picture: Improving the prosthetic design cycle using 360 3D digital image correlation." (2020).
  5. DeNise, Adam. Implementing 3D Digital Image Correlation to Study the Dynamics of Globally-Coupled Multistable Structures. Diss. The Ohio State University, 2019.
  6. Kao, Anika Rothlin, Chang Xu, and Gregory John Gerling. "Using Digital Image Correlation to Quantify Skin Deformation with Von Frey Monofilaments." IEEE Transactions on Haptics (2021).
  7. Pisonero, Javier, et al. "A Comparative Study of 2D and 3D Digital Image Correlation Approaches for the Characterization and Numerical Analysis of Composite Materials." IEEE Access 9 (2021): 160675-160687.
  8. Atkinson, Devan, and Thorsten Hermann Becker. "Stereo Digital Image Correlation in MATLAB." Applied Sciences 11.11 (2021): 4904.
  9. Hebert, John J. "Using Multi-Dimensional Digital Image Correlation to Measure Mechanical Properties of Additively Manufactured and Anisotropic Materials."" Diss. University of Louisiana at Lafayette, 2020.
  10. Pflüger, Jonathan, Yuting Chen, and Christian Breitsamter. "Deformation Measurements of a Full Span Model with Adaptive Elasto-Flexible Membrane Wings." STAB/DGLR Symposium. Springer, Cham, 2020.
  11. Gacek, Elizabeth, Arin M. Ellingson, and Victor H. Barocas. "In Situ Lumbar Facet Capsular Ligament Strains Due to Joint Pressure and Residual Strain." Journal of biomechanical engineering 144.6 (2022): 061007.
  12. Li, Yuanzhe, et al. "Imaging dynamic three-dimensional traction stresses." Science advances 8.11 (2022): eabm0984.
  13. Jung, Yei Hwan, et al. "A wireless haptic interface for programmable patterns of touch across large areas of the skin." Nature Electronics (2022): 1-12.
  14. Álvarez-Blanco, Mario, et al. "Crack morphology in lattice-core specimens made of biopolymer via fused deposition modelling." Procedia Structural Integrity 39 (2022): 379-386.
  15. Shiraishi, Yasuyuki, et al. "In Vitro Modelling for Bulging Sinus Effects of an Expanded Polytetrafluoroethylene Valved Conduit Based on High-Speed 3D Leaflet Evaluation." 2022 44th Annual International Conference of the IEEE Engineering in Medicine & Biology Society (EMBC). IEEE, 2022.
  16. Ni, Xinchen, et al. "Soft shape-programmable surfaces by fast electromagnetic actuation of liquid metal networks." Nature communications 13.1 (2022): 1-9.
  17. Kang, Youn J., et al. "Soft skin-interfaced mechano-acoustic sensors for real-time monitoring and patient feedback on respiratory and swallowing biomechanics." npj Digital Medicine 5.1 (2022): 1-13.
  18. Sun, Weifu, et al. "Digital image correlation-aided non-destructive buckling load prediction of cylindrical shells." International Journal of Solids and Structures 254 (2022): 111941.
  19. Lee, Duncan RC. "Design and Clinical Evaluation of a Digital Transtibial Prosthetic Interface." Diss. Massachusetts Institute of Technology, 2022.
  20. Zhu, Xing, et al. "Identification of crack initiation and damage thresholds in sandstone using 3D digital image correlation." Theoretical and Applied Fracture Mechanics 122 (2022): 103653.
  21. Kim, Jin-Tae, et al. "Dynamics of plosive consonants via imaging, computations, and soft electronics." Proceedings of the National Academy of Sciences 119.46 (2022): e2214164119.
  22. Kim, Jin-Tae, et al. "Mechanics of vibrotactile sensors for applications in skin-interfaced haptic systems." Extreme Mechanics Letters 58 (2023): 101940.
  23. Ghadimi, Hamed, et al. "Effects of Printing Layer Orientation on the High-Frequency Bending-Fatigue Life and Tensile Strength of Additively Manufactured 17-4 PH Stainless Steel." Materials 16.2 (2023): 469.
  24. Álvarez-Blanco, Mario, et al. "Influence of material extrusion parameters on fracture mechanisms of polylactic acid under three-point bending." Engineering Fracture Mechanics 283 (2023): 109223.
  25. Huang, Senbin, et al. "Experimental investigations of optimized 3D Printing Planar X-joints manufactured by stainless steel and high-strength steel." Engineering Structures 285 (2023): 116054.
  26. Arias-Blanco, Adrián, et al "Experimental and numerical analysis of the influence of intramedullary nail position on the cut-out phenomenon." Computer Methods and Programs in Biomedicine (2023): 107734.

License

MultiDIC is provided under the Apache-2.0 license. The license file is found on the GitHub repository.