Main Content

normalize

Normalize anomaly score map using percentiles

Since R2024b

    Description

    normalizedMap = normalize(normalizer,map) normalizes an anomaly map, map, using the map percentile statistics computed by the percentileNormalizer object normalizer.

    Note

    This functionality requires the Automated Visual Inspection Library for Computer Vision Toolbox™. You can install the Automated Visual Inspection Library for Computer Vision Toolbox from Add-On Explorer. For more information about installing add-ons, see Get and Manage Add-Ons.

    normalizedMap = normalize(normalizer,map,Name=Value) specifies options for anomaly map normalization using one or more name-value arguments. For example, NormalOutputRange=[0 0.2] specifies the normalized map output range of a normal image as [0, 0.2].

    Input Arguments

    collapse all

    Percentile normalizer, specified as a percentileNormalizer object.

    Anomaly score map, specified as an M-by-N numeric matrix. You can produce an anomaly score map using the anomalyMap function. Larger values indicate a greater chance that the corresponding pixel is an anomaly.

    Name-Value Arguments

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: normalize(normalizer,map,NormalOutputRange=[0 0.2]) specifies the normalized map output range of a normal image as [0, 0.2].

    Normalized map output range of a normal image, specified as a two-element row vector. The percentileNormalizer function linearly maps this range to the range specified by the NormalPercentileRange name-value argument. To learn more, see Linear Mapping for Anomaly Map Normalization.

    Clipping of the normalized heat map output range, specified by a two-element row vector. This argument specifies the limits of the output normalized anomaly scores, and both values must be within the range specified by the NormalOutputRange name-value argument.

    Output Arguments

    collapse all

    Normalized anomaly score map, returned as an M-by-N numeric matrix.

    Tips

    • The normalized anomaly score values returned in the normalizedMap argument are unbounded. To limit the range of the normalized anomaly scores, such as to [0, 1] for use with anomalyMapOverlay, specify the range using the OutputClipRange name-value argument.

    Version History

    Introduced in R2024b