Big Faceless Graph Library 2.3 Tag Documentation - Copyright © 2006 Big Faceless Organization

data

Description

The "data" tag is used inside every type of series except for a "functionseries". It represents an item of data, whether that be a sample (in a Line series), a bar (in a Bar series) or similar. Because of it's versatility it has a number of attributes, many of which may not apply in a particular situation.

Valid Children

label? (only for data inside a "piegraph" tag)

Examples

Example: an sample in a line series
<axesgraph width="300" height="300">
  <lineseries name="FloatingBars">
    <data x="15" y="20" />
  </lineseries>
</axesgraph>
Example: a regular bar series data entry
<axesgraph width="300" height="300">
  <barseries name="MyBars">
    <data x="Apples" y="20" />
  </barseries>
</axesgraph>
Example: an entry in a bar series that 'floats' off the bottom
<axesgraph width="300" height="300">
  <barseries name="FloatingBars">
    <data x="Apples" min="20" max="30" />
  </barseries>
</axesgraph>
Example: an entry in a PieGraph
<piegraph width="300" height="300">
  <data key="Apples" value="20" />
</piegraph>
Example: two entries in a PieGraph with different radii
<piegraph width="300" height="300">
  <data key="Apples" value="20" />
  <data key="Oranges" value="20" innerradius="25" outerradius="75" />
</piegraph>

Attributes

x Real, Date or String optional XML / Tag Library

Description

In an AxesGraph, The X value of the Data. This value is required, but exact nature of the value depends on it's context:
  • For data in a Bar or Box-Whisper series, X is typically a Date or a String (depending on if the bar is being plotted against a Bar axis or a Data axis).
  • For data in a Line or Bubble series, X is a number or a Data, again depending on the type of axis it's being plotted againse
  • For data in a Candle series, X is a Date
When specifying a date the format must be unambiguous. ISO8601 is acceptable, as is RFC822 and the common formats "yyyy-MM-dd HH:mm" and "dd-MMM-yyyy"
y Real or Date optional XML / Tag Library

Description

In an AxesGraph, The Y value of the Data. If the "y" attribute is not specified, some other appropriate attributes must be set to determine the Y value of the data ("min" and "max" for instance).
min Real or Date optional XML / Tag Library

Description

  • When plotting bars in a Bar series, if the "y" attribute is not specified the "min" and "max" attributes may be specified to position the bar so that it "floats" above the X axis.
  • When plotting bars in a Candle series, the "min" value specifies the minimum trading price for that day.
  • When plotting bars in a Box-Whisker series, the "min" value specified the extent of the bottom whisker.

See Also

max Real or Date optional XML / Tag Library

Description

  • When plotting bars in a Bar series, if the "y" attribute is not specified the "min" and "max" attributes may be specified to position the bar so that it "floats" above the X axis.
  • When plotting bars in a Candle series, the "max" value specifies the maximum trading price for that day.
  • When plotting bars in a Box-Whisker series, the "max" value specified the extent of the top whisker.

See Also

open Real optional XML / Tag Library

Description

When plotting bars in a Candle series, the "open" value specifies the opening price for that day.

See Also

close Real optional XML / Tag Library

Description

When plotting bars in a Candle series, the "close" value specifies the closing price for that day.

See Also

middle Real optional XML / Tag Library

Description

When plotting bars in a Box Whisker series, the "middle" attribute is mandatory and specifies the middle of the bar (typically representing the median value).

See Also

top Real optional XML / Tag Library

Description

When plotting bars in a Box Whisker series, the "bottom" and "top" attributes are mandatory and specify the top and bottom of the box component.

See Also

bottom Real optional XML / Tag Library

Description

When plotting bars in a Box Whisker series, the "bottom" and "top" attributes are mandatory and specify the top and bottom of the box component.

See Also

upper Real optional XML / Tag Library

Description

When plotting bars in a Box Whisker series, the "lower" and "upper" attributes may optionally be specified to set the "shoulders" of the box. When these are used they typically represent the 25th and 75th percentile, while the "top" and "bottom" values represent the 95th and 5th.

See Also

lower Real optional XML / Tag Library

Description

When plotting bars in a Box Whisker series, the "lower" and "upper" attributes may optionally be specified to set the "shoulders" of the box. When these are used they typically represent the 25th and 75th percentile, while the "top" and "bottom" values represent the 95th and 5th.

See Also

xradius Real optional XML / Tag Library

Description

When plotting elliptical bubbles in a Bubble series, the "xradius" attribute determines the width of the bubble.

