dicmain.hpp

Functions

void engine(const py::array_t<bool> &img_roi_arr, const Calib &calib, const util::Config &conf, const MultiwindowConfig &multiwindowconf, const common_util::SaveConfig &saveconf)

Runs Digital Image Correlation (DIC) engine on input image data.

This function performs 2D DIC using a specified correlation criterion, shape function, interpolation scheme, and scan method. It computes displacement fields by comparing a reference image with a stack of deformed images over a defined region of interest (ROI).

The function supports multiple scan methods including raster scan, brute force, reliability-guided, and Fourier-based approaches. It computes correlation between the reference and deformed images over subsets defined by the ROI.

Subset data is initialized and processed in parallel using OpenMP. Results are saved after processing each image.

Note

This function is intended to be called via the Python interface using pybind11. Image arrays are expected to be contiguous and C-style (row-major) in memory.

Parameters:

  • img_ref_arr – A 2D NumPy array (pybind11) representing the reference image.

  • img_def_stack_arr – A 3D NumPy array containing a stack of deformed images. Each image must have the same dimensions as the reference image.

  • img_roi_arr – A 2D boolean NumPy array specifying the region of interest (ROI). True values indicate active ROI pixels.

  • conf – Configuration parameters for the DIC engine (subset size, correlation method, etc.). This is an instance of util::Config.

  • saveconf – Output configuration for saving DIC results to disk. This is an instance of SaveConfig.

void engine_images(const std::vector<Image> &images, const py::array_t<bool> &img_roi_arr, const Calib &calib, const util::Config &conf, const MultiwindowConfig &multiwindowconf, const common_util::SaveConfig &saveconf)
void build_info()
bool should_update_ref(const int img_num_def_l, const ResultArrays &results, const util::Config &conf)