Home » Images » Image_Graph

A package for displaying (numerical) data as a graph/chart/plot.

This package is unmaintained.

Download latest release 0.8.0 (archived versions might be outdated)

License: LGPL

Description

Image_Graph provides a set of classes that creates graphs/plots/charts based on (numerical) data.

Many different plot types are supported: Bar, line, area, step, impulse, scatter, radar, pie, map, candlestick, band, box & whisker and smoothed line, area and radar plots.

The graph is highly customizable, making it possible to get the exact look and feel that is required.

The output is controlled by a Image_Canvas, which facilitates easy output to many different output formats, amongst others, GD (PNG, JPEG, GIF, WBMP), PDF (using PDFLib), Scalable Vector Graphics (SVG).

Image_Graph is compatible with both PHP4 and PHP5.

Maintainers

• Jesper Veggerby (nosey) — lead, active
• Stefan Neufeind (neufeind) — lead, active
• Tobias Schlitt (toby) — lead, active

Dependencies

Required

• PHP (>= 5.0.0)
• PEAR Installer (>= 1.4.0b1)
• PEAR (>= 1.3.1)
• Image_Canvas (>= 0.3.0)

Optional

• Numbers_Roman
• Numbers_Words

Releases

• 0.8.0 (alpha, 2010-10-05)
  Release notes

  License: LGPL

  QA release
  * PLEASE NOTE: Package now needs PHP 5.x (needed for workaround for Bug #16529 and future cleanups)
  Bug #16529 Doesn't work with PHP 5.3.0 neufeind
  Bug #16834 Column width error, small PHP typo (fix incl.) neufeind
  Bug #2685 Plots do not honor ID tags for fills. nosey
  Bug #2791 wrong x-axis label position when using ttf font nosey
  Bug #2831 using Image_Graph_Fill in Image_Graph_Fill_Array
  Bug #2832 GD always outputs PNG nosey
  Bug #3346 double as data nosey
  Bug #3496 Image/Graph/value/marker.php - dir don't exist
  Bug #3984 Cannot inherit image_color
  Bug #4080 setSpaceFromBorder missing ??
  Bug #4333 Legend division by zero error on PieChart nosey
  Bug #4417 Cannot use point ID as marker value nosey
  Bug #4430 Call-time pass-by-reference has been deprecated nosey
  Bug #4484 SVG output problem with fill and alignment attributes of text nosey
  Bug #4522 Image_Graph_Axis::_calcLabelInterval() dont work like it was working before
  Bug #4586 Content type image/jpg does not recognized by IE nosey
  Bug #4876 mis-type in code -> undefined property nosey
  Bug #5066 Reference Notices nosey
  Bug #5607 X Axis Labels align to right nosey
  Bug #6941 Logarithmic axis values between 0 and 1 nosey
  Bug #7364 Incorrect Include in Grid.php nosey
  Bug #7367 Windows XP Marker for top Y-value cut nosey
  Bug #7375 Windows XP "Only variables should be assigned by reference" notice
  Bug #7572 addPoint function in Image_Graph_Dataset_Sequential doesn't use parameter nosey
  Bug #7621 Linux Pie Chart Legend does not display nosey
  Bug #7729 Wrong axis X label placement
  Bug #8055 No Legend with Pie Charts nosey
  Bug #11812 "forceMaximum" method uwesteinm

• 0.7.2 (alpha, 2006-03-02)
  Release notes

  License: LGPL

  * Added Pie chart support for grouping items with values below a specified threshold in a "the rest" group
  * Added possibility to set color of axis ticks (thanks to bdondo from forum)
  * Added clipping support, causing forceMinimum() and forceMaximum() to show expected results
  * Modified axis arrows, so that an axis with all negative values, the arrow will be shown at the minimum value instead of maximum
  * Fixed a bug with Image_Graph_DataPreprocessor_Function not working, when callback function is an object method
  * Fixed a bug with Candlestick, Band and Box & Whisker plots not working when using markers
  * Fixed Bug #6024 "Undefined variable: parameters"
  * Fixed Bug #6085 "Graph doesn't understand a numeric variable extracted from the GET method."
  * Fixed Bug #6919 "Isolated points in linegraphs with breaks drawn incorrectly"
  * Fixed Bug #6921 "Marker not drawn for points with Y value == 0"
  * Fixed Bug #6941 "Logarithmic axis values between 0 and 1"
  * Fixed Request #5985 "Logarithmic Axis Minimum Value"
  * Fixed a problem with labels not appearing on the same baseline
  * Added possibility to specify padding on all edges of an element separately
  * Updated some API documentation entries

• 0.7.1 (alpha, 2005-10-05)
  Release notes

  License: LGPL

  * Fixed Bug #5415 "Axis's wrong when plot is Dot/Scatter"
  * Fixed Bug #5607 "X Axis Labels align to right"
  * Fixed a problem with horizontal plots and axis labels and titles not showing/aligning properly
  * Fixed a problem with horizontal Step plot

• 0.7.0 (alpha, 2005-09-30)
  Release notes

  License: LGPL

  * Added Image_Graph_Plot_Odo (thanks Maxime Delorme)
  * Added Image_Graph_DataSelector_Values (thanks Paolo)
  * Added best-fit line plot (Image_Graph_Plot_Fit_Line)
  * Added possibility to specify the pie plot diameter
  * Modified Image_Graph_Plot_CandleStick, it is now only necessary to specify 'open' for first point (other 'open' = previous 'close')
  * Changed Image_Graph_Plotarea::hideAxis() to actually hide the axis, not remove them
  * Added Image_Graph_Plotarea::clearAxis() to remove the axis
  * Fixed markers so that y values equal to null never shows markers
  * Fixed problem in Image_Graph_Plot_BoxWhisker causing an undefined method
  * Fixed problem with markers and horizontal plots
  * Fixed problem with axis not showing arrow-ends even if enabled
  * Fixed problem with an error "Call to a member function on a non-object..." in Common.php
  * Fixed a problem with Image_Graph_Dataset_Trivial when supplying a datarray as constructor parameter and Image_Graph_Fill_Array
  * Fixed Bug #5421 "Documentation for Image_Graph constructor wrong"
  * Fixed Bug #5502 "Axis_Logarithmic::setAxisIntersection('max') is broken"
  * Fixed Bug #5504 "PHP Notice: Undefined index: tohtml"
  * Fixed PHP notice with Image_Graph::done() when using output to file
  * Fixed so it is possible to use array(R, G, B, a?) as fill color
  * Fixed issue with markers not rotating along with plot when using setStartingAngle()
  * Fixed trivial dataset so that it is possible to use 'id' as key when populating dataset in constructor

• 0.6.0 (alpha, 2005-08-27)
  Release notes

  License: LGPL

  * Added possibility to set starting angle of pie chart (at which angle does the first pieslice start) and the direction of the pies (clockwise or counter-clockwise)
  * Added Request #5031 "Horizontal Bar graphs required" - all plot types (except radar and pie) support horizontal, it is the "Plotarea" that is horizontal
  * Fixed Bug #5035 "Legend and graph color mismatch when using zeros in stacked bar"
  * Fixed Bug #5066 "Reference Notices"

• 0.5.0 (alpha, 2005-08-08)
  Release notes

  License: LGPL

  * Major change: removed Image_Graph_Driver and subclasses and uses Image_Canvas instead, which implies:
  - Image_Graph_Color is obsolete, removing dependency on Image_Color (however Image_Canvas still depends on Image_Color)
  - Fonts are simplified (all identified by name) and implemented using Image_Graph_Font class, removing Image_Graph_Font subclasses (only subclasses!), removing Fonts/ folder
  - Added dependency on Image_Canvas
  - Image/Graph/Config.php becoming obsolete since only IMAGE_GRAPH_SYSTEM_FONT_PATH was defined here. File kept for future purposes but not used.
  - TTF Fonts (which were most often used) keep BC in 99% of the cases by replacing the 'ttf_font' factory alias mapping to 'Image_Graph_Font' and adding a mapping for 'Image_Graph_Font_TTF' to 'Image_Graph_Font'. Only case not working is when user manually includes Image/Graph/Font/TTF.php and creates and instance using 'new', which should only very, very rarely be the case
  - BC break: If drivers were explicitly created before, they now have to be changed to Image_Canvas objects
  * Added support for HTML image maps on line-, bar-, area-, smoothed line-, impulse-, band- and pie charts (more to come)
  * Added 'tohtml' option for output directly in HTML using canvas and imagemap (if any)
  * Added label option 'format' and 'dateformat' to Image_Graph_Axis to be able to format a label directly using sprintf() / date()
  * Changed plus and cross markers to be outlined (by defalut) - visual improvement
  * Added a star marker (Image_Graph_Marker_Star)
  * Added legends to scatter/dot plots - the marker now shows in legends
  * Performance optimization in Image_Graph_Axis_Category (with regards to heavy usage of array_search())
  * Improved appearance of axis arrows
  * Fixed Bug #4240 "Pie graph - color difference between graph and legend"
  * Fixed Bug #4430 "Call-time pass-by-reference has been deprecated"
  * Fixed Bug #4876 "mis-type in code -> undefined property"
  * Bugs fixed/Features added in Image_Canvas
  * Added Request #4451 "Unable to define IMAGE_GRAPH_SYSTEM_FONT_PATH outside of Config.php"
  * Fixed Bug #4484 "SVG output problem with fill and alignment attributes of text"
  * Fixed Bug #4586 "Content type image/jpg does not recognized by IE"

• 0.4.0 (alpha, 2005-05-24)
  Release notes

  License: LGPL

  * Added support for antialiasing images when using GD (both using native GD method and Image_Graph own implementation)
  * Added possibility to specify horizontal title alignment (left, right or center)
  * Fixed an "off-by-one" problem with secondary axis
  * Included all on-line examples in package
  * Removed some memory leaks as described in bug #3958 "Memory leaks in Image_Graph 0.3.0-alpha"
  * Fixed bug #4113 "Image_Graph_Driver_GD::pieSlice() warnings"
  * Fixed bug #4333 "Legend division by zero error on PieChart"
  * Fixed bug #4417 "Cannot use point ID as marker value"

• 0.3.0 (alpha, 2005-02-25)
  Release notes

  License: LGPL

  Added possibility to use arrays of the type $data[$id] = array('x' => $x, 'y' => $y) for easy data addition to a dataset
  * Added use of 'null' y-values in line plots (normal and smoothed) causing a break in the line (instead of dropping to zero)
  * Added possibility to make one legend use multiple plotareas
  * Added grouping to drivers (currently only fully supported by SVG driver)
  * Added axis padding (padding inside the plotarea)
  * Added Image_Graph_Axis::setFixedSize() to allow for alignment of axis on different plotareas when in a layout
  * Added possibility to use padding with overlayed legends to make legend _not_ display fx. on-top of y-axis
  * Added/improved support for multi line text using GD drivers
  * Added support for antialiasing images when using GD (GD built in method)
  * Implemented simple shadows (and removed shadow images from distribution)
  * Fixed bug #3346 "double as data"
  * Fixed a problem with normal multi-data bar charts not displaying expected bar width
  * Fixed problem with legends when overlayed
  * Fixed axis not displaying labels after resetting driver
  * Fixed problem in SVG driver with vertical texts
  * Fixed a problem with line axis marker on a secondary y-axis displaying vertically instead of horizontally
  * Fixed problem with logarithmic axis not scaling properly
  * Changed the way coordinates are calculated when adding titles to non-layout objects
  * Changed which changes API causing minor BC breaks
  - Renamed Image_Graph_Plot_Bar::barWidth() to Image_Graph_Plot_Bar::setBarWidth()
  - Renamed Image_Graph_Plot_Bar::spacing() to Image_Graph_Plot_Bar::setSpacing()
  - Removed Image_Graph_Layout_Plotarea, it being completely obsolete with introduction of Image_Graph_Axis::setTitle()
  * Updated header comment blocks to conform to new standards as specified by RFC
  * Performance optimizations

• 0.3.0dev4 (devel, 2005-01-28)
  Release notes

  License: LGPL

  Fixed problem with logarithmic axis causing an infinite loop

• 0.3.0dev3 (devel, 2005-01-27)
  Release notes

  License: LGPL

  * Added possibility to invert axis direction, fx. minimum at top or bottom
  * Added methods to handle axis label customization (Image_Graph_Axis::setLabelOption() and Image_Graph_Axis::setLabelOptions())
  * Minor change to the way GD driver(s) calculate height (so that fx. x-axis labels appear printed on the same baseline)
  * Fixed axis so that forceMinimum() works with axis intersection
  * Fixed PDF (PDFlib) driver to display images correctly
  * Fixed factory method class name alias 'vector', tried to create Image_Graph_Dataset_Vector instead of Image_Graph_Dataset_VectorFunction
  * Fixed a minor problem in category axis when adding more that one point with the same value, i.e. ('A', 10), ('A', 20)
  * Fixed problem with grids on category axis
  * Added possiblitity to add simple colors to Image_Graph_Line_Array
  * Added id tags for line styles
  * Performance optimization/tuning (axis, elements)
  * Removed XML_SVG driver which was included by mistake (SWF driver remains, but has several unimplemented features)
  * Added more tests

• 0.3.0dev2 (devel, 2005-01-13)
  Release notes

  License: LGPL

  * Added functionality for multi-level labels (ticks, text, etc.) to support for minor and major labels (and more if needed)
  * Added fontmapping in GD drivers useful for mapping mnemonic fontnames, i.e. Times New Roman to font file names (either partial or full)
  * Added configuration option in Config.php (IMAGE_GRAPH_SYSTEM_FONT_PATH) enabling to specify default search path for system fonts
  - On Windows systems this defaults to %SYSTEMROOT%\Fonts\
  * Added 'auto' split on layouts - calculated automatically based on actual sizes of the parts (supported only with titles)
  * Added visual tests - not PHPUnit, test cases:
  - Basic testing if requirements are met (GD + Freetype)
  - Testcases for testing drivers
  - Plot tests
  - Axis tests
  * Added support for setting width on the bars in a bar chart
  * Added setFontColor(), setFontSize(), setFontAngle() to elements for easy change of properties of propagating fonts, without needing to create a new object
  * Added new setTitle() method to axis to allow for easier displaying of axis titles
  * Added Image_Graph_Plot_CandleStick to display financial charts for the stock market
  * Added Image_Graph_Plot_Band
  * Added major tick customizability to axis
  * Added possibility to use user-defined values as axis-labels
  * Added support for adding an array to Image_Graph_Dataset_Trivial for easy point addition
  * Added some error/insanity checks
  * Added Image_Graph_Tool class with static function for bezier curve-smoothing for drivers without native support (fx. GD)
  * Added Image_Graph_Axis::setAxisIntersection() to specify a value for which the axis intersects another axis (i.e. Y-axis intersects X-axis in x=1 instead of x=0)
  * Implemented drivers to support different output formats
  - Currently full GD (JPEG/PNG/GIF/WBMP), SVG and PDF (PDFlib) support
  - Semi-supported drivers SWF (Ming)
  - Drivers planned SVG (XML_SVG), PDF (File_PDF) and SWF (libswf)
  - No BC breaking API changes
  - Currently no support for animations, i.e. SVG and SWF
  * Re-implemented support for line styles
  * Fonts now propagate through the structure, meaning if you set a font on the Graph all other elements inherit this font (but can be overridden)
  - This does *not* break BC
  * Modified Image_Graph_Axis_Radar to be a category axis
  * Modified Image_Graph_Dataset to allow for y-value to be an array of values (to support candlestick diagrams)
  * Changed pie chart legends, so they show all data values as legend except just one for complete chart
  * Changed logging behaviour (added Image_Graph::setLog() method)
  * Changed while-list-each to foreach for performance reasons (minor)
  * Changed Image_Graph_Title constructor slightly (second parameter, see Docs. for details)
  * Changed Image_Graph_Axis::setTitle() slightly to accomodate propagating fonts (no BC break)
  * Included some more aliases for the Image_Graph::factory() method
  * Updated how bar charts calculate width
  * Legends now scale properly
  * Legends now show differently depending on plot type
  * API Changes with minor impact on BC
  - Removed caching
  - Removed Image_Graph::saveAs(), functionality moved to Image_Graph_Driver::done() method
  - Removed Image_Graph::thumbnail()
  - Removed Image_Graph_Axis_Multidimensional, mainly for perfomance reasons
  - Image_Graph_Fill now inherits from Image_Graph_Common (instead of Image_Graph_Element)
  - Removed GLOBAL font variables
  * Fixed problems with Image_Graph_Axis_Radar showing values in wrong order
  * Fixed bug causing negative bars to display incorrecly (why o' why is 0 == 'some string'?)
  * Fixed bug causing setLineStyle() to fail
  * Fixed Bug #2684 "Source typo breaking data selectors"
  * Fixed Bug #2685 "Plots do not honor ID tags for fills"
  * Fixed bug #2791 "wrong x-axis label position when using ttf font"
  * Fixed bug causing displayErrors() to generate WARNING and FATAL ERROR
  * Fixed problems with gradient fills (did not display propery using GD drivers)
  * Fixed problem with bar-, area-, step- and impulse-charts when using forceMinimum(), causing bars to display 'below' x-axis
  * Fixed Image_Graph_Axis::force(Minimum|Maximum)
  * Removed default Image_Graph logo
  * Removed _graphWidth() and _graphHeight(), they are now handled by the driver

• 0.3.0dev1 (devel, 2004-10-25)
  Release notes

  License: LGPL

  First devel build

• 0.2.1 (alpha, 2004-02-22)
• 0.2.0RC1 (alpha, 2004-02-14)
• 0.1.1 (alpha, 2003-11-13)
• 0.1 (alpha, 2003-11-01)

Bugs