Classification fields

What are classification fields?
Classification field predictions categorise content on a document into a predefined set of classifications. These are distinct from e.g. extraction type fields which make predictions about the content of a document.
Classification types
Multi-class
A multi-class field is a type of document classification that assigns a single category, or class to a document. For example, the invoice.currencyCode field determines the currency used in an invoice. It is implemented as a multi-class field as there is usually only a single currency used in a single invoice.
Multi-label
A multi-label field is a similar type of classification, but instead of assigning a single category to a document, a multi-label classification can assign many categories, or labels to a document. For example, the document.type field determines which of Sypht's fieldsets are applicable to a given document. Since multiple fieldsets can be applicable to a single document, this field is implemented as a multi-label field.
Samples
For multi-class and multi-label fields, the value returned for each field is a JSON object.
Here is an example of output for the invoice.currencyCode multi-class field:
Multi-class example
1
{ 
2
  "name": "invoice.currencyCode",
3
  "value": {
4
    "invoice.currencyCode.AUD": {"value": true, "confidence": 0.69}, 
5
    "invoice.currencyCode.EUR": {"value": false, "confidence": 0}, 
6
    "invoice.currencyCode.GBP": {"value": false, "confidence": 0}, 
7
    "invoice.currencyCode.MYR": {"value": false, "confidence": 0}, 
8
    "invoice.currencyCode.NZD": {"value": false, "confidence": 0.29}, 
9
    "invoice.currencyCode.SGD": {"value": false, "confidence": 0}, 
10
    "invoice.currencyCode.Unknown": {"value": false, "confidence": 0.02}
11
  },
12
  "confidence": 0.69,
13
  "boundingBox": null
14
}
Copied!
The list of keys in the object enumerate each possible class/label for the field. For the invoice.currencyCode shown above, there are seven possible classes, six of which represent a currency code and a seventh Unknown class for cases where Sypht cannot determine the currency. Note that each class is qualified with the field name.
Decoding classifications
Each class/label has a value and a confidence. For multi-class fields (as above), only a single class will have a value of true.
For multi-label fields (such as document.type), multiple labels can have a value of true. Here is an example of output for the document.type multi-label field that demonstrates how multiple labels can simultaneously have a value of true:
Multi-label example
1
{
2
  "name": "document.type",
3
  "value": {
4
    "bank": { "value": false, "confidence": 1 },
5
    "bill": { "value": false, "confidence": 1 },
6
    "bpay": { "value": false, "confidence": 1 },
7
    "electricity": { "value": false, "confidence": 1 },
8
    "generic": { "value": false, "confidence": 1 },
9
    "invoice": { "value": true, "confidence": 0.96 },
10
    "issuer": { "value": true, "confidence": 0.94 },
11
    "ndis": { "value": false, "confidence": 0.93 },
12
    "paystub": { "value": false, "confidence": 1 },
13
    "recipient": { "value": true, "confidence": 0.81 },
14
    "statement": { "value": false, "confidence": 1 },
15
    "toll": { "value": false, "confidence": 0.99 },
16
    "vehicle": { "value": true, "confidence": 0.76 }
17
  },
18
  "confidence": 0.511464907008,
19
  "boundingBox": null
20
}
Copied!
Note that invoice, issuer, recipient and vehicle all have values of true.

Field types - Previous

Line Items

Next - Field types

Signals

Last modified 1yr ago

Copy link

Contents

What are classification fields?

Classification types

Samples

Decoding classifications