Filtering by an Entire Category Model

About Filtering by an Entire Category Model

When filtering Studio data by topics, you can return all data categorized into a given category model using the categorized operator.

How Root-Level Rules Affect the Categorized Filter

The categorized filter works differently for models with root-level rules and models without them. A root-level rule works like a filter applied to an entire model: only the sentences and documents that match this filter are considered for categorization.

• If a model does not have root-level rules, the categorized filter returns all documents where at least 1 sentence hits at least 1 category in the model.
• If a model has root-level rules, the categorized filter returns all documents that match the root-level rule. No other categories are taken into account.

To better understand this, let’s look at an example. Imagine we have 3 documents:

• Document A mentions a red truck.
• Document B mentions a red sedan.
• Document C mentions a green van.

A MODEL WITHOUT ROOT-LEVEL RULES

Our first model has a category for trucks and does not have any root-level rules. Here is how the categorized filter will handle these documents:

• Document A fits the Trucks category and is considered categorized.
• Document B doesn’t fit any category and is considered not categorized. It’s added to a special “Global Other” category that contains uncategorized data for the model.
• Document C doesn’t fit any category and is considered not categorized. It’s added to the “Global Other” category as well.

A MODEL WITH ROOT-LEVEL RULES

Our second model also has a category for trucks, but comes with a root-level rule that filters for the color red. Here is how the categorized filter will handle these documents:

• Document A matches the root-level rule and fits the Trucks category. It’s considered categorized.
• Document B matches the root-level rule, but doesn’t fit any other category. It’s added to a “Global Other” category, but still considered categorized.
• Document C doesn’t match the root-level rule and is considered not categorized. It’s not added to a Global Other category.

If you have a model with root-level rules, but want to filter out documents that do not hit any category within that model, don’t use the categorized filter. Instead, set the operator to Is and select all of the top-level categories.

Example: Using the example above, the categorized filter includes documents A and B. However, if you set a topic filter to include only Trucks, SUVs, and Coupes, then it will only return document A.

Checking a Model for Root-Level Rules

Since root-level rules can change how the categorization filter behaves, here’s how to find whether or not a given category model has root-level rules.

Checking for root-level rules in Designer

The easiest way to find root-level rules is to open the category model in Designer and look at the topmost node.

1. Open Designer.
   
   Qtip: In this screenshot, we have multiple instances of Designer. You may have only a single instance.
2. Select the project where your category model is located.
   
3. Go to Categorize.
4. Select the model you want to check.
5. On the left, select the very first topic at the very top of the list.
6. On the right, if you see rules, this means the category model has root-level rules. If you don’t see rules, the model doesn’t have root-level rules.

Checking for root-level rules in Studio

1. Create a new dashboard, or edit an existing dashboard.
2. Add any reporting widget (for example, a bar widget).
3. In Group by, select the category model you want to check.
   
4. Go to the Filters tab.
5. Look under the Widget Filters dropdown:
   • If this section contains a Root Node filter with the name of the model, it means the model has root-level rules.
     
   • If this section does not contain a Root Node filter, it means the model has no root-level rules.
     
6. Close the widget and leave the dashboard without saving.

FAQs