#RacePie

AnimatedPie Chart (Race Pie Chart)

Suitable for showing the proportion relationship of data changes over time, using the size of the sector area to represent the proportion of each category.

Applicable scenarios:

- Show the change of proportion distribution of categorical data over time

- Emphasize the evolution of the overall and partial relationship of data on the time dimension

- Observe the proportion fluctuation of different categories in the total amount

AnimatedPie Chart:

- Angle maps measure values, color maps dimension values

- Supports controlling the time dimension through a player, animating the proportion changes

- Sector area is adjusted with animation as data changes

AnimatedPie Chart, suitable for showing the proportion relationship of data changes over time

Data source

Dimensions

Field ID corresponding to the dimension

Dimension alias

Dimension date format configuration

Time granularity, determines the date display precision

Channel to which the dimension is mapped

- color: supports mapping multiple dimensions to the color channel

- detail: supports mapping multiple dimensions to the detail channel

- tooltip: supports mapping multiple dimensions to the tooltip channel

- label: supports mapping multiple dimensions to the label channel

- row: supports mapping multiple dimensions to the row channel

- column: supports mapping multiple dimensions to the column channel

- player: supports mapping multiple dimensions to the player channel

Stroke color

Measure ID, must be unique

Measure alias, duplicates allowed; when not set, alias defaults to id

Automatic number formatting, enabled by default, highest priority

When autoFormat=true, it overrides all numFormat configurations

When enabled, chart data labels and tooltips will automatically select the appropriate formatting based on measure values and locale

Formatting rules: decimal numbers with compact notation enabled, minimum 0 decimal places, maximum 2 decimal places, automatic rounding, using the browser's Intl.NumberFormat implementation

For example:

- locale=zh-CN: 749740.264 → 74.45~74.45万

- locale=en-US: 749740.264 → 744.5K

Custom number formatting for measures; automatically applied to labels and tooltips

Note: To use custom formatting, you must explicitly set autoFormat=false; otherwise autoFormat will override this config

Number format type, supports: number (decimal), percent (%), permille (‰), scientific notation

Number format ratio, cannot be 0

Number format symbol, e.g. %, ‰

Thousands separator for number formatting

Number format suffix

Number format prefix

Decimal places for number formatting, using the browser's Intl.NumberFormat minimumFractionDigits and maximumFractionDigits; lower priority than significantDigits

Significant digits for number formatting, using the browser's Intl.NumberFormat minimumSignificantDigits and maximumSignificantDigits; higher priority than fractionDigits

Rounding priority for number formatting when both significantDigits and fractionDigits are set; uses the browser's Intl.NumberFormat, following the same rules as Intl.NumberFormat's roundingPriority

Rounding mode for number formatting, using the browser's Intl.NumberFormat, following the same rules as Intl.NumberFormat's roundingMode

Number format type, supports: number (decimal), percent (%), permille (‰), scientific notation

Number format ratio, cannot be 0

Number format symbol, e.g. %, ‰

Thousands separator for number formatting

Number format suffix

Number format prefix

Decimal places for number formatting, using the browser's Intl.NumberFormat minimumFractionDigits and maximumFractionDigits; lower priority than significantDigits

Significant digits for number formatting, using the browser's Intl.NumberFormat minimumSignificantDigits and maximumSignificantDigits; higher priority than fractionDigits

Rounding priority for number formatting when both significantDigits and fractionDigits are set; uses the browser's Intl.NumberFormat, following the same rules as Intl.NumberFormat's roundingPriority

Rounding mode for number formatting, using the browser's Intl.NumberFormat, following the same rules as Intl.NumberFormat's roundingMode

Channel to which the measure is mapped

- angle: measure mapped to the angle channel

- color: measure mapped to the color channel

- label: measure mapped to the label channel

- tooltip: measure mapped to the tooltip channel

In flat measure configuration form, builds a tree-shaped measure group. parentId points to the id of the parent measure group, used for building the measure tree

PaginationConfiguration

Pagination field; specifies the field name for pagination, must be a dimension

Current pagination value; specifies the value used to determine the current page

Player configuration, used to specify the time dimension, the core configuration of the AnimatedPie Chart

Player configuration, used to specify the player field name, must be a dimension

Maximum playback count; data exceeding this count will be truncated, set to false for no limit

Playback interval, unit: ms

Whether to auto play

Whether to loop play

Player position

Player progress bar rail color

Player progress bar track color

Player progress bar slider handle color

Player progress bar slider handle border color

Player start button color

Player pause button color

Player backward button color

Player forward button color

Background color

Color configuration

Discrete color scheme used to define the colors of different elements in the chart

Linear gradient color scheme used to define the colors of different elements in the chart

Color mapping used to map data values to specific colors

Positive/negative color configuration; defines the color for positive values in the chart

Positive/negative color configuration; defines the color for negative values in the chart

LabelConfiguration

Whether label functionality is enabled

Whether labels wrap to the next line

Whether labels display measure values

In multi-measure scenarios, there is no concern about conflicting values, because all plot-related measures go through foldMeasures processing and are merged into one measure representing a single data point

Note: encoding's label has higher priority; this config does not affect encoding's label

Whether labels display the percentage of measure values

In multi-measure scenarios, there is no concern about conflicting values, because all plot-related measures go through foldMeasures processing and are merged into one measure representing a single data point

