Describe a Pie Chart

About the narrative

Details covered in the analysis

The length of the narrative and the level of detail the narrative contains depend on which Narrative length narrative option is selected.

The pie chart narrative includes:

  • the totals as numbers and percentages.

  • the biggest and smallest contributors, contributors with uniform distributions, and outliers.

The narrative wording depends on the selected aggregation types, referring, for example, to total, average, minimum or maximum values. For the Percentage, Rating and Ratio entity types, total values are omitted from the narrative as it does not make sense to sum up non-additive measures.



Data requirements

All NLG Apps have the same data requirements for supported formats and field names. See NLG Apps Data requirements for details.

In addition, each app has specific data requirements:

If your data selection and configuration do not meet the specific requirements for a particular app, the app is disabled in the wizard and a warning message is displayed:


Dimensions and measures

This app can analyze:

  • two or more measures (no dimensions)

  • one dimension (can be a time dimension) and one measure

Minimum requirement: two measures, or one dimension (can be a time dimension) and one measure.


If including a time dimension, make sure the Entity Type field in Step 2 is set to DateTime.



The first dimension and all measures selected in the extension are shown on the Describe a Pie Chart data attributes page by default. Adjust the number of dimensions and measures shown until they meet one of these requirements:

  • two or more measures (no dimensions)

  • exactly one measure and exactly one dimension (can be a time dimension)

To replace the default dimension with a dimension of your choosing, first remove it using the Remove button. The Add dimension button is displayed only when no dimensions remain.



Aggregation and entity types

Not all combinations of aggregation and entity types are supported for measures. The Describe a Pie Chart app can analyze the following combinations:



Entity types and other data attributes are set in Step 2 of the wizard.



Narrative options

The following fields are available to configure in Step 3 of the NLG Apps wizard: Narrative options.




Narrative length

Summary: produces a narrative of filtered facts in a more concise way than the Important things option.

Important things: produces a narrative of filtered facts based on Arria's ranking algorithm.

Tell me everything: produces a narrative that includes every fact extracted from your data by Arria's algorithms.

Default: Important things