flir_thermal.analysisRun.extremeTemperatureReadings

Description

Finds the highest and lowest finite values in a calibrated temperature image. NaN, Inf, and -Inf pixels are ignored. Coordinates are one-based image coordinates: x is the column and y is the row. If an extreme occurs more than once, MATLAB column-major order selects the first occurrence. Display palettes and color limits do not affect this calculation.

Inputs

temperatureC

Two-dimensional numeric temperature matrix in degrees Celsius. The values are converted to double before calculation.

Outputs

hotSpot

Scalar structure containing the finite maximum's x, y, and temperatureC fields.

coldSpot

Scalar structure containing the finite minimum's x, y, and temperatureC fields. Empty, nonmatrix, or all-nonfinite input returns NaN in every field of both outputs.

Failure Behavior

Empty, nonmatrix, or all-nonfinite input returns NaN readings. Values must otherwise be convertible to double; unsupported MATLAB types propagate the originating conversion error.

Example

T = [NaN 24; 18 31];
[hot, cold] = flir_thermal.analysisRun.extremeTemperatureReadings(T);
assert(hot.x == 2 && hot.y == 2 && hot.temperatureC == 31)
assert(cold.x == 1 && cold.y == 2 && cold.temperatureC == 18)