JavaScript Spline Band Chart

Demonstrates how to create a JavaScript Spline Band Chart or High-Low Fill using SciChart.js, our High Performance JavaScript Chart Software

Fullscreen

Edit

 Edit

Docs

drawExample.ts

index.html

vanilla.ts

stackedMountainChartData.ts

ExampleDataProvider.ts

theme.ts

Copy to clipboard
Minimise
Fullscreen
1import {
2    AxisMarkerAnnotation,
3    EAxisAlignment,
4    ECoordinateMode,
5    EDragMode,
6    EHorizontalAnchorPoint,
7    ELegendOrientation,
8    ELegendPlacement,
9    EllipsePointMarker,
10    FadeAnimation,
11    LegendModifier,
12    MouseWheelZoomModifier,
13    NativeTextAnnotation,
14    NumberRange,
15    NumericAxis,
16    ScaleAnimation,
17    SciChartSurface,
18    SplineBandRenderableSeries,
19    XyyBezierRenderDataTransform,
20    XyyDataSeries,
21    YAxisDragModifier,
22    ZoomExtentsModifier,
23    ZoomPanModifier,
24} from "scichart";
25// import { XyyBezierRenderDataTransform } from "scichart/Charting/Visuals/RenderableSeries/RenderDataTransforms/BezierRenderDataTransform";
26import { ExampleDataProvider } from "../../../ExampleData/ExampleDataProvider";
27import { appTheme } from "../../../theme";
28//import { xValues } from "../StackedMountainChart/data/stackedMountainChartData";
29
30
31export const drawExample = async (rootElement: string | HTMLDivElement) => {
32    
33    // Create a SciChartSurface
34    const { wasmContext, sciChartSurface } = await SciChartSurface.create(rootElement, {
35        theme: appTheme.SciChartJsTheme,
36    });
37
38    // Add an XAxis, YAxis
39    sciChartSurface.xAxes.add(new NumericAxis(wasmContext, { axisAlignment: EAxisAlignment.Top }));
40    sciChartSurface.yAxes.add(
41        new NumericAxis(wasmContext, {
42            axisAlignment: EAxisAlignment.Left,
43            visibleRange: new NumberRange(-1.75, 0.75),
44            backgroundColor: appTheme.VividSkyBlue + "33",
45            labelStyle: { color: appTheme.VividOrange },
46            majorTickLineStyle: { color: appTheme.VividOrange },
47        })
48    );
49    sciChartSurface.yAxes.add(
50        new NumericAxis(wasmContext, {
51            axisAlignment: EAxisAlignment.Right,
52            id: "y2",
53            visibleRange: new NumberRange(-0.9, 1.6),
54            backgroundColor: appTheme.VividPurple + "33",
55            labelStyle: { color: appTheme.VividRed },
56            majorTickLineStyle: { color: appTheme.VividRed },
57        })
58    );
59
60    // The spline bandseries requires a special dataseries type called XyyDataSeries
61    // This stores X, Y1, Y2 point data for the two lines in the band
62    const yData = ExampleDataProvider.getDampedSinewave(0, 0.9, 0, 0.002, 1000, 17);
63    const y1Data = ExampleDataProvider.getDampedSinewave(0, 0.9, 0, 0.002, 1000, 16);
64
65    const xValues: number[] = [];
66    const yValues: number[] = [];
67    const y1Values: number[] = [];
68
69    for (let i = 0; i < 20; i++) {
70        const index = i * 50;
71        xValues.push(yData.xValues[index]);
72        yValues.push(yData.yValues[index]);
73        y1Values.push(y1Data.yValues[index]);
74    }
75
76    // Create the band series and add to the chart
77    const rendSeries = new SplineBandRenderableSeries(wasmContext, {
78        dataSeries: new XyyDataSeries(wasmContext, { xValues, yValues, y1Values, dataSeriesName: "Default Spline" }),
79        strokeThickness: 3,
80        fill: appTheme.VividOrange + "33",
81        fillY1: appTheme.VividSkyBlue + "33",
82        stroke: appTheme.VividOrange,
83        strokeY1: appTheme.VividSkyBlue,
84        interpolationPoints: 20, // Choose the number of points to interpolate for smoothing
85        pointMarker: new EllipsePointMarker(wasmContext, {
86            width: 7,
87            height: 7,
88            fill: appTheme.PaleSkyBlue,
89            stroke: appTheme.VividSkyBlue,
90        }),
91        animation: new ScaleAnimation({ duration: 800, zeroLine: 0, fadeEffect: true }),
92    });
93
94    sciChartSurface.renderableSeries.add(rendSeries);
95
96    const bezierSeries = new SplineBandRenderableSeries(wasmContext, {
97        dataSeries: new XyyDataSeries(wasmContext, {
98            xValues,
99            yValues,
100            y1Values,
101            dataSeriesName: "XyyBezier (Range Restricted)",
102        }),
103        stroke: appTheme.VividPurple,
104        strokeY1: appTheme.VividRed,
105        fill: appTheme.VividPurple + "33",
106        fillY1: appTheme.VividRed + "33",
107        pointMarker: new EllipsePointMarker(wasmContext, {
108            width: 7,
109            height: 7,
110            fill: appTheme.PaleSkyBlue,
111            stroke: appTheme.VividSkyBlue,
112        }),
113        yAxisId: "y2",
114        strokeThickness: 3,
115        interpolationPoints: 20, // Choose the number of points to interpolate for smoothing
116        animation: new ScaleAnimation({ duration: 800, zeroLine: 0, fadeEffect: true }),
117    });
118    const bezierTransform = new XyyBezierRenderDataTransform(
119        bezierSeries,
120        wasmContext,
121        [bezierSeries.drawingProviders[0]],
122        { interpolationPoints: 20, curvature: 0.5 }
123    );
124    bezierSeries.renderDataTransform = bezierTransform;
125    sciChartSurface.renderableSeries.add(bezierSeries);
126
127    const curvatureAnnotation = new AxisMarkerAnnotation({
128        yCoordinateMode: ECoordinateMode.Relative,
129        y1: 0.5,
130        yAxisId: "y2",
131        formattedValue: "Bezier Curvature 0.5",
132        backgroundColor: appTheme.VividPurple,
133        isEditable: true,
134        onDrag: (args) => {
135            bezierTransform.curvature = curvatureAnnotation.y1;
136            curvatureAnnotation.formattedValue = "Bezier Curvature " + curvatureAnnotation.y1.toFixed(2);
137        },
138    });
139    sciChartSurface.annotations.add(curvatureAnnotation);
140
141    sciChartSurface.annotations.add(
142        new NativeTextAnnotation({
143            xCoordinateMode: ECoordinateMode.Relative,
144            yCoordinateMode: ECoordinateMode.Relative,
145            x1: 0.9,
146            y1: 0.9,
147            horizontalAnchorPoint: EHorizontalAnchorPoint.Right,
148            text: "Drag the left or right y axis to overlay and compare the series",
149            fontSize: 16,
150        })
151    );
152
153    // Optional: Add some interactivity modifiers
154    sciChartSurface.chartModifiers.add(
155        new YAxisDragModifier({ dragMode: EDragMode.Panning }),
156        new MouseWheelZoomModifier(),
157        new LegendModifier({
158            orientation: ELegendOrientation.Vertical,
159            placement: ELegendPlacement.TopRight,
160            showCheckboxes: true,
161        })
162    );
163
164    return { wasmContext, sciChartSurface };
165};
166

