reference

`labkit.thermal.renderImage`

Map a thermal matrix to an RGB image.

Syntax

rgb = labkit.thermal.renderImage(values)
rgb = labkit.thermal.renderImage(values, opts)

Description

Linearly maps numeric values between the selected limits onto a thermal colour palette. Values below or above the limits are clipped to the first or last palette colour. NaN and Inf values use the first palette colour. This function changes only the display representation; it does not modify the source temperatures or apply a calibration.

Inputs

values: Numeric M-by-N matrix containing temperatures or raw sensor values.
opts: Optional scalar structure. See Options.

Options

Limits: Two finite, increasing numeric values [low high]. When omitted, the finite minimum and maximum of values are used. An all-nonfinite matrix uses [0 1]. A constant matrix uses [value value+1].
Palette: String scalar naming the colour palette. Allowed values are "turbo", "parula", "hot", "gray", and "iron". Default: "turbo".
Levels: Finite numeric scalar giving the palette length. Values are rounded to the nearest integer and must be at least 2. Default: 256.

Outputs

rgb: M-by-N-by-3 double array with channel values in the interval [0, 1].

Errors

Throws labkit:thermal:InvalidOptions when Limits, Palette, or Levels is invalid.

Example

temperatureC = [20 24 28; 32 36 40];
rgb = labkit.thermal.renderImage(temperatureC, ...
struct("Limits", [20 40], "Palette", "iron", "Levels", 256));
assert(isequal(size(rgb), [2 3 3]))

labkit.thermal.rawToTemperatureC — Convert FLIR raw sensor values to degrees Celsius.
labkit.thermal.readFile — Read radiometric image data and convert it to degrees Celsius.
labkit.thermal.fileDialogFilter — Create a file-selection filter for thermal images.
labkit.thermal.inspectFile — Check whether a file contains supported radiometric data.
labkit.thermal.isSupportedPath — Test whether a path has a supported thermal extension.
labkit.thermal.readFiles — Read several radiometric image files.
labkit.thermal.supportedExtensions — List the supported thermal filename extensions.
labkit.thermal.version — Return version information for the thermal API.

Source

This page is generated from the MATLAB help text in +labkit/+thermal/renderImage.m.

labkit.thermal.renderImage