echarts-simple-transform

This is a non-official library, and is a fork of 100pah/echarts-simple-transform.

There are some simple data transformers for Apache ECharts 5 in this library. Some of them might be migrated as ECharts built-in transforms in future.

There's an active issue in the Apache ECharts repository. It might speed things up if you up vote that issue. Once that feature is implemented as a core feature, we can get rid of this plugin.

Differences vis-à-vis the OG 100pah/echarts-simple-transform

• Exports type definitions so that TS usage is simplified.
• During grouping if a group has only 1 element, the SUM aggregation should return that element instead of 0. CodeSandBox
• Add OptionSourceData and update ExternalSource["cloneRawData"] return type to OptionSourceData.
• The bundles are generated with TSC target as ES2017 instead of ES3.
• The bundles are generated with TSC module as ESNext instead of ES2015.
• Add AggregateTransformConfig.
• Export ExternalDataTransformParam, ExternalDataTransform.

Aggregate Transform

echarts.registerTransform(ecSimpleTransform.aggregate);

const option = {
    dataset: [{
        source: [
            ['aa', 'bb', 'cc', 'tag'],
            [12, 0.33, 5200, 'AA'],
            [21, 0.65, 7100, 'AA'],
            [51, 0.15, 1100, 'BB'],
            [71, 0.75, 9100, 'BB'],
            ...
        ]
    }, {
        transform: {
            type: 'ecSimpleTransform:aggregate',
            config: {
                resultDimensions: [
                    // by default, use the same name with `from`.
                    { from: 'aa', method: 'sum' },
                    { from: 'bb', method: 'count' },
                    { from: 'cc' }, // method by default: use the first value.
                    { from: 'dd', method: 'Q1' },
                    { from: 'tag' }
                ],
                groupBy: 'tag'
            }
        }
        // Then the result data will be:
        // [
        //     ['aa', 'bb', 'cc', 'tag'],
        //     [12, 0.33, 5200, 'AA'],
        //     [21, 0.65, 8100, 'BB'],
        //     ...
        // ]
    }],
    // ...
};

const myChart = echarts.init(dom);
myChart.setOption(option);

Current supported methods (case insensitive):

• 'sum'
• 'count'
• 'first'
• 'average'
• 'Q1'
• 'Q2' or 'median'
• 'Q3'
• 'min'
• 'max'

Also see this example.

Id Transform

echarts.registerTransform(ecSimpleTransform.aggregate);

const option = {
    dataset: [{
        source: [
            ['aa', 'bb', 'cc', 'tag'],
            [12, 0.33, 5200, 'AA'],
            [21, 0.65, 8100, 'AA'],
            ...
        ]
    }, {
        transform: {
            type: 'ecSimpleTransform:id',
            config: {
                dimensionIndex: 4,
                dimensionName: 'ID'
            }
        }
        // Then the result data will be:
        // [
        //     ['aa', 'bb', 'cc', 'tag', 'ID'],
        //     [12, 0.33, 5200, 'AA', 0],
        //     [21, 0.65, 8100, 'BB', 1],
        //     ...
        // ]
    }],
    // ...
};

const myChart = echarts.init(dom);
myChart.setOption(option);