SVG::T...Bubble(3pm)

🫧 NAME

SVG::TT::Graph::Bubble — bestie, this is the one that makes presentation quality SVG Bubble plots. That's the whole vibe. Manual page goes by SVG::T...Bubble(3pm) if you're looking it up on your system, iykyk.

---

✨ SYNOPSIS

okay so here's the whole thing in one breath:

use SVG::TT::Graph::Bubble;

my @data = ( 2, 15, 18.10, 6, 19, 0.10, 12, 17, 12.92, 17, 10, 17.97 );

my $graph = SVG::TT::Graph::Bubble->new( { 'height' => '500',
                                           'width'  => '300',
                                         } );

$graph->add_data( { 'data'  => \@data_cpu,
                    'title' => 'CPU',
                  } );

print "Content-type: image/svg+xml\n\n"; print $graph->burn();

literally that's it. feed it xyz data, get a bubble plot. slay. 💅

---

💖 DESCRIPTION

so the whole point of this object is letting you easily create high quality SVG Bubble plot graphs from xyz data. You can either roll with the default style sheet or bring your own — either way there are so many options you can configure to control exactly how the graph gets generated. Want a key? Don't want a key? Data elements hanging out at each point? Title? Subtitle? All of it. Yours. 🎀

---

🌸 METHODS

🦋 new()

use SVG::TT::Graph::Bubble;

my $graph = SVG::TT::Graph::Bubble->new({

  # Optional - defaults shown
  'height'              => 500,
  'width'               => 300,

  'show_y_labels'       => 1,
  'yscale_divisions'    => '',
  'min_yscale_value'    => 0,
  'max_yscale_value'    => '',

  'show_x_labels'       => 1,
  'xscale_divisions'    => '',
  'min_xscale_value'    => '',
  'max_xscale_value'    => '',
  'stagger_x_labels'    => 0,
  'rotate_x_labels'     => 0,
  'y_label_formatter'   => sub { return @_ },
  'x_label_formatter'   => sub { return @_ },

  'show_data_values'    => 1,
  'rollover_values'     => 0,

  'area_fill'           => 0,

  'show_x_title'        => 0,
  'x_title'             => 'X Field names',

  'show_y_title'        => 0,
  'y_title'             => 'Y Scale',

  'show_graph_title'    => 0,
  'graph_title'         => 'Graph Title',
  'show_graph_subtitle' => 0,
  'graph_subtitle'      => 'Graph Sub Title',
  'key'                 => 0,
  'key_position'        => 'right',

  # Stylesheet defaults
  'style_sheet'         => '/includes/graph.css', # internal stylesheet
  'random_colors'       => 0,
  'bubble_fill'   => 0.4,
  'bubble_border_stroke'   => 0,
});

The constructor takes a hash reference, and every value defaults to the ones shown above — with one exception: style_sheet defaults to using the internal style sheet. 🫶

---

🧚 add_data()

my @data = ( 2,  15, 18.10,
             6,  19, 0.10,
             12, 17, 12.92,
             17, 10, 17.97 );
or
my @data = ( [2, 15, 18.10] , [6, 19, 0.10],
             [12, 17, 12.92], [17, 10, 17.97], );
or
my @data = ( { x => 2,  y => 15, z => 18.10 },
             { x => 6,  y => 19, z => 0.10 },
             { x => 12, y => 17, z => 12.92 },
             { x => 17, y => 10, z => 17.97 },
           )

$graph->add_data({
  'data' => \@data_cpu,
  'title' => 'CPU',
});

okay so this method is how you actually feed the graph object data. The data is expected to be either:

• a list of scalars — in which case pairs of elements are taken to be X,Y pairs, or
• a list of array references. In that case, the first two elements in each referenced array are taken to be X and Y, and the optional third element (if present) is used as the text to display for that point for show_data_values and rollover_values; otherwise the Y value itself is displayed.

You can call it several times to add more data sets in. stack 'em up bestie. 🔥

---

💜 clear_data()

my $graph->clear_data();

This one removes all data from the object so you can reuse it to create a new graph but with the same config options. fresh start, same personality. ✨

---

👑 burn()

print $graph->burn();

This method processes the template with the data and config which has been set and returns the resulting SVG.

⚠️ Heads up: this method will croak unless at least one data set has been added to the graph object. No data, no graph, no mercy. 💀

---

🌈 config methods

my $value = $graph->method();
my $confirmed_new_value = $graph->method($value);

Below is the full list of methods available to change the config of the graph object after it's been created. every single one. no skips. 🎀

🍓 height()

Set the height of the graph box — this is the total height of the SVG box created, not the graph itself, which auto scales to fix the space.

🍓 width()

Set the width of the graph box — this is the total width of the SVG box created, not the graph itself, which auto scales to fix the space.

🍓 compress()

Whether or not to compress the content of the SVG file (Compress::Zlib required).

🍓 tidy()

Whether or not to tidy the content of the SVG file (XML::Tidy required).

