Skip to content

Arction/lcjs-example-0007-sharedAxis

Repository files navigation

Shared Axis

Shared Axis

This demo application belongs to the set of examples for LightningChart JS, data visualization library for JavaScript.

LightningChart JS is entirely GPU accelerated and performance optimized charting library for presenting massive amounts of data. It offers an easy way of creating sophisticated and interactive charts and adding them to your website or web application.

The demo can be used as an example or a seed project. Local execution requires the following steps:

  • Make sure that relevant version of Node.js is installed

  • Open the project folder in a terminal:

      npm install              # fetches dependencies
      npm start                # builds an application and starts the development server
    
  • The application is available at http://localhost:8080 in your browser, webpack-dev-server provides hot reload functionality.

Description

Best practice of data visualization within Data Analysis in different fields and industries is combining multiple series in one chart to examine and get richer insight about collected data. Moreover, it allows researchers to make conclusions about the researching phenomena out of each data set, to search patterns and relationships both within a collection and across collections

This example shows how to:

  • configure the axis styling;
  • create additional axes;
  • assign series to explicit axes;
  • styling of ChartXY zooming rectangle.

Request default axes.

Cartesian XY charts contains default X and Y axes by default. To request the default axes of a chart, you can simply use:

// Cache reference to default X-axis for further usage.
const axisXDefault = chart.getDefaultAxisX()

// Cache reference to default Y-axis for further usage.
const axisYDefault = chart.getDefaultAxisY()

During the creation of any XY series, you can attach series to default axes by not specifying the xAxis or yAxis options.

Create new axis and attach series.

// Create additional X-axis
const axisYNew = chart.addAxisX()

// Create additional Y-axis
const axisYNew = chart.addAxisY()

During the creation of any XY series, you can attach series to any axes via the cached references as the arguments.

// Create series with explicit axes, share the same x-axis between two series.
const allSeries = [
    chart.addSplineSeries({
    xAxis: axisXDefault,
    yAxis: AxisYDefault
    }),
    chart.addSplineSeries({
    xAxis: axisXDefault,
    yAxis: axisYNew
    }),
    ...
]

Axis styling.

Both X and Y axes share the same flexible and fully customizable API, meaning the same setters and getters. The full list of methods of the class Axis you can find in LightningChart JS API reference.

// Add additional styling for the axis.
axis
    .setTitle( 'My axis' )
    // Configure axis line style.
    .setStrokeStyle( axisStrokeStyle )
    // Configure axis tick style by modifying the Axis TickStrategy.
    .setTickStrategy(
        // Use Numeric TickStrategy as Base.
        AxisTickStrategies.Numeric,
        // Use a mutator to modify the TickStrategy.
        ( tickStrategy ) => tickStrategy
            // Modify the Major Ticks for the TickStrategy.
            // Minor and Extreme TickStyles must be set separately.
            .setMajorTickStyle( visibleTicks => visibleTicks
                // Label fill Style.
                .setLabelFillStyle( axisLabelFillStyle )
                // Font.
                .setLabelFont( font => font
                    // Configure the font.
                    ...
                )
                // Grid stroke style
                .setGridStrokeStyle( gridStrokeStyle )
            )
    )
    // Configure axis overlay style (interactive axis area).
    .setOverlayStyle( axisFillStyleHighlight )
    // Configure axis nibs overlay style (interactive axis nibs area).
    .setNibOverlayStyle( axisFillStyleHighlight )

API Links

Support

If you notice an error in the example code, please open an issue on GitHub repository of the entire example.

Official API documentation can be found on LightningChart website.

If the docs and other materials do not solve your problem as well as implementation help is needed, ask on StackOverflow (tagged lightningchart).

If you think you found a bug in the LightningChart JavaScript library, please contact sales@lightningchart.com.

Direct developer email support can be purchased through a Support Plan or by contacting sales@lightningchart.com.

© LightningChart Ltd 2009-2022. All rights reserved.