├── .gitignore ├── LICENSE ├── README.md ├── cal.html ├── cal_help.html ├── cal_options.html ├── fonts ├── fw_400 │ ├── cyrillic-ext.woff2 │ ├── cyrillic.woff2 │ ├── greek-ext.woff2 │ ├── greek.woff2 │ ├── latin-ext.woff2 │ ├── latin.woff2 │ └── vietnamese.woff2 ├── fw_600 │ ├── cyrillic-ext.woff2 │ ├── cyrillic.woff2 │ ├── greek-ext.woff2 │ ├── greek.woff2 │ ├── latin-ext.woff2 │ ├── latin.woff2 │ └── vietnamese.woff2 └── local_material_icons.woff2 ├── images ├── DICe_logo_white-01.png ├── checkerboard_diagram.png ├── dots_black_diagram.png ├── dots_diagram.png ├── icons │ ├── mac │ │ └── DICe.icns │ ├── png │ │ ├── icon_128x128.png │ │ ├── icon_128x128@2x.png │ │ ├── icon_16x16.png │ │ ├── icon_16x16@2x.png │ │ ├── icon_256x256.png │ │ ├── icon_256x256@2x.png │ │ ├── icon_32x32.png │ │ ├── icon_32x32@2x.png │ │ ├── icon_512x512.png │ │ └── icon_512x512@2x.png │ └── win │ │ └── DICe.ico ├── ui-icons_444444_256x240.png ├── ui-icons_555555_256x240.png ├── ui-icons_777620_256x240.png ├── ui-icons_777777_256x240.png ├── ui-icons_cc0000_256x240.png └── ui-icons_ffffff_256x240.png ├── index.html ├── jquery-ui.min.css ├── js ├── cal.js ├── cal_options.js ├── dice.js ├── file_utils.js ├── global.js ├── jquery-3.1.0.js ├── jquery-3.1.0.min.js ├── jquery-ui.js ├── jquery.min.js ├── live_plot.js ├── live_plot_line.js ├── live_plot_tracklib.js ├── live_plot_utils.js ├── loader.js ├── parser.js ├── plotly-mod.js ├── plotly-mod.min.js ├── preview.js ├── requires.js ├── show_tracking.js ├── utils.js └── viewer.js ├── main.js ├── material_icons.css ├── open_sans.css ├── package.json └── style.css /.gitignore: -------------------------------------------------------------------------------- 1 | *~ 2 | .dice-*.js 3 | .DS_Store 4 | .project 5 | .cproject 6 | .settings 7 | /node_modules -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | // ************************************************************************ 2 | // 3 | // Digital Image Correlation Engine (DICe) 4 | // Copyright 2015 Sandia Corporation. 5 | // 6 | // Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, 7 | // the U.S. Government retains certain rights in this software. 8 | // 9 | // Redistribution and use in source and binary forms, with or without 10 | // modification, are permitted provided that the following conditions are 11 | // met: 12 | // 13 | // 1. Redistributions of source code must retain the above copyright 14 | // notice, this list of conditions and the following disclaimer. 15 | // 16 | // 2. Redistributions in binary form must reproduce the above copyright 17 | // notice, this list of conditions and the following disclaimer in the 18 | // documentation and/or other materials provided with the distribution. 19 | // 20 | // 3. Neither the name of the Corporation nor the names of the 21 | // contributors may be used to endorse or promote products derived from 22 | // this software without specific prior written permission. 23 | // 24 | // THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY 25 | // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 26 | // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 27 | // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE 28 | // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 29 | // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 30 | // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 31 | // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 32 | // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 33 | // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 34 | // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 35 | // 36 | // Questions? Contact: Dan Turner (dzturne@sandia.gov) 37 | // 38 | // ************************************************************************ -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ## DICe GUI 2 | 3 | The Electron-based desktop GUI for DICe (created with a combo of html, css, and javascript) 4 | 5 | ## Questions 6 | 7 | Contact: Dan Turner (dzturne@sandia.gov) 8 | 9 | ## License 10 | 11 | See LICENSE file -------------------------------------------------------------------------------- /cal.html: -------------------------------------------------------------------------------- 1 | 2 | 3 |
4 | 5 |total pattern width
194 | 219 |total pattern height
222 | 247 |inner pattern width
252 | 263 |inner pattern height
266 | 277 |origin offset x
282 | 294 |origin offset y
297 | 309 |Select 'perform cal' to run a calibration given a set of images using the OpenCV 31 | calibration tools through DICe.
32 |The first step in performing a calibration is selecting the image file folder. Once 33 | this folder is selected, DICe will attempt to automatically determine the file naming 34 | convention. If this fails, the components of the file naming convention need to be filled in 35 | manually. If the components of the naming convention are filled in correctly, an example 36 | image name will appear in green at the bottom of the first column on the calibration tool. 37 | If the name appears in red, this indicates that the file pattern is invalid. (note: all numbers 38 | in the filenames should be padded with zeros, for example if there are 10 images the image numbering 39 | should be _00 ... _10, not _0 ... _10, or for 100 images _000 ... _100, not _0 ... _100.)
40 |The second step is to select the pattern parameters, beginning with the type of 41 | calibration plate that is used in the images. There are three options for this: 42 | checkerboard, black dots on a white background, and white dots on a black background. Once 43 | the pattern type is selected, the user must input the dimensions of the board, including the 44 | spacing size.
45 |To preview the calibration marker extraction for a particular image, click the 46 | 'Preview' button in the left column of the tool. If the marker extraction is successful, the 47 | images will appear with a green border. A red border indicates a failed extraction.
48 |For checkerboard patterns, there are thresholding options that can be adjusted. For dot 49 | patterns, the default thresholding used involves stepping through a series of constant 50 | binary threshold values until the marker dots can be extracted. The threshold setting can be 51 | changed by de-selecting the auto-threshold check box and setting the parameters.
52 |If the calibration is successful, a cal.txt file will be created in the working 53 | directory. This file must then be loaded by pressing the 'accept' button in the calibration 54 | tool. An existing calibration file can be loaded using the 'load cal' menu option and 55 | selecting the file.
56 |For a stereo calibration, the epipolar error should be less than 0.5 pixels. Large 57 | epipolar errors happen when one or more of the images introduces too much reprojection 58 | error. If this occurrs, look at the cal.log file in the working directory to see which 59 | images have the highest error. Through trial and error, eliminate images by selecting them 60 | in the list in the right column and re-running the calibration until the error is less than 0.5 pixels.
61 |For single camera calibration, only the intrinsic parameters are estimated (such as the 62 | focal lengths, image centroids, etc). No reprojection error is calculated so there isn't a 63 | quality metric for the single camera calibration other than the RMS error.
64 |If the calibration has already been completed, or you would like to use an existing 66 | calibration file, select the 'load cal' menu option and select the desired file. DICe uses a 67 | specific xml format for calibration files, but can also read VIC3D xml files.
68 |This is a format similar to the one used in a VIC3D .z3d file. Note that the 70 | orientations for each camera are not with respect to each other, but the origin between the 71 | two cameras. The file extension must be .xml for this format to be used (.z3d files must be 72 | unzipped. The .xml file from the archive can then be loaded in DICe)
73 |