XyPlot class resource descriptions

xyCoordData

Specifies the array of data object ids that provide the X/Y coordinate pairs to be plotted. This resource is a data resource partially managed with the help of the DataComm superclass.

Default: NULL

xyCoordDataSpec

This resource is a retrievable resource only. It is used to allow the user a greater amount of configurability for how each coordinate pair array is displayed in the XyPlot. After adding DataItems to the XyPlot xyCoordData resource, this resource can be retrieved to get an array of XyDataSpec object ids. This array is ordered so that the elements of this array correspond directly with the elements of the xyCoordData array resource. The XyDataSpec resources can be set to each object in this array. This will determine exactly how the corresponding DataItem in the xyCoordData resource will be rendered in the XyPlot.

Default: NULL

xyXStyle

Sets the style for the X-axis of the XyPlot. The styles are LOG, LINEAR, IRREGULAR, TIME, and GEOGRAPHIC. These are identical to the styles available through the TickMark object. XyPlot does not allow the programmer to set the top and bottom styles directly like it is done in the TickMark object. To achieve multiple scales (i.e. Pressure on top, Km on bottom) either the tmX[TB]Mode can be set to EXPLICIT and strings representing the alternate scale provided.

Default: LINEAR

xyYStyle

Sets the style for the Y-axis of the XyPlot. The styles are LOG, LINEAR, IRREGULAR, TIME, and GEOGRAPHIC. These are identical to the styles available through the TickMark object. XyPlot does not allow the programmer to set the left and right styles directly like it is done in the TickMark object. To achieve multiple scales (i.e. Pressure on left, Km on right) either the tmY[TB]Mode can be set to EXPLICIT and strings representing the alternate scale provided.

Default: LINEAR

xyXIrregularPoints

An array of floats that specify a discrete representation of an irregular coordinate system. The values in this array must be monotonic increasing or decreasing. This resource is only used if xyXStyle is IRREGULAR

Default: NULL

xyYIrregularPoints

An array of floats that specify a discrete representation of an irregular coordinate system. The values in this array must be monotonic increasing or decreasing. This resource is only used if xyYStyle is IRREGULAR

Default: NULL

xyXIrrTensionF

Specifies the tension to apply to the spline approximation used to determine the transformation for the xyXIrregularPoints. This resource is only used if xyXStyle is IRREGULAR.

Default: 2.0

xyYIrrTensionF

Specifies the tension to apply to the spline approximation used to determine the transformation for the xyYIrregularPoints. This resource is only used if xyYStyle is IRREGULAR.

Default: 2.0

xyComputeXMin

If this resource is True, then the trXMinF resource will be recalculated every time the xyCoordData resource is modified. If this resource is False, then the trXMinF resource will not be recalculated each time the xyCoordData resource is modified.

Default: dynamic
If the programmer specifies the trXMinF resource, then the default for this resource will be False. If the programmer doesn't specify the trXMinF resource, then the default for this resource will be True.

xyComputeXMax

If this resource is True, then the trXMaxF resource will be recalculated every time the xyCoordData resource is modified. If this resource is False, then the trXMaxF resource will not be recalculated each time the xyCoordData resource is modified.

Default: dynamic
If the programmer specifies the trXMaxF resource, then the default for this resource will be False. If the programmer doesn't specify the trXMaxF resource, then the default for this resource will be True.

xyComputeYMin

If this resource is True, then the trYMinF resource will be recalculated every time the xyCoordData resource is modified. If this resource is False, then the trYMinF resource will not be recalculated each time the xyCoordData resource is modified.

Default: dynamic
If the programmer specifies the trYMinF resource, then the default for this resource will be False. If the programmer doesn't specify the trYMinF resource, then the default for this resource will be True.

xyComputeYMax

If this resource is True, then the trYMaxF resource will be recalculated every time the xyCoordData resource is modified. If this resource is False, then the trYMaxF resource will not be recalculated each time the xyCoordData resource is modified.

Default: dynamic
If the programmer specifies the trYMaxF resource, then the default for this resource will be False. If the programmer doesn't specify the trYMaxF resource, then the default for this resource will be True.

XyDataSpec class resource descriptions

xyDashPattern

This resource determines the dash pattern index that all the curves derived from the associated data object will be drawn with if xyMonoDashPattern is True.

Default: NhlSOLIDLINE

xyDashPatterns

