Surface Plot
-------------
^surface7^ Var1 Var2 Var3 , saving(string) ^round^(#) ^orient^(string)
^nowire^ ^xtitle(string)^ ^ytitle(string)^ ^ztitle(string)^
Description
-----------
The function attempts to draw a wireframe plot from three variables.
Var1 specifies the x-coordinate, var2 the y-coordinate and var3 the
z-coordinate. Alternatively the function can draw a circle at each
point and add a straight line going
down to the lowest point.
This function can handle data that is not in the form of a matrix of values.
However if there are too many x- and y- values the function will attempt
to round the dataset values into a more reasonable spread of values. This
will result in very messy figures. However in s uch a case it is the
impression that is needed. Many otehr statistical packages require a full
matrix of values. This is not a problem for the ^nowire^ option.
At present the state of rotating the diagram is limited to interchanging the
axes.
Options
-------
^saving^(^filename)^ this will save the resulting graph in filename.gph.
If the file already exists it is ^DELETED^ and the new graph will be saved.
^nowire^ this suppresses the drawing of the wire frame in exchange for lines
^round()^, data is automatically rounded if there are too many x and y
values. This option controls the amount of rounding, for example round(1)
rounds the x and y values to the nearest integer.
^orient()^ this function must take the letters xyz or a combination of them.
Whichever letter comes first is the x-axis, second is y-axis and third is
the z-axis. Thus orient(zxy) means that var1 is now the y coordinates, var2
is the z-coordinates and var3 is the x-coordinates. This is different from
changing the variables around since the wireframe is still draw across the
original x and y values. This is a crude attempt to implement rotation to
obtain a clearer picture.
^xtitle(string)^ specifies the title for the X-axis, the default is "X-axis"
^ytitle(string)^ specifies the title for the Y-axis, the default is "Y-axis"
^ztitle(string)^ specifies the title for the Z-axis, the default is "Z-axis"
Examples
--------
surface7 x y z, saving(myfile) round(10) orient(zxy)
surface7 x y z, xtitle(my x title) ytitle(my y title) ztitle(my z title)