dic_params.txt

# ============================================================================
# DIC Parameters Configuration File
# Main configuration for global and DIC analysis parameters
# Lines starting with # are comments
# Format: key = value
# ============================================================================

# ============================================================================
# GLOBAL PARAMETERS
# ============================================================================

# Frictional conditions (comma-separated list)
frictional_conditions = glass,coating,coating_oil

# Number of stereo pairs
num_pair = 2

# Mirrored (MNG) rig only, used when built with -DXDIC_MODE=mirrored
# (theGlobalSettings_MNG.m: Npair and cam_order)
mirrored_num_pair = 7
mirrored_cam_order = 2,1,4,3

# Sampling frequencies
robot_sample_freq = 1000.0
vid_sample_freq = 50.0

# ============================================================================
# PATH DEFINITIONS
# ============================================================================

# Base path for the project
base_path = /Users/jaoga/devlab/MultiDIC

# Data path (location of video files and protocol files)
# Leave empty to use default: <base_path>/Data
data_path = /Users/jaoga/devlab/MultiDIC/example_data

# DIC path (location of output data from DIC)
# Leave empty to use default: <base_path>/DIC_Output
dic_path = /Users/jaoga/devlab/MultiDIC/analysis

# ============================================================================
# PROCESSING FLAGS
# ============================================================================

# Image filter mode
im_filter_mode = false

# Grayscale saturation (satur.m clipping above limit_grayscale) on imported frames.
# Set false for videos already filtered/normalised upstream (e.g. MNG rigs):
# clipping such frames flattens the speckle contrast and makes ncorr diverge.
im_saturation_mode = true

# When true, idx_frame_start/idx_frame_end/frame_jump are authoritative; the
# protocol-derived per-phase window (from the protocol .mat) is not applied.
force_frame_window = false

# Automatic processing flag
automatic_process = true

# Parallel processing flag
parallel_processing = false

# Debug mode (enables additional output and logging)
debug_mode = true

# ============================================================================
# DIC ANALYSIS PARAMETERS
# ============================================================================

# Subject identifier
subject_id = S09

# Phase identifier (e.g., loading, unloading)
phase_id = loading

# Material identifier (index into frictional_conditions, 0-based)
# 0=glass, 1=coating, 2=coating_oil
material_id = 2

# Number of conditions (comma-separated list)
nfcond_set = 5

# Speed conditions (comma-separated list)
spddxlcond_set = 0.04,0.08

# Calibration folder set
calib_folder_set = 2

# Reference trial number
ref_trial_id = 5

# ============================================================================
# FRAME SETTINGS
# ============================================================================

# Starting frame index
idx_frame_start = 1

# Ending frame index
idx_frame_end = 150

# Frame jump (process every Nth frame)
frame_jump = 1

# ============================================================================
# STEP D PARAMETERS (Initial Tracking)
# ============================================================================

# Analysis direction type: regular, reverse
step_d_analysis_type = regular

# Subset radius for tracking (pixels)
step_d_radius = 40

# Subset spacing (pixels)
step_d_spacing = 10

# Cutoff threshold for convergence
step_d_cutoff_diffnorm = 1e-5

# Number of iterations for solver
step_d_cutoff_iteration = 100

# Number of threads
step_d_total_threads = 1

# High strain analysis enabled
step_d_high_strain_enabled = true

# Seed propagation type: seed, roi
step_d_seed_type = seed

# Auto reference change
step_d_auto_update = true

# Step for reference change
step_d_step_ref_change = 10

# Initial seed point (pixel world coordinates: x,y)
# Leave empty for automatic seed selection
step_d_initial_seed = 

# ============================================================================
# STEP E PARAMETERS (Matching)
# ============================================================================

# Analysis direction type: regular, reverse
step_e_analysis_type = regular

# Subset radius for matching (pixels)
step_e_radius = 60

# Subset spacing (pixels)
step_e_spacing = 10

# Cutoff threshold for convergence
step_e_cutoff_diffnorm = 1e-5

# Number of iterations for solver
step_e_cutoff_iteration = 100

# Number of threads
step_e_total_threads = 1

# High strain analysis enabled
step_e_high_strain_enabled = true

# Seed propagation type: seed, roi
step_e_seed_type = seed

# Auto reference change
step_e_auto_update = true