Spline Band Series Chart Example in JavaScript

Overview

This example demonstrates how to create a Spline Band Series Chart using SciChart.js in a JavaScript environment. The implementation visualizes two spline band series with high-low fills, utilizing dual Y axes for comparing different data ranges. It leverages custom styling, smooth interpolation, and interactive annotations to deliver an engaging charting experience.

Technical Implementation

The chart is initialized asynchronously using the SciChartSurface.create() method as described in the Getting Started with SciChart JS documentation. Two NumericAxis are configured for distinct visual zones with custom styles, as detailed in the Numeric Axis Documentation. Data for the spline band is managed by the XyyDataSeries which stores dual-line datasets, and is rendered using the SplineBandRenderableSeries. Smooth spline curves are achieved by setting interpolation points and applying the XyyBezierRenderDataTransform with customizable curvature.

Features and Capabilities

Key features include real-time update capabilities via an interactive AxisMarkerAnnotation that allows dynamic adjustment of the Bezier transform curvature. The series incorporate smooth animations using the ScaleAnimation for a refined rendering effect. Advanced spline interpolation is enabled by specifying interpolation points, ensuring that the chart curves are rendered with high visual fidelity, as explained in The Spline (Smoothed) Band Series Type. Interactive modifiers, such as the YAxisDragModifier and MouseWheelZoomModifier, further enhance the user experience by providing intuitive controls for data navigation and zooming.