An array of integer dash pattern indices to use when drawing the corresponding curves in the associated data object. If there are more curves than the number of dash pattern indices in this resource, the remaining curves will be drawn using the xyDashPattern resource.

This resource is only used if the xyMonoDashPattern resource is False.

Default: NULL

xyMonoDashPattern

If this resource is True, then all the curves in the associated data object will be drawn with the dash pattern specified by the xyDashPattern resource. Otherwise, the curves are drawn with the dash pattern specified by the corresponding index in the xyDashPatterns array resource.

Default: False

xyMarkLineMode

This resource determines if markers, curves, or both markers and curves will be displayed for all coordinate arrays derived from the associated data object if xyMonoMarkLineMode is True.

Default: NhlLINES

xyMarkLineModes

An array of NhlMarkLineMode enumerations to use when drawing the corresponding coordinate pair arrays in the associated data object. If there are more coordinate pair arrays than the number of elements in this resource, the remaining coordinate pair arrays will be drawn using the value of the xyMarkLineMode resource.

Default: NULL

xyMonoMarkLineMode

If this resource is True, then all the coordinate pair arrays in the associated data object will be drawn as specified by the xyMarkLineMode resource. Otherwise, the coordinate pair arrays are drawn in the NhlTMarkLineMode specified by the corresponding index in the xyMarkLineModes array resource.

Default: False

xyExplicitLegendLabels

An array of character strings to use as labels in the XyPlot legend. The legend labels will default to the values in the xyExplicitLabels resource. If there are more coordinate pair arrays than the number of elements in this resource, the remaining coordinate pair arrays will also be labeled with the corresponding value of the xyExplicitLabels resource.

Default: NULL

xyLineColor

This resource determines what color index all the curves derived from the associated data object will be drawn with if xyMonoLineColor is True.

Default: NhlFOREGROUND

xyLineColors

An array of color indices to use when drawing the corresponding curves in the associated data object. If there are more curves than the number of color indices in this resource, the remaining curves will be drawn using the xyLineColor resource.

This resource is only used if the xyMonoLineColor resource is False.

Default: NULL

xyMonoLineColor

If this resource is True, then all the curves in the associated data object will be drawn in the color specified by the xyLineColor resource. Otherwise, the curves are drawn in the color specified by the corresponding index in the xyLineColors array resource.

Default: False

xyLineDashSegLenF

This resource indicates the length of each segment of a dash pattern. It is the length in NDCs before the dash pattern repeats itself. This resource automatically scales with changes in the size of the viewport of the XyPlot. If line labels are being drawn, this is also the length between the end of one label and the start of the next.

Default: <Dynamic>
This resource defaults to 25 percent of the average of the XyPlot's width and height.

xyLineLabelFontHeightF

This allows the user to set the size of the characters used for the curve labels when the data-dependent resource xyLabelMode is set to LETTERED or CUSTOM. The size of the font is expressed in NDCs and scales with changes in the size of the viewport of the XyPlot object.

Default: <Dynamic>
This resource defaults to 1.5 percent of the average of the XyPlot's width and height.

xyLineLabelFontColor

This resource indicates what color index to draw the line labels if xyLabelMode is set to NhlLETTERED or NhlCUSTOM. This value is only used if xyMonoLineLabelFontColor is True, or the xyLineLabelFontColors array doesn't specifiy enough values.

Default: NhlFOREGROUND

xyLineLabelFontColors

This resource indicates what color index to draw the line labels in if xyLabelMode is set to NhlLETTERED or NhlCUSTOM. It is an array of NhlColorIndexes that indicate the color for the line labels in the corresponding coordinate arrays in the associated data object. If there are more coordinate arrays than the number of NhlColorIndexes in this resource, the remaining coordinate arrays will be drawn using the xyLineLabelFontColor resource.

Default: NULL

xyMonoLineLabelFontColor

If this resource is True, then all the line labels for the corresponding coordinate arrays in the associated data object will be drawn with the color specified by the xyLineLabelFontColor resource. Otherwise, each coordinate array's markers are drawn with the color specified by the corresponding index in the xyLineLabelFontColors array resource.

Default: False

xyLabelMode

