Configure a Classification Locator

Use the procedure to configure a Classification Locator.

Before you begin

Before you can configure a Classification Locator, a classification project must already exist.

Procedure
  1. Open the Classification Locator Properties icon Properties.

    The properties for the Classification Locator are displayed.

  2. On the General tab, configure the following settings.

    Setting

    Description

    Referenced project file

    Browse to the location where the reference project is located and select the desired project. A copy of that project is made and stored within the data files of the current project. No images from the original project are copied to the current project because they are not required for classification purposes.

    This project copy is referenced and updated whenever a document is processed by the corresponding Classification Locator.

    Automatic update from project file

    Ensures the local copy of the reference project stays up-to-date with the original reference project file. For the best results, select this setting only if the referenced project is updated regularly. (Default: Cleared)

    If this setting is selected, the Tungsten TotalAgility Transformation Server accesses the original referenced project and if it is newer, the copy of the project is updated. This means that both the original project and its copy must be accessible during production.

    Classification Mode

    Select from the following classification modes:

    Complete document (text only):

    This value means the entire document and its text is used for classification. (Default: Selected)

    This mode does not consider any hierarchical classification rules, such as subtree classification or default classification results. .

    The text used here for classification can be restricted to specific regions or pages.

    Line by line (text only):

    This mode means that each text line is classified individually and returned as an alternative, if the confidence is high enough. The results are then sorted by confidence.

    The coordinates of the line are included with the returned alternatives and each alternative is highlighted on the document. This enables the calling project to access these coordinates as needed. For example, to find the highest line on a page that was classified as a specific value.

    By Paragraph (text only):

    This mode uses paragraphs from a document for classification, honoring chapter or section numbers as well as numbered or bullet lists.

    Complete document (hierarchical):

    This mode means that both layout and text classification can be used in the referenced classification project. For the actual classification process, the various settings in the classification project is used.

    The regions definition is used to determine how many pages need OCR.

    A final classification result can have a very low confidence if certain classification rules were applied. The result can also be lower than the results of other classes that are not the final classification result. The Set classification result to 100% setting should be used in that case.

    If you choose this value, you cannot define a default result for the locator and therefore the default result for the Result Mode pane is disabled. In case no result is found for this locator, the default classification result that is defined within the referenced project file is assigned as the locator result.

    These classification modes do not execute scripts, even classification scripts.

    Min. confidence

    Only classification results with a confidence higher than or equal to this value is returned as alternatives. (Default: 70)

    Set classification result to 100%

    Available only when the Complete document (hierarchical) value is selected for the Classification Mode setting.

    When this setting is selected, the confidence of the alternative that is the final classification result always is 100%. This is important because the final classification result might be very low as a result of subtree classification or using the default classification result. If that were to happen, it would not be possible to distinguish between the final classification result and other possible alternatives. (Default: Selected)

    Min. words in a paragraph

    Available only when the Classification Mode is set to By Paragraph (text only).

    You can configure the minimum size of a paragraph. This means that paragraphs with fewer words than what is specified here are not classified. (Default: 20)

    Result Mode

    Select one of the following result modes:

    Single topic:

    If this value is selected, only one class from the referenced project is used as a result in the alternative. (Default: Selected)

    Multi topic:

    If this value is selected, a semicolon delimited list of the best class results is used as alternative values.

    Max. number of results (0 = all)

    Limits the number of returned classification results to the specified number. A value of 0 means all alternatives that meet the confidence requirements is returned. (Default: 5)

    Default result

    This setting is disabled unless the Complete document (text only) value is selected for the Classification Mode setting. If no classification result is found, this default result is assigned as the final result. If no default result is defined, the locator returns no value. (Default: None)

    The default result can be a text string such as "Nothing", "Unclassified", or something similar.

  3. Open a test document and select Test to test your settings.
  4. Optional. Select Close to close the locator properties window.
  5. Save the changes to your project.