ALIAS: errorline

Example of Error Line Chart:

JavaScript embedding code:

    <script type="text/javascript">
    FusionCharts.ready(function(){
        var myChart = new FusionCharts({
            "type": "errorline",
            "dataFormat": "jsonurl",
            "dataSource": "chartdata.json"
            });
        });
    </script>

Data for this chart:

• JSON
• XML

Chart Attributes

Functional Attributes

You can control a variety of functional elements on the chart. For example, you can opt to show/hide data labels, data values, y-axis values. You can also set chart limits and extended properties.

These attributes let you control the functional properties of an error line chart.

Chart Titles and Axis Names

These attributes let you control the various headings and titles of chart like caption, sub-caption, x-axis and y-axis names etc.

Chart Caption Cosmetics

These attributes let you configure the cosmetics of chart caption and sub-caption.

X-axis Name Cosmetics

These attributes let you control the X-Axis name cosmetics.

Y-axis Name Cosmetics

These attributes let you control the Y-Axis name cosmetics.

Chart Cosmetics

These attributes let you configure chart cosmetics like background color, background alpha, canvas color & alpha etc.

Data Plot Cosmetics

Various other controls over plot cosmetics can be attained using this set of attributes. If the plots can show borders, you can control the border properties using the attributes listed below. Or, if they support gradient fills, you can again configure various properties of the gradient using these attributes.

These attributes let you configure how your plot (columns, lines, area, pie or any data that you're plotting) will appear on the chart.

Data Value Cosmetics

These attributes let you configure font, background and border cosmetics, of value text-field that appear for each data plot.

Anchors

If the price is plotted as line chart, anchors (or marker points) are polygons which appear at the joint of two consecutive line points. These are indicators to show the position of data points.

The anchors handle tool tips and links for the data points. So, if you opt to not render anchors on a chart, the tool tips and links won't function. You can, however, hide them by setting alpha to 0 and still enable tool tips and links.

These attributes let you represent data point in a line/spline/area chart.

Divisional Lines & Grids

You can control various properties of divisional lines, zero plane, and alternate color bands.

Divisional Lines are horizontal or vertical lines running through the canvas. Each divisional line signifies a smaller unit of the entire axis thus aiding the users in interpreting the chart.

The zero plane is a 2D/3D plane that signifies the 0 position on the chart. If there are no negative numbers on the chart, you won't see a visible zero plane.

Alternate color bands are colored blocks between two successive divisional lines.

These attributes let you configure the divisional lines and grids in a chart.

Legend Properties

In error line chart, the series name of each data-set shows up in the legend of the chart. If you do not need the legend, you can opt to hide the same.

Also, the legend can be placed at the bottom of the chart or to the right of the chart.

These attributes let you configure the functional and cosmetic properties for the legend.

Number Formatting Properties

FusionCharts XT offers you a lot of options to format your numbers on the chart.

Using the attributes below, you can control a myriad of options like:

• Formatting of commas and decimals
• Number prefixes and suffixes
• Decimal places to which the numbers will round to
• Scaling of numbers based on a user defined scale
• Custom number input formats

These attributes let you appropriately format the numbers displayed on the chart.

Font Properties

These attributes let you define the generic font properties for all the text on the chart, allowing you a high level control over font properties.

Tool-tip Properties

These attributes let you configure tool-tip properties.

Data Plot Hover Effects

You can show an effect on the data plot (column, line anchor, pie etc.) when the user hovers his mouse over the data plot using hover effects of data plots.

These attributes let you configure the cosmetics of the hover for all data plots in the chart.

Chart Padding & Margins

PowerCharts XT allows you to manually customize the padding of various elements on the chart to allow advanced manipulation and control over chart visualization. Padding in PowerCharts XT is always defined in pixels, unless the attribute itself suggests some other scale (like plotSpacePercent).

You can also define the chart margins. Chart margins refer to the empty space left on the top, bottom, left, and right of the chart. That means, PowerCharts XT will not plot anything in that space.

It is not necessary for you to specify any padding/margin values. PowerCharts XT automatically assumes the best values for the same.

These attributes let you configure the functional and cosmetic properties of chart paddings and margins.

<categories> element

The <categories> element lets you bunch together x-axis labels of the chart. For a multi-series chart, it's necessary to provide data labels using <category> elements under <categories> element.

These attributes of the <categories> element let you control the font properties of data labels.

<category> element

Each <category> element represents an x-axis data label.

In a multi-series chart, it's necessary to provide an equal number of <category> elements and data items ( <set> element within each <dataset>). PowerCharts XT plots only those data items for which it could find a respective <category> element.

These attributes let you configure the <category> element.

Vertical Data Separator Lines

vLines are vertical separator lines that help you separate blocks of data. These lines run through the height of the chart, thereby segregating data into different blocks.

For example, if you're plotting a chart showing monthly sales from October 2005-Mar 2006, you might want to plot a vertical separator line between Dec 2005 and January 2006 to indicate end of year.

Use the code snippet shown below to render a vertical data separator line on the chart:

    "data": [{
                "label": "Fri",
                "value": "5529"
            },
            {
                 "vline": "true",
                 "linePosition": "0.8",
                 "color": "#333333",
                 "thickness": "1"
            },
            {
                "label": "Sat",
                "value": "5803"
            }];

These attributes let you configure the vertical data separator lines cosmetics for the chart.

<dataset> element

Each <dataset> element contains a series of data.You can provide data-set level cosmetics so that all data within that data-set will be plotted in the same color/alpha/etc.

These properties let you configure a <dataset> element.

<set> element

Each <set> element (child of <chart> or <dataset> element) represents a set of data which is to be plotted on the graph and determines a set of data which would appear on the chart.

In error charts, along with the chart data, we also plot the range of possible error as the value of errorValue attribute in the respective <set> elements.

For an error line chart, it could look like:

<dataset seriesName='Series 1'>
    <set value='35445' errorValue='4356' />
    <set value='35675' errorValue='2355' />
    .... and so on ....
</dataset>

These attributes let you configure the <set> element.

Trend-lines

Using the <trendlines> element (and children <line> elements), you can define trend-lines on the chart.

Trend-lines are horizontal lines spanning the chart canvas which aid in interpretation of data with respect to some pre-determined value. For example, if you are plotting sales data of current year, you might want to add previous year's average monthly sales as trend indicator for ease of comparison.

Use the code snippet shown below to render a trend-line on the chart:

    "trendlines": [{
     "line": [{
                "startvalue": "177500",
                 "color": "#9b59b6",
                 "displayvalue": "Target"
             }]
                    }]

These attributes let you configure the trend-line cosmetic and functional properties.