classify
Description
predicts whether test image isAnomaly
= classify(detector
,I
)I
is anomalous or normal, given an anomaly
detector with an anomaly threshold.
Note
This functionality requires Deep Learning Toolbox™ and 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.
specifies options using one or more name-value arguments. For example,
isAnomaly
= classify(detector
,I
,Name=Value
)classify(detector,I,MiniBatchSize=32)
limits the batch size to
32.
Examples
Calculate Metrics for Trained FCDD Anomaly Detector
Load test images and corresponding labels, then create a datastore that reads the test data. The data set consists of grayscale images of handwritten digits 0–9.
[Xtest,gtLabels] = digitTest4DArrayData; dsTest = arrayDatastore(Xtest,IterationDimension=4);
Load a pretrained FCDD anomaly detector. This detector has been trained to classify the digit 8 as normal and all other digits as anomalies. Therefore, specify the set of anomaly labels as the set of digits between 0 and 9, excluding 8.
load("digit8AnomalyDetector.mat"); anomalyLabels = setdiff(string(0:9),"8");
Classify each test image as normal or anomalous.
predLabels = classify(detector,dsTest);
Calculate metrics for the anomaly detection results.
metrics = evaluateAnomalyDetection(predLabels,gtLabels,anomalyLabels)
Evaluating anomaly detection results ------------------------------------ * Finalizing... Done. * Data set metrics: GlobalAccuracy MeanAccuracy Precision Recall Specificity F1Score FalsePositiveRate FalseNegativeRate ______________ ____________ _________ ______ ___________ _______ _________________ _________________ 0.7662 0.839 0.98971 0.748 0.93 0.85204 0.07 0.252
metrics = anomalyDetectionMetrics with properties: ConfusionMatrix: [2x2 table] NormalizedConfusionMatrix: [2x2 table] DataSetMetrics: [1x8 table] ClassMetrics: [2x2 table]
Display the confusion matrix.
cm = metrics.ConfusionMatrix
cm=2×2 table
Normal Anomaly
______ _______
Normal 465 35
Anomaly 1134 3366
Input Arguments
detector
— Anomaly detector
efficientADAnomalyDetector
(since R2024b)
object | fcddAnomalyDetector
object | fastFlowAnomalyDetector
object | patchCoreAnomalyDetector
object
Anomaly detector, specified as an efficientADAnomalyDetector
object, an fcddAnomalyDetector
object, a fastFlowAnomalyDetector
object, or a patchCoreAnomalyDetector
object. You must set the
Threshold
property of the detector before calling this
function.
I
— Test image
numeric array | datastore | formatted dlarray
object
Test image, specified in one of these formats:
Format | Supported Detectors |
---|---|
M-by-N-by-3 numeric array representing a truecolor image. | EfficientAD, FCDD, FastFlow, PatchCore |
M-by-N-by-3-by-B numeric array representing a batch of B truecolor images. | EfficientAD, FCDD, FastFlow, PatchCore |
Datastore that reads and returns truecolor images. The images must all have the same size. | EfficientAD, FCDD, FastFlow, PatchCore |
Formatted | EfficientAD, FCDD, FastFlow |
FCDD anomaly detectors also support grayscale test images, with one color channel instead of three.
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: isAnomaly = classify(detector,I,MiniBatchSize=32)
limits the
batch size to 32.
MiniBatchSize
— Size of batches
128
(default) | positive integer
Size of batches for calculating predictions, specified as a positive integer. Larger batch sizes lead to faster processing but take up more memory.
ScoreFunction
— Function for computing scalar score from anomaly map
function handle
Function for computing a scalar score from an anomaly map when detector
is an efficientADAnomalyDetector
object, an fcddAnomalyDetector
object, or a fastFlowAnomalyDetector
object, specified as a function handle. The
function handle ScoreFunction
must represent a function that
accepts the input data I
and
returns an output in the form of a numeric scalar. I
must be
2-D numeric image data, dlarray
data with two spatial dimensions,
or a datastore. The default value of ScoreFunction
depends on the
type of detector specified:
Detector Specified in detector Argument | Default ScoreFunction Value |
---|---|
FastFlow |
|
EfficientAD |
|
FCDD |
|
PatchCore | Not supported |
ExecutionEnvironment
— Hardware resource
"auto"
(default) | "gpu"
| "cpu"
Hardware resource on which to run the detector, specified as
"auto"
, "gpu"
, or "cpu"
.
The table shows the valid hardware resource values.
Resource | Action |
---|---|
"auto" | Use a GPU if it is available. Otherwise, use the CPU. |
"gpu" | Use the GPU. To use a GPU, you must have Parallel Computing Toolbox™ and a CUDA® enabled NVIDIA® GPU. If a suitable GPU is not available, the function returns an error. For information about the supported compute capabilities, see GPU Computing Requirements (Parallel Computing Toolbox). |
"cpu" | Use the CPU. |
Output Arguments
isAnomaly
— Test image is anomaly
N-element logical vector
Test image is anomaly, returned as an N-element logical vector,
where N is the number of test images in I
. The
value true
indicates an anomaly (positive detection). The value
false
indicates normality (negative detection).
Data Types: logical
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Usage notes and limitations:
FCDD, FastFlow, PatchCore | EfficientAD |
---|---|
|
|
GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.
Usage notes and limitations:
FCDD, FastFlow, PatchCore | EfficientAD |
---|---|
|
|
Version History
Introduced in R2022bR2024b: Support for EfficientAD anomaly detector
You can now specify the detector
argument as an efficientADAnomalyDetector
object.
R2024a: Option to specify custom anomaly score function for FastFlow and FCDD detectors
Specify a custom anomaly score function, which the classify
function
uses to compute a scalar score from the anomaly map, by using the ScoreFunction
name-value argument.
R2023a: Support for FastFlow and PatchCore anomaly detectors
You can now specify the detector
argument as a fastFlowAnomalyDetector
object or a patchCoreAnomalyDetector
object.
R2023a: Support for C and GPU code generation
classify
now supports the
generation of C code (requires MATLAB®
Coder™) and optimized CUDA code (requires GPU Coder™).
Commande MATLAB
Vous avez cliqué sur un lien qui correspond à cette commande MATLAB :
Pour exécuter la commande, saisissez-la dans la fenêtre de commande de MATLAB. Les navigateurs web ne supportent pas les commandes MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)