SVGGraph Horizontal Bar Graphs
Skip to:
SVGGraph currently contains these classes for drawing horizontal bar graphs: HorizontalBarGraph; HorizontalStackedBarGraph; HorizontalGroupedBarGraph; PopulationPyramid. An example of each type is shown below.
There are also HorizontalBar3DGraph, HorizontalStackedBar3DGraph and HorizontalGroupedBar3DGraph classes:
Example code
Here are the settings and PHP code used to generate the graphs above:
<?php
require_once 'SVGGraph/autoloader.php';
$settings = array(
'back_colour' => '#eee',
'stroke_colour' => '#000',
'back_stroke_width' => 0,
'back_stroke_colour' => '#eee',
'back_image' => 'images/svgbg.png',
'axis_colour' => '#333',
'axis_overlap' => 2,
'axis_font' => 'Georgia',
'axis_font_size' => 10,
'grid_colour' => '#666',
'label_colour' => '#000',
'pad_right' => 20,
'pad_left' => 20,
'link_base' => '/',
'link_target' => '_top',
'minimum_grid_spacing' => 20
);
$values = array(
array('Dough' => 30, 'Ray' => 50, 'Me' => 40, 'So' => 25, 'Far' => 45, 'Lard' => 35),
array('Dough' => 20, 'Ray' => 30, 'Me' => 20, 'So' => 15, 'Far' => 25, 'Lard' => 35,
'Tea' => 45)
);
$colours = array(
array('red','yellow'), array('blue','white')
);
$links = array(
'Dough' => 'jpegsaver.php', 'Ray' => 'crcdropper.php',
'Me' => 'svggraph.php'
);
$graph = new Goat1000\SVGGraph\SVGGraph(300, 200, $settings);
$graph->colours($colours);
$graph->values($values);
$graph->links($links);
$graph->render('HorizontalBarGraph');
If you have already looked at the bar graph page,
this code should be familiar - the only change is 'HorizontalBarGraph' in the call
to $graph->render
. (I have also removed the 'project_angle' option,
since that is only used by the vertical 3D bar graph.)
Change 'HorizontalBarGraph' to one of the other class names to draw that type instead.
The PopulationPyramid class
The population pyramid (also known as an “age pyramid” or “age picture diagram”) is a modified version of the horizontal stacked bar graph. Instead of the values in each dataset stacking from the axis at the left of the graph, the axis is in the centre and datasets alternate from left to right of the axis, stacking outwards.
The population pyramid in the example at the top of the page is using some realistic census data instead of the contrived values used for the other graphs.
Settings
These options are common to all graph types.
General options + Show table
This table lists the options that are common to all the grid-based graph types - the options for grid spacing, axis labelling, etc.
Grid-based graph options - Hide table
Option | Default | Description |
---|---|---|
axis_colour |
"rgb(0,0,0)" |
Colour of axis lines and text. |
axis_colour_h |
NULL |
Colour of horizontal axis. |
axis_colour_v |
NULL |
Colour of vertical axis. |
axis_double_x |
false |
Enables display of X axis at both sides of graph. |
axis_double_y |
false |
Enables display of Y axis at both sides of graph. |
axis_extend_bottom |
null |
Extends the bottom end of horizontal axes. |
axis_extend_left |
null |
Extends the left side of horizontal axes. |
axis_extend_right |
null |
Extends the right side of horizontal axes. |
axis_extend_top |
null |
Extends the top end of horizontal axes. |
axis_fallback_max |
1 |
Sets a fallback value for the axis maximum when the graph contains all zero values. |
axis_font |
"Courier New" |
Font for axis division labels. |
axis_font_adjust |
0.6 |
Font aspect ratio of axis division text. |
axis_font_adjust_h |
NULL |
Font aspect ratio of horizontal axis division text. |
axis_font_adjust_v |
NULL |
Font aspect ratio of vertical axis division text. |
axis_font_h |
NULL |
Font for horizontal axis division labels. |
axis_font_size |
10 |
Font size for axis division labels. |
axis_font_size_h |
NULL |
Font size for horizontal axis division labels. |
axis_font_size_v |
NULL |
Font size for vertical axis division labels. |
axis_font_v |
NULL |
Font for vertical axis division labels. |
axis_font_weight |
"normal" |
Font weight for axis division labels. |
axis_font_weight_h |
null |
Font weight for horizontal axis division labels. |
axis_font_weight_v |
null |
Font weight for vertical axis division labels. |
axis_label_position |
0.5 |
Sets position of axis label as a fraction of the axis length. |
axis_label_position_h |
null |
Sets position of horizontal axis label as a fraction of the axis length. |
axis_label_position_v |
null |
Sets position of vertical axis label as a fraction of the axis length. |
axis_levels_h |
null |
Sets the number of levels of horizontal axis division labels. |
axis_levels_v |
null |
Sets the number of levels of vertical axis division labels. |
axis_max_h |
NULL |
Maximum value for horizontal axis. |
axis_max_v |
NULL |
Maximum value for vertical axis. |
axis_min_h |
NULL |
Minimum value for horizontal axis. |
axis_min_v |
NULL |
Minimum value for vertical axis. |
axis_overlap |
5 |
Distance axes extend past grid. |
axis_pad_bottom |
0 |
Inserts space between bottom axis and grid area. |
axis_pad_left |
0 |
Inserts space between left axis and grid area. |
axis_pad_right |
0 |
Inserts space between right axis and grid area. |
axis_pad_top |
0 |
Inserts space between top axis and grid area. |
axis_right |
false |
Enables axis on right of grid. |
axis_space |
15 |
Space between axes on the right of the graph. |
axis_stroke_width |
2 |
Width of axis lines. |
axis_stroke_width_h |
NULL |
Width of horizontal axis line. |
axis_stroke_width_v |
NULL |
Width of vertical axis line. |
axis_text_align |
null |
Sets the text alignment for axis division labels. |
axis_text_align_h |
null |
Sets the text alignment for horizontal axis division labels. |
axis_text_align_v |
null |
Sets the text alignment for vertical axis division labels. |
axis_text_angle_h |
0 |
Angle of horizontal axis division text. |
axis_text_angle_v |
0 |
Angle of vertical axis division text. |
axis_text_back_colour |
null |
Background colour for axis division labels. |
axis_text_back_colour_h |
null |
Background colour for horizontal axis division labels. |
axis_text_back_colour_v |
null |
Background colour for vertical axis division labels. |
axis_text_callback |
NULL |
Callback function for axis division text labels. |
axis_text_callback_x |
NULL |
Callback function for X axis division text labels. |
axis_text_callback_y |
NULL |
Callback function for Y axis division text labels. |
axis_text_colour |
NULL |
Colour of axis division labels. |
axis_text_colour_h |
NULL |
Colour of horizontal axis division labels. |
axis_text_colour_v |
NULL |
Colour of vertical axis division labels. |
axis_text_line_spacing |
null |
Sets line spacing for axis division labels. |
axis_text_line_spacing_h |
null |
Sets line spacing for horizontal axis division labels. |
axis_text_line_spacing_v |
null |
Sets line spacing for vertical axis division labels. |
axis_text_location |
"grid" |
Position of axis text when graph contains negative numbers. |
axis_text_location_h |
null |
Position of horizontal axis text when graph contains negative numbers. |
axis_text_location_v |
null |
Position of vertical axis text when graph contains negative numbers. |
axis_text_position |
"outside" |
Position of axis division text labels. |
axis_text_position_h |
NULL |
Position of horizontal axis division text labels. |
axis_text_position_v |
NULL |
Position of vertical axis division text labels. |
axis_text_space |
2 |
Space between axis division text and axis. |
axis_text_space_h |
NULL |
Space between horizontal axis division text and axis. |
axis_text_space_v |
NULL |
Space between vertical axis division text and axis. |
axis_ticks_x |
null |
Specifies positions of axis tick marks for X-axis. |
axis_ticks_y |
null |
Specifies positions of axis tick marks for Y-axis. |
axis_tightness_x |
0 |
Sets the algorithm used to choose X-axis divisions. |
axis_tightness_y |
1 |
Sets the algorithm used to choose Y-axis divisions. |
axis_top |
false |
Switches the horizontal axis from the bottom of the grid to the top. |
axis_zero_y |
true |
Allows graph to pick a non-zero value for bottom of Y-axis. |
dataset_axis |
NULL |
Enables multiple Y-axes. |
datetime_text_format |
NULL |
Date format for date/time axis. |
datetime_week_start |
"monday" |
Week start day for date/time axis. |
decimal_digits |
NULL |
Number of decimal digits in axis text labels. |
decimal_digits_x |
NULL |
Number of decimal digits in X axis text labels. |
decimal_digits_y |
NULL |
Number of decimal digits in Y axis text labels. |
division_colour |
NULL |
Colour of axis division marks. |
division_colour_h |
NULL |
Colour of horizontal axis division marks. |
division_colour_v |
NULL |
Colour of vertical axis division marks. |
division_size |
3 |
Length of division marks. |
division_size_h |
NULL |
Size of horizontal axis division marks. |
division_size_v |
NULL |
Size of vertical axis division marks. |
division_style |
"out" |
Style of axis division marks. |
division_style_h |
NULL |
Style of horizontal axis division marks. |
division_style_v |
NULL |
Style of vertical axis division marks. |
force_block_label_x |
false |
Forces block-style labelling for X axis. |
grid_back_colour |
NULL |
Colour of grid area background. |
grid_back_opacity |
1 |
Opacity of grid background fill. |
grid_back_stripe |
false |
Displays grid background stripes. |
grid_back_stripe_colour |
"rgb(240,240,240)" |
Colour of grid background stripes. |
grid_back_stripe_opacity |
1 |
Opacity of grid background stripes. |
grid_bottom |
NULL |
Position of bottom of grid. |
grid_clip_overlap_x |
2 |
Sets the grid clipping overlap to the left and right sides. |
grid_clip_overlap_y |
10 |
Sets the grid clipping overlap above and below the grid area. |
grid_colour |
"rgb(220,220,220)" |
Colour of grid lines. |
grid_colour_h |
NULL |
Colour of vertical grid lines. |
grid_colour_v |
NULL |
Colour of horizontal grid lines. |
grid_dash |
NULL |
Grid lines dash pattern. |
grid_dash_h |
NULL |
Grid vertical lines dash pattern. |
grid_dash_v |
NULL |
Grid horizontal lines dash pattern. |
grid_division_h |
NULL |
Division interval on horizontal axis. |
grid_division_v |
NULL |
Division interval on vertical axis. |
grid_left |
NULL |
Position of left side of grid. |
grid_right |
NULL |
Position of right side of grid. |
grid_straight |
false |
Enables straight grid lines on radar graph. |
grid_stroke_width |
1 |
Sets the thickness of grid lines. |
grid_stroke_width_h |
null |
Sets the thickness of grid lines drawn from the horizontal axis. |
grid_stroke_width_v |
null |
Sets the thickness of grid lines drawn from the vertical axis. |
grid_subdivision_colour |
"rgba(220,220,220,0.5)" |
Colour of grid subdivision lines. |
grid_subdivision_colour_h |
NULL |
Colour of vertical grid subdivision lines. |
grid_subdivision_colour_v |
NULL |
Colour of horizontal grid subdivision lines. |
grid_subdivision_dash |
NULL |
Grid subdivision lines dash pattern. |
grid_subdivision_dash_h |
NULL |
Grid vertical subdivision lines dash pattern. |
grid_subdivision_dash_v |
NULL |
Grid horizontal subdivision lines dash pattern. |
grid_subdivision_stroke_width |
null |
Sets the thickness of grid subdivision lines. |
grid_subdivision_stroke_width_h |
null |
Sets the thickness of vertical grid subdivision lines. |
grid_subdivision_stroke_width_v |
null |
Sets the thickness of horizontal grid subdivision lines. |
grid_top |
NULL |
Position of top of grid. |
increment |
NULL |
X-axis increment for histograms. |
label_colour |
"rgb(0,0,0)" |
Colour for axis label text. |
label_colour_h |
NULL |
Colour for horizontal axis label text. |
label_colour_v |
NULL |
Colour for vertical axis label text. |
label_font |
"Arial" |
Font for axis labels. |
label_font_h |
NULL |
Font for horizontal axis label. |
label_font_size |
10 |
Font size for axis labels. |
label_font_size_h |
NULL |
Font size for horizontal axis label. |
label_font_size_v |
NULL |
Font size for vertical axis label. |
label_font_v |
NULL |
Font for vertical axis label. |
label_font_weight |
"normal" |
Font weight for axis labels. |
label_font_weight_h |
NULL |
Font weight for horizontal axis label. |
label_font_weight_v |
NULL |
Font weight for vertical axis label. |
label_h |
"" |
Text label for horizontal axis. |
label_line_spacing |
null |
Sets line spacing for axis labels. |
label_line_spacing_h |
null |
Sets line spacing for label on horizontal axis. |
label_line_spacing_v |
null |
Sets line spacing for label on vertical axis. |
label_space |
6 |
Spacing around axis labels. |
label_v |
"" |
Text label for vertical axis. |
label_x |
"" |
Text label for X axis. |
label_y |
"" |
Text label for Y axis. |
limit_text_angle |
true |
Limits the angle of axis text to between -90° and +90°. |
log_axis_x |
false |
Enables logarithmic scale for X-axis. |
log_axis_x_base |
10 |
Specifies logarithm base for use on logarithmic X-axis. |
log_axis_y |
false |
Enables logarithmic Y-axis divisions. |
log_axis_y_base |
10 |
Base of the logarithmic axis scale. |
minimum_grid_spacing |
15 |
Minimum distance between grid/axis divisions. |
minimum_grid_spacing_h |
NULL |
Minimum distance between horizontal axis divisions. |
minimum_grid_spacing_v |
NULL |
Minimum distance between vertical axis divisions. |
minimum_subdivision |
5 |
Minimum distance between subdivisions. |
minimum_units_y |
0 |
Minimum units to display on Y axis. |
show_axes |
true |
Enables axis display. |
show_axis_h |
true |
Enables horizontal axis line. |
show_axis_text_h |
true |
Enables labelling of horizontal axis divisions. |
show_axis_text_v |
true |
Enables labelling of vertical axis divisions. |
show_axis_v |
true |
Enables vertical axis line. |
show_divisions |
true |
Enables axis division marks. |
show_grid |
true |
Disables displaying grid. |
show_grid_h |
true |
Disables displaying horizontal grid lines. |
show_grid_subdivisions |
false |
Enables displaying grid subdivisions. |
show_grid_v |
true |
Disables displaying vertical grid lines. |
show_subdivisions |
false |
Enables axis subdivision marks. |
show_x_axis |
true |
Enables X-axis on radar graphs. |
subdivision_colour |
NULL |
Colour of axis subdivision marks. |
subdivision_colour_h |
NULL |
Colour of horizontal axis subdivision marks. |
subdivision_colour_v |
NULL |
Colour of vertical axis subdivision marks. |
subdivision_h |
NULL |
Horizontal axis subdivision interval. |
subdivision_size |
2 |
Length of axis subdivision marks. |
subdivision_size_h |
NULL |
Length of horizontal axis subdivision marks. |
subdivision_size_v |
NULL |
Length of vertical axis subdivision marks. |
subdivision_style |
"out" |
Style of axis subdivision marks. |
subdivision_style_h |
NULL |
Style of horizontal axis subdivision marks. |
subdivision_style_v |
NULL |
Style of vertical axis subdivision marks. |
subdivision_v |
NULL |
Vertical axis subdivision interval. |
text_classes_file |
null |
Specifies an INI file for use with text classes. |
units_before_x |
NULL |
Units shown before value on X-axis. |
units_before_y |
NULL |
Units shown before value on Y-axis. |
units_x |
NULL |
Units shown after value on X-axis. |
units_y |
NULL |
Units shown after value on Y-axis. |
These options are used by the horizontal bar graphs (the
vertical bar graphs support these options too). Note:
bar_label_*
options have been superseded by
data_label_*
options in version 2.18. See the
data labels page for details.
Horizontal bar graph options - Hide table
Option | Default | Description |
---|---|---|
bar_space [1] |
10 |
Space between bars |
bar_width |
NULL |
Thickness of bar in pixels. Overrides size calculated using bar_space |
bar_round |
0 |
Radius of bar corners, or 0 for no rounding |
bar_width_min |
1 |
Minimum thickness of bar in pixels. |
show_bar_labels [Deprecated] |
false |
Displays bar value in or above bar |
bar_label_position [Deprecated] |
"top" |
Where to display the bar label ("top", "bottom", "centre" or "above") |
bar_label_font [Deprecated] |
"Arial" |
Font for bar labels |
bar_label_font_size [Deprecated] |
10 |
Size of bar label font |
bar_label_font_weight [Deprecated] |
"normal" |
Weight of bar label font |
bar_label_colour [Deprecated] |
"rgb(0,0,0)" |
Colour of bar label text |
bar_label_space [Deprecated] |
3 |
Space between label and top or bottom of bar |
bar_label_colour_above [Deprecated] |
NULL |
Alternative colour to use when the bar label is outside the bar |
group_space [2] |
3 |
Space between bars of group |
show_bar_totals [3] |
false |
Displays the total value for the bar in a label above the bar |
bar_total_font [3] |
"Arial" |
Font for bar total labels |
bar_total_font_size [3] |
10 |
Size of bar total label font |
bar_total_font_weight [3] |
"normal" |
Weight of bar total label font |
bar_total_colour [3] |
"rgb(0,0,0)" |
Colour of bar total label text |
bar_total_space [3] |
3 |
Space between total label and top or bottom of bar |
bar_total_type [4] |
NULL |
Label type for bar totals |
bar_total_font_adjust [4] |
NULL |
Font adjustment for bar totals |
bar_total_back_colour [4] |
NULL |
Background colour for bar totals |
bar_total_angle [4] |
NULL |
Text angle for bar totals |
bar_total_padding [4] |
NULL |
Padding inside bar totals |
bar_total_padding_x [4] |
NULL |
Horizontal padding inside bar totals |
bar_total_padding_y [4] |
NULL |
Vertical padding inside bar totals |
bar_total_round [4] |
NULL |
Rounded corners for bar total boxes or bubbles |
bar_total_outline_colour [4] |
NULL |
Colour of bar total outline |
bar_total_outline_thickness [4] |
NULL |
Thickness of bar total outline |
bar_total_fill [4] |
NULL |
Colour, gradient or pattern to fill in bar total box or bubble |
bar_total_tail_width [4] |
NULL |
Thickness of tail for bar total bubbles or lines |
bar_total_tail_length [4] |
NULL |
Length of tail for bar total bubbles or lines |
bar_total_shadow_opacity [4] |
NULL |
Opacity of bar total shadows |
bar_total_callback [3] |
NULL |
Name of callback function for formatting bar totals. The function will be called with two arguments: callback($key, $total) . The function should return a text string to display in the label. |
- [1]For HorizontalGroupedBarGraph,
bar_space
is the space between groups of bars. - [2]Only used for HorizontalGroupedBarGraph.
- [3]Only used for HorizontalStackedBarGraph and PopulationPyramid.
- [4]Added in version 2.18 to control new
data_label
-based labels. When not set, options for data labels are used.