.. _auto_cvision_classifyimage:

*COMPUTER VISION. CLASSIFY THE IMAGE BASED ON A TRAINING SET*
=============================================================

Classifies an input image against a user-supplied training set using computer vision techniques. Provide a labelled image collection as the training set and the worker returns the predicted class label for the query image. Use this worker when you need automated image categorisation within a d3VIEW workflow.

When to use
-----------

Classification: **process**.

Tagged: ``computer_vision``, ``cv``, ``image_classification``, ``label``, ``predict``, ``training_set``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - File Name
     - filename
     - view
     - —
     - ✓
     - Path or view reference to the query image file to be classified (e.g. PNG, JPEG); must point to a single image whose class label is to be predicted.
   * - Training Set
     - trainingset
     - collection
     - —
     - ✓
     - Collection of labelled training images used to build the classification model; each item in the collection should carry a class label and a corresponding image reference.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - cvision_classifyimage_output_1
     - cvision_classifyimage_output_1
     - text
     - Predicted class label (text string) assigned to the input image based on the supplied training set.

Disciplines
-----------

- ai_ml.supervised.classification
- ai_ml.vision

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>cvision_classifyimage</code>. Schema hash: <code>6db1157dbc2e</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>