Scatter chart¶

Usage¶

Use this chart to show the correlation between two variables, to identify a distribution pattern or potential outliers.

Different shapes can be used to make the information more accessible. The circle is the default shape, but it can be combined with rectangle, triangle or diamond shapes as needed.

Best practices¶

• Use colors and shapes to help differentiate between data points.
• Provide context for the data by including relevant annotations and explaining the significance of trends and highlighted patterns.
• Avoid overcrowding the chart by limiting the number of data points displayed or by using a subset of data that is representative of the overall trend.
• Consider the distribution of the data on both the X and Y axes and choose an appropriate axis scale that accurately reflects the relationships between the variables.
• Keep the design of the chart simple and uncluttered. Avoid adding unnecessary elements that can distract from the data.

Design¶

If you want to display values as a collection of points, a scatter chart would be your best choice.

1. Chart title, 2. Legend, 3. Points, 4. X axis, 5. Y axis

Code¶

Usage¶

import { SiChartCartesianComponent } from '@siemens/charts-ng';

@Component({
  imports: [SiChartCartesianComponent, ...]
})

SiChartCartesianComponent API Documentation¶

Input Properties¶

Name	Type	Default	Description
additionalOptions ¶	EChartOption		Used to override specific properties set in options .
autoZoomSeriesIndex ¶	number	-1	No auto dataZoom update) by default. Use together with visibleEntries .
axisPointer ¶	(undefined | string | boolean)	false	Used to display axisPointer line either by click or mouse-move.
customLegendAction ¶	boolean
dataZoomFilterMode ¶	FilterMode	'none'
dataZoomMaxValueSpan ¶	number
dataZoomMinValueSpan ¶	number
dataZoomRange ¶	DataZoomRange
eChartContainerHeight ¶	(null | string)
externalXAxisFormatter ¶	(value: any, visibleRange: number) => string		External XAxis Formatter from consumer
externalZoomSlider ¶	boolean	false	Flag to use external zoom slider
maxEntries ¶	number	1000
options ¶	EChartOption		See [ECharts 5.x Documentation] https://echarts.apache.org/en/option.html for all available options.
palette ¶	string	undefined	The name of the color palette (if any) of the loaded theme .
renderer ¶	("canvas" | "svg")	'canvas'	the renderer to use: canvas or svg
selectedItem ¶	SelectedLegendItem	{ legendItemName: '' }
series ¶	CartesianChartSeries[]
showCustomLegend ¶	boolean	false
showLegend ¶	boolean	true
stacked ¶	boolean	false	Used to display the chart as a stacked one.
subChartGrids ¶	SubchartGrid[]
subTitle ¶	string
theme ¶	any		The desired theme to load.
themeCustomization ¶	any		Used to override specific options of loaded theme .
title ¶	string
tooltipFormatter ¶	(string | TooltipFormatterCallback<TopLevelFormatterParams>)
visibleEntries ¶	number	-1	No auto dataZoom update) by default. Use together with autoZoomSeriesIndex .
visibleRange ¶	number	-1	No auto dataZoom update) by default. Use together with autoZoomSeriesIndex .
xAxis ¶	(ChartXAxis | ChartXAxis[])
yAxis ¶	(ChartYAxis | ChartYAxis[])
zoomInside ¶	boolean	false	Enables zooming inside the chart with the mouse wheel/touch.
zoomMode ¶	boolean		Enable or disable brush zoom mode
zoomSlider ¶	boolean	false	Enables the zoom slider below the chart.
zoomSliderBrush ¶	boolean	true	enable brush mode for zoom slider
zoomSliderRealtime ¶	boolean	true	realtime update mode for zoom slider
zoomSliderShadow ¶	boolean	true	Shows data shadow in dataZoom slider, use together with zoomSlider .
showTimeRangeBar ¶	boolean	false	If true, add consumer-provided time range bar. Use together with zoomSlider . Deprecated: The input will be removed in future versions as the time range bar slot is deprecated.

Output Properties¶

Attributes and Methods¶

Types Documentation¶

universalTransition: true
 universalTransition: { enabled: true }