Dial Chart
Dial Chart
The dial chart plots a single value on gauge-type image, similar to an odometer. The value needle that represents the value positions itself between the maximum and minimum values for the dial, as specified in the dataset.
Dataset Guidelines
The dial chart expects one row of data with three columns. The value to plot is in the first numeric column. The second column value is the minimum value on the dial, and the third column value is the maximum value on the dial.
Note: the charting component will attempt to convert dial chart values to a numeric value. Acceptable values are locale-specific numeric or currency values, e.g. "1,500", "1.500" or "$1,500". Dial charts are the only type of charts that accept formatted numeric values at this time.
here is a sample dial dataset:
DIAL_VALUE |
DIAL_MIN |
DIAL_MAX |
---|---|---|
57.0 |
0 |
100 |
Required Properties
The only property a dial chart requires is the appropriate chart-type.
<chart-type>DialChart</chart-type>
The optional chart properties that are supported for this chart are listed in the Chart Properties Reference.
Example
The following chart definition will produce the chart you see below:
<chart> <chart-type>DialChart</chart-type> <units></units> <!-- this is the color of the needle --> <needle-color>#000080</needle-color> <!-- this is the background for the whole image --> <!-- chart-background type="color">#ffffff</chart-background> --> <chart-background type="gradient"> <x1>0.0</x1> <y1>0.0</y1> <color1>#dddddd</color1> <x2>100.0</x2> <y2>100.0</y2> <color2>#FFFFFF</color2> <cyclic>true</cyclic> </chart-background> <!-- this ia the background for the dial --> <plot-background type="gradient"> <color1>#000000</color1> <color2>#FFFFFF</color2> <cyclic>true</cyclic> </plot-background> <!-- intervals define ranges on the dial that are colored differently from the dial background --> <intervals> <interval> <label>low</label> <!-- this is the value that the range starts at --> <minimum>0</minimum> <!-- this is the value that the range stops at --> <maximum>30</maximum> <!-- this is the color of the range --> <!-- color>#ff8080</color --> <interval-background type="gradient"> <x1>50</x1> <y1>50</y1> <x2>150</x2> <y2>150</y2> <color1>#ffffff</color1> <color2>#ff0000</color2> <cyclic>true</cyclic> </interval-background> <!-- this is the color of the text for the range value and tick marks --> <text-color>#0000bb</text-color> </interval> <interval> <label>medium</label> <minimum>30</minimum> <maximum>70</maximum> <!-- color>#ffff80</color --> <text-color>#0000bb</text-color> <interval-background type="gradient"> <x1>50</x1> <y1>50</y1> <x2>150</x2> <y2>150</y2> <color1>#ffffff</color1> <color2>#ffff00</color2> <cyclic>true</cyclic> </interval-background> </interval> <interval> <label>high</label> <minimum>70</minimum> <maximum>100</maximum> <text-color>#0000bb</text-color> <interval-background type="gradient"> <x1>50</x1> <y1>50</y1> <x2>150</x2> <y2>150</y2> <color1>#ffffff</color1> <color2>#40FF40</color2> <cyclic>true</cyclic> </interval-background> </interval> </intervals> </chart>