Our team demonstrates how to create a React 3D Bubble Chart using SciChart.js, capable of creating detailed 3D JavaScript Charts.
drawExample.ts
index.tsx
ExampleDataProvider.ts
theme.ts
1import { appTheme } from "../../../theme";
2
3import {
4 SciChart3DSurface,
5 CameraController,
6 Vector3,
7 MouseWheelZoomModifier3D,
8 OrbitModifier3D,
9 ResetCamera3DModifier,
10 NumericAxis3D,
11 NumberRange,
12 ScatterRenderableSeries3D,
13 XyzDataSeries3D,
14 SpherePointMarker3D,
15 TGradientStop,
16 parseColorToUIntArgb,
17 TooltipModifier3D,
18 SeriesInfo3D,
19 TooltipSvgAnnotation3D,
20 XyzSeriesInfo3D,
21 IPointMetadata3D,
22} from "scichart";
23
24import {
25 fetchPopulationDataData,
26 TMappedPopulationData,
27 TPopulationMetadata,
28} from "../../../ExampleData/ExampleDataProvider";
29
30const initializeChart = async (rootElement: string | HTMLDivElement) => {
31 const { sciChart3DSurface, wasmContext } = await SciChart3DSurface.create(rootElement, {
32 theme: appTheme.SciChartJsTheme,
33 });
34 sciChart3DSurface.camera = new CameraController(wasmContext, {
35 position: new Vector3(-141.6, 310.29, 393.32),
36 target: new Vector3(0, 50, 0),
37 });
38
39 sciChart3DSurface.chartModifiers.add(
40 new MouseWheelZoomModifier3D(),
41 new OrbitModifier3D(),
42 new ResetCamera3DModifier()
43 );
44
45 const tooltipModifier = new TooltipModifier3D({ tooltipLegendOffsetX: 10, tooltipLegendOffsetY: 10 });
46 tooltipModifier.tooltipDataTemplate = (seriesInfo: SeriesInfo3D, svgAnnotation: TooltipSvgAnnotation3D) => {
47 const valuesWithLabels: string[] = [];
48 if (seriesInfo && seriesInfo.isHit) {
49 const md = (seriesInfo as XyzSeriesInfo3D).pointMetadata as TPopulationMetadata;
50 valuesWithLabels.push(md.country);
51 valuesWithLabels.push(`Life Expectancy: ${seriesInfo.xValue}`);
52 valuesWithLabels.push(`GDP Per Capita: ${seriesInfo.yValue}`);
53 valuesWithLabels.push(`Year: ${seriesInfo.zValue}`);
54 }
55 return valuesWithLabels;
56 };
57 const defaultTemplate = tooltipModifier.tooltipSvgTemplate;
58 tooltipModifier.tooltipSvgTemplate = (seriesInfo: SeriesInfo3D, svgAnnotation: TooltipSvgAnnotation3D) => {
59 if (seriesInfo) {
60 const md = (seriesInfo as XyzSeriesInfo3D).pointMetadata as TPopulationMetadata;
61 svgAnnotation.containerBackground = md.color;
62 svgAnnotation.textStroke = "white";
63 }
64 return defaultTemplate(seriesInfo, svgAnnotation);
65 };
66 sciChart3DSurface.chartModifiers.add(tooltipModifier);
67
68 sciChart3DSurface.xAxis = new NumericAxis3D(wasmContext, {
69 axisTitle: "Life Expectancy",
70 visibleRange: new NumberRange(30, 85),
71 labelPrecision: 0,
72 });
73 sciChart3DSurface.yAxis = new NumericAxis3D(wasmContext, {
74 axisTitle: "Gdp Per Capita",
75 visibleRange: new NumberRange(0, 50000),
76 labelPrecision: 0,
77 });
78 sciChart3DSurface.zAxis = new NumericAxis3D(wasmContext, {
79 axisTitle: "Year",
80 visibleRange: new NumberRange(1950, 2010),
81 labelPrecision: 0,
82 });
83
84 const renderableSeries = new ScatterRenderableSeries3D(wasmContext, {
85 pointMarker: new SpherePointMarker3D(wasmContext, { size: 10 }),
86 opacity: 0.9,
87 dataSeries: new XyzDataSeries3D(wasmContext),
88 });
89
90 sciChart3DSurface.renderableSeries.add(renderableSeries);
91
92 const setData = (data: TMappedPopulationData) => {
93 const { lifeExpectancy, gdpPerCapita, year, metadata } = data;
94
95 (renderableSeries.dataSeries as XyzDataSeries3D).appendRange(lifeExpectancy, gdpPerCapita, year, metadata);
96 };
97
98 return { sciChartSurface: sciChart3DSurface, setData };
99};
100
101export const drawExample = async (rootElement: string | HTMLDivElement) => {
102 const [chart, data] = await Promise.all([initializeChart(rootElement), fetchPopulationDataData()]);
103 chart.setData(data);
104
105 return chart;
106};
107This example demonstrates how to create a React 3D Bubble Chart using SciChart.js. It presents a comprehensive setup where a 3D chart is asynchronously initialized, customized, and data-bound in a React environment. The example visualizes complex datasets such as life expectancy, GDP per capita, and year, and integrates custom tooltips to enhance interactive data exploration.
The implementation utilizes the <SciChartReact/> component for seamless React integration. The initialization function, passed as the initChart prop, sets up a SciChart 3D surface with features such as camera control via a CameraController, 3D chart modifiers like MouseWheelZoomModifier3D, OrbitModifier3D, and ResetCamera3DModifier, and a custom tooltip modifier for dynamic data rendering. Asynchronous initialization is managed with async/await, ensuring that chart setup and data fetching occur concurrently. Developers can refer to the React Charts with SciChart.js: Introducing “SciChart React” article for deeper insights into the integration process.
The example highlights advanced features such as custom tooltip rendering, which is implemented to display detailed metadata (e.g., country, life expectancy, GDP per capita, and year) in a styled format. Real-time data binding is managed by appending data points to an XyzDataSeries3D, enabling dynamic updates. The use of WebGL rendering ensures high performance even when working with large datasets, a concept well explained in the Advanced JavaScript Chart and Graph Library | SciChart JS documentation. Additionally, performance optimization techniques are inherently supported by SciChart.js, reducing CPU overhead and improving rendering times.
This example adheres to best practices for React integration including clear component separation, asynchronous chart initialization, and careful resource management to ensure charts are properly disposed when no longer needed. Customizations such as chart modifiers and tooltip templates leverage the deep customization capabilities of SciChart.js as seen in the Orbit Modifier 3D | JavaScript Chart Documentation. For asynchronous data synchronization and binding mechanics, developers might also review the guidelines in the Tutorial 05 - Synchronizing React Charts with Data in a Group. This structured approach not only simplifies development but also enhances maintainability and performance of highly interactive 3D charts in React.

Design a React 3D Surface Mesh Chart with SciChart.js - feature-rich JavaScript chart library. Represent 2D data in a 3D map. Get your free demo.

Create detailed React 3D Line Chart using SciChart's 5-star rated JavaScript chart library. Supports large datasets. Get your free demo now.

Demonstrating the capability of SciChart.js to create JavaScript 3D Point Cloud charts and visualize LiDAR data from the UK Defra Survey.

Demonstrating the capability of SciChart.js to create a composite 2D & 3D Chart application. An example like this could be used to visualize Tenor curves in a financial setting, or other 2D/3D data combined on a single screen.

Design a React 3D Surface Mesh Chart with SciChart.js - feature-rich JavaScript chart library. Represent 2D data in a 3D map. Get your free demo.

Create detailed React 3D Column Chart using SciChart's 5-star rated JavaScript chart library. Supports large datasets

Create advanced React 3D Styling Demo using SciChart's 5-star rated JavaScript chart library. Explore axis styling, plane visibility and multiple point markers.