Demonstrates how to create a JavaScript Choropleth map, a type of thematic map where areas are shaded or patterned in proportion to the value of a variable being represented, using our FastTriangleRenderableSeries.
drawExample.ts
index.html
vanilla.ts
theme.ts
australiaData.ts
helpers.ts
1import {
2 ZoomExtentsModifier,
3 ZoomPanModifier,
4 NumericAxis,
5 SciChartSurface,
6 NumberRange,
7 XyDataSeries,
8 ETriangleSeriesDrawMode,
9 FastTriangleRenderableSeries,
10 MouseWheelZoomModifier,
11 FastBubbleRenderableSeries,
12 EllipsePointMarker,
13 XyzDataSeries,
14 IPointMetadata,
15 EHorizontalTextPosition,
16 Thickness,
17 EVerticalTextPosition,
18 FastLineRenderableSeries,
19} from "scichart";
20
21import { appTheme } from "../../../theme";
22
23import {
24 getMinMax,
25 interpolateColor,
26 keyData,
27 australiaData,
28 preserveAspectRatio,
29} from "./helpers";
30
31import { australianCities } from "./australiaData";
32
33type Keytype = "population" | "population_density" | "area_km2";
34
35const dataArray: { name: string; areaData: number[][] }[] = [];
36const outlines: number[][][] = [];
37
38function setMapJson(mapJson: any) {
39 dataArray.length = 0;
40 outlines.length = 0;
41 mapJson.forEach((d: any) => {
42 outlines.push(d.outline);
43 dataArray.push({ name: d.name, areaData: d.areaData });
44 });
45}
46
47export const drawExample = async (rootElement: string | HTMLDivElement) => {
48 // Create a SciChartSurface
49 const { wasmContext, sciChartSurface } = await SciChartSurface.create(rootElement, {
50 theme: appTheme.SciChartJsTheme,
51 });
52
53 const growBy = new NumberRange(0.1, 0.1);
54
55 sciChartSurface.xAxes.add(new NumericAxis(wasmContext, { growBy, isVisible: true }));
56 sciChartSurface.yAxes.add(new NumericAxis(wasmContext, { growBy, isVisible: true }));
57
58 const xAxis = sciChartSurface.xAxes.get(0);
59 const yAxis = sciChartSurface.yAxes.get(0);
60
61 let firstTime = true;
62
63 const setMap = (key: Keytype) => {
64 sciChartSurface.renderableSeries.clear(true);
65
66 const [min, max] = getMinMax(key, australiaData);
67
68 const series = dataArray.map((d, i) => {
69 const dataSeries = new XyDataSeries(wasmContext, {
70 xValues: d.areaData.map((p) => p[0]),
71 yValues: d.areaData.map((p) => p[1]),
72 });
73
74 const triangleSeries = new FastTriangleRenderableSeries(wasmContext, {
75 dataSeries: dataSeries,
76 drawMode: ETriangleSeriesDrawMode.List,
77 fill: interpolateColor(min, max, keyData[d.name][key]),
78 opacity: 0.9,
79 });
80
81 return triangleSeries;
82 });
83
84 sciChartSurface.renderableSeries.add(...series);
85
86 // outline
87 const outlinesSC = outlines.map((outline) => {
88 const xVals = outline.map((d) => d[0]);
89 const yVals = outline.map((d) => d[1]);
90
91 //FastMountainRenderableSeries
92 const lineSeries = new FastLineRenderableSeries(wasmContext, {
93 dataSeries: new XyDataSeries(wasmContext, {
94 xValues: xVals,
95 yValues: yVals,
96 }),
97 stroke: "#FFFFFF",
98 strokeThickness: 1,
99 opacity: 1,
100 });
101
102 return lineSeries;
103 });
104
105 sciChartSurface.renderableSeries.add(...outlinesSC);
106
107 // cities
108 const cLongitude = australianCities.map((d) => d.longitude);
109 const clatitude = australianCities.map((d) => d.latitude);
110 const cSize = australianCities.map((d) => 5);
111 const cMetadata = australianCities.map((d) => d) as unknown as IPointMetadata[];
112
113 const citiesSeries = new FastBubbleRenderableSeries(wasmContext, {
114 pointMarker: new EllipsePointMarker(wasmContext, {
115 width: 64,
116 height: 64,
117 fill: appTheme.ForegroundColor,
118 strokeThickness: 0,
119 }),
120 dataSeries: new XyzDataSeries(wasmContext, {
121 xValues: cLongitude,
122 yValues: clatitude,
123 zValues: cSize,
124 metadata: cMetadata,
125 }),
126 dataLabels: {
127 verticalTextPosition: EVerticalTextPosition.Above,
128 horizontalTextPosition: EHorizontalTextPosition.Right,
129 style: {
130 fontFamily: "Arial",
131 fontSize: 14,
132 padding: new Thickness(0, 0, 3, 3),
133 },
134 color: appTheme.TextColor,
135 metaDataSelector: (md) => {
136 const metadata = md as unknown as { name: string };
137 return metadata.name.toString();
138 },
139 },
140 });
141 sciChartSurface.renderableSeries.add(citiesSeries);
142
143 if (firstTime) {
144 sciChartSurface.zoomExtents();
145 firstTime = false;
146 }
147 };
148
149 sciChartSurface.preRender.subscribe(() => {
150 const result = preserveAspectRatio(
151 sciChartSurface.viewRect.width,
152 sciChartSurface.viewRect.height,
153 xAxis.visibleRange.min,
154 xAxis.visibleRange.max,
155 yAxis.visibleRange.min,
156 yAxis.visibleRange.max
157 );
158
159 xAxis.visibleRange = new NumberRange(result.minVisibleX, result.maxVisibleX);
160 yAxis.visibleRange = new NumberRange(result.minVisibleY, result.maxVisibleY);
161 });
162
163 // Add zoom/pan controls
164 sciChartSurface.chartModifiers.add(
165 new ZoomExtentsModifier(),
166 new ZoomPanModifier({ enableZoom: true }),
167 new MouseWheelZoomModifier()
168 );
169
170 return { wasmContext, sciChartSurface, setMap, setMapJson };
171};
172This JavaScript example demonstrates how to create an interactive map of Australia using SciChart.js. It visualizes geographic data with FastTriangleRenderableSeries for terrain coloring and FastLineRenderableSeries for state outlines.
The implementation uses triangulation to convert geographic coordinates into renderable triangles with ETriangleSeriesDrawMode.List mode. Data is loaded from predefined arrays and styled based on population density metrics. The chart includes interactive modifiers like ZoomPanModifier for navigation. This example fetches australiaConverted.json from server. australiaConverted.json is array of objects and each object contains 'name', 'outline' and 'areaData'.
name is string that contains name of the location
outline is array of arrays that represent longitude and latitude of points that represent outline of area
areaData is array of arrays that represent series of coordinate points that form triangles used by SciChart's FastTriangleRenderableSeries to create shapes that represent area
areaData is generated using poly2tri - https://github.com/r3mi/poly2tri.js, a 2D constrained Delaunay triangulation library from GeoJSON representation of Australia map
The example shows dynamic recoloring of states based on selected metrics (population, area, or density) using a custom interpolation function. City markers are displayed using FastBubbleRenderableSeries with data labels.
The implementation follows JavaScript best practices with async chart initialization and proper surface disposal. The aspect ratio preservation logic ensures correct map proportions during resizing.

