Alias: boxandwhisker2d

Example of Box and Whisker 2D Chart:

JavaScript embedding code:

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

Data for this chart:

• JSON
• XML

Chart Attributes

Functional Attributes

These attributes let you 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.

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 customize the cosmetic properties for the x-axis name.

Y-axis Name Cosmetics

These attributes let you customize the cosmetic properties for the y-axis name.

Chart Cosmetics

These attributes let you customize chart cosmetics like the background color, background alpha, canvas color, canvas alpha etc.

Data Plot Cosmetics

These attributes let you customize the cosmetics (columns, lines, area, pie or any data that you're plotting) of the data plots in the chart.

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.

Various other controls over plot cosmetics can be attained using this set of attributes.

Data Value Cosmetics

These attributes let you customize the font, background, and border cosmetics of the data values on the chart.

Divisional Lines and Grids

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 cosmetics for the divisional lines and grids.

Legend Properties

In box and whisker 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.

These attributes let you 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 the functional and cosmetic properties of tool-tips.

Data Plot Hover Effects

If you wish to show an effect on the data plot (column, line anchor, pie etc.) when the user hovers his mouse over it, you can apply the hover effects to a data plot.

These attributes let you configure the hover effect 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.

The <categories> Element

The <categories> element lets you bunch together x-axis labels of the chart. For a multi-series chart, it is 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.

The <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.

The <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.

The <set> element

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

For a single series chart, a typical <set> element will look like:

<set label='January' value='17400' />

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.