ALIAS: realtimeline

Example of Real Time Line Chart:

JavaScript embedding code:

    <script type="text/javascript">
    FusionCharts.ready(function(){
        var myChart = new FusionCharts({
            "type": "realtimeline",
            "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 customize the various headings and titles for a chart, like the caption, sub-caption, x-axis and y-axis names etc.

Chart Caption Cosmetics

These attributes let you customize the cosmetic properties of the chart caption and sub-caption.

X-axis Name Cosmetics

These attributes let you control the cosmetic properties for the x-axis label.

Y-axis Name Cosmetics

These attributes let you control the cosmetic properties for the y-axis label.

Chart Y-Axis

These attributes let you configure the functional properties of the y-axis.

Chart Labels and Values

Data labels refer to the names for the data points which appear on the x-axis and data values refer to the plot values i.e., values of each data plot.

These attributes let you configure the functional and cosmetic properties of chart labels and values.

Real-time Properties

The real-time feature allows you to update data for a chart at specified intervals, without any page refreshes. These attributes let you configure the real-time feature.

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.

Message Logger

FusionWidgets XT uses the concept of streaming and showing real-time messages in the chart using Message Logger. The message logger can be effectively used to show necessary real-time information or live error logs. These attributes let you to configure the message logger.

Plot (Line) Properties

These attributes let you customize the cosmetic properties of the plot (line).

Anchors

Anchors (or marker points) are polygons which appear at the joint of two consecutive lines/area 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 their transparency to 0 and still enable tool tips and links. In area charts, anchors are set transparent by default. In case you wish to show the anchor, use anchorAlpha="100" attribute.

These attributes let you configure and customize the anchors on your chart.

Chart Cosmetics

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

Canvas Cosmetics

Canvas refers to the area in which the chart is plotted.

These attributes let you customize the cosmetic properties of the chart canvas.

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.

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

These attributes let you configure the cosmetics of the divisional lines and grids.

Zero Plane Properties

The zero plane is a 2D/3D plane that signifies the 0 position on the chart which separates the positive and negative numbers on a chart having both of them. If there are no negative numbers on the chart, you won't see a visible zero plane.

These attributes let you customize the cosmetic properties of the zero plane.

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.

Legend Properties

In multi-series charts, by default, the series name of each dataset 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. Using legends you can correlate a data plot to its series name using its color representation in the legend.

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

Tool-tip Properties

These attributes let you configure the functional and cosmetic properties of tool-tips.

Chart Paddings and Margins

FusionWidgets 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 FusionWidgets 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, FusionWidgets XT will not plot anything in that space.

It is not necessary for you to specify any padding/margin values. FusionWidgets 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's necessary to provide data labels using <category> elements under <categories> element. The following properties of <categories> element help you control the font properties of data labels.

The <category> Element

Each <category> element represents an x-axis data label. In multi-series charts, it's necessary to provide an equal number of <category> elements and data items (<set> elements within each <dataset>).

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.

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

    "data": [{
        ...
    },
    {
        "linePosition": "0.8",
        "vLine": "true"
    },
    ...

These attributes let you configure the functional and cosmetic properties for vertical trend-lines and trend-zones.

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 attributes let you customize the cosmetic properties for a data-set.

The <set> Element

Each <set> element (child of <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 individual data values in a data-set.

Trend-lines

Using the <trendlines> element (and the 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 horizontal trend-line on the chart:

    ...
    "chart": {
                ...
        };

    "trendlines": [{
          "line": [{
              "startvalue": "177500",
              "color": "#00cc00",
              "displayvalue": "Target"
         }]
    }]

    ...

These attributes let you customize the functional and cosmetic properties for trend-lines.