Plot
A plot
is the actual representation of data as one of the
following graphical elements:
The most basic and self-explanatory plot objects are
Points and
Lines. Bars are
useful to draw (one-dimensional) histograms and distributions.
Pixels can be used to visualize
dense
data sets in two or three dimensions. Two-dimensional
images (rectangular grids) are best visualized using
Tiles. Volumetric data sets can be drawn
using Cubes. To allow the user to mark
certain ranges/points or polygons inside a graph, the
Cursor plot can be used.
Interface
The following functions and properties are common for all plot objects.
Properties
-
name
:KontrastName
The name of the plot. The name has to be unique within the graph the plot belongs to. The name must not be empty and must not contain a dot, colon, semicolon or a hash (
#
). The name defaults toplotN
, whereN
is a non-negative integer. We recommend you choose a meaningful name for each plot, so that it can be easily accessed via the development console or the Kontrast menu. -
markerLegend
:KontrastString
(default value: empty string)If this string is not empty, it is used as the first entry inside the hover marker. It may consist of HTML.
See also: Marker documentation
-
excludeFromHoverMarker
:KontrastBoolean
(default value:false
)When set to true, the plot is not considered for showing a hover marker.
See also: Marker documentation
-
hidden
:KontrastBoolean
(default value:false
)When set to true, the plot is hidden.
-
renderIndex
:KontrastNumber
(default value:0
)This number determines the order in which graphical elements (the axes and the plots) are drawn. The behavior is similar to the concept of a
layer
: First, the object with the lowestrenderIndex
is drawn on the screen. The object with the largestrenderIndex
within the graph is drawn last. -
data
:KontrastData
An object that associates data entries (arrays, numbers, additional information) with a corresponding axis.