DBIx::Chart

Perl DBI Extension For Rendering Charts and Graphs

Description
Version
Prerequisites and
  Conformance
Examples
 SQL Dialect
        SELECT
    User Defined Colors
    Imagemaps
    Error Handling
    Diagnostics
    Driver Specific
      Attributes
    Driver Specific
      Functions
 Restrictions and Limitations
Change History
Known Bugs
To Do List
Acknowledgements
References
Copyright

Last updated August 11, 2005

  

Description

DBI extension module for rendering charts directly from any DBI and SQL compatible database. DBIx::Chart extends SQL to return a VARBINARY image value using aggregate function syntax to define the type of chart, and various pseudo-columns to define the properties of the image. The following types of charts are supported (via DBD::Chart):

  • pie charts
  • bar charts
  • histograms
  • box & whisker charts
  • linegraphs
  • pointgraphs (scatter graphs)
  • areagraphs
  • candlestick graphs
  • Gantt charts
  • quadtree graphs

BE ADVISED: This is BETA software, and subject to change at the whim of the author(s).

Why DBIx::Chart ? One of the most common uses for data extracted from a database is for graphing. Until DBIx::Chart, extra software was always required, and extra programming steps needed to render those charts, and the APIs and/or tools for generating the charts usually didn't mate well with existing SQL tools. With DBIx::Chart, every DBMS looks like its got an internal rendering engine, and its all SQL based.

BTW: This driver is 100% pure Perl.

 

Current Version

Release 0.03

ZIP version
.tar.gz version

Prerequisites and Conformance

DBIx::Chart requires the following Perl modules(versions are recommended only, cuz they're the version I built with...if you're feeling frisky, you can try older or newer versions.):

  • Perl version 5.6.0
  • DBI version 1.28.
  • DBD::Chart 0.80
  • GD module 1.32
  • GD::Text (aka GDTextUtil) module 0.80
  • Time::Local
  • DBD::CSV 1.024 (for running the test script)
In addition, the following (non-Perl) libraries are required:

Since DBIx::Chart is a simple subclass of DBI, all the usual DBI functions are supported.

EXAMPLES

Refer to the included t/plottest.t test script for complete details of connecting, populating datapoints, send fetching the image and any associated imagemap. Here's a bit of code to generate a piechart from an Oracle connection:

use DBIx::Chart;
my $dbh = DBIx::Chart->connect('dbi:Oracle:bunceville', $user, $pass)
    or die "Cannot connect\n";
