dic_postprocess.analysisRun.prepareOutputs

Inputs

inputs

Scalar source struct with referenceImage, maskImage, and strain. strain must contain exx, eyy, and roiMask arrays on a common DIC grid.

parameters

Scalar display struct described below.

Parameters

alpha

Overlay blend fraction.

colorMin

Lower shared EXX/EYY strain color limit.

colorMax

Upper shared EXX/EYY strain color limit.

oversample

Strain-grid interpolation enlargement factor.

smoothSigma

Gaussian smoothing sigma.

edgeTrim

Valid strain edge pixels removed before interpolation.

brightness

Additive normalized reference brightness adjustment.

contrast

Reference contrast multiplier around 0.5.

gamma

Reference-image intensity exponent.

saturation

Reference HSV saturation multiplier.

redGain

Reference red-channel multiplier.

greenGain

Reference green-channel multiplier.

blueGain

Reference blue-channel multiplier.

Outputs

summaryTable

Five-row table of Mean, Std, Median, Min, and Max with EXX and EYY columns.

overlayExx

Double RGB EXX overlay at referenceImage size.

overlayEyy

Double RGB EYY overlay at referenceImage size.

Description

prepareOutputs is the GUI-free composition used by the app. It converts the mask image to a logical display mask, uses a fixed 256-color jet map for both components, renders EXX and EYY with identical display parameters, and summarizes finite strain samples inside roiMask when supplied.

Failure Behavior

Missing input/parameter fields, incompatible EXX/EYY/mask geometry, or invalid display values propagate the originating field-access, overlay, or summary error. The function does not catch partial-output failures.

Typical Call

[summary, exxImage, eyyImage] = ...
dic_postprocess.analysisRun.prepareOutputs(inputs, parameters);