Skip to content

Commit 466b05b

Browse files
committed
update terms
1 parent 6e03c91 commit 466b05b

File tree

9 files changed

+34
-34
lines changed

9 files changed

+34
-34
lines changed

articles/applied-ai-services/form-recognizer/concept-composed-models.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ With composed models, you can assign multiple custom models to a composed model
4242

4343
::: moniker range="form-recog-3.0.0"
4444

45-
With the introduction of [****custom classifier models****](./concept-custom-classifier.md), you can choose to use [**composed models**](./concept-composed-models.md) or the classifier model as an explicit step before analysis. For a deeper understanding of when to use a classifier or composed model, _see_ [**Custom classifier models**](concept-custom-classifier.md).
45+
With the introduction of [****custom classification models****](./concept-custom-classifier.md), you can choose to use [**composed models**](./concept-composed-models.md) or the classification model as an explicit step before analysis. For a deeper understanding of when to use a classification or composed model, _see_ [**Custom classification models**](concept-custom-classifier.md).
4646

4747
## Compose model limits
4848

articles/applied-ai-services/form-recognizer/concept-custom-classifier.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Custom classifier model - Form Recognizer
2+
title: Custom classification model - Form Recognizer
33
titleSuffix: Azure Applied AI Services
4-
description: Use the custom classifier model to train a model to identify and split the documents you process within your application.
4+
description: Use the custom classification model to train a model to identify and split the documents you process within your application.
55
author: vkurpad
66
manager: nitinme
77
ms.service: applied-ai-services
@@ -14,32 +14,32 @@ monikerRange: 'form-recog-3.0.0'
1414
recommendations: false
1515
---
1616

17-
# Custom classifier model
17+
# Custom classification model
1818

1919
**This article applies to:** ![Form Recognizer v3.0 checkmark](media/yes-icon.png) **Form Recognizer v3.0**.
2020

21-
Custom classifier models are deep-learning-model types that combine layout and language features to accurately detect and identify documents you process within your application. Custom classifier models can classify each page in an input file to identify the document(s) within and can also identify multiple documents or multiple instances of a single document within an input file.
21+
Custom classification models are deep-learning-model types that combine layout and language features to accurately detect and identify documents you process within your application. Custom classification models can classify each page in an input file to identify the document(s) within and can also identify multiple documents or multiple instances of a single document within an input file.
2222

2323
## Model capabilities
2424

25-
Custom classifier models can analyze a single- or multi-file documents to identify if any of the trained document types are contained within an input file. Here are the currently supported scenarios:
25+
Custom classification models can analyze a single- or multi-file documents to identify if any of the trained document types are contained within an input file. Here are the currently supported scenarios:
2626

2727
* A single file containing one document. For instance, a loan application form.
2828

2929
* A single file containing multiple documents. For instance, a loan application package containing a loan application form, payslip, and bank statement.
3030

3131
* A single file containing multiple instances of the same document. For instance, a collection of scanned invoices.
3232

33-
Training a custom classifier model requires at least two distinct classes and a minimum of five samples per class.
33+
Training a custom classification model requires at least two distinct classes and a minimum of five samples per class.
3434

35-
### Compare custom classifier and composed models
35+
### Compare custom classification and composed models
3636

37-
A custom classifier model can replace [a composed model](concept-composed-models.md) in some scenarios but there are a few differences to be aware of:
37+
A custom classification model can replace [a composed model](concept-composed-models.md) in some scenarios but there are a few differences to be aware of:
3838