#
#    example: create a pie chart
#
$rsth = $dbh->prepare(
"SELECT region, sum(sales) FROM widget_sales_tbl
 WHERE year=2002 AND product='widgets'
 GROUP BY region
 RETURNING PIECHART(*)
 WHERE WIDTH=400 AND HEIGHT=400 AND
 TITLE = '2002 Widget Sales By Region' AND
 COLOR IN ('red', 'green', 'blue', 'lyellow', 'lpurple') AND
 BACKGROUND='lgray' AND
 SIGNATURE='Copyright(C) 2001, GOWI Systems, Inc.'");
$rsth->execute;
$rsth->bind_col(1, \$buf);
$rsth->fetch;

The following set of charts were rendered using the SQL statement to the chart's right.

ChartRendering SQL
simpline 
select * from simpline
    returning linegraph(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Linegraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND LOGO='t/gowilogo.png'
    AND FORMAT='PNG'
    AND SHOWGRID=1
    AND LINEWIDTH=4
    AND MAPNAME='simpline'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLOR='newcolor'
    AND SHAPE='fillcircle'
    AND SHOWVALUES=1
simpscat 
select * from simpline
    returning pointgraph(x,y), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    and Y_AXIS='Some Range'
    AND TITLE='Scattergraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND LOGO='t/gowilogo.png'
    AND FORMAT='PNG'
    AND SHOWGRID=0
    AND MAPNAME='simpscat'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND SHOWVALUES=1
simparea 
select * from simpline
    returning areagraph(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Areagraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND LOGO='t/gowilogo.png'
    AND FORMAT='PNG'
    AND SHOWGRID=1
    AND MAPNAME='simparea'
    AND COLOR='newcolor'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML' AND SHOWVALUES=0
symline 
select * from symline
    returning linegraph(*), imagemap
    where WIDTH=500 AND HEIGHT=500
    AND X_AXIS='Some Domain'
    and Y_AXIS='Some Range'
    AND TITLE='Symbolic Domain Linegraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND LOGO='t/gowilogo.png'
    AND FORMAT='PNG'
    AND SHOWGRID=1
    AND MAPNAME='symline'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML' AND COLOR=newcolor AND SHAPE=fillcircle
simpbar 
select * from symline
    returning barchart(*), imagemap
    where WIDTH=500 AND HEIGHT=500
    AND X_AXIS='Some Domain'
    and Y_AXIS='Some Range'
    AND TITLE='Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND MAPNAME='simpbar'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML' AND COLOR=newcolor
iconbars 
select * from symline
    returning barchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    and Y_AXIS='Some Range'
    AND TITLE='Iconic Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND ICON='t/pumpkin.png'
    AND MAPNAME='iconbars'
    AND SHOWGRID=1
    AND GRIDCOLOR='blue'
    AND TEXTCOLOR='dbrown'
    AND MAPSCRIPT='ONCLICK="alert(''Got X=:X, Y=:Y'')"'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
iconhisto 
select * from symline
    returning histogram(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Iconic Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND ICON='t/pumpkin.png'
    AND MAPNAME='iconhisto'
    AND SHOWGRID=1
    AND GRIDCOLOR='red'
    AND TEXTCOLOR='newcolor'
    AND MAPSCRIPT='ONCLICK="alert(''Got X=:X, Y=:Y'')"'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
simpbox 
select * from simpbox
    returning boxchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND TITLE='Boxchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND COLORS IN ('newcolor', 'red')
    AND SHOWVALUES=1
    AND MAPNAME='simpbox'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
simpcandle 
select * from simpcandle
    returning candlestick(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS = 'Price'
    AND TITLE='Candlestick Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND COLORS IN ('newcolor')
    AND SHAPE='fillsquare'
    AND SHOWVALUES=1
    AND SHOWGRID=1
    AND MAPNAME='simpcandle'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
simppie 
select * from simppie
    returning piechart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND TITLE='Piechart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND COLORS IN ('red', 'blue', 'newcolor', 'green', 'yellow')
    AND MAPNAME='simppie'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
pie3d 
select * from simppie
    returning piechart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND TITLE='3-D Piechart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND COLORS IN ('red', 'blue', 'newcolor', 'green', 'yellow')
    AND THREE_D=1
    AND MAPNAME='pie3d'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
bar3d 
select * from simpline
    returning barchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='3-D Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND COLORS IN ('orange')
    AND THREE_D=1
    AND SHOWGRID=1
    AND MAPNAME='bar3d'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
bar3axis 
select * from bar3axis
    returning barchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='3 Axis Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Region'
    AND Y_AXIS='Sales'
    AND Z-AXIS='Quarter'
    AND FORMAT='PNG'
    AND COLORS IN ('red')
    AND SHOWGRID=1
    AND SHOWVALUES=1
    AND MAPNAME='bar3axis'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
simphisto 
select * from simppie
    returning histogram(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND COLOR IN ('red', 'green', 'orange', 'blue', 'newcolor')
    AND SHOWGRID=1
    AND SHOWVALUES=1
    AND MAPNAME='simphisto'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
histo3d 
select * from simppie
    returning histogram(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND COLOR='orange'
    AND THREE_D=1
    AND SHOWGRID=1
    AND SHOWVALUES=1
    AND MAPNAME='histo3d'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
histo3axis 
select * from bar3axis
    returning histogram(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='3 Axis Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Region'
    AND Y_AXIS='Sales'
    AND Z_AXIS='Quarter'
    AND FORMAT='PNG'
    AND COLORS='red'
    AND SHOWGRID=1
    AND SHOWVALUES=1
    AND MAPNAME='histo3axis'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
templine 
select * from templine
    returning linegraph(xdate, y), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Temporal Domain Linegraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND X_ORIENT='VERTICAL'
    AND LOGO='t/gowilogo.png'
    AND FORMAT='PNG'
    AND COLORS=newcolor
    AND SHOWGRID=1
    AND SHOWVALUES=1
    AND MAPNAME='templine'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
templine2 
select * from templine2
    returning linegraph(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Temporal Range Linegraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND X_ORIENT='VERTICAL'
    AND LOGO='t/gowilogo.png'
    AND FORMAT='PNG'
    AND COLORS=newcolor
    AND SHOWGRID=1
    AND SHOWVALUES=1
    AND SHAPE=fillcircle
    AND MAPNAME='templine2'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
logtempline 
select * from logtempline
    returning linegraph(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Logarithmic Temporal Range Linegraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND X_ORIENT='VERTICAL'
    AND Y-LOG=1
    AND FORMAT='PNG'
    AND COLORS=newcolor
    AND SHOWGRID=1
    AND SHOWVALUES=1
    AND SHAPE=fillcircle
    AND MAPNAME='logtempline'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
tempbar 
select * from templine
    returning barchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Temporal Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND COLORS=red
    AND SHOWVALUES=1
    AND MAPNAME='tempbar'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
temphisto 
select * from templine2
    returning histogram(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Temporal Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND COLORS=blue
    AND SHOWVALUES=1
    AND MAPNAME='temphisto'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
complinept 
select * from
    (select * from simpline
    returning linegraph(*)
        where color=newcolor
        AND shape='fillcircle') simpline,
    (select  * from simppie
    returning pointgraph(*)
        where color=blue
        AND shape='opensquare') simppt
    returning image, imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Line/Pointgraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND MAPNAME='complinept'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
complpa 
select * from
    (select * from simpline
    returning linegraph(*)
        where color=newcolor
        AND shape=fillcircle) simpline,
    (select * from simppie
    returning pointgraph(*)
        where color=blue
        AND shape=opensquare) simppt,
    (select * from complpa
    returning areagraph(*)
        where color=red) simparea
    returning image, imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Line/Point/Areagraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND MAPNAME='complpa'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
compblpa 
select * from
    (select * from simpline
    returning linegraph(*)
        where color=newcolor
        AND shape=fillcircle) simpline,
    (select * from simppie
    returning pointgraph(*)
        where color=blue
        AND shape=opensquare) simppt,
    (select * from complpa
    returning areagraph(*)
        where color=green) simparea,
    (select * from complpa
    returning barchart(*)
        where color=red) simpbar
    returning image, imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Bar/Line/Point/Areagraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND MAPNAME='compblpa'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
complnbox 
select * from
    (select * from complnbox
    returning linegraph(*)
    where color=red
    AND shape=fillcircle) simpline,
    (select * from simpbox
    returning boxchart(*)
        where color=newcolor) simpbox
    returning image, imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Box
    AND Line Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND MAPNAME='complnbox'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
compllbb 
select * from
    (select * from complnbox
    returning linegraph(*)
    where color=newcolor
    AND shape=fillcircle
        and showvalues=1) simpline,
    (select * from simpbox
    returning boxchart(*)
    where color=newcolor) simpbox,
    (select * from compllbb
    returning linegraph(*)
    where color=red
    AND shape=fillcircle
        and showvalues=0) simpline2,
    (select * from simpbox2
    returning boxchart(*)
    where color=red) simpbox2
    returning image, imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Multiple Box
    AND Line Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND MAPNAME='compllbb'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
comphisto 
select * from
    (select * from simppie returning histogram(*)
        where color=red) histo1,
    (select * from complpa returning histogram(*)
        where color=blue) histo2
    returning image, imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND THREE_D=1
    AND SHOWVALUES = 1
    AND MAPNAME='comphisto'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
compbars 
select * from
    (select * from simppie
    returning barchart(*)
        where color=red) bars1,
    (select * from complpa
    returning barchart(*)
        where color=blue) bars2
    returning image, imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND SHOWVALUES = 1
    AND SHOWGRID=1
    AND MAPNAME='compbars'
    AND ICONS=('t/pumpkin.png', 't/turkey.png' )
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
denseline 
select * from
    (select * from densesin
    returning linegraph(*)
        where color=red) densesin,
    (select * from densecos
    returning linegraph(*)
        where color=blue) densecos
    returning image
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Dense Linegraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Angle (Radians)'
    AND Y_AXIS='Sin/Cos'
    AND FORMAT='PNG'
densearea 
select * from
    (select * from densesin
    returning areagraph(*)
        where color=red) densesin,
    (select * from densecos
    returning areagraph(*)
        where color=blue) densecos
    returning image
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Composite Dense Areagraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Angle (Radians)'
    AND Y_AXIS='Sin/Cos'
    AND FORMAT='PNG'
simpgantt 
select * from simpgantt
    returning gantt(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Simple Gantt Chart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Tasks'
    AND Y_AXIS='Schedule'
    AND COLOR=red
    AND LOGO='t/gowilogo.png'
    AND MAPNAME='simpgantt'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND X_ORIENT='VERTICAL'
    AND FORMAT='PNG'
stackbar 
select * from stackbar
    returning barchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Stacked Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND MAPNAME='stackbar'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('yellow', 'blue')
stackicon 
select * from stackbar
    returning barchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    and Y_AXIS='Some Range'
    AND TITLE='Stacked Iconic Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND ICONS IN ('t/pumpkin.png', 't/turkey.png')
    AND MAPNAME='stackbar'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
stackarea 
select * from stackbar
    returning areagraph(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Stacked Areagraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND MAPNAME='stackarea'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('red', 'green')
stackhisto 
select * from stackbar
    returning histogram(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Stacked Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND MAPNAME='stackhisto'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('red', 'green')
stackcandle 
select * from stackcandle
    returning candlestick(*), imagemap
    where WIDTH=300
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS = 'Price'
    AND TITLE='Stacked Candlestick Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND COLORS IN ('newcolor', 'red')
    AND SHOWGRID=1
    AND STACK=1
    AND MAPNAME='stackcandle'
    AND LINEWIDTH=5
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
multilinemm 
select * from stackbar
    returning linegraph(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Multiline NULL Shape, Map Modifier Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND MAPNAME='multilinemm'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('red', 'green')
    AND SHAPES IN (NULL, 'filldiamond')
quadtree 
SELECT * FROM myquad
returning QUADTREE(*), IMAGEMAP
WHERE COLORS IN ('red', 'black', 'green')
    AND WIDTH=500
    AND HEIGHT=500
    AND TITLE='My Quadtree'
    AND MAPTYPE='HTML'
    AND MAPNAME='quadtree'
    AND MAPURL=
'http://www.presicient.com/cgi-bin/quadtree.pl?group=:X&item=:Y&value=:Z&intensity=:PLOTNUM'
stack3Dbar 
select * from stackbar
    returning barchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Stacked 3-D Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND THREE_D=1
    AND MAPNAME='stack3Dbar'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('yellow', 'blue')
stack3Dhisto 
select * from stackbar
    returning histogram(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Stacked 3-D Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND THREE_D=1
    AND MAPNAME='stack3Dhisto'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('red', 'green')
tmstamp 
select * from tmstamp
    returning linegraph(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Timestamp Domain Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND MAPNAME='tmstamp'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('yellow', 'blue')
floatarea 
select * from floatbar
    returning areagraph(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Floating Stacked Areagraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND ANCHORED=0
    AND MAPNAME='floatarea'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('green', 'yellow', 'red')
floathisto 
select * from floatbar
    returning histogram(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    and Y_AXIS='Some Range'
    AND TITLE='Floating Stacked Histogram Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND ANCHORED=0
    AND MAPNAME='floathisto'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('red', 'green', 'orange')
floatbar 
select * from floatbar
    returning barchart(*), imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND TITLE='Floating Stacked Barchart Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND FORMAT='PNG'
    AND SHOWVALUES=1
    AND STACK=1
    AND ANCHORED=0
    AND MAPNAME='floatbar'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
    AND COLORS IN ('yellow', 'blue', 'red')
multwidth 
select * from
    (select * from floatbar
    returning areagraph(*)
    where anchored=0
        and stack=1
    AND colors in ('blue', 'yellow', 'red')),
    (select * from regline
    returning linegraph(*)
        where color='newcolor'
    AND showvalues=1 ) regline,
    (select * from fatline
    returning linegraph(*)
        where color='lgray'
    AND linewidth=10) fatline,
    (select * from midline
    returning linegraph(*)
        where color='green'
    AND linewidth=4) midline
    returning image, imagemap
    where WIDTH=500
    AND HEIGHT=500
    AND TITLE='Variable Width Linegraph Test'
    AND SIGNATURE='(C)2002, GOWI Systems'
    AND X_AXIS='Some Domain'
    AND Y_AXIS='Some Range'
    AND FORMAT='PNG'
    AND MAPNAME='multwidth'
    AND MAPURL='http://www.gowi.com/cgi-bin/sample.pl?x=:X&y=:Y&z=:Z&plotno=:PLOTNUM'
    AND MAPTYPE='HTML'
(10,23) (20,-39) (30,102) (40,67) (50,80) (10,23) (20,-39) (30,102) (40,67) (50,80) (10,23) (20,-39) (30,102) (40,67) (50,80) 23 -39 102 67 80 23 -39 102 67 80 23 -39 102 67 80 23 -39 102 67 80 32[21.5..43.5] 10 60 41.5[25..55] 10 70 53 23 39 -39 127 102 89 67 108 80 53(12.7%) 39(9.3%) 127(30.5%) 89(21.3%) 108(25.9%) 53(12.7%) 39(9.3%) 127(30.5%) 89(21.3%) 108(25.9%) 53 39 127 89 108 (2002-12-24,23) (2002-12-25,-39) (2002-12-26,102) (2002-12-27,67) (2002-12-28,80) (2002-12-24,00:12:34) (2002-12-25,11:29:00) (2002-12-26,05:57:33) (2002-12-27,22:22:22) (2002-12-28,04:06:01) (1970-01-24,00:12:33.99) (1975-01-25,11:28:59.99) (1985-01-26,255:57:32.99) (1997-01-27,2222:22:21.99) (2030-01-28,4328:06:00.99) 23 -39 102 67 80 00:12:34 11:29:00 05:57:33 22:22:22 04:06:01 (10,23) (20,-39) (30,102) (40,67) (50,80) (10,53) (20,39) (30,127) (40,89) (50,108) (10,35) (20,45) (30,55) (40,65) (50,75) (10,23) (20,-39) (30,102) (40,67) (50,80) (10,53) (20,39) (30,127) (40,89) (50,108) 35 0 30 55 0 35 45 55 65 75 23 -39 102 67 80 53 39 127 89 108 32[21.5..43.5] 10 60 (10,2) (11,1) (12,3) (13,1) (14,2) (15,5) (16,1) (17,1) (18,2) (19,2) (20,3) (21,2) (22,4) (23,4) (24,4) (25,2) (26,0) (27,2) (28,5) (29,0) (30,2) (31,1) (32,2) (33,1) (34,2) (35,2) (36,1) (37,5) (38,4) (39,2) (40,2) (41,0) (42,0) (43,5) (44,2) (45,2) (46,1) (47,1) (48,1) (49,3) (50,3) (51,0) (52,3) (53,3) (54,1) (55,2) (56,0) (57,2) (58,0) (59,0) (60,1) 32[21.5..43.5] 10 60 40.5[23.5..55] 10 70 (10,2) (11,1) (12,3) (13,1) (14,2) (15,5) (16,1) (17,1) (18,2) (19,2) (20,3) (21,2) (22,4) (23,4) (24,4) (25,2) (26,0) (27,2) (28,5) (29,0) (30,2) (31,1) (32,2) (33,1) (34,2) (35,2) (36,1) (37,5) (38,4) (39,2) (40,2) (41,0) (42,0) (43,5) (44,2) (45,2) (46,1) (47,1) (48,1) (49,3) (50,3) (51,0) (52,3) (53,3) (54,1) (55,2) (56,0) (57,2) (58,0) (59,0) (60,1) (10,4) (11,3) (12,2) (13,5) (14,5) (15,1) (16,3) (17,5) (18,7) (19,2) (20,3) (21,4) (22,4) (23,2) (24,3) (25,3) (26,1) (27,4) (28,3) (29,2) (30,5) (31,4) (32,3) (33,6) (34,3) (35,1) (36,3) (37,1) (38,1) (39,5) (40,2) (41,3) (42,3) (43,4) (44,5) (45,5) (46,4) (47,3) (48,1) (49,4) (50,5) (51,4) (52,3) (53,2) (54,3) (55,2) (56,2) (57,7) (58,4) (59,1) (60,2) (61,2) (62,0) (63,7) (64,5) (65,2) (66,4) (67,4) (68,3) (69,2) (70,4) 53 39 127 89 108 35 45 55 65 75 2002-01-24->2002-01-31 2002-01-27->2002-02-27 2002-02-01->2002-02-25 2002-02-14->2002-03-10 2002-03-28->2002-04-15 23 35 -39 45 102 55 67 65 80 75 23 35 -39 45 102 55 67 65 80 75 23 35 -39 45 102 55 67 65 80 75 (10,88) (20,84) (30,182) (40,154) (50,183) (10,53) (20,39) (30,127) (40,89) (50,108) 53 23 88 53 39 -39 84 39 127 102 182 127 89 67 154 89 108 80 183 108 10 secs, $53 20 secs, $39 30 secs, $127 40 secs, $89 50 secs, $108 Changed it! Changed it! Changed it! Changed it! Changed it! Energy:Power Utility:Edison=800(-1.5) Energy:Oil Discovery:Schumberger=300(-1) Energy:Oil Producers:Exxon=1200(-2) Retail:Specialty:Sharper Image=100(2.3) Retail:Dept. Store:Nordstrom=400(1.2) Retail:Discount:Walmart=900(1.5) Service:Restaurant:YUM=240(1.1) Service:Media:Tribune=350(-1.3) Service:Media:Disney=690(-1) Finance:Banks:Banc of America=1400(1.7) Finance:Brokerages:Morgan Stanley=760(1) Finance:Insurance:Allianz=430(-1) Telecomm:CLEC:Verizon=1300(-1) Telecomm:Long distance:ATT=900(1.1) Telecomm:Wireless:Cingular=550(0.7) Manufacturing:Aerospace:Boeing=1600(-3) Manufacturing:Heavy Equipement:John Deere=750(0) Manufacturing:Durable Goods:Whirlpool=400(2) Manufacturing:Automotive:GM=1200(3) Manufacturing:Other:Fruit of the Loom=100(-1.4) Health Care:HMO:Kaiser=1100(2) Health Care:Services:Medical Billing Inc=250(1.2) Health Care:Hospital:Bethel=320(0.5) Health Care:Equipment:XYZ=200(-0.4) Transportation:Airlines:UAL=1000(-1) Transportation:Rails:Union Pacific=1000(2) Transportation:Trucking:Longhaul=450(1) High Tech:Hardware:Dell=800(1) High Tech:Biotech:Merck=1000(1.4) High Tech:Software:Microsoft=1200(-1.1) High Tech:Semiconductor:Intel=1000(-2.1) (10, 23) (20, -39) (30, 102) (40, 67) (50, 80) (North, 455, Q4) (East, 777, Q4) (South, 409, Q4) (West, 650, Q4) (North, 987, Q3) (East, 294, Q3) (South, 222, Q3) (West, 555, Q3) (North, 354, Q2) (East, 978, Q2) (South, 99, Q2) (West, 233, Q2) (North, 123, Q1) (East, 346, Q1) (South, 765, Q1) (West, 687, Q1) (10, 53) (20, 39) (30, 127) (40, 89) (50, 108) (North, 455, Q4) (East, 777, Q4) (South, 409, Q4) (West, 650, Q4) (North, 987, Q3) (East, 294, Q3) (South, 222, Q3) (West, 555, Q3) (North, 354, Q2) (East, 978, Q2) (South, 99, Q2) (West, 233, Q2) (North, 123, Q1) (East, 346, Q1) (South, 765, Q1) (West, 687, Q1) (10, 53) (10, 35) (20, 39) (20, 45) (30, 127) (30, 55) (40, 89) (40, 65) (50, 108) (50, 75) (10, 23) (10, 58) (20, -39) (20, 45) (30, 102) (30, 157) (40, 67) (40, 132) (50, 80) (50, 155) (10, 23) (10, 58) (20, -39) (20, 45) (30, 102) (30, 157) (40, 67) (40, 132) (50, 80) (50, 155) (2002-12-24 10:33:00,35) (2002-12-24 13:33:06,45) (2002-12-24 17:20:00,55) (2002-12-25 0:13:34,65) (2002-12-25 4:44:44,75) 30 35 -39 45 25 55 22 65 28 75 30 35 -39 45 25 55 22 65 28 75 (10,88) (20,84) (30,182) (40,154) (50,183) (10,53) (20,39) (30,127) (40,89) (50,108) (10,180) (50,180) (10,40) (50,40) (10,-10) (50,-10) (10,23) (20,-39) (30,102) (40,67) (50,80) (10,53) (20,39) (30,127) (40,89) (50,108) (10,35) (20,45) (30,55) (40,65) (50,75)

 

Driver Specific Behavior

Data Source Name

The dsn string passed to DBIx::Chart->connect() is identical to the equivalent DBI connect string.

Data Types

Refer to DBD::Chart's user guide for details regarding

  • how column data is applied to the various types of charts
  • how the data types of the columns are treated when charted
  • what chart properties can be defined and how they behave
  • how imagemaps are generated

SQL Dialect

Charts are rendered using the following SELECT statement syntax:

Simple form:

<select-stmt> RETURNING <chart-function> [, IMAGEMAP ] WHERE <chart-prop-expr> [AND ...]

Composite form:

SELECT * FROM (<chart-subquery>)[ qry-name] [, (<chart-subquery>)[ qry-name]...] RETURNING IMAGE [, IMAGEMAP] WHERE <chart-prop-expr> [AND ...]

chart-subquery := <select-stmt> RETURNING <chart-function> WHERE <chart-prop-expr> [AND ...]

chart-function := any of

  • LINEGRAPH( * | column-list )
  • AREAGRAPH( * | column-list )
  • POINTGRAPH( * | column-list )
  • BARCHART( * | column-list )
  • HISTOGRAM( * | column-list )
  • BOXCHART( * | column-list )
  • PIECHART( * | column-list )
  • GANTTCHART( * | column-list )
  • QUADTREE( * | column-list )
  • IMAGE

<select-stmt> := any valid SELECT statement, including any grouping, ordering, or other qualifiers

chart-prop-expr := <property> < = | IN > <literal-list>

literal-list := <? | literal [, literal-list ]>

(Note: support for using returned columns of a charted query to specify chart property values is planned for a future release.)

When IMAGEMAP is included in the column list, text is generated for either

  • an HTML client-side imagemap
  • a Perl compatible array of hashrefs of value and coordinate attributes
Various <properties>s from the WHERE clause provide base URL or scripting tags to be associated with the imagemap. See IMAGEMAPS below for details.

When any of the various $sth->fetch() operations is applied to the SELECT statement:

  • For PNG, JPEG, or GIF formats, images are returned as VARBINARY objects representing the binary image data.
  • Imagemaps are returned as VARCHAR objects containing the HTML imagemap text.

General Restrictions:

  • ordering of wedges and bars in pie and barcharts is determined by the order the rows are returned by the associated SELECT statement.
  • Ordering of plot points in line, area, and point graphs with numeric and temporal domains is ascending left to right on the X-axis, ascending bottom to top on Y-axis. Graphs with symbolic domains are plotted in the order they are INSERT'd.
  • When generating area graphs with multiple range valuesets (i.e., more the 1 set of Y values), the order in which the range valuesets are plotted is column 2, column 3,...column N. This order may cause some ranges to be completely obscured by the areagraph of a succeding range. You'll need to experiment with the order of your range valuesets to get the best view.
  • Support for JPEG images on Windows platforms with ActiveState Perl requires installing the Tk::JPEG PPM from ActiveState.
  • Support for GIF image formats requires a compatible version of the GD modules (pre 1.20).
  • Composite images can only be constructed from compatible chart types:
    • piecharts, Gantt charts, quadtrees, and 3-axis barcharts/histograms must be used alone (i.e., a single graph composite).
    • histograms are only compatible with other histograms
    • 3-d barcharts are only compatible with other 3-d barcharts
    • all other types are compatible with one another
  • The domain types for the individual graphs in a composite image must be compatible, i.e., numeric with numeric, temporal with temporal, and symbolic with symbolic.
  • Named derived table queries cause the specified name to be used to identify the associated plot in any legend generated for the composite image. If no name is given for a derived table query, the default name "PLOTn", where n is the sequence number of the query in the image, will be used.

Colormaps

The colors used to render the various image elments can be adjusted by the application by modifying the predefined COLORMAP table. The COLORMAP table is predefined as follows: 
CREATE TABLE CHART.COLORMAP (
	Name VARCHAR(30),	-- name of color
	RedValue INTEGER,	-- value of red component
	GreenValue INTEGER,	-- value of green component
	BlueValue INTEGER,	-- value of blue component
);
The color component values must be specified between 0 and 255.

Refer to DBD::Chart for the predefined values in the COLORMAP table.

For example, to define a new color: 

$dbh->do('INSERT INTO COLORMAP VALUES('chartreuse', 230, 179, 180);
To modify an existing color: 
$dbh->do("UPDATE COLORMAP SET REDVALUE=100 WHERE NAME='marine'");
To fetch the current values of an existing color: 
$sth = $dbh->prepare("SELECT * FROM COLORMAP NAME='marine'");
$sth->execute;
$row = $sth->fetchrow_arrayref;
Finally, a generic parameterized statement can be used to define colors at runtime: 
$sth = $dbh->prepare("INSERT INTO COLORMAP VALUES(?, ?, ?, ?)");
$sth->execute('marine', 127, 127, 255);
Note that using non-alphanumeric characters in color names may cause parsing problems, so stick to alphanumerics, e.g., 'red3'.

Error Handling

Any errors generated from improper SQL usage are flagged with an error value of -1, and appropriate text in the errstr. Errors emanating from DBI, or any underlying DBI driver, will be flagged in err and errstr with whatever info is returned.

Diagnostics

DBI provides the trace() function to enable various levels of trace information. DBIx::Chart currently doesn't add any traces to this.

Driver Specific Attributes

While the application does not have direct access to the DBD::Chart handles used by DBIx::Chart, the following attributes will be passed to DBD::Chart when provided:

  • chart_noverify
  • chart_map_modifier

Any other attributes will be passed to the driver defined by the connect() DSN string.

Restrictions and Limitations

  1. Quoted identifiers are not supported in the chart column list
  2. Expressions, literals, and placeholders are not supported in the chart column list
  3. DBIx::Chart relies on the DBI statement handle NAME and TYPE attributes to locate the specified column positions and datatypes in the returned result set. If the returned NAME strings are not fully qualified (i.e., of the form alias.columnname), DBIx::Chart currently cannot disambiguate columns with the same names, and will always use the first matching column in the NAME list. Furthermore, if the datasource does not provide NAME or TYPE attributes, the application must use the chart_type_map driver-specific attribute for DBD::Chart to supply that information. Refer to both the DBD::Chart homepage and the DBIx::Chart t/plottest.t test script for example usage of chart_type_map.

Change History

  • Release 0.04:
    • Fixed placeholder mapping for source statements
    • Fixed bad sth subclassing

    • Release 0.03:
      • Several bug fixes for DBIx::Threaded testing

    • Release 0.02:
      • Several bug fixes for SQL::Preproc testing

    • Release 0.01:
      • Coded; first beta release

    Known Bugs

    Bug Number Report
    Date    		 Release
    Reported in    		 Description Status Fix
    Release
    1 2002-Nov-09 0.01 fetch() not implemented Fixed 0.02

    TO DO List

    • some limited meta-data capability
    • Any suggestions?

    Acknowledgements

    Many thanks to all the authors of the various GD, PNG, JPEG, and zlib modules. Special thanks to Tim Bunce for providing sublassing, and suggesting SQL syntax.

    References

    Author

    Dean Arnold, Presicient Corp.

    Copyright

    Copyright (c) 2002, Dean Arnold, Presicient Corp., USA

    Permission is granted to use this software according to the terms of the Artistic License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

    The software is offered AS IS, and the author ACCEPTS NO LIABILITY FOR ANY ERRORS OR OMMISSIONS IN, OR LOSSES INCURRED AS A RESULT OF USING DBIx::Chart.

    I reserve the right to provide support for this software to individual sites under a separate (possibly fee-based) agreement.