Understanding data points, independent variables and dependent variables (parameters and values) Chartcontrol

WinForms Controls > Controls > Chart Control > Fundamentals > Charting Basics > Understanding Data Point, I TS Argument and Value

This topic provides general information is about a chart's dataPoint, and explains its argument and value (s).

This section provides general information about the data points of the chart, explaining the parameters and values.

A chart ' s most fundamental element is a datapoint. A group of data points represents a single series. Points reside in the Series.points collection, and no Series are displayed until it has at least one data point specified.

The most important element of a chart is the data point. A set of data points represents a sequence. The point set is located in the Series.points collection, and the collection is not displayed unless you specify at least one data point.

Because Xtracharts supports numerous series view types, which represent and organize data in different ways, visu Al representation of a data point differs from one view to another. For details on this, the refer to Understanding series and the series views.

Because Xtracharts supports a wide variety of sequence view types, this type can present and organize data in many different ways, and one data point that is visualized in one view may be different from another view. Learn more, see Understanding Series and Series views.

Linear series data points and bar chart data points

Each data point must has specified one argument and at least one value, corresponding to it. In general, a pairing of the argument and its value are represented on a diagram ' s axes as their X and Y coordinate s, respectively, as the following image demonstrates.

Each data point must have an independent argument and at least one value associated with it. Typically, a set of parameters and values is displayed on the axis of a graph as an x-coordinate and a y-coordinate, as shown below.

Additional values is prescribed by certain view types (e.g. financial and Bubble series). Visually, they is represented differently, depending on the particular view type.

In a chart ' s Legend, it's possible to represent either a separate series, or individual points of the series. For details on the, refer to Legend overview.

A particular type of view class will have some extra values (such as financials and bubble charts). Visually, they are completely different, depending on their view type. In the legend of the chart, you can display either a separate sequence or just an individual point in the sequence. For more details, refer to Legend overview.

To learn the ways data points can is created, refer to manually Add points to a Series.

For more information, refer to Series Points.

Understanding series and Series views

1. Learning sequences and sequence views

WinForms Controls > Controls > Chart Control > Fundamentals > Charting Basics > Understanding Series and Se Ries views

This topic provides general information about a chart ' s series, and their view types available.

A continuity of data points represents a series, which isn ' t displayed until is have at least one point is specifi Ed. For example, the following image demonstrates both separate line series, and the underlying data they represent.

Some continuous data points represent a sequence, and you need to specify at least one point to display the sequence. For example, the image shows two columns of independent linear sequences that represent hidden data.

Series reside in the Chartcontrol.series collection. And, until there is at least one visible series in it, a chart's diagram is empty, as well as the chart itself. To learn the ways in which series can be created is explained, refer to manually Create a series.

The sequence is in the Chartcontrol.series collection. As with the chart itself, the chart remains empty unless there is at least one visible sequence.

Xtracharts supports numerous different chart types (some of which is shown in the following image), and it's the view Type which determines both a series ' specific image, and the available set of options. For the list of available series view types, refer to series views.

Xtracharts supports a number of different chart classes (some of which are shown below), and its view type determines the specified image of the sequence and the available option settings. For the available sequence view types, refer to series views.

The view type of the first visible series in a chart ' s collection determines the chart's diagram type, meaning that all OT Her series should has acompatible view type, in order for them to being plotted together in the same chart control. For information in series compatibility, refer to combining Different series views.

In the chart collection, the view type of the first visual sequence determines the chart type, meaning that all other sequences should have a compatible view type in order to be drawn in the same chart control.

The following image demonstrates how a similar set of series views looks in charts with different diagram types (xy-diagra M and Xy-diagram 3D).

The following image shows the appearance of a set of similar series views in different diagram types (Xy-diagram and Xy-diagram 3D).

For more information, refer to Series views overview.

Understanding a Diagram

1. Learning Map

WinForms Controls > Controls > Chart Control > Fundamentals > Charting Basics > Understanding a Diagram

This topic provides general information about a chart ' s diagram, and the types available.

A diagram is a chart's main area, where the most of the IT data and graphical elements is displayed (e.g. series and ax Es and panes), even although some of these elements doesn ' t actually belong to a Diagram object (such as Series). For a complete list of the chart elements, refer to chart elements.

The graph is the main area of the chart, with most of the data and graphic elements shown above (such as series and axes and panes), although sometimes some elements do not belong to diagram objects (such as series). For a complete list of view elements, refer to chart Elements.

A Single Chart Control instance can is only possess one diagram object. Its particular type was auto-determined by the view type of the first visible series in the chart ' s collection. Each diagram type have a special set of options, and is used to the plot series of a compatible view type only. For a complete list of the available diagram types with each type ' s description, refer to diagram.

A single chart control instance can occupy only one diagram object. The specific type of a chart is automatically determined by the view type of the first visual sequence of the chart collection. Each diagram type has a specific set of options that are used only to draw a sequence of compatible view types. A complete list of type descriptions of the available diagram types, refer to diagram.

