SplineSeries

This series is visualized on the screen as a smooth line connecting all data points.

Declaratively defined series

You can use the following definition to display a simple SplineSeries

Example 1: Declaring a SplineSeries in XAML

<telerik:RadCartesianChart Palette="Windows8"> 
<telerik:RadCartesianChart.HorizontalAxis> 
    <telerik:CategoricalAxis/> 
</telerik:RadCartesianChart.HorizontalAxis> 
<telerik:RadCartesianChart.VerticalAxis> 
    <telerik:LinearAxis /> 
</telerik:RadCartesianChart.VerticalAxis> 
<telerik:RadCartesianChart.Series> 
    <telerik:SplineSeries> 
        <telerik:SplineSeries.DataPoints> 
            <telerik:CategoricalDataPoint Category="January" Value="2" /> 
            <telerik:CategoricalDataPoint Category="February" Value="5" /> 
            <telerik:CategoricalDataPoint Category="March" Value="3" /> 
            <telerik:CategoricalDataPoint Category="April" Value="10" /> 
            <telerik:CategoricalDataPoint Category="May" Value="9" /> 
            <telerik:CategoricalDataPoint Category="June" Value="7" /> 
            <telerik:CategoricalDataPoint Category="July" Value="1" /> 
        </telerik:SplineSeries.DataPoints> 
    </telerik:SplineSeries> 
</telerik:RadCartesianChart.Series> 
</telerik:RadCartesianChart> 

Figure 1: SplineSeries visual appearance

radchartview-series-splineseries

Properties

  • CategoryBinding: A property of type DataPointBinding that gets or sets the property path that determines the category value of the data point.
  • ValueBinding: A property of type DataPointBinding that gets or sets the property path that determines the value of the data point.
  • DashArray: A property of type DoubleCollection that gets or sets the dash pattern applied to the spline series itself.
  • Stroke: A property of type Brush that gets or sets the stroke of the spline series.
  • StrokeShapeStyle: A property of type Style that gets or sets the style of the stroke of the spline series. The property accepts a style that targets an object of type Path.

Data Binding

You can use the ValueBinding and CategoryBinding properties of the LineSeries to bind the DataPoints’ properties to the properties from your view models.

Example 2: Defining the view model

public class PlotInfo 
{ 
    public string Category { get; set; } 
    public double Value { get; set; } 
} 
 
//....... 
this.DataContext = new ObservableCollection<PlotInfo> 
{ 
    new PlotInfo() { Category = "January", Value = 2}, 
    //.... 
}; 

Example 3: Specify a SplineSeries in XAML

<telerik:SplineSeries ItemsSource="{Binding}" CategoryBinding="Category" ValueBinding="Value" /> 

See the Create Data-Bound Chart for more information on data binding in the RadChartView suite.

Spline Tension

The spline-type series provide two properties allowing to control the additional points calculated for the spline of the line. The tension is controlled via the SplineTension property. The tension works with relative values between 0 and 1. The default tension is set to 0.5d.

Example 4: Setting SplineTension

 <telerik:SplineSeries SplineTension="0.4" /> 

Spline tension 0.8 (left) and 0.4 (right)

Silverlight RadChartView SplineSeries with Spline Tension 0.8 (Left) and 0.4 (Right)

Additionally, you can control the smoothness of the spline using the SplinePointsDistanceFactor property. The property controls the distance between the additionally calculated spline points. The bigger the factor is the less points will be created, thus the line will become less smooth. The property works with values between 0 and 0.35. The default value is 0.03d.

Example 5: Setting SplinePointsDistanceFactor

 <telerik:SplineSeries SplinePointsDistanceFactor="0.18" /> 

SplinePointsDistanceFactor set to 0.18

Silverlight RadChartView SplineSeries with SplinePointsDistanceFactor Set to 0.18

Styling the Series

You can see how to style area series using different properties in the SplineSeries section of the Customizing CartesianChart Series help article.

Additionally, you can use the Palette property of the chart to change the colors of the SplineSeries on a global scale. You can find more information about this feature in the Palettes section in our help documentation.

See Also

In this article