Note: encoding's label has higher priority; this config does not affect encoding's label

Whether labels display dimension labels

Display all dimension labels

Note: encoding's label has higher priority; this config does not affect encoding's label

Whether label values are automatically formatted; when autoFormat is true, numFormat configuration is ignored

Label value format configuration; merged with the format in measure, where measure's format has higher priority. numFormat priority is lower than autoFormat

Number format type, supports: number (decimal), percent (%), permille (‰), scientific notation

Number format ratio, cannot be 0

Number format symbol, e.g. %, ‰

Thousands separator for number formatting

Number format suffix

Number format prefix

Decimal places for number formatting, using the browser's Intl.NumberFormat minimumFractionDigits and maximumFractionDigits; lower priority than significantDigits

Significant digits for number formatting, using the browser's Intl.NumberFormat minimumSignificantDigits and maximumSignificantDigits; higher priority than fractionDigits

Rounding priority for number formatting when both significantDigits and fractionDigits are set; uses the browser's Intl.NumberFormat, following the same rules as Intl.NumberFormat's roundingPriority

Rounding mode for number formatting, using the browser's Intl.NumberFormat, following the same rules as Intl.NumberFormat's roundingMode

Label font size

Label font weight

Label background color

Label stroke color

Label font color

Whether labels automatically invert font color based on the graphical element's color

label position

Whether label anti-overlap functionality is enabled

Label filtering; the default condition relationship between selectors is Or

Dimension field; the id of an item in dimensions

Operator

- in: Select data items where the value of the dimension field is in 'value'

- not in: Select data items where the value of the dimension field is not in 'value'

Operator

- in: Select data items where the value of the dimension field is in 'value'

- not in: Select data items where the value of the dimension field is not in 'value'

same as operator

Select the value of the dimension field in the data item; supports arrays

Animated filter (AI-generated code execution)

Implement complex data filtering logic via AI-generated JavaScript code

Core capabilities:

- Supports arbitrary complex data filtering conditions

- Use built-in utility functions for data manipulation

- Safely execute in browser environments (Web Worker sandbox)

Environment Requirements: Only browser environments are supported; Node.js environments will use fallback

Note: selector and dynamicFilter cannot be used simultaneously; dynamicFilter has higher priority

Chart animated filter configuration

Filter chart symbols (bars, points, etc.) via AI-generated JavaScript code

User's filtering requirement description (natural language)

AI-generated JavaScript filtering code

- Can only use built-in utility functions (accessible via _ or R)

- Input parameters: data (array), each item contains __row_index field representing row number

- Must return an array of row index and field combinations: Array<{ __row_index: number, field: string }>

- __row_index represents the row number of the original data item, and field represents the field to be highlighted

- Forbidden: eval, Function, asynchronous operations, DOM API, network requests

Fallback plan when code execution fails or the environment is not supported

Dimension field; the id of an item in dimensions

Operator

- in: Select data items where the value of the dimension field is in 'value'

- not in: Select data items where the value of the dimension field is not in 'value'

Operator

- in: Select data items where the value of the dimension field is in 'value'

- not in: Select data items where the value of the dimension field is not in 'value'

same as operator

Select the value of the dimension field in the data item; supports arrays

Animated filter execution result (runtime field)

Written during the prepare() stage, read-only at runtime

Label layout method; only effective for Pie Chart and Donut Chart when labelPosition is outside

- arc: Lay out labels according to an arc shape

- labelLine: Labels are aligned on both ends, connected to sector elements via leader lines

- edge: Labels are aligned on both ends, connected to sector elements via leader lines, and placed close to the edges of the chart

Legend configuration

Whether the legend function is enabled

Whether the legend border is enabled

Legend font color

Pager icon color

Pager icon disabled color

Legend font size

Legend font color

Legend font weight

Legend shape

Legend position

When there are a large number of legends, the maximum number of columns or rows

If position is horizontal (bottom, bottomLeft, bottomRight, bl, br, top, topLeft, topRight, tl, tr), maxSize controls the number of columns displayed

If position is vertical (left, leftTop, leftBottom, lt, lb, right, rightTop, rightBottom, rt, rb), maxSize controls the number of rows displayed

Tooltip configuration

Whether the tooltip function is enabled

Brush configuration

Chart brush configuration

Whether to enable brush selection

Brush type

Define the shape and selection direction of the brush

- rect: Rectangular selection, can select in both X-axis and Y-axis directions simultaneously

- polygon: Polygonal selection, select by clicking multiple points to draw an arbitrary polygon

- x: X-axis selection, select only in the X-axis direction, Y-axis is not restricted

- y: Y-axis selection, select only in the Y-axis direction, X-axis is not restricted

Brush mode, single or multiple selection

Define the selection mode

- single: Single selection mode, only one brush box at a time

- multiple: Multiple selection mode, multiple brush boxes can exist simultaneously

Whether to clear the selection box when brushing ends

Style of selected data

Define the style of selected data points

Opacity

Opacity of selected data points, range 0-1

Stroke color

Stroke width

Style of unselected data

Define the style of unselected data points

Opacity

Opacity of unselected data points, range 0-1

Stroke color

Stroke width

Theme configuration

Built-in light and dark themes are available, and new themes can be customized via registerTheme.

Language configuration