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 Tell me how to say it 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.


Dates are always reported using the formal American written format. For example, "January 1, 2021".



Data requirements

All NLG Apps have the same data requirements relating to supported formats and field names. See the NLG Apps Data requirements topic 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 grayed out and disabled in the wizard. In this example, the Describe a Pie Chart app has been disabled:


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 1 is set to DateTime.

If using the Power BI date hierarchy, be aware that each field of the hierarchy is counted as a separate time dimension.


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:



Aggregation types are set in Power BI. Note that Power BI may automatically set the aggregation type of a calculated measure to Don't summarize.

Entity types and other data attributes are set in Step 1 of the Arria for Power BI wizard.



Configuration options

The following options are available to configure:




Tell me how to say it

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.