flir_thermal.analysisRun.pointTemperatureReading

Description

Samples the nearest pixel in a calibrated temperature image. Coordinates are rounded to integers and limited to the image bounds, so a point outside the image samples the nearest edge pixel. The function does not change the image, draw a marker, or apply display color limits.

Inputs

temperatureC

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

pointXY

Numeric image coordinate [x y], where x is the column and y is the row. Additional values are ignored. Both selected values must be finite.

Outputs

reading

Scalar structure with x, y, and temperatureC fields. x and y are the effective one-based integer pixel coordinates. An empty or nonmatrix image, or a coordinate without two finite values, returns NaN in all fields. A nonfinite sampled pixel remains nonfinite in the result.

Failure Behavior

Invalid image geometry or fewer than two finite coordinates returns a NaN reading. Inputs must otherwise be convertible to double; unsupported MATLAB types propagate the originating conversion error.

Example

T = [10 20 30; 40 50 60];
reading = flir_thermal.analysisRun.pointTemperatureReading(T, [2.2 1.7]);
assert(reading.x == 2 && reading.y == 2 && reading.temperatureC == 50)