Home

Awesome

RealTimeGraphX

Build Status GitHub Nuget Nuget

RealTimeGraphX is a data type agnostic, high performance plotting library for WPF and UWP.

The library core components are built using .Net Standard which makes it portable to a range of platforms.

Typical use case is, scientific measurements applications which requires real-time display with large data volumes.

RealTimeGraphX has a number of built-in data point types (axis) like Double, Float, Int32 ,TimeSpan and DateTime, but you can easily implement any kind of custom data type by inheriting and implementing the mathematical logic for that type.

Features:

<br/> <hr/> <br/>

The solution contains demo projects for WPF and UWP.

Single Series

alt tag

Multi Series

alt tag

Gradient Fill

alt tag

<br/> <hr/> <br/>

The follwing diagrams demonstrates the connections between graph components and how they are implemented on each platform.

Model

alt tag

The graph controller binds to a renderer and a surface. Data points are pushed to the controller, the controller uses the renderer in orderer to prepare and arrange the points for visual display. Finally, the controller directs the renderer to draw the points on the specific surface.

WPF Stack Implementation

alt tag

Each platform (WPF/UWP etc.) should implement it's own IGraphDataSeries and IGraphSurface.

<br/> <hr/> <br/> <h3>Example<h3>
Model.cs

   public class ViewModel
   {
       //Graph controller with timespan as X axis and double as Y.
       public WpfGraphController<TimeSpanDataPoint, DoubleDataPoint> Controller { get; set; }

       public ViewModel()
       {
           Controller = new WpfGraphController<TimeSpanDataPoint, DoubleDataPoint>();
           Controller.Renderer = new ScrollingLineRenderer<WpfGraphDataSeries>();
           Controller.DataSeriesCollection.Add(new WpfGraphDataSeries()
           {
               Name = "Series Name",
               Stroke = Colors.Red,
           });

           //We will attach the surface using WPF binding...
           //Controller.Surface = null;
       }

       private void Start()
       {
           Stopwatch watch = new Stopwatch();
           watch.Start();

           Thread thread = new Thread(() => 
           {
               while (true)
               {
                   //Get the current elapsed time and mouse position.
                   var y = System.Windows.Forms.Cursor.Position.Y;
                   var x = watch.Elapsed;

                   //Push the x,y to the controller.
                   Controller.PushData(x, y);

                   Thread.Sleep(30);
               }
           });
           thread.Start();
       }
   }

View.xaml

  <Grid>
      <Grid.RowDefinitions>
          <RowDefinition Height="1*"/>
          <RowDefinition Height="35"/>
      </Grid.RowDefinitions>
      <Grid.ColumnDefinitions>
          <ColumnDefinition Width="70"/>
          <ColumnDefinition Width="1*"/>
      </Grid.ColumnDefinitions>

      <Grid Grid.Column="1">
          <realTimeGraphX:WpfGraphGridLines Controller="{Binding Controller}" />
          <realTimeGraphX:WpfGraphSurface Controller="{Binding Controller}" />
      </Grid>

      <realTimeGraphX:WpfGraphAxisControl Orientation="Vertical" Controller="{Binding Controller}" StringFormat="0.0" />
      <realTimeGraphX:WpfGraphAxisControl Orientation="Horizontal" Controller="{Binding Controller}" Grid.Column="1" Grid.Row="1" StringFormat="hh\:mm\:ss"/>
  </Grid>