3939
| Capability | Custom classifier process | Composed model process |
4040
|--|--|--|
41-
|Analyze a single document of unknown type belonging to one of the types trained for extraction model processing.| &#9679; Requires multiple calls. </br> &#9679; Call the classifier models based on the document class. This step allows for a confidence-based check before invoking the extraction model analysis.</br> &#9679; Invoke the extraction model. | &#9679; Requires a single call to a composed model containing the model corresponding to the input document type. |
42-
|Analyze a single document of unknown type belonging to several types trained for extraction model processing.| &#9679;Requires multiple calls.</br> &#9679; Make a call to the classifier that ignores documents not matching a designated type for extraction.</br> &#9679; Invoke the extraction model. | &#9679; Requires a single call to a composed model. The service selects a custom model within the composed model with the highest match.</br> &#9679; A composed model can't ignore documents.|
41+
|Analyze a single document of unknown type belonging to one of the types trained for extraction model processing.| &#9679; Requires multiple calls. </br> &#9679; Call the classification models based on the document class. This step allows for a confidence-based check before invoking the extraction model analysis.</br> &#9679; Invoke the extraction model. | &#9679; Requires a single call to a composed model containing the model corresponding to the input document type. |
42+
|Analyze a single document of unknown type belonging to several types trained for extraction model processing.| &#9679;Requires multiple calls.</br> &#9679; Make a call to the classification that ignores documents not matching a designated type for extraction.</br> &#9679; Invoke the extraction model. | &#9679; Requires a single call to a composed model. The service selects a custom model within the composed model with the highest match.</br> &#9679; A composed model can't ignore documents.|
4343
|Analyze a file containing multiple documents of known or unknown type belonging to one of the types trained for extraction model processing.| &#9679; Requires multiple calls. </br> &#9679; Call the extraction model for each identified document in the input file.</br> &#9679; Invoke the extraction model. | &#9679; Requires a single call to a composed model.</br> &#9679; The composed model invokes the component model once on the first instance of the document. </br> &#9679;The remaining documents are ignored. |
4444

4545
## Language support
@@ -48,13 +48,13 @@ Classifier models currently only support English language documents.
4848

4949
## Best practices
5050

51-
Custom classifier models require a minimum of five samples per class to train. If the classes are similar, adding extra training samples improves model accuracy.
51+
Custom classification models require a minimum of five samples per class to train. If the classes are similar, adding extra training samples improves model accuracy.
5252

5353
## Training a model
5454

55-
Custom classifier models are only available in the [v3.0 API](v3-migration-guide.md) starting with API version ```2023-02-28-preview```. [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio) provides a no-code user interface to interactively train a custom classifier.
55+
Custom classification models are only available in the [v3.0 API](v3-migration-guide.md) starting with API version ```2023-02-28-preview```. [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio) provides a no-code user interface to interactively train a custom classifier.
5656

57-
When using the REST API, if you've organized your documents by folders, you can use the ```azureBlobSource``` property of the request to train a classifier model.
57+
When using the REST API, if you've organized your documents by folders, you can use the ```azureBlobSource``` property of the request to train a classification model.
5858

