Skip to content

ChartDataMapping

ClassChartGuruChartGuru
public class ChartDataMapping

Inspector-editable mapping that tells a file/live data source which columns of a parsed ChartGuru.ChartTabularData become which axes.

Two flavours of multi-series data are supported:

  • Long format (default): one Y column, plus an optional `ChartGuru.ChartDataMapping.SeriesByColumn`. Each distinct value of that column becomes a series.
  • Wide format (`ChartGuru.ChartDataMapping.WideFormat` = true): every column listed in `ChartGuru.ChartDataMapping.YColumns` is a series; `ChartGuru.ChartDataMapping.SeriesByColumn` is ignored.

OHLC mappings (Candlestick) are configured via `ChartGuru.ChartDataMapping.OpenColumn`/`ChartGuru.ChartDataMapping.HighColumn`/`ChartGuru.ChartDataMapping.LowColumn`/`ChartGuru.ChartDataMapping.CloseColumn`. When all four are non-empty the source emits [ChartGuru.CandleStickMark](/tools/chartguru/api/chartguru-candlestickmark/)s regardless of the chart's selected type.

public string XColumn

Returns

System.String

public string LabelColumn

Returns

System.String

public string[] YColumns

Returns

System.String[]

public bool WideFormat

Returns

System.Boolean

public string SeriesByColumn

Returns

System.String

public string DateFormat

Returns

System.String

public string DateCulture

Returns

System.String

public string OpenColumn

Returns

System.String

public string HighColumn

Returns

System.String

public string LowColumn

Returns

System.String

public string CloseColumn

Returns

System.String

public int MaxRows

Returns

System.Int32

public ChartDataMapping Clone()

Creates an independent copy of this Chart Data Mapping; later configuration changes do not affect the original instance.

Returns

ChartGuru.ChartDataMapping

public bool ShapeEquals(ChartDataMapping other)

Quick equality check used by the diff fast-path.

Parameters

Name Type
other ChartGuru.ChartDataMapping

Returns

System.Boolean

public ChartDataMapping()

public bool IsOhlc { get; }

True when ChartGuru.ChartDataMapping.OpenColumn/ChartGuru.ChartDataMapping.HighColumn/ChartGuru.ChartDataMapping.LowColumn/ChartGuru.ChartDataMapping.CloseColumn are all non-empty.

Returns

System.Boolean

public bool IsConfigured { get; }

True when there is at least one Y column (or OHLC) to plot.

Returns

System.Boolean