===== BigDataLineChart ===== com.ergotech.vib.graphics.javascript.charting.BigDataLineChart ==== Image Examples ==== | {{:mistudio:graphics:charts:pasted:20260701-193730.png?40|BigDataLineChart in the graphics palette}} | {{:mistudio:graphics:charts:pasted:20260701-193827.png?200|BigDataLineChart graphic example}} | | //BigDataLineChart in the graphics palette.// | //BigDataLineChart graphic example.// | ==== Overview ==== The BigDataLineChart graphic is a chart graphic used to display one or more data series as lines. BigDataLineChart is similar to LineChart, but is intended for larger or denser data sets. It includes a built-in x-axis zoom/data window and additional data reduction settings such as **DecimationStyle** and **SamplingSize**. BigDataLineChart is commonly used for trends, time-based data, larger data sets, and dashboard displays where the user needs to zoom into a section of the chart. ==== Common Uses ==== * Displaying large or dense trend data * Showing time-based data * Plotting multiple data series * Building dashboards with live or test data * Comparing multiple values on the same chart * Viewing a selected range of data with the x-axis zoom window * Showing reference lines such as center, upper, or lower limit lines ==== Input Behavior ==== BigDataLineChart accepts input through **valueInput**. The input can come from a data source, Constant, BroadcastServer, or another logic component. For full chart behavior, BigDataLineChart works best with table-style or array-style data sources. Common test data sources include: * **TwoDimensionalDataSource** * **ArrayDataSource** **TwoDimensionalDataSource** is useful for testing x/y values, timestamps, and multiple data columns. **ArrayDataSource** can be used for simple testing, but **TwoDimensionalDataSource** gives more predictable BigDataLineChart behavior. ==== Output Behavior ==== BigDataLineChart is used as a display graphic. BigDataLineChart does not provide a default user-input output workflow. ==== BigDataLineChart-Specific Behavior ==== BigDataLineChart displays data using one or more configured line series. BigDataLineChart-specific settings include: * **Name** Sets the name of the BigDataLineChart graphic. * **CenterLine** Configures an optional center reference line. * **DecimationStyle** Controls how dense chart data is reduced or summarized for display. * **High Value** Sets the high value used for chart scaling or range behavior. * **LclLine** Configures an optional lower control limit reference line. * **Low Value** Sets the low value used for chart scaling or range behavior. * **SamplingSize** Sets the sample size used when reducing or summarizing chart data. * **Series** Configures the chart line series. * **TopSpacing** Sets spacing above the chart area. * **UclLine** Configures an optional upper control limit reference line. * **Use Color** Controls whether incoming colors are used when supported. * **UseTooltip** Controls whether chart tooltips are shown. * **YAxis** Configures the chart y-axis. * **Bad Qual. Indicator** Controls the indicator used when bad quality data is received. * **Visible** Controls whether the BigDataLineChart is shown. * **Warning Qual. Indicator** Controls the indicator used when warning or transitional quality data is received. ==== Logic Ports ==== In the Logic Editor, BigDataLineChart includes this default port: * **valueInput** The **valueInput** port receives array-style or two-dimensional chart data. ==== Series Configuration ==== BigDataLineChart uses the **Series** property to define the line series displayed on the chart. A series controls how one line appears on the chart. The Series editor includes a live preview and grouped settings for appearance, symbols, axis selection, and animation. When a data source provides multiple data columns, matching series should be configured so each column can display as a separate line. For example, if a TwoDimensionalDataSource provides multiple Y columns, the BigDataLineChart should have matching line series configured for those values. ==== Adding a Line Series ==== To add another line series: - Select the BigDataLineChart graphic in the Design Editor. - In the Basic properties, open the **Series** property editor. - Click the **+** button in the Series editor. - Configure the new line series. - Set the line appearance, symbol options, Y-axis assignment, and animation setting. - Click **OK** to save the series settings. {{:mistudio:graphics:charts:pasted:20260706-193326.png?500|BigDataLineChart Series editor}} //BigDataLineChart Series editor with preview, appearance, symbol, axis, and animation settings.// ==== Line Series Settings ==== The Series editor includes these sections: * **Preview** Shows a preview of the configured line series. * **Appearance** Controls the visual style of the line. * **Symbols** Controls whether point symbols are shown on the line. * **Axis** Selects which Y-axis the line series uses. * **Animation** Controls whether animation is enabled for the line series. The **Appearance** section includes: * **Line Color** Sets the color of the line series. * **Line Width** Sets the thickness of the line. * **Line Style** Sets the line style, such as solid. The **Symbols** section includes: * **Show Symbols on Graph** Controls whether point symbols are shown on the line. * **Symbol Icon** Sets the symbol shape. * **Symbol Size** Sets the size of the symbol. * **Use Line Color for Symbol** Uses the line color for the symbol. * **Symbol Color** Sets a separate symbol color when line color is not used. The **Axis** section includes: * **Y Axis** Selects which Y-axis the line series uses. The **Animation** section includes: * **Animation** Controls whether the line series uses animation. ==== Multiple Series Behavior ==== When using multiple data columns, each visible line needs a matching configured series. For example: One Y column = one line series Two Y columns = two line series Three Y columns = three line series If the chart only has one configured series, extra data columns can fail to appear as separate lines. ==== Two-Dimensional Data Behavior ==== TwoDimensionalDataSource is the main test data source for BigDataLineChart. With timestamp behavior enabled on the data source, the chart can display time-based data. With timestamp behavior disabled, the first data column can be used as the x-axis, and additional columns can be used as y-series data. Multiple y-series require matching entries in the **Series** configuration. ==== Array Data Behavior ==== ArrayDataSource can be used for simpler BigDataLineChart testing. When ArrayDataSource is connected to BigDataLineChart, the chart does not display the array the same way as LineChart. In the current MIStudio version, BigDataLineChart appears to plot the array as a reduced line segment and may only show the first and last values from the array. For full x/y behavior, timestamp behavior, multiple data columns, or more predictable chart output, use **TwoDimensionalDataSource**. ==== Zoom and Data Window ==== BigDataLineChart includes a built-in x-axis zoom/data window at the bottom of the chart. The zoom/data window allows the user to focus on a smaller range of the chart data without changing the full data source. This is one of the main visual differences between BigDataLineChart and LineChart. ==== Data Reduction Settings ==== BigDataLineChart includes data reduction settings for larger or denser data sets. * **DecimationStyle** Controls how dense data is reduced or summarized for display. * **SamplingSize** Sets the sample size used during data reduction. These settings help the chart display larger sets of data more efficiently. ==== Reference Lines ==== BigDataLineChart includes optional reference line properties: * **CenterLine** * **LclLine** * **UclLine** These properties are used for chart reference lines such as center, lower control limit, and upper control limit lines. Reference line settings are chart configuration values and should be edited through the chart property controls. ==== Notes ==== Use BigDataLineChart when data should be displayed as a line or trend and the chart needs a zoom/data window for larger data sets. Use **TwoDimensionalDataSource** for full chart testing with x/y values, timestamps, and multiple columns. Use **ArrayDataSource** for simpler single-series testing. Use numeric or array-style data sources with BigDataLineChart. String data sources are not appropriate for numeric chart input. LineChart is better for simpler trend-style line displays. BigDataLineChart is better when larger data sets or x-axis zooming are needed. ==== Related Pages ==== * [[mistudio:design_editor:start|MIStudio Design Editor]] * [[mistudio:design_editor:charts:start|Charts]] * [[mistudio:design_editor:charts:linechart|LineChart]] * [[mistudio:design_editor:charts:barchart|BarChart]] * [[mistudio:design_editor:charts:radarchart|RadarChart]] * [[mistudio:getting_started:test_data_sources|Using Test Data Sources]] * [[mistudio:getting_started:connect_data_source_to_graphic|Connecting a Data Source to a Graphic]]