At design time, a diagram's options can be accessed via the Chartcontrol.diagram property.

At design time, the diagram options can be obtained through the Chartcontrol.diagram property.

At runtime, to access a diagram ' s properties, it's required to cast Your instance of a diagram object to a Specif IC type, as the following example demonstrates.

To get the diagram properties at run time, you need to force the diagram object to convert to a specific type, as shown in the following example.

c#     & nbsp;  

Using Devexpress.xtracharts; // ... private void Form1_Load (object sender, EventArgs e) { true;} Imports Devexpress.xtracharts‘ ...PrivateSub Form1_Load (byval sender as Object, byval e as EventArgs) Handles  mybase.load ' Create a new Chartcontrol instance.   dim chartControl1 as  new Chartcontrol () ' Access the diagram ' s properties.  Span class= "Cr-vb-keyword" >ctype (Chartcontrol1.diagram, xydiagram2d). rotated = true  ctype (Chartcontrol1.diagram, xydiagram2d). enableaxisxscrolling = true End SUB 

C#

Using Devexpress.xtracharts; // ... private void Form1_Load (object sender, EventArgs e) { true;}

Vb

Imports Devexpress.xtracharts‘ ...PrivateSub Form1_Load (byval sender as Object, byval e as EventArgs) Handles  mybase.load ' Create a new Chartcontrol instance.   dim chartControl1 as  new Chartcontrol () ' Access the diagram ' s properties.  Span class= "Cr-vb-keyword" >ctype (Chartcontrol1.diagram, xydiagram2d). rotated = true  ctype (Chartcontrol1.diagram, xydiagram2d). enableaxisxscrolling = true End SUB 

For most diagram types, you can provide your end-users with the capability to scroll and zoom the Diagra M. For details on this, refer to zooming and scrolling (2D xy-charts) and zooming and scrolling (3D Charts).

For most diagram types, you can provide a graph of the terminal's scrolling and zooming. For more information, refer to zooming and scrolling (2D xy-charts) and zooming and scrolling (3D Charts).

Among the most common diagram types are the xydiagram2d, which employs, axes to plot series, and supports multi ple panes, in which separate series can be distributed. These is explained in the next topic of this section:understanding Axes and Panes.

The most common diagram type is xydiagram2d, which uses two axes to depict the sequence and supports multiple panels, which can distribute independent sequences.

For more information on using a diagram, refer to Diagram overview.

Understanding Axes and Panes

1. Learning axes and panels

WinForms Controls > Controls > Chart Control > Fundamentals > Charting Basics > Understanding Axes and Pane S

This topic provides general information on an Xy-diagram ' s axes and panes, and explains the Differenc E between primary and secondary axes.

Describes the axes and panels of the xy-diagram, and explains the difference between the spindle and the secondary axis.

It consists of the following sections:

• Understanding Axes
• Understanding Panes

Understanding Axes Learning Axis

A diagram ' s axes is the essential grids of reference for series points, as they provide the coordinates for THEI R arguments and values. Each diagram type represents them differently. Most charts use axes:the axis of arguments (x-axis) and the axis of values (y-axis). The following image demonstrates axes of the most popular diagram type (which is the xydiagram2d).

The axes of the graph are the necessary reference grids for sequence clicks, because the axes provide coordinates for the parameters and values of the points. Each diagram type presents them in a different form. Most charts use two axes: the parametric axis (x axis) and the value axis (Y-axis).

By default, each Xy-diagram have only a single pair of the X and Y axis, which is called the primary axis. Additional (or, secondary) axes is supported, which was of great help when, for example, it's required to Simulta neously display series with a significant value range difference. For more information, refer to Primary and secondary Axes.

By default, each Xy-diagram has only a pair of x and y axes, which are called spindles. Additional axes (secondary axes) are also supported, which is useful, for example, when a sequence with a relatively distinct range of differences is required to be displayed. For more information, refer to primary and secondary Axes.

To access the primary axes options for design time, select the chart control, and in the Properties window, expand The Chartcontrol.diagram property. You'll see the Xydiagram.axisx and Xydiagram.axisy properties, which provide access to the options and elements of the app Ropriate axis.

To get the spindle options at design time, you need to select the chart control, in the Properties window, expand the Chartcontrol.diagram property, you will see the XYDIAGRAM.AXISX and Xydiagram.axisy properties, which provide the properties and elements of the corresponding axes.

To access the primary axes options at runtime, you should cast your Diagram object to the required Diagram type, as the FO Llowing code demonstrates.

The option to get the spindle at run time, you need to convert the diagram object to the required diagram type, as shown in the following code.

C# Vb

((Xydiagram) chartcontrol1.diagram). Axisx.color = Color.mistyrose; CType (Chartcontrol1.diagram, Xydiagram). Axisx.color = Color.mistyrose

