This project provides Matlab code and verification data for paper entitled "A joint calibration method for monocular speckle structured light system".
A preprint version of our paper can be found at https://doi.org/10.1364/opticaopen.25507099.
Run run_all.m to begin.
| Code | Description |
|---|---|
run_all.m |
A script for runing all codes. |
run_circlegrid_detect_and_dic_match.m |
Detect circle grid pattern and perform DIC matching. |
run_joint_optimization.m |
Joint optimization. |
run_depth_and_pointcloud_calc.m |
Correct images and calculate depth and point cloud. |
RefineCircleDetection.m |
Function for refining circle grid pattern detection using homologous transformation. |
DicMatch.m |
Function for DIC matching. |
Zncc.m |
Function for calculating zero-normalized cross-correlation. |
SFExpressions.m |
Function for calculating shape function. |
SubCorr.m |
Function for calculating sub-pixel correlation. |
ReprojectionError.m |
Function for calculating reprojection error. |
CorrectReferenceImage.m |
Function for correcting refecence speckle image. |
CorrectSceneImage.m |
Function for correcting scene speckle image. |
./images/Sim gives simulation data to verify the correctness of our method. The simulation data are 16-bit images. The simulation parameters are as follows.
| Parameter | Value |
|---|---|
| circle grid cols | 16 |
| circle grid rows | 12 |
| circle grid spacing | 60 |
| 75, 1, 1 | |
| 0.017465704563530, -0.0349207694917477, 750 | |
| 500, 500 | |
| 599.5, 449.5 | |
| 0, 0, 0 | |
| 0, 0 |
./images/Real gives real data to verify the feasibility and accuracy of our method. The spacing of the circle grid pattern in ./image/Real/AccuracyTest/ is 20mm.
The core algorithm included in this repository is covered by authorized Chinese Invention Patent ZL 2024 1 0309840.X.
Non-commercial Use: Free access & modification permitted for academic research, student coursework, non-profit scientific projects without any commercial revenue, no patent license required.
Commercial Use Required Official License: Any commercial deployment including industrial 3D inspection equipment, structured-light scanner, paid software, mass-produced hardware, SaaS service needs a written patent licensing agreement signed with patent owner in advance. Unauthorized commercial implementation constitutes patent infringement under Chinese Patent Law and related international IP regulations. For commercial licensing inquiry: jzx345@163.com
Furthermore, note that in the case of using this code for works related to publications (scientific or otherwise) requires citing of the source paper (citation given below).
“A joint calibration method for monocular speckle structured light system,” Optica Open, (2024), https://doi.org/10.1364/opticaopen.25507099.
We thank Yong Su et al. and Devan Atkinson et al. for their open source work on digital image correlation.
-
Su Y, Zhang Q. Glare: A free and open-source software for generation and assessment of digital speckle pattern[J]. Optics and Lasers in Engineering, 2022, 148: 106766.
-
Atkinson D, Becker T. A 117 line 2D digital image correlation code written in MATLAB[J]. Remote Sensing, 2020, 12(18): 2906.