ChartDirector 7.0 (PHP Edition)

Waterfall Chart




This example demonstrates creating a multi-color waterfall chart.

This chart is created as a multi-color box-whisker layer using XYChart.addBoxWhiskerLayer2. Only the "box" part of the box-whisker layer is used.

The top-edges of the boxes are obtained by accumulating the raw data using the ArrayMath utility. The bottom-edges of the boxes are simply the top-edges of previous boxes, with the exception of the last "total" box which always starts at 0.

Source Code Listing

[File: phpdemo/waterfall.php]
<?php require_once("../lib/phpchartdir.php"); # 4 data points to represent the cash flow for the Q1 - Q4 $data = array(230, 140, 220, 330, 150); # We want to plot a waterfall chart showing the 4 quarters as well as the total $labels = array("Product 1", "Product 2", "Product 3", "Product 4", "Product 5", "Total"); # The top side of the bars in a waterfall chart is the accumulated data. We use the ChartDirector # ArrayMath utility to accumulate the data. The "total" is handled by inserting a zero point at the # end before accumulation (after accumulation it will become the total). $boxTop = (new ArrayMath($data))->insert2(0, 1)->acc()->result(); # The botom side of the bars is just the top side of the previous bar. So we shifted the top side # data to obtain the bottom side data. $boxBottom = (new ArrayMath($boxTop))->shift(1, 0)->result(); # The last point (total) is different. Its bottom side is always 0. $boxBottom[count($boxBottom) - 1] = 0; # Create a XYChart object of size 500 x 280 pixels. Set background color to light blue (ccccff), # with 1 pixel 3D border effect. $c = new XYChart(500, 290, 0xccccff, 0x000000, 1); # Add a title to the chart using 13 points Arial Bold Itatic font, with white (ffffff) text on a # deep blue (0x80) background $c->addTitle("Product Revenue - Year 2004", "Arial Bold Italic", 13, 0xffffff)->setBackground( 0x000080); # Set the plotarea at (55, 50) and of size 430 x 215 pixels. Use alternative white/grey background. $c->setPlotArea(55, 45, 430, 215, 0xffffff, 0xeeeeee); # Set the labels on the x axis using Arial Bold font $c->xAxis->setLabels($labels)->setFontStyle("Arial Bold"); # Set the x-axis ticks and grid lines to be between the bars $c->xAxis->setTickOffset(0.5); # Use Arial Bold as the y axis label font $c->yAxis->setLabelStyle("Arial Bold"); # Add a title to the y axis $c->yAxis->setTitle("USD (in millions)"); # Add a multi-color box-whisker layer to represent the waterfall bars $layer = $c->addBoxWhiskerLayer2($boxTop, $boxBottom); # Put data labels on the bars to show the cash flow using Arial Bold font $layer->setDataLabelFormat("{={top}-{bottom}}M"); $layer->setDataLabelStyle("Arial Bold")->setAlignment(Center); # Output the chart $viewer = new WebChartViewer("chart1"); $viewer->setChart($c, SVG); # Include tool tip for the chart $viewer->setImageMap($c->getHTMLImageMap("", "", "title='{xLabel}: {={top}-{bottom}} millions'")); ?> <!DOCTYPE html> <html> <head> <title>Waterfall Chart</title> <!-- Include ChartDirector Javascript Library to support chart interactions --> <script type="text/javascript" src="cdjcv.js"></script> </head> <body style="margin:5px 0px 0px 5px"> <div style="font:bold 18pt verdana;"> Waterfall Chart </div> <hr style="border:solid 1px #000080; background:#000080" /> <div style="font:10pt verdana; margin-bottom:1.5em"> <a href="viewsource.php?file=<?=basename(__FILE__)?>">View Chart Source Code</a> </div> <!-- ****** Here is the chart image ****** --> <?php echo $viewer->renderHTML(); ?> </body> </html>