Surface()

Plots a 3d surface given a 2d unit cell of density, inside a three dimensional window

Surface/DRAW lattice=Realarray density=Realarray dlow=Real dhigh=Real devert=Real table=Colourtable [eye=Realarray] [light=Realarray] Plots a 3d surface, in a 3d window.
Surface/ALTER [lattice=Realarray] [dlow=Real] [dhigh=Real] [devert=Real] [table=Colourtable] [eye=Realarray] [light=Realarray] object=Gobject Alters a previously plotted surface.

example:

	#Plot a 3d surface
	>> s=surface:draw(lattice,density,0.0,30.0,30.0,table)
	#Alter the lowest density to be plotted
	>> surface/alter dlow=10.0 object=s

Surface/Draw

Plots a 3d surface given a 2d unit cell of density, inside a 3d window. All (x,y,z) values are taken to be given in world coordinates. The z component of all lattice vertices should be negative.

Parameters:

lattice (Realarray)

(x,y,z) coordinates of the origin and the a, & b lattice vertices. The array should be allocated by DIMENSIONS(3,3).

density (Realarray)

The density at regular points within the unit cell. The array is of size (N1+1)x(N2+1), where N1, N2 are the dimensions of the unit cell grid. It should be allocated by DIMENSIONS(N2+1,N1+1). The density is wrapped around so that DENSITY(0,J)=DENSITY(N1,J) etc.

dlow (Real)

The lowest density to be plotted.

dhigh (Real)

The highest density to be plotted.

dvert (Real)

A "vertical" world coordinate length corresponding to density range.

table (Colourtable)

The colour table to be used, see ColourTable for details.

eye (Realarray)

(x,y,z) coordinate of the eye position, see Win_ThreeD for details.

light (Realarray)

(x,y,z) direction of the flood-light, see Win_ThreeD for details.

RESULT = (Gobject)

Returns the properties of the newly created surface.

Surface/Alter

Alters a surface plotted inside a 3d window.

Parameters:

lattice (Realarray)

(x,y,z) coordinates of the origin and the a, & b lattice vertices. The array should be allocated by DIMENSIONS(3,3).

dlow (Real)

The lowest density to be plotted.

dhigh (Real)

The highest density to be plotted.

dvert (Real)

A "vertical" world coordinate length corresponding to density range.

table (Colourtable)

The colour table to be used, see ColourTable for details.

eye (Realarray)

(x,y,z) coordinate of the eye position, see Win_ThreeD for details.

light (Realarray)

(x,y,z) direction of the flood-light, see Win_ThreeD for details.

object (Gobject)

The surface object to be altered.

RESULT = (Gobject)

Returns the properties of the altered surface.