Group Smaller Points

Smaller points on the PieChart can be collected in a single group in one of the following modes:

  • Top N
    Top N points with the biggest values remain ungrouped; all other points form a group. The smallValuesGrouping.topCount option specifies the N.

    jQuery
    JavaScript
    $(function() {
        $("#pieChartContainer").dxPieChart({
            smallValuesGrouping: {
                mode: "topN",
                topCount: 5
            }
        });
    });
    Angular
    HTML
    TypeScript
    <dx-pie-chart>
        <dxo-small-values-grouping
            mode="topN"
            [topCount]="5">
        </dxo-small-values-grouping>
    </dx-pie-chart>
    import { DxPieChartModule } from "devextreme-angular";
    // ...
    export class AppComponent {
        // ...
    }
    @NgModule({
        imports: [
            // ...
            DxPieChartModule
        ],
        // ...
    })
    Vue
    App.vue
    <template> 
        <DxPieChart ... >
            <DxSmallValuesGrouping
                :top-count="5"
                mode="topN"
            />
        </DxPieChart>
    </template>
    
    <script>
    import DxPieChart, {
        DxSmallValuesGrouping
    } from 'devextreme-vue/pie-chart';
    
    export default {
        components: {
            DxPieChart,
            DxSmallValuesGrouping
        }
    }
    </script>
    React
    App.js
    import React from 'react';
    import PieChart, {
        SmallValuesGrouping
    } from 'devextreme-react/pie-chart';
    
    class App extends React.Component {
        render() {
            return (
                <PieChart ... >
                    <SmallValuesGrouping
                        topCount={5}
                        mode="topN"
                    />
                </PieChart>
            );
        }
    }
  • Threshold
    Points that fall beyond a threshold establish a group. The smallValuesGrouping.threshold option specifies the threshold.

    jQuery
    JavaScript
    $(function() {
        $("#pieChartContainer").dxPieChart({
            smallValuesGrouping: {
                mode: "smallValueThreshold",
                threshold: 3.5
            }
        });
    });
    Angular
    HTML
    TypeScript
    <dx-pie-chart>
        <dxo-small-values-grouping
            mode="smallValueThreshold"
            [threshold]="3.5">
        </dxo-small-values-grouping>
    </dx-pie-chart>
    import { DxPieChartModule } from "devextreme-angular";
    // ...
    export class AppComponent {
        // ...
    }
    @NgModule({
        imports: [
            // ...
            DxPieChartModule
        ],
        // ...
    })
    Vue
    App.vue
    <template> 
        <DxPieChart ... >
            <DxSmallValuesGrouping
                :threshold="3.5"
                mode="smallValueThreshold"
            />
        </DxPieChart>
    </template>
    
    <script>
    import DxPieChart, {
        DxSmallValuesGrouping
    } from 'devextreme-vue/pie-chart';
    
    export default {
        components: {
            DxPieChart,
            DxSmallValuesGrouping
        }
    }
    </script>
    React
    App.js
    import React from 'react';
    import PieChart, {
        SmallValuesGrouping
    } from 'devextreme-react/pie-chart';
    
    class App extends React.Component {
        render() {
            return (
                <PieChart ... >
                    <SmallValuesGrouping
                        threshold={3.5}
                        mode="smallValueThreshold"
                    />
                </PieChart>
            );
        }
    }

The group for small points is called "others" by default. You can change this using the smallValuesGrouping.groupName option.

jQuery
JavaScript
$(function() {
    $("#pieChartContainer").dxPieChart({
        smallValuesGrouping: {
            // ...
            groupName: "miscellaneous"
        }
    });
});
Angular
HTML
TypeScript
<dx-pie-chart>
    <dxo-small-values-grouping ...
        groupName="miscellaneous">
    </dxo-small-values-grouping>
</dx-pie-chart>
import { DxPieChartModule } from "devextreme-angular";
// ...
export class AppComponent {
    // ...
}
@NgModule({
    imports: [
        // ...
        DxPieChartModule
    ],
    // ...
})
Vue
App.vue
<template> 
    <DxPieChart ... >
        <DxSmallValuesGrouping ...
            group-name="miscellaneous"
        />
    </DxPieChart>
</template>

<script>
import DxPieChart, {
    DxSmallValuesGrouping
} from 'devextreme-vue/pie-chart';

export default {
    components: {
        DxPieChart,
        DxSmallValuesGrouping
    }
}
</script>
React
App.js
import React from 'react';
import PieChart, {
    SmallValuesGrouping
} from 'devextreme-react/pie-chart';

class App extends React.Component {
    render() {
        return (
            <PieChart ... >
                <SmallValuesGrouping ...
                    groupName="miscellaneous"
                />
            </PieChart>
        );
    }
}

View Demo