C#	((Xydiagram) chartcontrol1.diagram). Axisx.color = Color.mistyrose;
Vb	CType (Chartcontrol1.diagram, Xydiagram). Axisx.color = Color.mistyrose

Likewise, secondary axes is specified via the Xydiagram.secondaryaxesx and Xydiagram.secondaryaxesy properties.

Similarly, the secondary axis is specified in Xydiagram.secondaryaxesx and Xydiagram.secondaryaxesy

An important characteristic of a axis is it scale type. It determines how a chart interprets its underlying data:as numeric, date-time or qualitative. Each scale type assumes a specific representation of this data, and the specific options for customizing how this data is represented. An axis scale type is auto-determined by the scale type of series associated with this axis. So, a improper series scale type restricts the available set of axis options, and may cause the chart ' s data representati On to is a completely distorted. For more information, refer to Axis scale Types.

The most important characteristic of an axis is its scale type. This determines how the chart interprets the data behind it: As a numerical, a date, a qualitative. Each tick type assumes a specific data representation and the specific options for customizing how the data is displayed. The scale type of an axis is automatically specified by the value type of the sequence associated to the axis. Therefore, inappropriate sequence scalar types will limit the available axis options and even cause the chart's data to appear completely deformed. For more information, refer to axis scale Types.

The visible range of axis values is auto-determined (when the Axisrange.auto property is enabled). However, you can manually specify-axis values by which a axis should be limited, either in units appropriate for the Axis scale type (via the Axisrange.minvalue and axisrange.maxvalueproperties), or in internal double values with no regard To the Axis scale type (axisrange.minvalueinternal and axisrange.maxvalueinternal).

The visible scale range of the axis is determined automatically (only if the Axisrange.auto property is available). However, you can also manually specify the scale of the two axes to constrain the range of the axis, or the appropriate units for the axis scale type (Axisrange.minvalue and Axisrange.maxvalue properties) or the internal two values, ignoring the axis scale type ( Axisrange.minvalueinternal and Axisrange.maxvalueinternal).

In a similar-out, when scrolling is enables for both the diagram and the pane-which an axis belong, and the Scrollingra Nge. Auto property was disabled, you also can manually specify the extreme axis values to which a axis can be scrolled. For more information, refer to Axis Visible and scrolling Ranges and zooming and scrolling (2D xy-charts).

Along an axis, between pairs of their values, multiple scale breaks can is inserted, to allow compact representation of Poin TS with outsized values.

Between a pair of ticks, you can insert multiple scale breakpoints, allowing a compact representation of the extra-large points.

Axes additional elements is axis Titles, axis Labels, Grid Lines, Tickmarks and interlacing, Constant Lines and Strips.

The other elements of the axis are axis titles, axis labels, gridlines, horizontal lines, and bands

To learn more on axes and their functionality, refer to Axes overview.

Understanding Panes Panel

A diagrams ' pane is a rectangular area used to plot series and their associate axes. In general, panes make it possible to distribute multiple series among different areas, which share (or not) their axes (b OTH primary and secondary). Note that panes is available only for the xydiagram2d type (which includes the Xy-diagram and Swift Plot Diagram).

The panel of the diagram is a rectangular area depicting the sequence and associated axes. Panels make it possible to distribute multiple sequences in different regions, with multiple sequences shared (and can not be shared) axes (spindles and secondary axes). Note: The panel is only valid for xydiagram2d types (including Xy-diagram andswift Plot Diagram).

By default, a chart displays it series in the default pane (represented by an Xydiagramdefaultpane object). Its options can is accessed via Thexydiagram2d.defaultpane property.

By default, the chart data is displayed in the default panel of the Xydiagramdefaultpane object. Can be set through the Xydiagram2d.defaultpane property.

To enable additional panes for a diagram, you can add them to the collection returned by the Xydiagram2d.panes property. For more information, refer to Adding Panes.

To use the rest of the panels, add to the Xydiagram2d.panes sequence properties, and refer to adding Panes for more information.

When axes scrolling and/or zooming was enabled at the diagram's level (via the xydiagram2d.enableaxisxscrolling,xydiagram2d . Enableaxisyscrolling, Xydiagram2d.enableaxisxzooming, and Xydiagram2d.enableaxisyzooming properties), you can adjust The availability of axes scrolling and zooming individually for each pane (via the similar XYDIAGRAMPANEBASE.ENABLEAXISXSC Rolling,xydiagrampanebase.enableaxisyscrolling, Xydiagrampanebase.enableaxisxzooming, and Xydiagrampanebase.enableaxisyzooming Properties. For more information, refer to Axis Visible and scrolling Ranges and zooming and scrolling (2D xy-charts).

If panes share the same X or Y axis, by scrolling this axis in one pane, and other panes which use the same axis is also SCRO Lled.

To learn more on panes and their functionality, refer to panes.

Understanding data points, independent variables and dependent variables (parameters and values) Chartcontrol