#Rose

Stacked rose chart, suitable for multi-dimensional data comparison scenarios, displaying data size through the arc length and radius of sectors in a polar coordinate system

Applicable scenarios:

- Distribution comparison of multi-dimensional data

- Comparison of strength in periodic data

- Concurrent display of numerical values and proportions for categorical data

Stacked rose chart

Stacked rose chart, displaying multi-dimensional data comparison relationships through a polar coordinate system

Dataset

An aggregated dataset that conforms to the TidyData specification, used to define the chart's data source and structure. User-input datasets do not require any manual processing; VSeed features a powerful data reshaping function that automatically transforms the data. Rose chart data is ultimately converted into 2 dimensions and 1 measure.

Dimensions

The first dimension of the stacked rose chart is mapped to the angular axis; other dimensions are merged with measure names (when multiple measures exist) to be displayed as legend items.

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

- angle: supports mapping multiple dimensions to the angle channel

- 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

Measures

Measures in the stacked rose chart are automatically merged into one measure and mapped to the radius axis. When multiple measures exist, measure names are merged with other dimensions to be displayed as legend items.

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万

- 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

- radius: measure mapped to the radius 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

Pagination configuration, used to specify the field name for pagination; must be a dimension

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

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

Chart background color

Background color can be a color string (e.g. 'red', 'blue'), or a hex, rgb, or rgba value (e.g. '#ff0000', 'rgba(255,0,0,0.5)')

Color

Color configuration for defining the chart's color scheme, including color lists, color mappings, and color gradients.

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

Label

Label configuration for defining chart data labels, including their position, format, and style.

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 the label font color automatically inverts based on the graphic element color

label position

Whether the label anti-overlap feature is enabled

Label filtering; the default 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

Dynamic filter (AI-generated code execution)

Implement complex data filtering logic via AI-generated JavaScript code

Core capabilities:

• Supports any complex data filtering conditions

• Use built-in utility functions for data operations

• Execute safely in the browser environment (Web Worker sandbox)

Environment requirements: Only supports browser environment; Node.js environment will use fallback

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

Chart dynamic filter configuration

Implement filtering of chart marks (bars, points, etc.) via AI-generated JavaScript code

User filtering requirement description (natural language)

AI-generated JavaScript filtering code

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

• Input parameter: data (array), each item contains __row_index representing the row number

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

• __row_index represents the original data item row number, and field represents the field to highlight

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

Fallback when code execution fails or the environment is unsupported

Dimension field, the id of an item in dimensions

Operator

• in: selects data items where the dimension field value is in value

• not in: selects data items where the dimension field value is not in value

Operator

• in: selects data items where the dimension field value is in value

• not in: selects data items where the dimension field value is not in value

same as operator

Selects the value of the dimension field in the data item; arrays are supported

Dynamic filter execution result (runtime field)

Written during prepare(); read-only at runtime

Label layout mode, only effective for Pie and Donut charts when labelPosition is outside.

- arc: Layout labels along an arc.

- labelLine: Labels are aligned at both ends, connected to sector primitives via leader lines.

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

Legend

Legend configuration; used to define the chart legend, including its position, format, style, etc.

Whether the legend feature 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

Maximum number of columns or rows for the legend when many items exist.

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

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

Tooltips

Tooltip configuration; used to define chart tooltips, including their position, format, style, etc.

Whether the tooltips feature is enabled

Brush selection

Brush configuration; used to enable/disable brush selection capabilities.

Chart brush configuration

Whether to enable brush selection

Brush type

Defines the shape and direction of the selection box.

- rect: Rectangular selection; selection can be made in both X and Y directions simultaneously.

- polygon: Polygon selection; perform selection by clicking multiple points to draw an arbitrary polygon.

- x: X-axis selection; selection only in the X direction, with no limits in the Y direction.

- y: Y-axis selection; selection only in the Y direction, with no limits in the X direction.

Brush selection mode: single or multiple.

Defines the selection mode.

- single: Single selection mode; only one selection box can exist at a time.

- multiple: Multiple selection mode; multiple selection boxes can exist simultaneously.

Whether to clear the selection box after the brush selection ends

Style for selected data items

Defines the style of the selected data points.

Opacity

Opacity of the selected data points, ranging from 0 to 1

Stroke color

Stroke width

Style for unselected data items

Defines the style of the unselected data points.

Opacity

Opacity of unselected data points, ranging from 0 to 1

Stroke color

Stroke width

Animation configuration

Chart animation configuration, with available effects constrained by chart type.

Whether to enable pie/donut/rose chart animation

Pie/donut/rose chart animation parameters

Pie/donut/rose chart appear animation configuration

Pie/donut/rose chart appear effects, supporting radial and scale animations

Whether to enable the current animation stage

Animation easing function

Animation duration, in milliseconds

Animation highlight or atmosphere color

Pie/donut/rose chart update animation configuration

Pie/donut/rose chart update effects, supporting radial animation

Whether to enable the current animation stage

Animation easing function

Animation duration, in milliseconds

Animation highlight or atmosphere color

Pie/donut/rose chart loop animation configuration

Whether to enable loop animation

Loop animation interval, in milliseconds

Pie/donut/rose chart loop animation configuration

Pie/donut/rose chart loop effects

Whether to enable the current animation stage

Animation easing function

Animation duration, in milliseconds

Animation highlight or atmosphere color

Pie/donut/rose chart atmosphere animation configuration

Atmosphere animation easing function

Atmosphere animation color

Chart theme. Theme is a low-priority configuration that includes common settings shared across all chart types and specific settings for a single chart type.

Built-in light and dark themes; users can customize themes via the Builder.

Theme

Built-in light and dark themes; new themes can be customized via registerTheme.

Locale

Chart locale configuration; supports 'zh-CN' and 'en-US'. You can also call intl.setLocale('zh-CN') to set the language.