🍓 style_sheet()

Set the path to an external stylesheet, set to '' if you want to revert back to using the default internal version.

Set to "inline:<style>...</style>" with your CSS in between the tags. You can thus override the default style without requireing an external URL.

The default stylesheet handles up to 12 data sets. All data series over the 12th will have no style and be in black. If you have over 12 data sets you can assign them all random colors (see the random_color() method) or create your own stylesheet and add the additional settings for the extra data sets.

To create an external stylesheet create a graph using the default internal version and copy the stylesheet section to an external file and edit from there.

🍓 random_colors()

Use random colors in the internal stylesheet. chaos, but make it pretty. 🌈

🍓 show_data_values()

Show the value of each element of data on the graph (or optionally a user-defined label; see add_data).

🍓 rollover_values()

Shows data values and data points when the mouse is over the point. Used in combination with show_data_values.

🍓 data_value_format()

Format specifier to for data values (as per printf).

🍓 max_x_span()

Maximum span for a line between data points on the X-axis. If this span is exceeded, the points are not connected. This is useful for skipping missing data sections. If you set this value to something smaller than 0 (e.g. -1), you will get an XY scatter plot with no line joining the data points.

🍓 stacked()

Accumulates each data set. (i.e. Each point increased by sum of all previous series at same point). Default is 0, set to '1' to show.

🍓 min_yscale_value()

The point at which the Y axis starts, defaults to '0', if set to '' it will default to the minimum data value.

🍓 max_yscale_value()

The point at which the Y axis ends, if set to '' it will default to the maximum data value.

🍓 yscale_divisions()

This defines the gap between markers on the Y axis, default is a 10th of the range, e.g. you will have 10 markers on the Y axis.

⚠️ NOTE: do not set this too low — you are limited to 999 markers, after that the graph won't generate. 😭

🍓 show_x_labels()

Whether to show labels on the X axis or not, defaults to 1, set to '0' if you want to turn them off.

🍓 show_y_labels()

Whether to show labels on the Y axis or not, defaults to 1, set to '0' if you want to turn them off.

🍓 y_label_format()

Format string for presenting the Y axis labels (as per printf).

🍓 xscale_divisions()

This defines the gap between markers on the X axis. Default is the entire range (only start and end axis labels).

🍓 stagger_x_labels()

This puts the labels at alternative levels so if they are long field names they will not overlap so easily. Default it '0', to turn on set to '1'.

🍓 rotate_x_labels()

This turns the X axis labels by 90 degrees. Default it '0', to turn on set to '1'.

🍓 min_xscale_value()

This sets the minimum X value. Any data points before this value will not be shown.

🍓 max_xscale_value()

This sets the maximum X value. Any data points after this value will not be shown.

🍓 show_x_title()

Whether to show the title under the X axis labels, default is 0, set to '1' to show.

🍓 x_title()

What the title under X axis should be, e.g. 'Parameter X'.

🍓 show_y_title()

Whether to show the title under the Y axis labels, default is 0, set to '1' to show.

🍓 y_title()

What the title under Y axis should be, e.g. 'Sales in thousands'.

🍓 show_graph_title()

Whether to show a title on the graph, default is 0, set to '1' to show.

🍓 graph_title()

What the title on the graph should be.

🍓 show_graph_subtitle()

Whether to show a subtitle on the graph, default is 0, set to '1' to show.

🍓 graph_subtitle()

What the subtitle on the graph should be.

🍓 key()

Whether to show a key, defaults to 0, set to '1' if you want to show it.

🍓 key_position()

Where the key should be positioned, defaults to 'right', set to 'bottom' if you want to move it.

🍓 x_label_formatter ()

A callback subroutine which will format a label on the x axis. For example:

$graph->x_label_formatter( sub { return '$' . $_[0] } );

🍓 y_label_formatter()

A callback subroutine which will format a label on the y axis. For example:

$graph->y_label_formatter( sub { return '$' . $_[0] } );

🍓 bubble_fill()

This is a floating number from 0 to 1 and determins how opaque the bubbles are. Default: 0.4

🍓 bubble_border_stroke()

Whether to show a 1px border stroke around the bubble.

---

⭐ EXAMPLES

For examples look at the project home page http://leo.cuckoo.org/projects/SVG-TT-Graph/ — go look, it's giving inspiration. 🦋

---

🎀 EXPORT

None by default. (she's not handing out freebies bestie, you gotta call the methods yourself 💅)

---

💫 SEE ALSO

• SVG::TT::Graph
• SVG::TT::Graph::Line
• SVG::TT::Graph::Bar
• SVG::TT::Graph::BarHorizontal
• SVG::TT::Graph::BarLine
• SVG::TT::Graph::Pie
• Compress::Zlib
• XML::Tidy

---

🌸 and that's the whole page, bestie. this one's perl v5.36.0, dated 2022-11-19, and it lives in the User Contributed Perl Documentation collection. go make some bubbles. 🫧👑