This can be set to either NOLABELS, LETTERED, or CUSTOM. NOLABELS means that the curves from the associated DataItem will not be labeled. LETTERED means that the curves will be labeled with capital letters in the order in which they appear in the associated DataItem. The current letter is retained so that if the next XyDataSpec in the list is using LETTERED, the letter will not be reused until the entire alphabet has been used. (Note: This means that LETTERED curves do not necessarily retain the same label when data are added or removed from the xyCoordData resource. CUSTOM means that the curves will be labeled with the corresponding strings provided by the xyExplicitLabels resource. If there is no corresponding string, the curves will be labeled by using the name of the XyDataSpec object and appending the curve index.

Default: NOLABELS

xyExplicitLabels

An array of character strings to place inside the corresponding curve in the associated DataItem. If there are more curves than the number of strings in this resource, the remaining curves will be labeled by using the name of the XyDataSpec object and appending the curve index.

Default: NULL

xyLineThicknessF

This resource sets the linewidth scale factor for curves derived from the associated data object if xyMonoLineThickness is True.

Default: 1.0

xyLineThicknesses

An array of floating point numbers that are used as line-width scale factors when drawing the corresponding curves in the associated data object. If there are more curves than the number of floating point numbers in this resource, the remaining curves will be drawn using the xyLineThicknessF resource.

This resource is only used if the xyMonoLineThickness resource is False.

Default: NULL

xyMonoLineThickness

If this resource is True, then all the curves in the associated data object will be drawn with the width factor specified by the xyLineThicknessF resource. Otherwise, the curves are drawn with the thickness specified by the corresponding index in the xyLineThicknesses array resource.

Default: False

xyMarker

This resource indicates which marker index all the coordinate pair arrays derived from the associated data object will be drawn with if xyMonoMarker is True.

Default: 0

xyMarkers

An array of marker indices to use when drawing the corresponding coordinate arrays in the associated data object. If there are more coordinate arrays than the number of enumerations in this resource, the remaining coordinate arrays will be drawn using the value of the xyMarker resource.

Default: NULL

xyMonoMarker

If this resource is True, then all the coordinate arrays in the associated data object will be drawn with the marker index specified by the xyMarker resource. Otherwise, the coordinate arrays are drawn with the marker specified by the corresponding index in the xyMarkers array resource.

Default: False

xyMarkerColor

This resource indicates what color index all markers drawn using the coordinate arrays from the associated data object will be drawn with if xyMonoMarkerColor is True.

Default: NhlFOREGROUND

xyMarkerColors

An array of color indices to use when drawing the markers for the corresponding coordinate arrays in the associated data object. If there are more coordinate arrays than the number of color indices in this resource, the remaining coordinate arrays will be drawn using the xyMarkerColor resource.

Default: NULL

xyMonoMarkerColor

If this resource is True, then all the markers for the corresponding coordinate arrays in the associated data object will be drawn in the color specified by the xyMarkerColor resource. Otherwise, each coordinate array's markers are drawn in the color specified by the corresponding index in the xyMarkerColors array resource.

Default: False

xyMarkerSizeF

This resource indicates the size for all markers drawn using the coordinate arrays from the associated data object if xyMonoMarkerSize is True.

The size is in NDC.

Default: .01

xyMarkerSizes

An array of floats that indicate the size for the markers in the corresponding coordinate arrays in the associated data object. If there are more coordinate arrays than the number of floats in this resource, the remaining coordinate arrays will be drawn using the xyMarkerSizeF resource.

The size is in NDCs.

Default: NULL

xyMonoMarkerSize

If this resource is True, then all the markers for the corresponding coordinate arrays in the associated data object will be drawn with the size specified by the xyMarkerSizeF resource. Otherwise, each coordinate array's markers are drawn with the size specified by the corresponding index in the xyMarkerSizes array resource.

Default: False

xyMarkerThicknessF

This resource sets the linewidth scale factor for markers derived from the associated data object if xyMonoMarkerThickness is True.

Default: 1.0

xyMarkerThicknesses

An array of floating point numbers that are used as linewidth scale factors to use when drawing the markers in the corresponding coordinate pair arrays in the associated data object. If there are more coordinate pair arrays than the number of floating point numbers in this resource, the remaining coordinate pair arrays will be drawn using the xyMarkerThicknessF resource.

This resource is only used if the xyMonoMarkerThickness resource is False.

Default: NULL

xyMonoMarkerThickness

If this resource is True, then all the curves in the associated data object will be drawn with the width factor specified by the xyMarkerThicknessF resource. Otherwise, the curves are drawn with the thickness specified by the corresponding index in the xyMarkerThicknesses array resource.

Default: False

Reference Manual Control Panel

NG4 Home, Index, Examples, Glossary, Feedback, Ref Contents, Ref WhereAmI?