Dependent Charts

A chart can be based on another chart's dataset. Using of the dependent chart implies the presence of at least two charts: the source chart (its data is used to build the dependent chart) and the dependent chart itself. Thus, dependent charts can only be created as part of Combined Domain XY Chart (or Combined Range XY Chart). The following charts can be dependent:

Setting up Dependent Charts

To configure a new dependent chart, perform the following steps:

  • Create a Combined Domain XY Chart (or Combined Range XY Chart).
  • Add a "simple" XY Chart to this combined chart.
  • Configure the data source for the simple XY chart and ensure that it shows correct data.
  • Add another XY chart to the combined chart. The second XY chart will depend on the source data of the first XY chart.
  • Change the Data Source Type of the second XY chart to Dependent.
  • Open Dependent Chart properties of the second XY chart and change Source Chart Name to the name of widget component matching the "source" XY chart, e.g. xyLineChart1.
  • Select Dependent Chart Bindings and configure expressions for source data processing.
  • Run the widget and test the dependent chart.

    • Dataset

    Building dependent chart dataset is performed by processing the source chart dataset using Dependent Chart Bindings. Here is a short description of this process:

  • Chart renderer takes first series from the dataset of the source chart.
  • Bindings from Dependent Chart Bindings table are applied to values of this series. Notice that binding is applied only if its Series Index complies with index of current series. And every application of the binding to the series generates a new series in the resulting dataset.
  • This process is repeated for the remaining series from the dataset of the source chart.

    • Here is a table with Dependent Chart Bindings:

    Binding

    Expected Value Type

    Description

    Series

    String

    Textual name of the data series.

    X

    Number

    Numeric value to display along the domain (X) axis.

    Y

    Number

    Numeric value to display along the range (Y) axis.

    Series Index

    Integer

    Index of the series for which current binding is applied. If it is not specified, binding is applied for every series.

    Dependent Chart Properties

    Dependent chart properties are available only for XY Line, Area and Bar charts when they are added as sub-charts to a Combined Domain XY Chart (or Combined Range XY Chart).

    Source Chart Name

    Name of sub-chart component whose data will be used to build dependent chart. Source chart and dependent chart must be placed in the same Combined Domain XY Chart (or Combined Range XY Chart).

    Property name: sourceDataPlotID

    Property type: String

    Dependent Chart Bindings

    A set of expressions used to retrieve data from the source chart and to build the dependent chart dataset. This property is valid only for dependent charts.

    Property name: dependentChartBindings

    Property type: Data Table

    Was this page helpful?