# Step for reference change
step_e_step_ref_change = 10

# Initial seed point (pixel world coordinates: x,y)
# Leave empty for automatic seed selection
step_e_initial_seed = 

# ============================================================================
# STEP F PARAMETERS (Combined/Final)
# ============================================================================

# Analysis direction type: regular, reverse
step_f_analysis_type = regular

# Subset radius (pixels)
step_f_radius = 40

# Subset spacing (pixels)
step_f_spacing = 10

# Cutoff threshold for convergence
step_f_cutoff_diffnorm = 1e-5

# Number of iterations for solver
step_f_cutoff_iteration = 100

# Number of threads
step_f_total_threads = 1

# High strain analysis enabled
step_f_high_strain_enabled = true

# Seed propagation type: seed, roi
step_f_seed_type = seed

# Auto reference change
step_f_auto_update = true

# Step for reference change
step_f_step_ref_change = 10

# Initial seed point (pixel world coordinates: x,y)
# Leave empty for automatic seed selection
step_f_initial_seed = 

# ============================================================================
# CAMERA PAIRS MAPPING
# ============================================================================

# Camera pairs: semicolon-separated pairs, each pair is "cam_first,cam_second"
# Matches MATLAB import_raw_vid.m: pair1=(1,2), pair2=(4,3)
# One entry per stereopair, in pair order; must list at least num_pair entries
# (e.g. an 8-camera rig: camera_pairs = 1,2;3,4;5,6;7,8). Missing entries default
# to (2N-1, 2N). Video files, REF masks/seeds and DLT calibrations are resolved
# from these camera ids.
camera_pairs = 1,2;4,3

# ============================================================================
# STEP E: 3D RECONSTRUCTION OPTIONS
# ============================================================================

# Enable distortion removal for 3D reconstruction
# MATLAB step3_dic_rewrited.m has distortionRemovalLogic = 0 (disabled)
step_e_distortion_removal = false

# Stitching of the per-pair 3D surfaces (used when all pairs of a trial exist):
#   geometric = MATLAB-faithful overlap removal + boundary zipping (can take hours
#               on multi-pair rigs with large overlaps, e.g. 8-view MNG)
#   simple    = plain append of all pairs (overlaps kept), seconds
step_e_stitch_mode = geometric

# Accelerate the geometric stitcher's ray casts with an AABB hierarchy over the faces.
# Exact: same hits, same stitched result; it only skips triangles the ray cannot reach.
# The brute-force scan dominates Step E on rigs with several pairs (hours vs minutes).
step_e_ray_bvh = false

# ============================================================================
# STEP D: 2D DIC POST-PROCESSING OPTIONS
# ============================================================================

# Replace bad correlation subsets with filtered data
# MATLAB step2_dic_finish.m: replacebadcorr is active but slow
# Set to true to match MATLAB behavior
step_d_replacebadcorr = false

# ============================================================================
# STEP F: DEFORMATION ANALYSIS OPTIONS
# ============================================================================

# Enable temporal filtering of displacements before deformation computation
step_f_temporal_filtering = true

# Low-pass cutoff frequency (Hz) for temporal filter
step_f_freq_filt = 10.0

# Compute rigid body motion (RBM) and ARBM deformation
# MATLAB step4_dic_rewrited.m: RBM computation is commented out
step_f_compute_rbm = false

# ============================================================================
# UNITS AND CALIBRATION
# ============================================================================

# Units per pixel conversion factor (e.g., mm per pixel)
units_per_pixel = 0.2

# Default subset radius for general use (pixels)
subregion_radius = 20

# Grayscale limit threshold
# Saturation limit: 0 = automatic (70 for subject numbers < 8, 100 otherwise);
# any positive value is used as-is (needed for subjects without a number, e.g. Artem)
limit_grayscale = 0

# ============================================================================
# OUTPUT CONTROL
# ============================================================================

# File version identifier
fileversion = v2

# Data format for pipeline I/O: mat, bin, or json
# Controls the format used for saving/loading DIC2D, DIC3Dcombined, DIC3DPPresults
data_format = mat

# Generate MATLAB .mat files (legacy flag, overridden by data_format)
generate_mat_files = true

# Delete cached .bin files after use
cleanup_cache_bins = false

# ---- added by xdic_webgui ----
log_level = 
log_file =