Skip to content

Manage models

Overview

Models are the text analysis engines produced by either running experiments or importing CPK files.

To access the list of all the models generated for the project, select the Models tab.

The tab is divided in the following panels:

  • The models list on the left side with the related summarized information, such as:
    • Model name
    • Execution time
    • Training library name
    • Documents number
    • Annotated documents number
    • Publishing status
  • The model details and the Knowledge Graph navigation regarding the selected model in the middle.
  • Possible operations with the selected model and the related experiments on the right side.

Change the model in focus

To change the model in focus, select it in the list on the left.

Sort the models list based on an item

To sort the models list based on an item, select the related drop-down menu at the top of the list then the criteria of your interest.

Filter the list based on an engine

To filter the list based on an engine, select the related drop-down menu at the top of the list then, in the Engine area, select the engine of your interest.

Filter the list based on a training library

To filter the list based on an training library select the related drop-down menu at the top of the list then, in the Train library area, select the library of your interest.

Search for a model

To search for a model enter the search criteria (minimum three characters) in the search bar then press enter.

Select to reset the search criteria.

Upload a CPK

To upload a CPK file select Upload CPK .

Once a CPK is uploaded the remapping panel is automatically displayed.

Remapping

After importing the CPK, the remapping panel is focused on the Remapped tab and it displays the result of the automatic remapping that it could be also empty in the worst case.

Since the imported CPK model may differ from the project you are working on, for example because it is produced at different times or by different users, it is sometimes necessary to remap it.

To perform the project remapping use the following tabs.

Note

It is also possible remap the resource later selecting Remap model.

All resources

This tab shows the complete resources of the imported model and if and how they have been remapped.

If no automatic remapping occurred, no match is displayed. Therefore, it is be possible to perform a manual remapping.

If you want to manually remap a resource from the imported model to a category of the existing project:

  1. Select a category from the list box on the right side.
  2. Select Save to confirm.

This mapping will be displayed in the Remapped tab.

Select Exit to exit.

Remapped

This tab shows the remapped items, both manually and automatically.

If you want to manually remap a resource from the imported model to a category of the existing project:

  1. Select a category from the list box on the right side.
  2. Select Save to confirm.

Select Exit to exit.

Missed

This tab shows the imported model resources that don't have a mapping with the existing model resources.

If you need to remap a resource from the imported model to a category of the existing project:

  1. Select a category from the list box on the right side.
  2. Select Save to confirm.

This mapping will be displayed in the Remapped tab.

Select Exit to exit.

Not Mapped

This tab shows the existing resources that don't have any mapping with the imported resources.

Select Exit to exit.

The model details

Select the Model details tab (displayed by default when you access the Models tab) to display information regarding:

  • The Training library.
  • The Training settings.

If the model in focus in an uploaded CPK the panel shows information about the NL-Core, the Disambiguator and the remapping, if any.

Knowledge Graph navigation

Select the Knowledge graph tab to navigate the Knowledge Graph used in the model in focus.

Note

Only the list view is available.

Start an experiment with a specific model

To start an experiment with a specific model:

  1. Select the model.
  2. Select Quick start an experiment.
  3. In the Start an experiment dialog, type the optional experiment name, select a library, then select Next.
  4. Check the summary in the Start an experiment, Summary dialog, then select Start.

Create a Knowledge Graph Customization project

To create a Knowledge Graph Customization project:

  1. Select a CPK or a model produced with an Explaination Categorization from the models list.
  2. Select Knowledge Graph Customization.
  3. In the dialog, type a name, an optional description and select Create.

Note

The project creation will occur as a background task.

Note

The Knowledge Graph Customization project on a CPK can be created only with compatible tech versions.

Publish and unpublish a model

To publish a model, select it from the models list and, if not a CPK, then select Publish model.

Once a model or a CPK is published, it is marked with a green dot in the models list.

Published models are available to be used in the workflows of the NL Flow part.

To unpublish a model, select Unpublish model on the right panel.

Remap a model (for CPKs only)

Select Remap model if you need to remap the resources (categories in the categorization projects) between the imported CPK imported and the existing project.

Export a model

To export a model:

  1. Select Export model if the model is generated with an Auto-ML Categorization engine or Export CPK in the other cases.

  2. In the Export model window (or Export CPK window), type the model name in File name or confirm the suggested one, then select:

    • Export model

    Or:

    • Export CPK (if a CPK)

  3. Select Download either in the dialog or in the notification in the lower right corner.

Edit the model name

To edit a build name:

  1. Select Edit model name and the Edit model name dialog is displayed.
  2. Enter the new name in Model name and select Save to confirm.

Delete a model

To delete a model:

  1. Select Delete model and the Delete model dialog is displayed.
  2. Select Delete to confirm.

To check related experiments, if any, see the Related experiments sub-panel.

Double-click the experiment to view its quality.