Integration and Best Practices

This example follows best practices for asynchronous initialization and proper disposal in a JavaScript context. After creation, the chart instance is disposed using the sciChartSurface.delete() method to manage resources effectively, as recommended in the Memory Best Practices guide. Developers are encouraged to explore the use of custom data series (such as XyyDataSeries), configurable animations, and interactive annotations to build high-performance and responsive charting applications in JavaScript. The approach demonstrated here provides a clear model for integrating SciChart.js into non-framework-specific environments, ensuring optimal performance and ease of customization.

javascript Chart Examples & Demos

See Also: JavaScript Chart Types (39 Demos)

JavaScript Line Chart | Javascript Charts | SciChart.js Demo

JavaScript Line Chart

Discover how to create a high performance JavaScript Line Chart with SciChart - the leading JavaScript library. Get your free demo now.

JavaScript Spline Line Chart | Javascript Charts | SciChart.js

JavaScript Spline Line Chart

Discover how to create a JavaScript Spline Line Chart with SciChart. Demo includes algorithm for smoother lines. Get your free trial now.

JavaScript Digital Line Chart | Javascript Charts | SciChart.js

JavaScript Digital Line Chart

Discover how to create a JavaScript Digital Line Chart with SciChart - your feature-rich JavaScript Chart Library. Get your free demo now.

JavaScript Band Chart | Javascript Charts | SciChart.js Demo

JavaScript Band Chart

Easily create a JavaScript Band Chart or High-Low Fill with SciChart - high performance JavaScript Chart Library. Get your free trial now.

JavaScript Digital Band Chart | Javascript Charts | SciChart.js

JavaScript Digital Band Chart

Learn how to create a JavaScript Digital Band Chart or High-Low Fill Chart with SciChart's easy-to-follow demos. Get your free trial today.

JavaScript Bubble Chart | Online JavaScript Chart Examples

JavaScript Bubble Chart

Create a high performance JavaScript Bubble Chart with Sci-Chart. Demo shows how to draw point-markers at X,Y locations. Get your free demo now.

JavaScript Candlestick Chart | Online JavaScript Chart Examples

JavaScript Candlestick Chart

Discover how to create a JavaScript Candlestick Chart or Stock Chart using SciChart.js. For high Performance JavaScript Charts, get your free demo now.

JavaScript Column Chart | Javascript Charts | SciChart.js Demo

JavaScript Column Chart

JavaScript Column Chart demo by SciChart supports gradient fill and paletteproviders for more custom coloring options. Get your free demo now.

JavaScript Population Pyramid | Javascript Charts | SciChart.js

JavaScript Population Pyramid

Population Pyramid of Europe and Africa

JavaScript Error Bars Char | Javascript Charts | SciChart.js

JavaScript Error Bars Chart

Create JavaScript Error Bars Chart using high performance SciChart.js. Display uncertainty or statistical confidence of a data-point. Get free demo now.

JavaScript Impulse Chart | Javascript Charts | SciChart.js Demo

JavaScript Impulse Chart

Easily create JavaScript Impulse Chart or Stem Chart using SciChart.js - our own high performance JavaScript Chart Library. Get your free trial now.

JavaScript Text Chart | Javascript Charts | SciChart.js Demo

JavaScript Text Chart

Create JavaScript Text Chart with high performance SciChart.js.

JavaScript Fan Chart | Javascript Charts | SciChart.js Demo

JavaScript Fan Chart

Discover how to create JavaScript Fan Chart with SciChart. Zoom in to see the detail you can go to using our JavaScript Charts. Get your free demo today.

JavaScript Heatmap Chart | Javascript Charts | SciChart.js Demo

JavaScript Heatmap Chart

Easily create a high performance JavaScript Heatmap Chart with SciChart. Get your free trial of our 5-star rated JavaScript Chart Component today.

JavaScript Non Uniform Heatmap Chart | SciChart.js Demo

JavaScript Non Uniform Heatmap Chart

Create JavaScript Non Uniform Chart using high performance SciChart.js. Display Heatmap with variable cell sizes. Get free demo now.

JavaScript Heatmap Chart With Contours | SciChart.js Demo

JavaScript Heatmap Chart With Contours Example

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

