KavaChart in Action - Examples and Documentation - AlaCarte

[ Back ] Timeseries Applet Collection - Line & Scatter Charts

Line charts are one of the most basic and versatile chart types. They can be used to display trends over time, to correlate one variable with another, or to find clusters of information. KavaChart's timeseries line chart collection includes date line charts that handle discontinuities.

KavaChart AlaCarte's Timeseries applet collection includes the following line chart applets:

  • com.ve.kavachart.applet.dateLineApp
  • com.ve.kavachart.applet.disDateLineApp
  • com.ve.kavachart.applet.scrollingDateLine
  • com.ve.kavachart.applet.twinAxisDateLineApp
  • com.ve.kavachart.applet.twinAxisDateComboApp
  • com.ve.kavachart.applet.StripChart

Use the source code to this page as a guide in creating your own line charts. You can also use the KavaChart ChartWizard to design your own line charts.

One of the most useful timeseries charts is "dateLineApp". This chart automatically converts time oriented data into comprehensible line charts. This sample shows wind data from a bouy outside Monterey Bay in California.

Like all time oriented charts, data can be supplied through the params "dataset0dateValues" and "dataset0yValues", or through external data sources, using "customDatasetHandler" to point to the file or URL that contains your data. If you're pointing to an external file, you can re-read the file periodically by using the param "networkInterval" to define how many seconds you want to use as a data refresh rate.

This chart uses "dataset0dateValues", along with "inputDateFormat" to define how the incoming timestamps are formatted. It also uses "dwellLabelDateFormat" to define the dwell labels. The axis date formatting is left to a default value.

A time oriented chart scans your data to create a meaningful time or date oriented axis. In our case, the axis interval is one day. Depending on your data, this interval could be one week, a couple of days, a year, a quarter, 5 seconds, or some other meaningful value. The axis extends a bit past the end of our data, and starts a bit before our data to make sure the axis starts and ends on a one day interval, since that's appropriate for these particular charts.

If you want an axis that uses a different interval, you can set "scalingType". If you want to use a different axis range, you can use "startDate" and "endDate" parameters.

If your data contains discontinuities, just use an unparseable number in place of a Y value ("x", for example), and use "disDateLineApp", which processes the discontinuities as line breaks.

<-- input data starts here -->

<-- input data starts here -->

The KavaChart timeseries collection is particularly useful when combined with data polling. By setting the "networkInterval" param, the applet will poll a URL for new data at a specified number of seconds. Timeseries applets can accept either replacement data, or additional data, via the "incrementalDataURL" param.

The "StripChart" applet is especially good at handling relatively rapid updates. The chart data is drawn end-to-end on the plotarea, and the time axis labels shift along the axis to keep step with the data.


This chart compares wind data with wave heights over a 5 day period. Since winds gust up to about 30 MPH, while swells only range up to about 4.5 meters, the wave data would be completely lost if use use the same scale. By using 2 axes, the wind and wave data can be visually compared together.

Data is assigned to the right hand axis with the param "dataset0OnRight". The right hand axis is referred to as the "auxAxis" in style and option parameters, such as "auxAxisStart", "auxAxisGridColor", and so on.

Time oriented twin axis charts are suitable for a wide range of applications in energy, environmental science, and finance. This applet is "twinAxisDateLineApp".

Time and date oriented twin axis charts use the same conventions as other time oriented applets: "inputDateFormat", "axisDateFormat" and "dwellLabelDateFormat" govern the presentation of the time information. Data comes from "customDatasetHandler" or "dataset0dateValues". URL oriented data can be read and re-read using the "networkInterval" parameter.

<-- input data starts here -->

This chart combines various data types. In this case we're comparing prices and volume in the same chart. Prices are in the $30 to $100 range, while volumes range up to about 15,000,000. Clearly, two axes are needed.

This chart uses lines and bars. Lines convey trend data while bars communicate discrete point observations. This applet, "twinAxisDateComboApp" also uses a time oriented X axis, which is appropriate for many kinds of financial and environmental data.

By default, this applet uses a special symbol format on the axis to represent very large numbers: 1,000,000 becomes 1M, and so on. This applet also lets you represent both line and bar (stick) data on either axis. The param "dataOnRight" assigns data to the right axis. This axis is referred to as the "auxAxis" in other parameters, such as "auxAxisGridColor", and so on. The param "dataset0Type" assigns dataset 0 to be either "Stick" or "Line".


This chart uses a definition identical to the first chart on this page, except that it adds a scrollbar to window through the data. Scrolled line charts are good for handling voluminous data, and provide utility you can't obtain with an image server.

<-- input data starts here -->