Boxes
Syntax: |
DENSITY\BOXES { x y } z { p1 p2 { q1 q2 { r }}}
|
Qualifiers: |
\PARTIAL, \XPROFILE, \YPROFILE, \BORDER, \AXES, \RESET
|
Defaults: | if z is a matrix:
x=[1;2;3;...], y=[1;2;3;...],
p1=0, p2=1, q1=0, q2=1, \-PARTIAL, \-XPROFILE, \-YPROFILE, \BORDER, \AXES, \RESET
|
To obtain the scaled rectangles type of density plot, use the
\BOXES
qualifier.
Input variables
If z
is a vector, the parameters x
and y
are expected and must be vectors. x
and y
are assumed to represent a scattered set
of points, where z[i]
is the altitude corresponding to the location
(x[i],y[i])
. No internal matrix is interpolated with the scaled rectangle type of density plot.
The lengths of the three vectors must be the same. A box is drawn, centred at
location (x[i],y[i])
with relative size determined by v[i]
.
If z
is a matrix, the parameters x
and y
default to
[1;2;3;...]
, but if entered they must be vectors. Each matrix element,
z[i,j]
, is associated with the coordinates (x[j],y[i])
. The
length of x
must be equal to the number of columns of z
and the length of
y
must be equal to the number of rows. The vectors x
and
y
are used for scaling the axes.
Accentuating a range of values
The optional parameters q1
and q2
can be used to accentuate a range
of values. If zmax
is the maximum value of the data and
zmin
is the minimum value of the data, the full box size range
will be from a minimum of min = q1*(zmax-zmin)+zmin
to
a maximum of max = q2*(zmax-zmin)+zmin
.
The default values are: q1 = 0
and q2 = 1
.
Delimiting the range of values
The optional parameters p1
and p2
can be used to select a window of
values from within the box size range, min
to max
, as defined
above. Suppose that z
is the data value at (x,y)
. A box is
drawn at (x,y)
if and only if
p1 < (z-min)/(max-min) < p2
.
The default values are: p1 = 0
and p2 = 1
.
Box size scale factor
The optional parameter r
is a scale factor which
controls the size of the boxes. For each box, the width and height is multiplied by
r
. The default value is: r = 1
.
Filled boxes
The boxes can be filled. Use the
AREAFILLCOLOR
characteristic to change the fill color. By default, there is no fill colour.
Example of a box type density plot with both x and y profiles
X=[ 1; 0; 1; 0; .2; .3; .5; .8] Y=[ 5; 5; 0; 0; 1;1.5; 2.5; 4] Z=[ 10; 10; 10; 10; -100; 10; -100; 500] GRID\XYOUT X Y Z M XOUT YOUT SET AREAFILLCOLOR RED DENSITY\BOXES\XPROFILE\YPROFILE XOUT YOUT M
Examples of box type density plots with accentuated and delimited values
X=[ 1; 0; 1; 0; .2; .3; .5; .8] Y=[ 5; 5; 0; 0; 1;1.5; 2.5; 4] Z=[ 10; 10; 10; 10; -100; 10; -100; 500] GRID\XYOUT X Y Z M XOUT YOUT WINDOW 5 SET XLABEL `DENSITY\BOXES XOUT YOUT M 0 1 0 1' SET XLABELON 1 DENSITY\BOXES XOUT YOUT M 0 1 0 1 WINDOW 7 SET XLABEL `DENSITY/BOXES XOUT YOUT M .5 1 0 1' SET XLABELON 1 DENSITY\BOXES XOUT YOUT M .5 1 0 1 WINDOW 6 SET XLABEL `DENSITY\BOXES XOUT YOUT M 0 1 .5 1' SET XLABELON 1 DENSITY\BOXES XOUT YOUT M 0 1 .5 1 WINDOW 8 SET XLABEL `DENSITY\BOXES XOUT YOUT M .5 1 .5 1' SET XLABELON 1 DENSITY\BOXES XOUT YOUT M .5 1 .5 1