ION Java User's Guide: Using ION's Pre-Built Applets

IONSurfaceApplet

The IONSurfaceApplet displays an IDL Surface plot. The X, Y and Z values of the plot and any IDL Surface properties supported by ION can be set through parameters to the applet.

Parameters

In addition to the parameters described in Parameters Specified via <PARAM> Tags, the IONSurfaceApplet accepts the following parameters:

X_VALUES

Set the value of this parameter equal to a valid IDL expression that evaluates to a vector or two-dimensional array specifying the X coordinates for the surface. If X_VALUES specifies a vector, each element specifies the X coordinate for a column in the Z_VALUES array(e.g., X[0] specifies the X coordinate for Z[0,*]). If X_VALUES specifies a two-dimensional array, each element specifies the X coordinate of the corresponding point in the Z_VALUES array.

Y_VALUES

Set the value of this parameter equal to a valid IDL expression that evaluates to a vector or two-dimensional array specifying the Y coordinates for the surface. If Y_VALUES specifies a vector, each element specifies the Y coordinate for a column in the Z_VALUES array(e.g., Y[0] specifies the Y coordinate for Z[0,*]). If Y_VALUES specifies a two-dimensional array, each element specifies the Y coordinate of the corresponding point in the Z_VALUES array.

Z_VALUES

Set the value of this parameter equal to a valid IDL expression that evaluates to a one- or two-dimensional array containing the values that make up the surface. If the X_VALUES and Y_VALUES parameters are provided, the contour is plotted as a function of the (X, Y) locations specified by their contents. Otherwise, the surface is generated as a function of the two-dimensional array index of each element of Z_VALUES.

surface_property_1, ..., surface_property_n

Here, surface_property_* is the name of a surface property supported by the IONGrSurface class. Properties for the IONSurfaceApplet reflect the capabilities implemented in keywords to the IDL SURFACE procedure.

The syntax above refers to the fact that you can supply more than one surface property to the applet via the <PARAM> tag. In the example in the next section, both TITLE and LEGO are surface properties, with values of "Surface" and "1," respectively.

The following IDL Surface properties are supported by the IONSurfaceApplet. Refer to the IDL documentation on keywords available for use with the SURFACE procedure for an explanation of each property:

AX, AZ, BOTTOM, HORIZONTAL, LEGO, LOWER_ONLY, SAVE, SHADES, UPPER_ONLY, ZAXIS, BACKGROUND, CHARSIZE, CLIP, COLOR, DATA, DEVICE, FONT, LINESTYLE, NOCLIP, NODATA, NOERASE, NORMAL, POSITION, SUBTITLE, T3D, TICKLEN, TITLE, MAX_VALUE, MIN_VALUE, NSUM, POLAR, XLOG, YNOZERO, YLOG, XCHARSIZE, YCHARSIZE, ZCHARSIZE, XGRIDSTYLE, YGRIDSTYLE, ZGRIDSTYLE, XMARGIN, YMARGIN, ZMARGIN, XMINOR, YMINOR, ZMINOR, XRANGE, YRANGE, ZRANGE, XSTYLE, YSTYLE, ZSTYLE, XTICKFORMAT, YTICKFORMAT, ZTICKFORMAT, XTICKLEN, YTICKLEN, ZTICKLEN, XTICKNAME, YTICKNAME, ZTICKNAME, XTICKS, YTICKS, ZTICKS, XTICKV, YTICKV, ZTICKV, XTITLE, YTITLE, ZTITLE, ZVALUE, ZLOG

Example

The following example creates an IONSurfaceApplet that connects to the same server used by the "Connection" applet defined in the IONGraphicApplet example. The applet generates some data for the Z value of the plot, and sets the "Title" and "Lego" properties of the plot.

<APPLET NAME="SURFACE" CODE=IONSurfaceApplet.class  
        WIDTH=200 HEIGHT=200  
        ARCHIVE="ion_64.zip"  
        CODEBASE=../classes>  
    <!-- This applet uses the applet 'CONNECTION' to connect  
        to the server -->  
    <PARAM NAME="ION_CONNECTION_NAME" VALUE="CONNECTION">  
    <PARAM NAME="LINK_URL" VALUE="surfaceappletsrc.html">  
    <PARAM NAME="Z_VALUES" VALUE="exp(-(shift(dist(30), 15,  
    15)/7)^2)">  
    <PARAM NAME="TITLE" VALUE="Surface">  
    <PARAM NAME="LEGO" VALUE="1">  
</APPLET>