From 342567f68bf716cf232061892dbd83b06ab85015 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Wed, 11 Nov 2026 13:49:34 +0400 Subject: [PATCH 1/3] Chart: Update DiscretePointsAggregation Demo Desc. --- .../DiscretePointsAggregation/description.md | 25 +++++++------------ 1 file changed, 9 insertions(+), 16 deletions(-) diff --git a/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md b/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md index 02ad5a030c28..1b7ddfd5f4da 100644 --- a/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md +++ b/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md @@ -1,22 +1,15 @@ -To [aggregate](/Documentation/Guide/UI_Components/Chart/Data_Aggregation/) points on discrete axes, follow the steps below. - - -1. Enable aggregation. -You can enable data aggregation for the following series: +A discrete axis can receive multiple data points for the same category. DevExtreme Chart can [aggregate](/Documentation/Guide/UI_Components/Chart/Data_Aggregation/) these points and display one value per category in each series. - - Individual series - Assign `true` to the [series](/Documentation/ApiReference/UI_Components/dxChart/Configuration/series/).[aggregation](/Documentation/ApiReference/UI_Components/dxChart/Configuration/series/aggregation/).[enabled](/Documentation/ApiReference/UI_Components/dxChart/Configuration/series/aggregation/#enabled) property. +This demo displays monthly crude oil production in six US states. The Chart creates a series for each year, so every series contains twelve values per state. Without aggregation, the Chart draws these values as twelve overlapping bars in the same position. Aggregation replaces them with a single bar. - - All series of a specific type - Assign `true` to the `aggregaion.enabled` property that belongs to the configuration object of a [specific series type](/Documentation/ApiReference/UI_Components/dxChart/Series_Types/). - - - All series in the Chart - Assign `true` to the [commonSeriesSettings](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/).[aggregation](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/).[enabled](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/#enabled) property. + -Individual series aggregation settings have priority over common aggregation settings in the component. For example, you can enable aggregation for all series and disable it for a specific series. +Use the options below the Chart to change aggregation settings: -In this demo, data aggregation is enabled for all series. +- **Aggregation enabled** +Clear this checkbox to display source data. All twelve monthly bars overlap and look like a single bar as tall as the highest monthly value. The tooltip displays the month for the bar under the mouse pointer, and this month changes as you move the pointer along the bar. -2. Specify an aggregation [method](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/#method) (optional). -In this demo, the `sum` method is used. +- **Method** +Select the value that aggregated bars display: average, sum, or minimum. Gray bars in the background display the monthly maximum for comparison. +You can apply common aggregation settings to all series. Activate [aggregation](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/).[enabled](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/#enabled) in [commonSeriesSettings](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/) and specify an aggregation [method](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/#method). Individual [series](/Documentation/ApiReference/UI_Components/dxChart/Configuration/series/aggregation/) settings override these common settings. In this demo, the gray series always use the *"max"* aggregation method. From 12d89fb5f9187b619b794347091b50b4108c0d08 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Wed, 11 Nov 2026 14:03:15 +0400 Subject: [PATCH 2/3] Add Minor Clarification --- .../demos/Demos/Charts/DiscretePointsAggregation/description.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md b/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md index 1b7ddfd5f4da..7f6a140faf94 100644 --- a/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md +++ b/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md @@ -10,6 +10,6 @@ Use the options below the Chart to change aggregation settings: Clear this checkbox to display source data. All twelve monthly bars overlap and look like a single bar as tall as the highest monthly value. The tooltip displays the month for the bar under the mouse pointer, and this month changes as you move the pointer along the bar. - **Method** -Select the value that aggregated bars display: average, sum, or minimum. Gray bars in the background display the monthly maximum for comparison. +Select the value that aggregated bars display: average, sum, or minimum. Gray bars in the background display the monthly maximum for comparison when average or minimum is selected. You can apply common aggregation settings to all series. Activate [aggregation](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/).[enabled](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/#enabled) in [commonSeriesSettings](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/) and specify an aggregation [method](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/#method). Individual [series](/Documentation/ApiReference/UI_Components/dxChart/Configuration/series/aggregation/) settings override these common settings. In this demo, the gray series always use the *"max"* aggregation method. From 21d4fc52a4789f56fe5f745a71d0cac125e027c6 Mon Sep 17 00:00:00 2001 From: Arman Boyakhchyan Date: Fri, 13 Nov 2026 08:12:29 +0400 Subject: [PATCH 3/3] Apply batched suggestions from code review Co-authored-by: Elena Khamliuk <80813840+khamlyuk@users.noreply.github.com> Signed-off-by: Arman Boyakhchyan --- .../Demos/Charts/DiscretePointsAggregation/description.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md b/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md index 7f6a140faf94..2d43b208cf08 100644 --- a/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md +++ b/apps/demos/Demos/Charts/DiscretePointsAggregation/description.md @@ -1,15 +1,15 @@ -A discrete axis can receive multiple data points for the same category. DevExtreme Chart can [aggregate](/Documentation/Guide/UI_Components/Chart/Data_Aggregation/) these points and display one value per category in each series. +Multiple data points within a data set can be attributed to the same category. DevExtreme Chart can [aggregate](/Documentation/Guide/UI_Components/Chart/Data_Aggregation/) such points and display one value per category in each series. This demo displays monthly crude oil production in six US states. The Chart creates a series for each year, so every series contains twelve values per state. Without aggregation, the Chart draws these values as twelve overlapping bars in the same position. Aggregation replaces them with a single bar. -Use the options below the Chart to change aggregation settings: +Use the options below the Chart to modify aggregation settings as follows: - **Aggregation enabled** Clear this checkbox to display source data. All twelve monthly bars overlap and look like a single bar as tall as the highest monthly value. The tooltip displays the month for the bar under the mouse pointer, and this month changes as you move the pointer along the bar. - **Method** -Select the value that aggregated bars display: average, sum, or minimum. Gray bars in the background display the monthly maximum for comparison when average or minimum is selected. +Select the aggregation method used to display bars: average, sum, or minimum. Gray bars in the background display the monthly maximum for comparison when average or minimum is selected. You can apply common aggregation settings to all series. Activate [aggregation](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/).[enabled](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/#enabled) in [commonSeriesSettings](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/) and specify an aggregation [method](/Documentation/ApiReference/UI_Components/dxChart/Configuration/commonSeriesSettings/aggregation/#method). Individual [series](/Documentation/ApiReference/UI_Components/dxChart/Configuration/series/aggregation/) settings override these common settings. In this demo, the gray series always use the *"max"* aggregation method.