1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118
|
<HTML>
<HEAD>
<TITLE>Boxes</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000">
<P><font size="+3" color="green"><B>Boxes</B></font></P>
<TABLE border="1" cols="2" frame="box" rules="all" width="572">
<TR>
<TD width="15%" valign="top"><B>Syntax</B>:</TD>
<TD width="85%" valign="top"><CODE>
DENSITY\BOXES { x y } z { p1 p2 { q1 q2 { r }}}</CODE>
</TD></TR>
<TR>
<TD valign="top"><B>Qualifiers</B>:</TD>
<TD valign="top"><CODE>
\PARTIAL, \XPROFILE, \YPROFILE, \BORDER, \AXES, \RESET</CODE>
</TD></TR>
<TR>
<TD valign="top"><B>Defaults</B>:</TD>
<TD valign="top">if <CODE>z</CODE> is a matrix:<code>
x=[1;2;3;...], y=[1;2;3;...],
p1=0, p2=1, q1=0, q2=1, \-PARTIAL, \-XPROFILE, \-YPROFILE, \BORDER, \AXES, \RESET</CODE>
</TD></TR>
</TABLE>
<P>
To obtain the scaled rectangles type of density plot, use the
<CODE>\BOXES</CODE> qualifier.</p>
<P>
<font size="+1" color="green">Input variables</font></P>
<P>
If <CODE>z</CODE> is a vector, the parameters <CODE>x</CODE> and <CODE>y</CODE>
are expected and must be vectors. <CODE>x</CODE> and <CODE>y</CODE> are assumed to represent a scattered set
of points, where <CODE>z[i]</CODE> is the altitude corresponding to the location
<CODE>(x[i],y[i])</CODE>. 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 <CODE>(x[i],y[i])</CODE> with relative size determined by <CODE>v[i]</CODE>.</p>
<p>
If <CODE>z</CODE> is a matrix, the parameters <CODE>x</CODE> and <CODE>y</CODE> default to
<CODE>[1;2;3;...]</CODE>, but if entered they must be vectors. Each matrix element,
<CODE>z[i,j]</CODE>, is associated with the coordinates <CODE>(x[j],y[i])</CODE>. The
length of <CODE>x</CODE> must be equal to the number of columns of <CODE>z</CODE> and the length of
<CODE>y</CODE> must be equal to the number of rows. The vectors <CODE>x</CODE> and
<CODE>y</CODE> are used for scaling the axes.</p>
<p>
<font size="+1" color="green">Accentuating a range of values</font></p>
<p>
The optional parameters <CODE>q1</CODE> and <CODE>q2</CODE> can be used to accentuate a range
of values. If <CODE>z<sub>max</sub></CODE> is the maximum value of the data and
<CODE>z<sub>min</sub></CODE> is the minimum value of the data, the full box size range
will be from a minimum of <CODE>min = q1*(z<sub>max</sub>-z<sub>min</sub>)+z<sub>min</sub></CODE> to
a maximum of <CODE>max = q2*(z<sub>max</sub>-z<sub>min</sub>)+z<sub>min</sub></CODE>.
The default values are: <CODE>q1 = 0</CODE> and <CODE>q2 = 1</CODE>.</p>
<p>
<font size="+1" color="green">Delimiting the range of values</font></p>
<p>
The optional parameters <CODE>p1</CODE> and <CODE>p2</CODE> can be used to select a window of
values from within the box size range, <CODE>min</CODE> to <CODE>max</CODE>, as defined
above. Suppose that <CODE>z</CODE> is the data value at <CODE>(x,y)</CODE>. A box is
drawn at <CODE>(x,y)</CODE> if and only if
<CODE>p1 < (z-min)/(max-min) < p2</CODE>.
The default values are: <CODE>p1 = 0</CODE> and <CODE>p2 = 1</CODE>.</p>
<p>
<font size="+1" color="green">Box size scale factor</font></p>
<p>
The optional parameter <CODE>r</CODE> is a scale factor which
controls the size of the boxes. For each box, the width and height is multiplied by
<CODE>r</CODE>. The default value is: <CODE>r = 1</CODE>.</p>
<p>
<font size="+1" color="green">Filled boxes</font></p>
<p>
The boxes can be filled. Use the
<CODE><a href="../Characteristics/GeneralGraph/areafillcolor/areafillcolor.htm">AREAFILLCOLOR</a></CODE>
characteristic to change the fill color. By default, there is no fill colour.</p>
<p>
<font size="+1" color="green">Example of a box type density plot with both
<I>x</i> and <i>y</i> profiles</font></P>
<font color="blue"><PRE>
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
</PRE></font>
<center><IMG SRC="boxes1.png"></center>
<p>
<font size="+1" color="green">Examples of box type density plots with accentuated
and delimited values</font></P>
<font color="blue"><PRE>
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
</PRE></font>
<center><IMG SRC="boxes2.png"></center>
<p>
<a href="diffusion.htm"><img src="../shadow_left.gif">
<font size="+1" color="olive">DIFFUSION</font></a></P>
</BODY>
</HTML>
|