MtxVecTee.DrawValues Method

Overload List

#SignatureDescription
1void DrawValues(TMtx matrix, MtxGridSeries series)Plot matrix values as 2-d grid.
2void DrawValues(TVec X, TVec Y, Series series, Boolean pixeldownsample)Plots Y=Y(X) using apropriate two dimensional series.
3void DrawValues(TVec Y, Series series, Double xoffset, Double xstep, Boolean pixeldownsample)Draws Y values by using any valid chart series.
4void DrawValues(TVec[] vectors, Series series)Passed an array of vectors to single series ValueList(s).
5void DrawValues(TVec[] vectors, Series series, Double xoffset, Double xstep)Passes an array of vectors to single series which requires multiple value lists ValueList(s).
6void DrawValues(TVec[] vectors, Series[] series, Double xoffset, Double xstep, Boolean pixeldownsample)Copy each of the vector in vectors array to separate series in series array.

Overload 1: void DrawValues(TMtx matrix, MtxGridSeries series)

Plot matrix values as 2-d grid.

#NameDescription
1matrix2D array storing indexed (i,j) matrix values.
2seriesMtxGridSeries to be used for drawing.

Result: stored in self (calling object)

Examples
using Dew.Math;
using Dew.Math.Tee;

Matrix m = new Matrix(50,30,false);
m.RandGauss();
MtxGridSeries gridseries;
tChart1.Series.Clear();
tChart1.Series.Add(gridseries = new MtxGridSeries());
MtxVecTee.DrawValues(m, gridseries);

Overload 2: void DrawValues(TVec X, TVec Y, Series series, Boolean pixeldownsample)

Plots Y=Y(X) using apropriate two dimensional series.

#NameDescription
1XStores x values.
2YStores y values.
3seriesSeries to be used for plotting. Series can be any series with two different ValueList(s).
4pixeldownsampleIf true, downsampling is performed prior to plotting.

Result: stored in self (calling object)

Examples
using Dew.Math;
using Dew.Math.Tee;

Vector x = new Vector(11);
Vector y = new Vector(11);
x.Ramp(-5,1);
y.Sqr(x); // y=x*x;
tChart1.Series.Clear();
tChart1.Series.Add(new Steema.TeeChart.Styles.Line());
MtxVecTee.DrawValues(x,y,tChart[0],false);

Overload 3: void DrawValues(TVec Y, Series series, Double xoffset, Double xstep, Boolean pixeldownsample)

Draws Y values by using any valid chart series.

#NameDescription
1YValues to be plotted, including INFs and NANs.
2seriesSeries to be used for plotting.
3xoffsetStarting x value for first y(x) value.
4xstepDistance between consecutive x values.
5pixeldownsampleIf true, perform downsampling before plotting.

Result: stored in self (calling object)

Remarks:

Series x values are calculated using the following formula: x[i] = xoffSet + xstep*i. The algorithm automatically removes any INFs and NANs and then uses Series.Add method to add points to series.

Examples
using Dew.Math;
using Dew.Math.Tee;

Vector y = new Vector(100,false);
y.RandGauss();
tChart1.Series.Clear();
tChart1.Series.Add(new Steema.TeeChart.Styles.Line());
MtxVecTee.DrawValues(y,tChart1[0],10.5,0.05,false);

Overload 4: void DrawValues(TVec[] vectors, Series series)

Passed an array of vectors to single series ValueList(s).

#NameDescription
1vectorsAn array of vectors defining series x,y,... values.
2seriesSeries to be used for plotting.

Result: stored in self (calling object)

Remarks:

Copy each of the vector in Vectors array to Series ChartValueList(s): XValues, YValues. Use this routine if you want to copy several vectors to the same series in one pass.

Examples
using Dew.Math;
using Dew.Math.Tee;

Vector x = new Vector(0);
Vector y = new Vector(0);
Vector error = new Vector(0);
x.LoadFromFile("x_data.vec");
y.LoadFromFile("y_data.vec");
error.LoadFromFile("error_data.vec");
tChart1.Series.Clear();
tChart1.Series.Add(Steema.TeeChart.Styles.Error());
MtxVecTee.DrawValues(new TVec[] {x,y,error},tChart1[0],0,1);

Overload 5: void DrawValues(TVec[] vectors, Series series, Double xoffset, Double xstep)

Passes an array of vectors to single series which requires multiple value lists ValueList(s).

#NameDescription
1vectorsAn array of vectors defining series x,y,... values.
2seriesSeries to be used for plotting.
3xoffsetStarting x value for first y(x) value.
4xstepDistance between consecutive x values.

Result: stored in self (calling object)

Examples
using Dew.Math;
using Dew.Math.Tee;

Vector x = new Vector(0);
Vector y = new Vector(0);
Vector errors = new Vector(0);
x.LoadFromFile("x.vec");
y.LoadFromFile("y.vec");
errors.LoadFromFile("errors.vec");
MtxVecTee.DrawValues(new TVec[] {x,y,errors},errorSeries1,0,1.0);

Overload 6: void DrawValues(TVec[] vectors, Series[] series, Double xoffset, Double xstep, Boolean pixeldownsample)

Copy each of the vector in vectors array to separate series in series array.

#NameDescription
1vectorsAn array of vectors to be passed to series array.
2seriesAn array of series to be used for plotting.
3xoffsetStarting x value for first y(x) value.
4xstepDistance between consecutive x values.
5pixeldownsampleIf true, downsampling is performed on all vectors prior to plotting.

Result: stored in self (calling object)

Examples
using Dew.Math;
using Dew.Math.Tee;

tChart1.Series.Clear();
tChart1.Series.Add(typeof(Steema.TeeChart.Styles.Fastline));
tChart1.Series.Add(typeof(Steema.TeeChart.Styles.Fastline));
tChart1.Series.Add(typeof(Steema.TeeChart.Styles.Fastline));
Vector v1,v2,v3;
// ...
MtxVecTee.DrawValues(new Vector[] {v1,v2,v3},new Styles.Series[]{tChart[0],tChart[1],tChart[2]});