NAME
Chart::Plotly - Generate html/javascript charts from perl data using javascript library plotly.js
VERSION
version 0.042
SYNOPSIS
my
$data
= {
x
=> [ 1 .. 10 ],
mode
=>
'markers'
,
type
=>
'scatter'
};
$data
->{
'y'
} = [
map
{
rand
10 } @{
$data
->{
'x'
} } ];
show_plot([
$data
]);
my
$big_array
= [ 1 .. 10000 ];
my
$scattergl
= Scattergl->new(
x
=>
$big_array
,
y
=> [
map
{
rand
100 }
@$big_array
] );
show_plot([
$scattergl
]);
use
PDL;
my
$size
= 25;
my
$x
= ( xvals zeroes
$size
+ 1,
$size
+ 1 ) /
$size
;
my
$y
= ( yvals zeroes
$size
+ 1,
$size
+ 1 ) /
$size
;
my
$z
= 0.5 + 0.5 * (
sin
(
$x
* 6.3 ) *
sin
(
$y
* 6.3 ) )**3;
# Bumps
my
$surface
= Surface->new(
x
=>
$x
,
y
=>
$y
,
z
=>
$z
);
show_plot([
$surface
]);
use
PDL::Math;
my
$bessel_size
= 50;
my
$bessel
= Surface->new(
x
=> xvals(
$bessel_size
),
y
=> xvals(
$bessel_size
),
z
=> bessj0( rvals( zeroes(
$bessel_size
,
$bessel_size
) ) / 2 )
);
show_plot([
$bessel
]);
DESCRIPTION
Generate html/javascript charts from perl data using javascript library plotly.js. The result is a file that you could see in your favourite browser.
Example screenshot of plot generated with examples/anscombe.pl:
Example screenshot of plots generated with examples/traces/*.pl:
The API is subject to changes.
FUNCTIONS
render_full_html
Parameters
data:
Data to be represented. It could be:
- Perl data structure of the json expected by plotly.js: http://plot.ly/javascript/reference/ (this data would be serialized to JSON)
- Array ref of objects of type Chart::Plotly::Trace::*
- Anything that could be serialized to JSON with the json expected by plotly.js
- Object that could be adapted using Chart::Plotly::Adapter::*
html_plot
Return the html for the plot or plots
Parameters
Data to be represented. The format is the same as the parameter data in render_full_html. Accepts multiple traces/plots/objects.
show_plot
Opens the plot or plots in a browser locally
Parameters
Data to be represented. The format is the same as the parameter data in render_full_html. Accepts multiple traces/plots/objects.
plotlyjs_version
Returns the version of plotly.js using in this version of the perl module as a string
plotlyjs_plot_function
Returns the name of function of plotly.js used in this version of the perl module to draw plots
plotlyjs_plot_function_parameters
Returns the function parameters of the function of plotly.js used in this version of the perl module to draw plots as a list of strings
BUGS
Please report any bugs or feature requests via github: https://github.com/pablrod/p5-Chart-Plotly/issues
DISCLAIMER
This is an unofficial Plotly Perl module. Currently I'm not affiliated in any way with Plotly. But I think plotly.js is a great library and I want to use it with perl.
If you like plotly.js please consider supporting them purchasing a pro subscription: https://plot.ly/products/cloud/
AUTHOR
Pablo Rodríguez González <pablo.rodriguez.gonzalez@gmail.com>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2022 by Pablo Rodríguez González.
This is free software, licensed under:
The MIT (X11) License
CONTRIBUTORS
Roy Storey <kiwiroy@users.noreply.github.com>
stphnlyd <stephanloyd9@gmail.com>
weatherwax <s.g.lobo@hotmail.com>