Create a JavaScript Histogram Chart with custom texture fills and patterns. Try the SciChart.js library for seamless integration today.

Build a JavaScript Gantt Chart with SciChart. View the demo for horizontal bars, rounded corners and data labels to show project timelines and task completion.

Create a JavaScript Multi-Layer Map Example, using FastTriangleRenderableSeries with GeoJSON data-points using a constrained delaunay triangulation algorithm.

Bring annual comparison data to life with the JavaScript Animated Bar Chart example from SciChart. This demo showcases top 10 tennis players from 1990 to 2024.

View the JavaScript Vector Field Plot example from SciChart, including dynamic vector generation, gradient-colored segments, and interactive zoom/pan. Try demo.

Build a JavaScript Waterfall Chart with dynamic coloring, multi-line data labels and responsive design. Try SciChart.js for seamless integration today.

Try the JavaScript Box-Plot Chart examples with developer-friendly chart lifecycle management, dynamic sub-surface positioning, and custom styling.

Create JavaScript Triangle Meshes with the Triangle Series from SciChart. This demo supports strip mode, list mode and the drawing of polygons. View the example.

Create a JavaScript Treemap Chart to define rectangle positions based on total value. Use SciChart FastRectangleRenderableSeries and d3-hierarchy.js layouts.

Design a highly dynamic JavaScript Map Chart with Heatmap overlay with SciChart's feature-rich JavaScript Chart Library. Get your free demo today.

Demonstrating the capability of SciChart.js to create a JavaScript Audio Analyzer Bars and visualize the Fourier-Transform of an audio waveform in realtime.

View the JavaScript Linear Gauge Chart example to combine rectangles & annotations. Create a linear gauge dashboard with animated indicators and custom scales.

The JavaScript Order of Rendering example gives you full control of the draw order of series and annotations for charts. Try SciChart's advanced customizations.

Build Responsive JavaScript HTML Annotations with SciChart. Use the advanced CSS container queries for responsive text layout and custom design. View demo now.

JavaScript HTML Chart Control example demonstrates advanced HTML annotation integration and how to render HTML components within charts. Try the SciChart demo.

Explore SciChart's Polar Interactivity Modifiers including zooming, panning, and cursor tracking. Try the demo to trial the Polar Chart Behavior Modifiers.