DataSeries

Initializes a new instance of the DataSeries class.

New to v3.3: when AcceptsUnsortedData is false, the DataSeries with throw an InvalidOperationException if unsorted data is appended. Unintentional unsorted data can result in much slower performance. To disable this check, set AcceptsUnsortedData = true.

Gets the number of points in this data series

Gets or Sets the DataDistrutionCalculator instance for this DataSeries. Used when resampling data to determine the correct algorithm

Gets the DataSeriesType for this DataSeries

Gets or sets the size of the FIFO buffer. If null, then the dataseries is unlimited. If a value is set, when the point count reaches this value, older points will be discarded

Gets whether the Data Series has values (is not empty)

Gets a value indicating whether this instance is attached.

Gets whether the dataseries behaves as a FIFO If True, when the FifoCapacity is reached, old points will be discarded in favour of new points

If true, this data series will not be selected for chart range calculation.

Gets whether this DataSeries contains Sorted data in the X-direction. Note: Sorted data will result in far faster indexing operations. If at all possible, try to keep your data sorted in the X-direction

Gets a value indicating whether updates for the target are currently suspended

Gets the item at the index from the specified DataSeriesColumn.

Gets the latest Y-Value of the DataSeries

Gets or sets the parent IUltrachartSurface which this IDataSeries instance is attached to

Gets or sets the name of this series

Gets the X Values of this dataseries

Gets the Y Values of this dataseries

Synchronization object (per instance)

Gets the computed Maximum value in X for this series

Gets the computed Minimum value in X for this series

Gets the computed XRange, which is an IRange wrapping XMin and XMax properties

Gets the Type of X-data points in this DataSeries. Used to check compatibility with Axis types

Gets the X Values of this series

Gets the computed Maximum value in Y for this series

Gets the computed Minimum value in Y for this series

Gets the computed YRange, which is an IRange wrapping YMin and YMax properties

Gets the Type of Y-data points in this DataSeries. Used to check compatibility with Axis types

Gets the Y Values of this series

Appends a list of X, Y points to the series

x

The list of X points

yValues

Lists of Y points (depends on series type)

Appends an X, Y point to the series

x

The X Value

yValues

The Y Values (depends on series type)

Clears the series, resetting internal lists to zero size

When overridden in a derived class, clears all columns in the Data Series

Creates a deep copy of a DataSeries

Called by IUpdateSuspender each time a target suspender is disposed. When the final target suspender has been disposed, ResumeUpdates is called

Finds the closest line to a point with given X and Y value. Search region is a vertical area with center in X and [maxXDistance] X units to left and right

x

The X-value of point [X data units, not pixels]

y

The Y-value of point [Y data units, not pixels]

xyScaleRatio

xUnitsPerPixel/yUnitsPerPixel

xRadius

specifies search region in X units (ticks for DateTime or TimeSpan)

drawNanAs

specifies how to handle NAN elements

Devuelve: The index of first point in line, -1 if not found (when count is zero)

Finds the closest point to a point with given X and Y value. Search region is a vertical area with center in X and [maxXDistance] X units to left and right

xValue

The X-value of point [X data units, not pixels]

yValue

The Y-value of point [Y data units, not pixels]

xyScaleRatio

xUnitsPerPixel/yUnitsPerPixel

hitTestRadius

Specifies search region in chart coordinates(ticks for DateTime or TimeSpan)

Devuelve: The index of the found value, -1 if not found (when count is zero)

Finds the index to the DataSeries at the specified X-Value

x

The X-value to search for

searchMode

The SearchMode options to use. Default is exact, where -1 is returned if the index is not found

Devuelve: The index of the found value

Gets the integer indices of the XValues array that are currently in the VisibleRange passed in.

range

The VisibleRange to get the indices range

Devuelve: The indices to the X-Data that are currently in range

Gets the minimum positive value of (positiveMin, min)

positiveMin

min

Gets the YRange of the data (min, max of the series) in the input visible range point range, where the input range is the VisibleRange

xRange

The X-Axis Range currently in view

getPositiveRange

Indicates whether to return positive YRange only

Devuelve: The YRange of the data in this window

Gets the YRange of the data (min, max of the series) in the input IndexRange, where indices are point-indices on the DataSeries columns

xIndexRange

The X-Axis Indices currently in view

Devuelve: The YRange of the data in this window

Gets the YRange of the data (min, max of the series) in the input visible range point range, where the input range is the VisibleRange

xRange

The X-Axis Range currently in view

Devuelve: The YRange of the data in this window

Gets the YRange of the data (min, max of the series) in the input IndexRange, where indices are point-indices on the DataSeries columns

xIndexRange

The X-Axis Indices currently in view

getPositiveRange

Indicates whether to return positive YRange only

Devuelve: The YRange of the data in this window

When overriden in a derived class, gets the Min(existingXMin, currentMin), where currentMin is the minimum at the specified index

index

The index to the underlying dataset

existingXMin

The existing minimum

Devuelve: The new XMin, which is the Min(existingXMin, currentMin)

When overriden in a derived class, gets the Max(existingYMax, currentMax), where currentMax is the maximum at the specified index

index

The index to the underlying dataset

existingYMax

The existing maximum

Devuelve: The new YMax, which is the Min(existingYMax, currentMax)

When overriden in a derived class, gets the Min(existingYMin, currentMin), where currentMin is the minimum at the specified index

index

The index to the underlying dataset

existingYMin

The existing minimum

Devuelve: The new YMin, which is the Min(existingYMin, currentMin)

May be called to trigger a redraw on the parent UltrachartSurface. This method is extremely useful when IDataSeries are in a ViewModel and bound via MVVM to IRenderableSeries. Please see the parameter for invalidation options

rangeMode

Provides RangeMode invalidation options for the parent surface

Removes the associated Y-Values for the specified X-Value

x

The X DataValue to remove. Removes all associated Y-Values

Removes the X,Y values at the specified index

index

The index to remove at

Removes a range of points starting from the specified index

startIndex

Starting index of the range of elements to remove

count

The number of elements to remove

Resumes updates on the target, intended to be called by IUpdateSuspender

suspender

Suspends drawing updates on the target until the returned object is disposed, when a final draw call will be issued

Devuelve: The disposable Update Suspender

Asserts correct number of parameters supplied to Append(TX, params TY) and throws if necessary

paramsCount

The expected params count

When overridden in a derived class, returns a HitTestInfo struct containing data about the data-point at the specified index

index

The index to the DataSeries

Devuelve: The HitTestInfo

Converts the default YValues to an IPointSeries which is used to render XY series

resamplingMode

The desired ResamplingMode

pointRange

The integer Indices range in the parent data-set

viewportWidth

The current width of the viewport

isCategoryAxis

If true, uses the indices to form the resampled X-values, else uses the X-Values themselves

dataIsDisplayedAs2D

If true, then data is considered as a scatter series without relationship between the points, e.g. not a line series

visibleXRange

factory

The PointResamplerFactory which returns IPointResampler instances

pointSeriesArg

Additional parameter to the point series.

Devuelve: A IPointSeries which is used to render XY series

OBSOLETE. Use ToPointSeries instead, and cast to correct type of point series

column

resamplingMode

pointRange

viewportWidth

isCategoryAxis

Event raised whenever points are added to, removed or one or more DataSeries properties changes

The XColumn for this DataSeries

The primary YColumn for this DataSeries