ILNumerics - Technical Application Development
Assembly: ILNumerics.Toolboxes.Drawing2 (in ILNumerics.Toolboxes.Drawing2.dll) Version: 5.5.0.0 (5.5.7503.3146)
Creates a new colormapped bar plot, provide Z values, X and Y ranges arrays.
[ILNumerics Drawing2 Toolbox]
Namespace: ILNumerics.Drawing.Plotting
Assembly: ILNumerics.Toolboxes.Drawing2 (in ILNumerics.Toolboxes.Drawing2.dll) Version: 5.5.0.0 (5.5.7503.3146)
Syntax
public BarPlotEx( InArray<float> Z, InArray<float> X = null, InArray<float> Y = null, Colormap colormap = null, Object tag = null )
Parameters
- Z
- Type: ILNumericsInArraySingle
Positions data for the grid points, scalar, vector or matrix of size [m x n] - X (Optional)
- Type: ILNumericsInArraySingle
X range: a matrix of size Z.S or a vector of length Z.S[1] or a scalar - Y (Optional)
- Type: ILNumericsInArraySingle
Y range: a matrix of size Z.S or a vector of length Z.S[0] or a scalar - colormap (Optional)
- Type: ILNumerics.Drawing.PlottingColormap
[optional] Colormap to be used for colormappings, default: 'ILNumerics' - tag (Optional)
- Type: SystemObject
[optional]tag used to identify the surface within the scene graph
Exceptions
Exception | Condition |
---|---|
ArgumentException | If Y is null or Y has wrong size according to Z. |
ArgumentException | If X is empty or X has wrong size according to Z. |
ArgumentException | If X or Y has different shape than Z |
Remarks
ParameterZ could be specified as scalar, vector or 2D matrix[m x n]. If Z is specified as matrix, X and Y could be also specified as vectors: X size of m and Y size of n; or matrices size of [m x n].
If Z is specified as scalar, default coordinates X, Y are 0, 0. A single bar will be drawn.
colormap is an optional parameter specified as Colormaps enumeration to define colormap template to fill the faces. By default colormap is set to 'ILNumerics'.
[ILNumerics Drawing2 Toolbox]
Examples
Example creates and draws BarPlotEx object
private void ilPanel1_Load(object sender, EventArgs e) { // setup the plot cube ... ilPanel1.Scene.Add(new PlotCube(twoDMode: false) { // draw bar plot, 3D detached new BarPlotEx(Z:SpecialData.sincf(20, 20, 1.5f), colormap: Colormaps.Jet); }); }
See Also