This is an enhancement made in 2007 of the famous
DataPlotter introduced in 2003 by Hans-Jürgen Schmidt. It includes requests raised meanwhile. In this article, I have included the Introduction, Background, and Using the Code sections from the original article. Finally, I have added my enhancements.
DataPlotter is a .NET control for graphical display of 2D data. For both the X and Y axis, a linear or logarithmic (any base) scaling can be selected. Also for both axis, the data range can be specified.
Maybe it is of interest to somebody else out there. At least, it can be used as another sample on how to fiddle with GDI+ in .NET.
For charting in the .NET world, there is still the good old MSChart ActiveX control or you have to buy one of the new .NET controls on the market.
Since neither the MSChart control made me happy for my purpose nor did I want to spend money, I decided to start something on my own. This project is nothing fancy or new -- it's just my first step in .NET graphics.
Using the Code
The implementation of
DataPlotter is quite simple: It's a .NET Windows control library with a bunch of properties. Everything else happens in the
These are the properties:
|The color of the data line|
|The color of the gird lines|
|The background color|
|The color of the axis and text|
|The font for the text|
|The width of the data line|
|Draw mode for the data points (|
|The internal border at the top|
|The internal border at the left|
|The internal border at the bottom|
|The internal border at the right|
|The start of the data range on the x axis|
|The end of the data range on the x axis|
|The start of the data range on the y axis|
|The end of the data range on the y axis|
|The spacing for the linear grid in x direction. Ignored for log. views|
|The spacing for the linear grid in y direction. Ignored for log. views|
|The base for log. views in x direction. If < 2, then a linear view is displayed|
|The base for log. views in y direction. If < 2, then a linear view is displayed|
|The data to be displayed for x|
|The data to be displayed for y|
The way the vertical grid for x-values is drawn
The way the horizontal grid for y-values is drawn
The format string for the x-value label
The format string for the y-value label
The inner (active) area of the chart
Point CalculatePoint(double x, double y)
Calculates the coordinate for a x and y value
A few hints on some properties:
- The borders define the inner axis rectangle. Use bigger borders on the left and bottom to have enough space for the scaling numbers.
- If a
LogBase property is below 2, then a linear scaling is selected. Otherwise the number is the base for logarithmic scaling. Typically use 0 for linear and 10 for logarithmic scales.
- For logarithmic scaling, use full decades for the
RangeEnd properties, e.g. 0.01 to 1000 for a
LogBase of 10.
- The Data arrays must be of the same size of course.
- The standard format string is "g" which is a 5 digit floating point. More details are found at
A short walkthrough of the
- Check the property values for consistency.
- Prepare the graphical tools. There are pens for the graph, grid lines and axis and a brush for scale numbering.
- The inner axis rectangle is calculated by deducting the border properties from the client rectangle size.
- The inner rectangle (=
ChartArea) is adjusted to fit equidistant grid lines.
- The grid lines are drawn for X and Y directions, according to the format setting.
- Here also the formatted scale numbers are written.
- The scale numbers are drawn in a way to avoid overlap.
- Then the axis rectangle is created.
- The data arrays are transformed into an array of points. The values from
RangeEnd are mapped onto points of the axis grid considering the
LogBase scales. Invalid points (detected by the exception handler) are skipped by reusing the last valid point.
- A clipping rectangle avoids lines drawn outside the chart area.
- The points are drawn according to the
DataPlotter is an assembly that can be used as shown in the
DataPlotterTest application. This demo has four buttons with sample data for the possible linear/logarithmic scaling. There is also a property grid to see/change the
Where To Go From Here
The current implementation of
DataPlotter served my purpose quite well. But there are many useful extensions and enhancements I can think of:
- Use more than one set of data to be drawn in different colors in the same diagram
- Add description properties like title, names for the axis etc.
- Extend draw modes, e.g. dotted or dashed lines etc.
Help yourself and let me know about your own enhancements.
Well, as you see, enhancements are easy on such a good base. Hans-Jürgen, thank you!