Imager-Graph
view release on metacpan or search on metacpan
lib/Imager/Graph/Vertical.pm view on Meta::CPAN
=cut
sub set_column_padding {
$_[0]->{'custom_style'}->{'column_padding'} = $_[1];
}
=item set_range_padding($percentage)
Sets the padding to be used, as a percentage. For example, if your
data ranges from 0 to 10, and you have a 20 percent padding, the y
axis will go to 12.
Defaults to 10. This attribute is ignored for positive numbers if
set_y_max() has been called, and ignored for negative numbers if
set_y_min() has been called.
=cut
sub set_range_padding {
$_[0]->{'custom_style'}->{'range_padding'} = $_[1];
}
=item set_negative_background($color)
Sets the background color or fill used below the x axis.
=cut
sub set_negative_background {
$_[0]->{'custom_style'}->{'negative_bg'} = $_[1];
}
=item draw()
Draw the graph
=cut
sub draw {
my ($self, %opts) = @_;
if (!$self->_valid_input()) {
return;
}
$self->_style_setup(\%opts);
my $style = $self->{_style};
$self->_make_img
or return;
my $img = $self->_get_image()
or return;
my @image_box = ( 0, 0, $img->getwidth-1, $img->getheight-1 );
$self->_set_image_box(\@image_box);
my @chart_box = ( 0, 0, $img->getwidth-1, $img->getheight-1 );
$self->_draw_legend(\@chart_box);
if ($style->{title}{text}) {
$self->_draw_title($img, \@chart_box)
or return;
}
# Scale the graph box down to the widest graph that can cleanly hold the # of columns.
return unless $self->_get_data_range();
$self->_remove_tics_from_chart_box(\@chart_box, \%opts);
my $column_count = $self->_get_column_count();
my $width = $self->_get_number('width');
my $height = $self->_get_number('height');
my $graph_width = $chart_box[2] - $chart_box[0];
my $graph_height = $chart_box[3] - $chart_box[1];
my $col_width = ($graph_width - 1) / $column_count;
if ($col_width > 1) {
$graph_width = int($col_width) * $column_count + 1;
}
else {
$graph_width = $col_width * $column_count + 1;
}
my $tic_count = $self->_get_y_tics();
my $tic_distance = ($graph_height-1) / ($tic_count - 1);
$graph_height = int($tic_distance * ($tic_count - 1));
my $top = $chart_box[1];
my $left = $chart_box[0];
$self->{'_style'}{'graph_width'} = $graph_width;
$self->{'_style'}{'graph_height'} = $graph_height;
my @graph_box = ($left, $top, $left + $graph_width, $top + $graph_height);
$self->_set_graph_box(\@graph_box);
my @fill_box = ( $left, $top, $left+$graph_width, $top+$graph_height );
if ($self->_feature_enabled("graph_outline")) {
my @line = $self->_get_line("graph.outline")
or return;
$self->_box(
@line,
box => \@fill_box,
img => $img,
);
++$fill_box[0];
++$fill_box[1];
--$fill_box[2];
--$fill_box[3];
}
$img->box(
$self->_get_fill('graph.fill'),
box => \@fill_box,
);
my $min_value = $self->_get_min_value();
my $max_value = $self->_get_max_value();
lib/Imager/Graph/Vertical.pm view on Meta::CPAN
my $series = $self->_get_data_series()->{'column'};
return (undef, undef, 0) unless $series;
my $max_value = 0;
my $min_value = STARTING_MIN_VALUE;
my $column_count = 0;
my @series = @{$series};
foreach my $series (@series) {
my @data = @{$series->{'data'}};
foreach my $value (@data) {
$column_count++;
if ($value > $max_value) { $max_value = $value; }
if ($value < $min_value) { $min_value = $value; }
}
}
return ($min_value, $max_value, $column_count);
}
sub _get_stacked_column_range {
my $self = shift;
my $max_value = 0;
my $min_value = STARTING_MIN_VALUE;
my $column_count = 0;
return (undef, undef, 0) unless $self->_get_data_series()->{'stacked_column'};
my @series = @{$self->_get_data_series()->{'stacked_column'}};
my @max_entries;
my @min_entries;
for (my $i = scalar @series - 1; $i >= 0; $i--) {
my $series = $series[$i];
my $data = $series->{'data'};
for (my $i = 0; $i < scalar @$data; $i++) {
my $value = 0;
if ($data->[$i] > 0) {
$value = $data->[$i] + ($max_entries[$i] || 0);
$data->[$i] = $value;
$max_entries[$i] = $value;
}
elsif ($data->[$i] < 0) {
$value = $data->[$i] + ($min_entries[$i] || 0);
$data->[$i] = $value;
$min_entries[$i] = $value;
}
if ($value > $max_value) { $max_value = $value; }
if ($value < $min_value) { $min_value = $value; }
}
if (scalar @$data > $column_count) {
$column_count = scalar @$data;
}
}
return ($min_value, $max_value, $column_count);
}
sub _draw_legend {
my $self = shift;
my $chart_box = shift;
my $style = $self->{'_style'};
my @labels;
my $img = $self->_get_image();
if (my $series = $self->_get_data_series()->{'stacked_column'}) {
push @labels, map { $_->{'series_name'} } @$series;
}
if (my $series = $self->_get_data_series()->{'column'}) {
push @labels, map { $_->{'series_name'} } @$series;
}
if (my $series = $self->_get_data_series()->{'line'}) {
push @labels, map { $_->{'series_name'} } @$series;
}
if (my $series = $self->_get_data_series()->{'area'}) {
push @labels, map { $_->{'series_name'} } @$series;
}
if ($style->{features}{legend} && (scalar @labels)) {
$self->SUPER::_draw_legend($self->_get_image(), \@labels, $chart_box)
or return;
}
return;
}
sub _draw_flat_legend {
return 1;
}
sub _draw_lines {
my $self = shift;
my $style = $self->{'_style'};
my $img = $self->_get_image();
my $max_value = $self->_get_max_value();
my $min_value = $self->_get_min_value();
my $column_count = $self->_get_column_count();
my $value_range = $max_value - $min_value;
my $width = $self->_get_number('width');
my $height = $self->_get_number('height');
my $graph_width = $self->_get_number('graph_width');
my $graph_height = $self->_get_number('graph_height');
my $line_series = $self->_get_data_series()->{'line'};
my $series_counter = $self->_get_series_counter() || 0;
my $has_columns = (defined $self->_get_data_series()->{'column'} || $self->_get_data_series->{'stacked_column'}) ? 1 : 0;
my $col_width = int($graph_width / $column_count) -1;
my $graph_box = $self->_get_graph_box();
my $left = $graph_box->[0] + 1;
my $bottom = $graph_box->[1];
my $zero_position = $bottom + $graph_height - (-1*$min_value / $value_range) * ($graph_height - 1);
my $line_aa = $self->_get_number("lineaa");
foreach my $series (@$line_series) {
my @data = @{$series->{'data'}};
my $data_size = scalar @data;
my $interval;
if ($has_columns) {
$interval = $graph_width / ($data_size);
}
else {
$interval = $graph_width / ($data_size - 1);
}
my $color = $self->_data_color($series_counter);
# We need to add these last, otherwise the next line segment will overwrite half of the marker
my @marker_positions;
for (my $i = 0; $i < $data_size - 1; $i++) {
my $x1 = $left + $i * $interval;
my $x2 = $left + ($i + 1) * $interval;
$x1 += $has_columns * $interval / 2;
$x2 += $has_columns * $interval / 2;
my $y1 = $bottom + ($value_range - $data[$i] + $min_value)/$value_range * $graph_height;
my $y2 = $bottom + ($value_range - $data[$i + 1] + $min_value)/$value_range * $graph_height;
lib/Imager/Graph/Vertical.pm view on Meta::CPAN
@_ > 1 or $value = 1;
$self->{custom_style}{features}{linemarkers} = $value;
return 1;
}
=item use_automatic_axis()
Automatically scale the Y axis, based on L<Chart::Math::Axis>. If
Chart::Math::Axis isn't installed, this sets an error and returns
undef. Returns 1 if it is installed.
=cut
sub use_automatic_axis {
eval { require Chart::Math::Axis; };
if ($@) {
return $_[0]->_error("use_automatic_axis - $@\nCalled from ".join(' ', caller)."\n");
}
$_[0]->{'custom_style'}->{'automatic_axis'} = 1;
return 1;
}
=item set_y_tics($count)
Set the number of Y tics to use. Their value and position will be
determined by the data range.
=cut
sub set_y_tics {
$_[0]->{'y_tics'} = $_[1];
}
sub _get_y_tics {
return $_[0]->{'y_tics'} || 0;
}
sub _remove_tics_from_chart_box {
my ($self, $chart_box, $opts) = @_;
# XXX - bad default
my $tic_width = $self->_get_y_tic_width() || 10;
my @y_tic_box = ($chart_box->[0], $chart_box->[1], $chart_box->[0] + $tic_width, $chart_box->[3]);
# XXX - bad default
my $tic_height = $self->_get_x_tic_height($opts) || 10;
my @x_tic_box = ($chart_box->[0], $chart_box->[3] - $tic_height, $chart_box->[2], $chart_box->[3]);
$self->_remove_box($chart_box, \@y_tic_box);
$self->_remove_box($chart_box, \@x_tic_box);
# If there's no title, the y-tics will be part off-screen. Half of the x-tic height should be more than sufficient.
my @y_tic_tops = ($chart_box->[0], $chart_box->[1], $chart_box->[2], $chart_box->[1] + int($tic_height / 2));
$self->_remove_box($chart_box, \@y_tic_tops);
# Make sure that the first and last label fit
if (my $labels = $self->_get_labels($opts)) {
if (my @box = $self->_text_bbox($labels->[0], 'legend')) {
my @remove_box = ($chart_box->[0],
$chart_box->[1],
$chart_box->[0] + int($box[2] / 2) + 1,
$chart_box->[3]
);
$self->_remove_box($chart_box, \@remove_box);
}
if (my @box = $self->_text_bbox($labels->[-1], 'legend')) {
my @remove_box = ($chart_box->[2] - int($box[2] / 2) - 1,
$chart_box->[1],
$chart_box->[2],
$chart_box->[3]
);
$self->_remove_box($chart_box, \@remove_box);
}
}
}
sub _get_y_tic_width {
my $self = shift;
my $min = $self->_get_min_value();
my $max = $self->_get_max_value();
my $tic_count = $self->_get_y_tics();
my $interval = ($max - $min) / ($tic_count - 1);
my %text_info = $self->_text_style('legend')
or return;
my $max_width = 0;
for my $count (0 .. $tic_count - 1) {
my $value = ($count*$interval)+$min;
if ($interval < 1 || ($value != int($value))) {
$value = sprintf("%.2f", $value);
}
my @box = $self->_text_bbox($value, 'legend');
my $width = $box[2] - $box[0];
# For the tic width
$width += 10;
if ($width > $max_width) {
$max_width = $width;
}
}
return $max_width;
}
sub _get_x_tic_height {
my ($self, $opts) = @_;
my $labels = $self->_get_labels($opts);
if (!$labels) {
return;
}
my $tic_count = (scalar @$labels) - 1;
my %text_info = $self->_text_style('legend')
or return;
my $max_height = 0;
for my $count (0 .. $tic_count) {
my $label = $labels->[$count];
my @box = $self->_text_bbox($label, 'legend');
my $height = $box[3] - $box[1];
# Padding + the tic
$height += 10;
if ($height > $max_height) {
$max_height = $height;
}
}
return $max_height;
}
sub _draw_y_tics {
my $self = shift;
my $min = $self->_get_min_value();
my $max = $self->_get_max_value();
my $tic_count = $self->_get_y_tics();
my $img = $self->_get_image();
my $graph_box = $self->_get_graph_box();
my $image_box = $self->_get_image_box();
my $interval = ($max - $min) / ($tic_count - 1);
my %text_info = $self->_text_style('legend')
or return;
my $line_style = $self->_get_color('outline.line');
my $show_gridlines = $self->{_style}{features}{'horizontal_gridlines'};
my @grid_line = $self->_get_line("hgrid");
my $tic_distance = ($graph_box->[3] - $graph_box->[1]) / ($tic_count - 1);
for my $count (0 .. $tic_count - 1) {
my $x1 = $graph_box->[0] - 5;
my $x2 = $graph_box->[0] + 5;
my $y1 = int($graph_box->[3] - ($count * $tic_distance));
my $value = ($count*$interval)+$min;
if ($interval < 1 || ($value != int($value))) {
$value = sprintf("%.2f", $value);
}
my @box = $self->_text_bbox($value, 'legend')
or return;
$img->line(x1 => $x1, x2 => $x2, y1 => $y1, y2 => $y1, aa => 1, color => $line_style);
my $width = $box[2];
my $height = $box[3];
$img->string(%text_info,
x => ($x1 - $width - 3),
y => ($y1 + ($height / 2)),
text => $value
);
if ($show_gridlines && $y1 != $graph_box->[1] && $y1 != $graph_box->[3]) {
$self->_line(x1 => $graph_box->[0], y1 => $y1,
x2 => $graph_box->[2], y2 => $y1,
img => $img,
@grid_line);
}
}
}
sub _draw_x_tics {
my ($self, $opts) = @_;
my $img = $self->_get_image();
my $graph_box = $self->_get_graph_box();
my $image_box = $self->_get_image_box();
my $labels = $self->_get_labels($opts);
my $tic_count = (scalar @$labels) - 1;
my $has_columns = (defined $self->_get_data_series()->{'column'} || defined $self->_get_data_series()->{'stacked_column'});
# If we have columns, we want the x-ticks to show up in the middle of the column, not on the left edge
my $denominator = $tic_count;
if ($has_columns) {
$denominator ++;
}
my $tic_distance = ($graph_box->[2] - $graph_box->[0]) / ($denominator);
my %text_info = $self->_text_style('legend')
or return;
# If automatic axis is turned on, let's be selective about what labels we draw.
my $max_size = 0;
my $tic_skip = 0;
if ($self->_get_number('automatic_axis')) {
foreach my $label (@$labels) {
my @box = $self->_text_bbox($label, 'legend');
if ($box[2] > $max_size) {
$max_size = $box[2];
}
}
# Give the max_size some padding...
$max_size *= 1.2;
$tic_skip = int($max_size / $tic_distance) + 1;
}
my $line_style = $self->_get_color('outline.line');
for my $count (0 .. $tic_count) {
next if ($count % ($tic_skip + 1));
my $label = $labels->[$count];
my $x1 = $graph_box->[0] + ($tic_distance * $count);
if ($has_columns) {
$x1 += $tic_distance / 2;
}
$x1 = int($x1);
my $y1 = $graph_box->[3] + 5;
my $y2 = $graph_box->[3] - 5;
$img->line(x1 => $x1, x2 => $x1, y1 => $y1, y2 => $y2, aa => 1, color => $line_style);
my @box = $self->_text_bbox($label, 'legend')
or return;
my $width = $box[2];
my $height = $box[3];
$img->string(%text_info,
x => ($x1 - ($width / 2)),
y => ($y1 + ($height + 5)),
text => $label
);
}
}
sub _valid_input {
my $self = shift;
if (!defined $self->_get_data_series() || !keys %{$self->_get_data_series()}) {
return $self->_error("No data supplied");
}
my $data = $self->_get_data_series();
if (defined $data->{'line'} && !scalar @{$data->{'line'}->[0]->{'data'}}) {
return $self->_error("No values in data series");
}
if (defined $data->{'column'} && !scalar @{$data->{'column'}->[0]->{'data'}}) {
return $self->_error("No values in data series");
}
if (defined $data->{'stacked_column'} && !scalar @{$data->{'stacked_column'}->[0]->{'data'}}) {
return $self->_error("No values in data series");
}
return 1;
}
sub _set_column_count { $_[0]->{'column_count'} = $_[1]; }
sub _set_min_value { $_[0]->{'min_value'} = $_[1]; }
sub _set_max_value { $_[0]->{'max_value'} = $_[1]; }
sub _set_image_box { $_[0]->{'image_box'} = $_[1]; }
sub _set_graph_box { $_[0]->{'graph_box'} = $_[1]; }
sub _set_series_counter { $_[0]->{'series_counter'} = $_[1]; }
sub _get_column_count { return $_[0]->{'column_count'} }
sub _get_min_value { return $_[0]->{'min_value'} }
sub _get_max_value { return $_[0]->{'max_value'} }
sub _get_image_box { return $_[0]->{'image_box'} }
sub _get_graph_box { return $_[0]->{'graph_box'} }
sub _reset_series_counter { $_[0]->{series_counter} = 0 }
sub _get_series_counter { return $_[0]->{'series_counter'} }
sub _style_defs {
my ($self) = @_;
my %work = %{$self->SUPER::_style_defs()};
$work{area} =
{
opacity => 0.5,
};
push @{$work{features}}, qw/graph_outline graph_fill linemarkers/;
$work{hgrid} =
{
( run in 0.945 second using v1.01-cache-2.11-cpan-39bf76dae61 )