ImageSCPlot Constructor (BaseArray, Colormaps, TupleSingle, Single, Object)

ILNumerics Ultimate VS Documentation

ILNumerics - Technical Application Development

Create new ImageSC plot, optionally providing colormap and/or data range for color mapping

[ILNumerics Visualization Engine]

Namespace: ILNumerics.Drawing.Plotting
Assembly: ILNumerics.Drawing (in ILNumerics.Drawing.dll) Version: ILNumerics Ultimate VS 4

Syntax

Copy

public ImageSCPlot(
	BaseArray Z = null,
	Colormaps colormap = Colormaps.ILNumerics,
	Tuple<float, float> minMaxDataRange = null,
	Object tag = null
)

Public Sub New ( 
	Optional Z As BaseArray = Nothing,
	Optional colormap As Colormaps = Colormaps.ILNumerics,
	Optional minMaxDataRange As Tuple(Of Single, Single) = Nothing,
	Optional tag As Object = Nothing
)

Dim Z As BaseArray
Dim colormap As Colormaps
Dim minMaxDataRange As Tuple(Of Single, Single)
Dim tag As Object

Dim instance As New ImageSCPlot(Z, colormap, 
	minMaxDataRange, tag)

Parameters

Z (Optional): Type: ILNumericsBaseArray
numeric matrix with data to plot
colormap (Optional): Type: ILNumerics.DrawingColormaps
[optional] colormap used to map values to colors. Default: Colormaps.ILNumerics
minMaxDataRange (Optional): Type: SystemTupleSingle, Single
[optional] data range used to find the color range for values in Z. Default: null (take the limits of Z)
tag (Optional): Type: SystemObject
[optional] tag used to identify the plot in the scene graph

Remarks

ImageSC plots visualize the values of a matrix as colored rectangle/square tiles. The color of a tile and its height (i.e. Z-coordinate) corresponds to the position of the values in the colormap used.

Distinction between ImageSC and Surface plots

ImageSC plots are less costly and less restrictive then surface plots. While a surface interprets the values of a matrix as grid points and connects the area between the grid points with linear interpolation, imagesc plots do not interpolate. Instead, every value is visualized as individual tile, the color reflects the value of the element. Adjacent values are not connected in any way. Therefore, imagesc plots do not require the data matrix to contain at least two columns or rows (as for surface plots). It rather allows for any shape of the data matrix (even empty matrices).

While ImageSC plots are intended to be used as 2D representation of a matrix, the tiles composing the elements of the matrix were given a height (z-coordinate) value according to their value in the matrix. Therefore, by rotating the plot in a 3D setup, allows the anticipation of the 'height map' defined by the matrix elements. However, ImageSC is optimized for speed and does not connect the tiles to its neighboring tiles. Hence, the visibility is limited, when watching the imagesc plot from the side.

In order to control the mapping of element values to colors within the colormap, next to the colormap argument, the minMaxDataRange argument is used. It allows the definition of the maximum value and the minimum value which are to be mapped to the maximum and minimum value of the colormap correspondingly. If no value is given (default) the maximum and minimum values of Z are used. In that case, the full colormap is addressed by the element values of Z.

[ILNumerics Visualization Engine]

Reference

ImageSCPlot Class

ImageSCPlot Overload

ILNumerics.Drawing.Plotting Namespace

ImageSCPlot Constructor (BaseArray, Colormaps, TupleAddLanguageSpecificTextSet("LST4FBCFDD2_0?cs=&lt;|vb=(Of |cpp=&lt;|fs=&lt;'|nu=(");Single, SingleAddLanguageSpecificTextSet("LST4FBCFDD2_1?cs=&gt;|vb=)|cpp=&gt;|fs=&gt;|nu=)");, Object)

Parameters

Distinction between ImageSC and Surface plots

Reference

ImageSCPlot Constructor (BaseArray, Colormaps, TupleSingle, Single, Object)