5959
```rest
6060
https://{endpoint}/formrecognizer/documentClassifiers:build?api-version=2023-02-28-preview
@@ -128,8 +128,8 @@ File list `car-maint.jsonl` contains the following files.
128128

129129
## Next steps
130130

131-
Learn to create custom classifier models:
131+
Learn to create custom classification models:
132132

133133
> [!div class="nextstepaction"]
134-
> [**Build a custom classifier model**](how-to-guides/build-a-custom-classifier.md)
134+
> [**Build a custom classification model**](how-to-guides/build-a-custom-classifier.md)
135135
> [**Custom models overview**](concept-custom.md)

articles/applied-ai-services/form-recognizer/concept-custom.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ recommendations: false
2424

2525
Form Recognizer uses advanced machine learning technology to identify documents, detect and extract information from forms and documents, and return the extracted data in a structured JSON output. With Form Recognizer, you can use document analysis models, pre-built/pre-trained, or your trained standalone custom models.
2626

27-
Custom models now include [custom classifier models](./concept-custom-classifier.md) for scenarios where you need to identify the document type prior to invoking the extraction model. Classifier models are available starting with the ```2023-02-28-preview``` API. A classifier model can be paired with a custom extraction model to analyze and extract fields from forms and documents specific to your business to create a document processing solution. Standalone custom extraction models can be combined to create [composed models](concept-composed-models.md).
27+
Custom models now include [custom classification models](./concept-custom-classifier.md) for scenarios where you need to identify the document type prior to invoking the extraction model. Classifier models are available starting with the ```2023-02-28-preview``` API. A classification model can be paired with a custom extraction model to analyze and extract fields from forms and documents specific to your business to create a document processing solution. Standalone custom extraction models can be combined to create [composed models](concept-composed-models.md).
2828

2929
::: moniker range="form-recog-3.0.0"
3030

@@ -81,9 +81,9 @@ The following table compares custom template and custom neural features:
8181
|Document variations | Requires a model per each variation | Uses a single model for all variations |
8282
|Language support | Multiple [language support](language-support.md#read-layout-and-custom-form-template-model) | English, with preview support for Spanish, French, German, Italian and Dutch [language support](language-support.md#custom-neural-model) |
8383

84-
### Custom classifier model
84+
### Custom classification model
8585

86-
Document classification is a new scenario supported by Form Recognizer with the ```2023-02-28-preview``` API. Document classifier supports classification and splitting scenarios. Train a classifier model to identify the different types of documents your application supports. The input file for the classifier model can contain multiple documents and classifies each document within an associated page range. See [custom classification](concept-custom-classifier.md) models to learn more.
86+
Document classification is a new scenario supported by Form Recognizer with the ```2023-02-28-preview``` API. Document classification supports classification and splitting scenarios. Train a classification model to identify the different types of documents your application supports. The input file for the classification model can contain multiple documents and classifies each document within an associated page range. See [custom classification](concept-custom-classifier.md) models to learn more.
8787

8888
## Custom model tools
8989

@@ -184,7 +184,7 @@ Extract data from your specific or unique documents using custom models. You nee
184184

185185
1. Review and create your project.
186186

187-
1. Label your documents to build and test your custom classifier model.
187+
1. Label your documents to build and test your custom classification model.
188188

189189
> [!div class="nextstepaction"]
190190
> [Try Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio/document-classifier/projects)

articles/applied-ai-services/form-recognizer/concept-model-overview.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ recommendations: false
5050
|**Custom models**||
5151
| [Custom model (overview)](#custom-models) | Extract data from forms and documents specific to your business. Custom models are trained for your distinct data and use cases. |
5252
| [Custom extraction models](#custom-extraction)| &#9679; **Custom template models** use layout cues to extract values from documents and are suitable to extract fields from highly structured documents with defined visual templates.</br>&#9679; **Custom neural models** are trained on various document types to extract fields from structured, semi-structured and unstructured documents.|
53-
| [Custom classifier model](#custom-classifier)| The **Custom classifier model** can classify each page in an input file to identify the document(s) within and can also identify multiple documents or multiple instances of a single document within an input file.
53+
| [Custom classification model](#custom-classifier)| The **Custom classification model** can classify each page in an input file to identify the document(s) within and can also identify multiple documents or multiple instances of a single document within an input file.
5454
| [Composed models](#composed-models) | Combine several custom models into a single model to automate processing of diverse document types with a single composed model.
5555

5656
### Read OCR
@@ -206,10 +206,10 @@ Custom extraction model can be one of two types, **custom template** or **custom
206206

207207
[:::image type="icon" source="media/studio/custom-classifier.png":::](https://formrecognizer.appliedai.azure.com/studio/custommodel/projects)
208208

209-
The custom classifier model enables you to identify the document type prior to invoking the extraction model. The classifier model is available starting with the 2023-02-28-preview. Training a custom classifier model requires at least two distinct classes and a minimum of five samples per class.
209+
The custom classification model enables you to identify the document type prior to invoking the extraction model. The classification model is available starting with the 2023-02-28-preview. Training a custom classification model requires at least two distinct classes and a minimum of five samples per class.
210210

211211
> [!div class="nextstepaction"]
212-
> [Learn more: custom classifier model](concept-custom-classifier.md)
212+
> [Learn more: custom classification model](concept-custom-classifier.md)
213213
214214
#### Composed models
215215

articles/applied-ai-services/form-recognizer/how-to-guides/build-a-custom-classifier.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Build and train a custom classifier"
33
titleSuffix: Azure Applied AI Services
4-
description: Learn how to label, and build a custom document classifier model.
4+
description: Learn how to label, and build a custom document classification model.
55
author: laujan
66
manager: nitinme
77
ms.service: applied-ai-services
@@ -13,13 +13,13 @@ monikerRange: 'form-recog-3.0.0'
1313
recommendations: false
1414
---
1515

16-
# Build and train a custom classifier model
16+
# Build and train a custom classification model
1717

1818
[!INCLUDE [applies to v3.0](../includes/applies-to-v3-0.md)]
1919

20-
Custom classifier models can classify each page in an input file to identify the document(s) within. Classifier models can also identify multiple documents or multiple instances of a single document in the input file. Form Recognizer custom models require as few as five training documents per document class to get started. To get started training a custom classifier model, you need at least **five documents** for each class and **two classes** of documents.
20+
Custom classification models can classify each page in an input file to identify the document(s) within. Classifier models can also identify multiple documents or multiple instances of a single document in the input file. Form Recognizer custom models require as few as five training documents per document class to get started. To get started training a custom classification model, you need at least **five documents** for each class and **two classes** of documents.
2121

22-
## Custom classifier model input requirements
22+
## Custom classification model input requirements
2323

2424
Make sure your training data set follows the input requirements for Form Recognizer.
2525

@@ -43,7 +43,7 @@ The Form Recognizer Studio provides and orchestrates all the API calls required
4343

4444
1. Start by navigating to the [Form Recognizer Studio](https://formrecognizer.appliedai.azure.com/studio). The first time you use the Studio, you need to [initialize your subscription, resource group, and resource](../quickstarts/try-v3-form-recognizer-studio.md). Then, follow the [prerequisites for custom projects](../quickstarts/try-v3-form-recognizer-studio.md#additional-prerequisites-for-custom-projects) to configure the Studio to access your training dataset.
4545

46-
1. In the Studio, select the **Custom classifier models** tile, on the custom models section of the page and select the **Create a project** button.
46+
1. In the Studio, select the **Custom classification models** tile, on the custom models section of the page and select the **Create a project** button.
4747

4848
:::image type="content" source="../media/how-to/studio-create-classifier-project.png" alt-text="Screenshot of how to create a classifier project in the Form Recognizer Studio.":::
4949

@@ -106,7 +106,7 @@ Once the model training is complete, you can test your model by selecting the mo
106106

107107
1. Validate your model by evaluating the results for each document identified.
108108

109-
Congratulations you've trained a custom classifier model in the Form Recognizer Studio! Your model is ready for use with the REST API or the SDK to analyze documents.
109+
Congratulations you've trained a custom classification model in the Form Recognizer Studio! Your model is ready for use with the REST API or the SDK to analyze documents.
110110

111111
## Next steps
112112

articles/applied-ai-services/form-recognizer/includes/input-requirements.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,4 +38,4 @@ ms.author: lajanuar
3838

3939
* For custom extraction model training, the total size of training data is 50 MB for template model and 1G-MB for the neural model.
4040

41-
* For custom classifier model training, the total size of training data is `1GB` with a maximum of 10,000 pages.
41+
* For custom classification model training, the total size of training data is `1GB` with a maximum of 10,000 pages.

articles/applied-ai-services/form-recognizer/quickstarts/try-form-recognizer-studio.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Prebuilt models help you add Form Recognizer features to your apps without havin
5252
#### Custom
5353

5454
* [**Custom extraction models**](https://formrecognizer-dogfood.appliedai.azure.com/studio/custommodel/projects): extract information from forms and documents with custom extraction models. Quickly train a model by labeling as few as five sample documents.
55-
* [**Custom classifier model**](https://formrecognizer-dogfood.appliedai.azure.com/studio/document-classifier/projects): train a custom classifier to distinguish between the different document types within your applications. Quickly train a model with as few as two classes and five samples per class.
55+
* [**Custom classification model**](https://formrecognizer-dogfood.appliedai.azure.com/studio/document-classifier/projects): train a custom classifier to distinguish between the different document types within your applications. Quickly train a model with as few as two classes and five samples per class.
5656

5757
#### Gated preview models
5858

articles/applied-ai-services/form-recognizer/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ items:
6161
- name: Build a custom extraction model
6262
displayName: tables, labels, ocr, input, train, training, sets, testing
6363
href: how-to-guides/build-a-custom-model.md
64-
- name: 🆕 Build a custom classifier model (preview)
64+
- name: 🆕 Build a custom classification model (preview)
6565
displayName: custom, classifier, splitter
6666
href: how-to-guides/build-a-custom-classifier.md
6767
- name: Compose custom extraction models
@@ -189,7 +189,7 @@ items:
189189
- name: Custom neural model
190190
displayName: selection, structure, tables, tabular, train, template, neural, build mode, signatures, custom
191191
href: concept-custom-neural.md
192-
- name: 🆕 Custom classifier model (preview)
192+
- name: 🆕 Custom classification model (preview)
193193
displayName: custom, train, classification, splitting
194194
href: concept-custom-classifier.md
195195
- name: Custom labels

0 commit comments

Comments
 (0)