When using charts to display data, it can be useful to display margins of error for each point. Showing a positive or negative error amount in the results of a scientific experiment can show the variability of the results at a glance.
The error type (error amount) can be set with the following:
Fixed Value - set error bar with a fixed value.
Percentage - set error bar with a percentage of the data value in the same direction axis.
Standard deviation - set error bar with a calculating value which depends on the set deviation and chart data value.
Standard error - set error bar with a calculating value which only depends on the chart data value.
Custom - set error bar with positive and negative values represented by formulas or fixed numbers.
This feature supports the following chart types:
Column
Line
Bar
Area
Scatter
Bubble
Customize
type: Specify the visibility of negative error bar and positive error bar.
noEndCap: Specify the visibility of the error bar caps.
style: Specify the line style of the error bar including color, width, and dash line.
You can customize the error bars using the following code:
import * as React from 'react';
import { createRoot } from 'react-dom/client';
import './styles.css';
import { AppFunc } from './app-func';
// import { App } from './app-class';
// 1. Functional Component sample
createRoot(document.getElementById('app')).render(<AppFunc />);
// 2. Class Component sample
// createRoot(document.getElementById('app')).render(<App />);
import * as React from 'react';
import GC from '@mescius/spread-sheets';
import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react';
import '@mescius/spread-sheets-shapes';
import '@mescius/spread-sheets-charts';
const COLORS = {
deepBlue: '#3e619f',
blue: '#a1b8e1',
deepOrange: '#c55a11',
orange: '#f6be98',
white: '#ffffff'
};
export function AppFunc() {
let spread = null;
const initSpread = (currSpread) => {
spread = currSpread;
spread.setSheetCount(3);
addBasicChart(spread.getSheet(0));
addStepChart(spread.getSheet(1));
addGanttChart(spread.getSheet(2));
}
const addBasicChart = (sheet) => {
sheet.name("BaseUsage");
let salesData = [
['', 'Sales'],
['Jan', 54],
['Feb', 60],
['Mar', 86],
['Apr', 92],
['May', 112],
['Jun', 157],
['Jul', 202],
['Aug', 195],
['Sep', 187],
['Oct', 194],
['Nov', 238],
['Dec', 289],
];
sheet.setArray(0, 0, salesData);
let chart1 = sheet.charts.add("chart1", GC.Spread.Sheets.Charts.ChartType.xyScatterSmooth, 140, 5, 500, 350, "A1:B13", GC.Spread.Sheets.Charts.RowCol.columns);
let series = chart1.series().get(0);
series.errorBars = {
vertical: {
type: GC.Spread.Sheets.Charts.ErrorBarType.both,
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.standardError,
style: {
color: COLORS.deepOrange
}
}
};
chart1.series().set(0, series);
}
const addStepChart = (sheet) => {
sheet.name("StepChart");
let priceData = [
['', 'Price', 'x-error', 'y-error-negative', 'y-error-positive'],
[new Date('5/7/2019'), 39],
[new Date('5/27/2019'), 47],
[new Date('6/15/2019'), 30],
[new Date('6/24/2019'), 46],
[new Date('8/3/2019'), 37],
[new Date('8/28/2019'), 50],
[new Date('9/29/2019'), 43],
[new Date('10/30/2019'), 48],
];
sheet.setArray(0, 0, priceData);
sheet.setFormula(1, 2, "=IF(A3, A3-A2, 20)");
sheet.setFormula(1, 3, "=IFERROR(IF(B1-B2>0, B1-B2, 0), 0)");
sheet.setFormula(1, 4, "=IFERROR(IF(B2-B1>0, B2-B1, 0), 0)");
sheet.fillAuto(new GC.Spread.Sheets.Range(1, 2, 1, 3), new GC.Spread.Sheets.Range(1, 2, 8, 3), {
direction: GC.Spread.Sheets.Fill.FillDirection.down,
fillType: GC.Spread.Sheets.Fill.FillType.auto
});
sheet.getRange(1, 1, 8, 1).formatter('_($* #,##0.00_);_($* (#,##0.00);_($* "-"??_);_(@_)');
sheet.setColumnWidth(0, 100);
let chart = sheet.charts.add("StepChart", GC.Spread.Sheets.Charts.ChartType.xyScatter, 160, 5, 800, 450, "A1:B9", GC.Spread.Sheets.Charts.RowCol.columns);
let axes = chart.axes();
axes.primaryCategory.format = 'm/d/yyyy';
axes.primaryCategory.majorTickPosition = GC.Spread.Sheets.Charts.TickMark.outside;
chart.axes(axes);
chart.legend({ visible: false });
let series = chart.series().get(0);
series.symbol = { fill: null, border: { color: null } }; // Hide the symbol.
series.errorBars = {
horizontal: {
type: GC.Spread.Sheets.Charts.ErrorBarType.plus,
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.custom,
noEndCap: true,
custom: {
positive: '=StepChart!$C$2:$C$9'
}
},
vertical: {
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.custom,
noEndCap: true,
custom: {
positive: '=StepChart!$D$2:$D$9',
negative: '=StepChart!$E$2:$E$9'
},
style: {
color: "gray",
dashStyle: GC.Spread.Sheets.Charts.LineDashStyle.dash
}
}
};
chart.series().set(0, series);
let dataLabels = chart.dataLabels();
dataLabels.showValue = true;
dataLabels.position = GC.Spread.Sheets.Charts.DataLabelPosition.above;
dataLabels.format = '$* #,##0.00';
dataLabels.color = "red";
chart.dataLabels(dataLabels);
}
const addGanttChart = (sheet) => {
sheet.name("GanttChart");
let ganttData = [
['End Date', 'Height'],
[new Date('4/15/2019'), 0.9375],
[new Date('4/29/2019'), 0.8125],
[new Date('5/6/2019'), 0.6875],
[new Date('5/20/2019'), 0.5625],
[new Date('5/27/2019'), 0.4375],
[new Date('6/17/2019'), 0.3125],
[new Date('6/24/2019'), 0.1875],
[new Date('7/1/2019'), 0.0625]
];
sheet.setArray(0, 0, ganttData);
sheet.setColumnWidth(0, 100);
let SIZE = 12;
let ZFACTOR = 25;
let chart = sheet.charts.add("GanttChart", GC.Spread.Sheets.Charts.ChartType.xyScatter, 180, 5, 500, 350, "A1:B9", GC.Spread.Sheets.Charts.RowCol.columns);
chart.title({ text: 'Advanced Gantt Chart' });
let axes = chart.axes();
axes.primaryCategory.format = 'm/d/yyyy';
axes.primaryCategory.majorTickPosition = GC.Spread.Sheets.Charts.TickMark.outside;
axes.primaryValue.visible = false;
chart.axes(axes);
chart.legend({ visible: false });
let backgroundSeriesIndex = 0;
let backgroundSeries = chart.series().get(backgroundSeriesIndex);
let backgroundErrorBar = {
type: GC.Spread.Sheets.Charts.ErrorBarType.minus,
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.custom,
noEndCap: true,
custom: {
negative: '={' + ZFACTOR + '}'
},
style: {
color: COLORS.blue,
width: SIZE
}
};
backgroundSeries.errorBars = { horizontal: backgroundErrorBar };
backgroundSeries.symbol = {
shape: GC.Spread.Sheets.Charts.SymbolShape.diamond,
size: SIZE,
fill: COLORS.deepBlue
};
chart.series().set(backgroundSeriesIndex, backgroundSeries);
let unfinishedSeries = {
chartType: GC.Spread.Sheets.Charts.ChartType.xyScatter,
axisGroup: GC.Spread.Sheets.Charts.AxisGroup.primary,
xValues: 'GanttChart!$A$2:$A$9',
yValues: 'GanttChart!$B$2:$B$9',
symbol: {
shape: GC.Spread.Sheets.Charts.SymbolShape.diamond,
size: SIZE - 4,
fill: COLORS.deepOrange
},
errorBars: {
horizontal: {
type: GC.Spread.Sheets.Charts.ErrorBarType.minus,
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.custom,
noEndCap: true,
custom: {
negative: '={' + createErrorBarValue(ganttData.slice(1), ZFACTOR).toString() + '}'
},
style: {
color: COLORS.orange,
width: SIZE
}
}
}
};
chart.series().add(unfinishedSeries);
let dataLabels = chart.dataLabels();
dataLabels.showValue = true;
dataLabels.position = GC.Spread.Sheets.Charts.DataLabelPosition.below;
dataLabels.format = '#,##0%';
dataLabels.color = COLORS.orange;
chart.dataLabels(dataLabels);
}
const createErrorBarValue = (dataSource, z) => {
let values = [];
for (let i = 0; i < dataSource.length; i++) {
values.push(dataSource[i][1] * z);
}
return values;
}
return (<div class="sample-tutorial">
<div class="sample-spreadsheets">
<SpreadSheets workbookInitialized={spread => initSpread(spread)}>
<Worksheet />
</SpreadSheets>
</div>
</div>);
}
import * as React from 'react';
import GC from '@mescius/spread-sheets';
import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react';
import '@mescius/spread-sheets-shapes';
import '@mescius/spread-sheets-charts';
const Component = React.Component;
const COLORS = {
deepBlue: '#3e619f',
blue: '#a1b8e1',
deepOrange: '#c55a11',
orange: '#f6be98',
white: '#ffffff'
};
export class App extends Component {
constructor(props) {
super(props);
this.spread = null;
}
render() {
return (<div class="sample-tutorial">
<div class="sample-spreadsheets">
<SpreadSheets workbookInitialized={spread => this.initSpread(spread)}>
<Worksheet />
</SpreadSheets>
</div>
</div>);
}
initSpread(spread) {
this.spread = spread;
spread.setSheetCount(3);
this.addBasicChart(spread.getSheet(0));
this.addStepChart(spread.getSheet(1));
this.addGanttChart(spread.getSheet(2));
}
addBasicChart(sheet) {
sheet.name("BaseUsage");
let salesData = [
['', 'Sales'],
['Jan', 54],
['Feb', 60],
['Mar', 86],
['Apr', 92],
['May', 112],
['Jun', 157],
['Jul', 202],
['Aug', 195],
['Sep', 187],
['Oct', 194],
['Nov', 238],
['Dec', 289],
];
sheet.setArray(0, 0, salesData);
let chart1 = sheet.charts.add("chart1", GC.Spread.Sheets.Charts.ChartType.xyScatterSmooth, 140, 5, 500, 350, "A1:B13", GC.Spread.Sheets.Charts.RowCol.columns);
let series = chart1.series().get(0);
series.errorBars = {
vertical: {
type: GC.Spread.Sheets.Charts.ErrorBarType.both,
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.standardError,
style: {
color: COLORS.deepOrange
}
}
};
chart1.series().set(0, series);
}
addStepChart(sheet) {
sheet.name("StepChart");
let priceData = [
['', 'Price', 'x-error', 'y-error-negative', 'y-error-positive'],
[new Date('5/7/2019'), 39],
[new Date('5/27/2019'), 47],
[new Date('6/15/2019'), 30],
[new Date('6/24/2019'), 46],
[new Date('8/3/2019'), 37],
[new Date('8/28/2019'), 50],
[new Date('9/29/2019'), 43],
[new Date('10/30/2019'), 48],
];
sheet.setArray(0, 0, priceData);
sheet.setFormula(1, 2, "=IF(A3, A3-A2, 20)");
sheet.setFormula(1, 3, "=IFERROR(IF(B1-B2>0, B1-B2, 0), 0)");
sheet.setFormula(1, 4, "=IFERROR(IF(B2-B1>0, B2-B1, 0), 0)");
sheet.fillAuto(new GC.Spread.Sheets.Range(1, 2, 1, 3), new GC.Spread.Sheets.Range(1, 2, 8, 3), {
direction: GC.Spread.Sheets.Fill.FillDirection.down,
fillType: GC.Spread.Sheets.Fill.FillType.auto
});
sheet.getRange(1, 1, 8, 1).formatter('_($* #,##0.00_);_($* (#,##0.00);_($* "-"??_);_(@_)');
sheet.setColumnWidth(0, 100);
let chart = sheet.charts.add("StepChart", GC.Spread.Sheets.Charts.ChartType.xyScatter, 160, 5, 800, 450, "A1:B9", GC.Spread.Sheets.Charts.RowCol.columns);
let axes = chart.axes();
axes.primaryCategory.format = 'm/d/yyyy';
axes.primaryCategory.majorTickPosition = GC.Spread.Sheets.Charts.TickMark.outside;
chart.axes(axes);
chart.legend({ visible: false });
let series = chart.series().get(0);
series.symbol = { fill: null, border: { color: null } }; // Hide the symbol.
series.errorBars = {
horizontal: {
type: GC.Spread.Sheets.Charts.ErrorBarType.plus,
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.custom,
noEndCap: true,
custom: {
positive: '=StepChart!$C$2:$C$9'
}
},
vertical: {
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.custom,
noEndCap: true,
custom: {
positive: '=StepChart!$D$2:$D$9',
negative: '=StepChart!$E$2:$E$9'
},
style: {
color: "gray",
dashStyle: GC.Spread.Sheets.Charts.LineDashStyle.dash
}
}
};
chart.series().set(0, series);
let dataLabels = chart.dataLabels();
dataLabels.showValue = true;
dataLabels.position = GC.Spread.Sheets.Charts.DataLabelPosition.above;
dataLabels.format = '$* #,##0.00';
dataLabels.color = "red";
chart.dataLabels(dataLabels);
}
addGanttChart(sheet) {
let self = this;
sheet.name("GanttChart");
let ganttData = [
['End Date', 'Height'],
[new Date('4/15/2019'), 0.9375],
[new Date('4/29/2019'), 0.8125],
[new Date('5/6/2019'), 0.6875],
[new Date('5/20/2019'), 0.5625],
[new Date('5/27/2019'), 0.4375],
[new Date('6/17/2019'), 0.3125],
[new Date('6/24/2019'), 0.1875],
[new Date('7/1/2019'), 0.0625]
];
sheet.setArray(0, 0, ganttData);
sheet.setColumnWidth(0, 100);
let SIZE = 12;
let ZFACTOR = 25;
let chart = sheet.charts.add("GanttChart", GC.Spread.Sheets.Charts.ChartType.xyScatter, 180, 5, 500, 350, "A1:B9", GC.Spread.Sheets.Charts.RowCol.columns);
chart.title({ text: 'Advanced Gantt Chart' });
let axes = chart.axes();
axes.primaryCategory.format = 'm/d/yyyy';
axes.primaryCategory.majorTickPosition = GC.Spread.Sheets.Charts.TickMark.outside;
axes.primaryValue.visible = false;
chart.axes(axes);
chart.legend({ visible: false });
let backgroundSeriesIndex = 0;
let backgroundSeries = chart.series().get(backgroundSeriesIndex);
let backgroundErrorBar = {
type: GC.Spread.Sheets.Charts.ErrorBarType.minus,
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.custom,
noEndCap: true,
custom: {
negative: '={' + ZFACTOR + '}'
},
style: {
color: COLORS.blue,
width: SIZE
}
};
backgroundSeries.errorBars = { horizontal: backgroundErrorBar };
backgroundSeries.symbol = {
shape: GC.Spread.Sheets.Charts.SymbolShape.diamond,
size: SIZE,
fill: COLORS.deepBlue
};
chart.series().set(backgroundSeriesIndex, backgroundSeries);
let unfinishedSeries = {
chartType: GC.Spread.Sheets.Charts.ChartType.xyScatter,
axisGroup: GC.Spread.Sheets.Charts.AxisGroup.primary,
xValues: 'GanttChart!$A$2:$A$9',
yValues: 'GanttChart!$B$2:$B$9',
symbol: {
shape: GC.Spread.Sheets.Charts.SymbolShape.diamond,
size: SIZE - 4,
fill: COLORS.deepOrange
},
errorBars: {
horizontal: {
type: GC.Spread.Sheets.Charts.ErrorBarType.minus,
valueType: GC.Spread.Sheets.Charts.ErrorBarValueType.custom,
noEndCap: true,
custom: {
negative: '={' + self.createErrorBarValue(ganttData.slice(1), ZFACTOR).toString() + '}'
},
style: {
color: COLORS.orange,
width: SIZE
}
}
}
};
chart.series().add(unfinishedSeries);
let dataLabels = chart.dataLabels();
dataLabels.showValue = true;
dataLabels.position = GC.Spread.Sheets.Charts.DataLabelPosition.below;
dataLabels.format = '#,##0%';
dataLabels.color = COLORS.orange;
chart.dataLabels(dataLabels);
}
createErrorBarValue(dataSource, z) {
let values = [];
for (let i = 0; i < dataSource.length; i++) {
values.push(dataSource[i][1] * z);
}
return values;
}
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/en/react/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<!-- SystemJS -->
<script src="$DEMOROOT$/en/react/node_modules/systemjs/dist/system.src.js"></script>
<script src="systemjs.config.js"></script>
<script>
System.import('$DEMOROOT$/en/lib/react/license.js').then(function () {
System.import('./src/app');
});
</script>
</head>
<body>
<div id="app"></div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: 100%;
height:100%;
overflow: hidden;
float: left;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
#app {
height: 100%;
}
(function (global) {
System.config({
transpiler: 'plugin-babel',
babelOptions: {
es2015: true,
react: true
},
meta: {
'*.css': { loader: 'css' }
},
paths: {
// paths serve as alias
'npm:': 'node_modules/'
},
// map tells the System loader where to look for things
map: {
'@mescius/spread-sheets-shapes': 'npm:@mescius/spread-sheets-shapes/index.js',
'@mescius/spread-sheets-charts': 'npm:@mescius/spread-sheets-charts/index.js',
'@mescius/spread-sheets': 'npm:@mescius/spread-sheets/index.js',
'@mescius/spread-sheets-react': 'npm:@mescius/spread-sheets-react/index.js',
'@grapecity/jsob-test-dependency-package/react-components': 'npm:@grapecity/jsob-test-dependency-package/react-components/index.js',
'react': 'npm:react/cjs/react.production.js',
'react-dom': 'npm:react-dom/cjs/react-dom.production.js',
'react-dom/client': 'npm:react-dom/cjs/react-dom-client.production.js',
'scheduler': 'npm:scheduler/cjs/scheduler.production.js',
'css': 'npm:systemjs-plugin-css/css.js',
'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js',
'systemjs-babel-build':'npm:systemjs-plugin-babel/systemjs-babel-browser.js'
},
// packages tells the System loader how to load when no filename and/or no extension
packages: {
src: {
defaultExtension: 'jsx'
},
"node_modules": {
defaultExtension: 'js'
},
}
});
})(this);