See Also

yradius Real optional XML / Tag Library

Description

When plotting elliptical bubbles in a Bubble series, the "yradius" attribute determines the height of the bubble.

See Also

xrange Real optional XML / Tag Library

Description

When plotting bubbles in a Bubble series, the "xrange" attribute determines the length of the line extending from the bubble horizontally. Typically this would be used to indicated the maximum range on one axis. Specifying a value identical to "xradius" would result in a line that reached the edge of the bubble.

See Also

yrange Real optional XML / Tag Library

Description

When plotting bubbles in a Bubble series, the "yrange" attribute determines the length of the line extending from the bubble vertically. Typically this would be used to indicated the maximum range on one axis. Specifying a value identical to "yradius" would result in a line that reached the edge of the bubble.

See Also

radius Real optional XML / Tag Library

Description

When plotting bubbles in a Bubble series, the "radius" attribute determines the width and height of the bubble. For elliptical bubbles you can use the "xradius" and "yradius" attributes.

See Also

key String optional XML / Tag Library

Description

In a PieGraph, the name of the Slice. This value is required

See Also

value Real > 0 optional XML / Tag Library

Description

In a PieGraph, the value of the Slice. This value is required

See Also

extend Real >= 0 optional XML / Tag Library

Description

In a PieGraph, how far to extend the slice away from the center of the pie. The value is a percentage of the radius of the pie, so "20" extends the slice 20% from the middle, "100" extends it 100% from the middle

Examples

Example: A PieGraph with the citrus fruit extended away from the middle
<piegraph width="300" height="300">
  <data key="Apples" value="20" />
  <data key="Oranges" value="38" extend="15" />
  <data key="Bananas" value="24" />
  <data key="Watermelon" value="12" />
  <data key="Lemons" value="3" extend="15" />
</piegraph>

See Also

innerradius Real optional XML / Tag Library

Description

For piegraphs only, this attribute may be used to set the size of the "doughnut hole" for this slice. This value will override the "doughnut" attribute on the piegraph for this slice and can range from 0 (the default, to draw a whole slice) to the value of "outerradius"

See Also

outerradius Real optional XML / Tag Library

Description

For piegraphs only, this attribute may be used to set the size of the outer radius for this slice. The default value of 100 is used for all slices, but the value can be reduced to make a slice that protudes less from the center of the pie, or set to greater than 100 to produce a similar effect to "extend".

See Also

color Paint optional XML / Tag Library

Description

The paint to use as the fill color for the specified object
bordercolor Color optional XML / Tag Library

Description

The color to use as the border color for the specified object. May be "none" to not draw a border for this object.
linethickness Real > 0 optional XML / Tag Library

Description

The thickness to draw the borders for this object, except for lineseries and functionseries objects when the graph is being drawn in 2D, in which case this attribute, as you would expect, sets the thickness of the lines.
dash Real[] optional XML / Tag Library

Description

The dashing pattern to use to draw the borders for this object (for 2D lineseries this functions the same as the linethickness attribute). An even number of parameters that are > 0 must be specified, where the first in each pair is the length of the dash, the second is the length of the space. Examples would be dash="5,5" to create a regular dash pattern, or dash="6,2,2,2" to create a dash/dot type pattern.
overflow Boolean optional XML / Tag Library

Description

If overflow is set to true, the item which it refers to will not play a part in the sizing algorithm used to ensure the graph fits the image: the item may overflow the edge of the graph. This makes sense only in a few situations, eg markers, lines and sometimes text, and should be used with caution.
href URI optional Tag Library Only

Description

Used in interactive graphs to turn a region of the graph into a hyperlink.
target frame-target optional Tag Library Only

Description

Used in interactive graphs to set the target of a href.
title Text optional Tag Library Only

Description

The "title" attribute of the image
onclick script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the click event occurs on a region of the graph
ondblclick script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the dblclick event occurs on a region of the graph
onkeydown script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the keydown event occurs on a region of the graph
onkeypress script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the keypress event occurs on a region of the graph
onkeyup script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the keyup event occurs on a region of the graph
onmousedown script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mousedown event occurs on a region of the graph
onmousemove script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mousemove event occurs on a region of the graph
onmouseout script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mouseout event occurs on a region of the graph
onmouseover script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mouseover event occurs on a region of the graph
onmouseup script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mouseup event occurs on a region of the graph
Big Faceless Graph Library 2.3 Tag Documentation - Copyright © 2006 Big Faceless Organization