Last Updated: 3/4/97
Class NFXYChartApp

Class NFXYChartApp

public class NFXYChartApp extends Applet

This class supports the generation of XY Charts that contain one or more data sets. Each data set can be rendered as a series of symbols, connected by lines and with the area beneath filled. The display of symbols, lines and area fill is optional for each data set.

The following standard parameters are supported by this chart:

 	Background

 	Header
 	HeaderBox
 	Footer
 	FooterBox
 	LeftTitle
 	LeftTitleBox
 	RightTitle
 	RightTitleBox

 	DwellLabel
 	DwellBox
 	ActiveClicks
 	ActiveLabels[1-50]

 	Legend
 	LegendBox
 	LegendItems

 	TopAxis
 	LeftAxis
 	RightAxis
 	BottomAxis

 	Grid
 	GridLine
 	GridAxis

 	ColorTable

 	NoteSets
 	NoteSets[1-20]
 	NoteArrow
 	NoteAxis
 	NoteLabel
 	NoteBox

The following parameters are specifically supported by this chart:

DataSets = (dataset1 tuple), (dataset2 tuple),...;

 	Defines a list of dataset tuples with the following attributes
 	in each tuple:

 	"Name"    - Name assigned to this data set
 	SymColor  - Symbol Color
 	SymType   - Symbol Type (NONE, CIRCLE, SQUARE, DIAMOND, CROSS,
 				 TRIANGLEDOWN, TRIANGLEUP)
 	SymSize   - Symbol Size (in pixels)
 	SymStyle  - Symbol Style (FILLED, OUTLINED)
 	LineType  - Line Type (NONE, SOLID, DOTTED, DASHED, DOTDASH)
 	LineWidth - Line Width (in pixels)
 	LineColor - Line Color
 	FillColor - Fill Color

 	By default, the Name and SymColor assigned to each data 
 	set will be used in the Legend.

 	If any of the symbol attributes are undefined, default 
 	values will be used.  If the SymType is set to NONE,
 	then no symbol will be displayed.

 	If the LineType attribute is defined, the data symbols 
 	in the given data set will be connected by line 
 	segments using the given line attributes.

 	If the FillColor attribute is defined, the area under 
 	the curve will be filled with the given color.
 	used for each symbol in the dataset.

 	At most 50 datasets may be displayed.

 	If a color is not specified in the vector, then the 
 	previously specified color will be used. If the color is
 	specified as "null", then a default color will be chosen
 	from the color table. (See the ColorTable parameter.)

 	If a line color or fill color is assigned "null", then
 	the line or area fill will not be drawn.

DataAxis = (XAxis1, YAxis1), (XAxis2, YAxis2), ...;

 	The XAxis and YAxis attributes define the specific axis
 	to be used when mapping the X and Y values respectively
 	for each data set defined. The XAxis attribute may be 
 	set to BOTTOM or TOP, while the YAxis may be set to LEFT
 	or RIGHT.

DataSet[1-50] = (x1,y1), (x2,y2), ...;

 	Defines a list of (x,y) values for each dataset defined 
 	by the DataSets parameter.  If "null" is substituted for
 	either or both of the x/y pair value's, the point will not 
 	be drawn.

AddDataPoint = (DataSetNumber, X, Y, label, url, target), ...

 	This is ONLY to be used if plotting dynamically, and 
 	must be the only command sent followed by the Update 
 	command.  This parameter allows the XY chart to be 
 	updated rapidly without refreshing the screen or 
 	reconfiguring the layout.  The "label", "url", and 
 	"target" fields are optional, and if specified, are used
 	to define an ActiveLabel for the given data point.  If 
 	"null" is substituted for either or both of the x/y pair 
 	value's, the point will not be drawn.

The following HTML segment defines an XY chart containing three sets of data points, with the second connected by dotted lines.

 	<applet code=NFXYChartApp.class width=600 height=400>

 	<param name=NFParamScript value = '

 	Background  = (lightGray, NONE);

 	Header	    = ("XY Chart Demo", cyan);
 	HeaderBox   = (darkGray, RECESS, 5);

 	BottomTics  = ("ON", white, "TimesRoman", 16);
 	BottomScale = (0, 40);

 	LeftTics    = ("ON", white, "TimesRoman", 16);
 	LeftScale   = (50, 100);

 	Legend	    = ("", black, "TimesRoman", 12);
 	LegendBox   = (white, SHADOW, 5);

 	DataSets = ("Set #1", blue,  CROSS,  15, FILLED),
 		   ("Set #2", green, SQUARE,  8, FILLED, DOTTED),
 		   ("Set #3", red,   CIRCLE, 10, OUTLINED, NONE);

 	DataSet1 = (18.1,67.7), (16,64), (18.9,68.8), (17,78.5);
 	DataSet2 = (24.5,86.2), (35.9,68.7), (35.1,64.2);
 	DataSet3 = (17,68), (14,87), (15,75), (14,81), (18,76);

 	'>
 	</applet>

Instance Variables

Type Name Description Default
public NFXYChart Underlying xy chart object xychart