# Class ScatterChartComponent
A component displaying the distribution of two variables on an X-Axis, Y-Axis, and two additional fields of data that are shown as colored circles scattered across the chart.
Point: A field that for each of its members a scatter point is drawn. The maximum amount of data points is 500.
Size: An optional field represented by the size of the circles. If omitted, all scatter points are equal in size. If used, the circle sizes are relative to their values.
# Example
<csdk-scatter-chart
[dataSet]="scatter.dataSet"
[dataOptions]="scatter.dataOptions"
[highlights]="filters"
[beforeRender]="onBeforeRender"
(dataPointClick)="logArguments($event)"
(dataPointContextMenu)="logArguments($event)"
(dataPointsSelect)="logArguments($event)"
/>
import { Component } from '@angular/core';
import { measureFactory, filterFactory } from '@sisense/sdk-data';
import * as DM from '../../assets/sample-healthcare-model';
@Component({
selector: 'app-analytics',
templateUrl: './analytics.component.html',
styleUrls: ['./analytics.component.scss'],
})
export class AnalyticsComponent {
DM = DM;
filters = [filterFactory.members(DM.Divisions.Divison_name, ['Cardiology', 'Neurology'])];
scatter = {
dataSet: DM.DataSource,
dataOptions: {
x: DM.Admissions.Room_ID,
y: measureFactory.sum(DM.Admissions.Cost_of_admission),
},
};
onBeforeRender(options: any) {
console.log('beforeRender');
console.log(options);
return options;
}
logArguments(...args: any[]) {
console.log(args);
}
}
# Constructors
# constructor
new ScatterChartComponent():
ScatterChartComponent
# Returns
# Properties
# Data
# dataOptions
dataOptions:
ScatterChartDataOptions
Configurations for how to interpret and present the data passed to the chart
# dataSet
dataSet:
Data|DataSource|undefined
Data set for a chart using one of the following options. If neither option is specified, the chart
will use the defaultDataSource specified in the parent SisenseContextProvider
component.
(1) Sisense data source name as a string. For example, 'Sample ECommerce'. Typically, you
retrieve the data source name from a data model you create using the get-data-model command (opens new window) of the Compose SDK CLI. Under the hood, the chart
connects to the data source, executes a query, and loads the data as specified in
dataOptions, filters, and highlights.
To learn more about using data from a Sisense data source, see the Compose SDK Charts Guide.
OR
(2) Explicit Data, which is made up of an array of
Column objects and a two-dimensional array of row data. This approach
allows the chart component to be used with any data you provide.
To learn more about using data from an external data source, see the Compose SDK Charts Guide.
Example data in the proper format:
const sampleData = {
columns: [
{ name: 'Years', type: 'date' },
{ name: 'Quantity', type: 'number' },
{ name: 'Units', type: 'number' },
],
rows: [
['2019', 5500, 1500],
['2020', 4471, 7000],
['2021', 1812, 5000],
['2022', 5001, 6000],
['2023', 2045, 4000],
],
};
# filters
filters:
FilterRelations|Filter[] |undefined
Filters to limit (or slice) a chart’s data using one of the following options.
(1) Array of Filter or FilterRelations returned from filter factory functions, such as
greaterThan() and members().
Use this option for filters that do not require a UI to set them or for filters where you will supply your own UI components or use pre-built UI components. This is the most common option.
To learn more about using filter factory functions to create filters, see the Compose SDK Charts Guide.
(2) Array of Filter controlled by filter UI components – for example MemberFilterTile.
Use this option for filters that you want your users to set using pre-built UI components.
To learn more about using filter UI components to create filters, see the Compose SDK Charts Guide.
# highlights
highlights:
Filter[] |undefined
Highlights based on filter criteria to apply to a chart using one of the following options.
NOTE that the filter dimensions used in highlights must match those defined in the
dataOptions of the chart. Otherwise, the filters will be applied as regular slice filters.
(1) Array of Filter returned from filter factory functions, such as
greaterThan() and members().
Use this option for highlights that do not require a UI to set them or for highlights where you will supply your own UI components or use pre-built UI components. This is the most common option.
To learn more about using filter factory functions to create highlights, see the Compose SDK Charts Guide.
(2) Array of Filter controlled by filter UI components – for example MemberFilterTile.
Use this option for highlights that you want your users to set using pre-built UI components.
To learn more about using filter components to create highlights, see the Compose SDK Charts Guide.
# Chart
# styleOptions
styleOptions:
ScatterStyleOptions|undefined
Configurations for how to style and present a chart's data.
# Callbacks
# beforeRender
beforeRender:
BeforeRenderHandler|undefined
A callback that allows you to customize the underlying chart element before it is rendered.
Use the highchartsOptions object that is passed to the callback to change
options values (opens new window) and then return the modified options
object. The returned options are then used when rendering the chart.
This callback is not supported for Indicator Chart, Areamap Chart, Scattermap Chart, and Table.
For an example of how the onBeforeRender callback can be used, see the
Compose SDK Charts Guide.
# dataPointClick
dataPointClick:
EventEmitter<ArgumentsAsObject<ScatterDataPointEventHandler|undefined, ["point","nativeEvent"] > >
Click handler callback for a data point
# dataPointContextMenu
dataPointContextMenu:
EventEmitter<ArgumentsAsObject<ScatterDataPointEventHandler|undefined, ["point","nativeEvent"] > >
Context menu handler callback for a data point
# dataPointsSelect
dataPointsSelect:
EventEmitter<ArgumentsAsObject<ScatterDataPointsEventHandler|undefined, ["points","nativeEvent"] > >
Handler callback for selection of multiple data points