NEW!
JavaScript Map Chart with Heatmap overlay | SciChart.js

JavaScript Map Chart with Heatmap overlay

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

JavaScript Mountain Chart | Javascript Charts | SciChart.js Demo

JavaScript Mountain Chart

Create JavaScript Mountain Chart with SciChart.js. Zero line can be zero or a specific value. Fill color can be solid or gradient as well. Get a free demo now.

JavaScript Spline Mountain Chart | Javascript Charts | SciChart.js

JavaScript Spline Mountain Chart

JavaScript Spline Mountain Chart design made easy. Use SciChart.js' JavaScript Charts for high performance, feature-rich designs. Get free demo now.

JavaScript Digital Mountain Chart | SciChart.js Demo

JavaScript Digital Mountain Chart

Create JavaScript Digital Mountain Chart with a stepped-line visual effect. Get your free trial of SciChart's 5-star rated JavaScript Chart Component now.

JavaScript Realtime Mountain Chart | View Online At SciChart

JavaScript Realtime Mountain Chart

JavaScript Realtime Mountain Chart made easy. Add animated, real-time updates with SciChart.js - high performance JavaScript Charts. Get free trial now.

JavaScript Scatter Chart | Javascript Charts | SciChart.js Demo

JavaScript Scatter Chart

Create JavaScript Scatter Chart with high performance SciChart.js. Easily render pre-defined point types. Supports custom shapes. Get your free trial now.

JavaScript Stacked Column Chart | Online JavaScript Charts

JavaScript Stacked Column Chart

Discover how to create a JavaScript Stacked Column Chart using our feature-rich JavaScript Chart Library, SciChart.js. Get your free demo today!

JavaScript Stacked Group Column Chart | View Examples Now

JavaScript Stacked Column Side by Side

Design JavaScript Stacked Group Column Chart side-by-side using our 5-star rated JavaScript Chart Framework, SciChart.js. Get your free demo now.

JavaScript Stacked Mountain Chart | SciChart.js Demo

JavaScript Stacked Mountain Chart

Design a high performance JavaScript Stacked Mountain Chart with SciChart.js - your one-stop JavaScript chart library. Get free demo now to get started.

JavaScript Smooth Stacked Mountain Chart | SciChart.js

JavaScript Smooth Stacked Mountain Chart

Design a high performance JavaScript Stacked Mountain Chart with SciChart.js - your one-stop JavaScript chart library. Get free demo now to get started.

JavaScript Pie Chart | Javascript Charts | SciChart.js Demo

JavaScript Pie Chart

Easily create and customise a high performance JavaScript Pie Chart with 5-star rated SciChart.js. Get your free trial now to access the whole library.

JavaScript Donut Chart | Javascript Charts | SciChart.js Demo

JavaScript Donut Chart

Create JavaScript Donut Chart with 5-star rated SciChart.js chart library. Supports legends, text labels, animated updates and more. Get free trial now.

JavaScript Linear Gauges | Javascript Charts | SciChart.js Demo

JavaScript Linear Gauges Example

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

JavaScript Quadrant Chart using Background Annotations

JavaScript Quadrant Chart using Background Annotations

Demonstrates how to color areas of the chart surface using background Annotations using SciChart.js Annotations API

JavaScript Histogram Chart | Javascript Charts | SciChart.js

JavaScript Histogram Chart

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

JavaScript Gantt Chart | Javascript Charts | SciChart.js Demo

JavaScript Gantt Chart Example

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.

JavaScript Choropleth Map | Javascript Charts | SciChart.js Demo

JavaScript Choropleth Map Example

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.

JavaScript Multi-Layer Map | Javascript Charts | SciChart.js

JavaScript Multi-Layer Map Example

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

JavaScript Vector Field Plot | Javascript Charts | SciChart.js

JavaScript Vector Field Plot

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

JavaScript Waterfall Chart | Bridge Chart | SciChart.js

JavaScript Waterfall Chart | Bridge Chart

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

JavaScript Box Plot Chart | Javascript Charts | SciChart.js Demo

JavaScript Box Plot Chart

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

JavaScript Triangle Series | Triangle Mesh Chart | SciChart

JavaScript Triangle Series | Triangle Mesh Chart

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.

JavaScript Treemap Chart | Javascript Charts | SciChart.js Demo

JavaScript Treemap Chart

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

SciChart Ltd, 16 Beaufort Court, Admirals Way, Docklands, London, E14 9XL.