Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pablrod/p5-chart-plotly
Generate html/javascript charts with perl data using javascript library Plotly.js
https://github.com/pablrod/p5-chart-plotly
chart javascript-library-plotly perl perl-data plot
Last synced: about 1 month ago
JSON representation
Generate html/javascript charts with perl data using javascript library Plotly.js
- Host: GitHub
- URL: https://github.com/pablrod/p5-chart-plotly
- Owner: pablrod
- License: mit
- Created: 2016-09-24T14:55:07.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-08-15T15:25:53.000Z (over 2 years ago)
- Last Synced: 2024-06-18T18:35:04.634Z (6 months ago)
- Topics: chart, javascript-library-plotly, perl, perl-data, plot
- Language: Perl
- Size: 26.8 MB
- Stars: 9
- Watchers: 6
- Forks: 4
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
- License: LICENSE
Awesome Lists containing this project
README
# NAME
Chart::Plotly - Generate html/javascript charts from perl data using javascript library plotly.js
# VERSION
version 0.042
# SYNOPSIS
```perl
use Chart::Plotly 'show_plot';
my $data = { x => [ 1 .. 10 ],
mode => 'markers',
type => 'scatter'
};
$data->{'y'} = [ map { rand 10 } @{ $data->{'x'} } ];
show_plot([$data]);
use aliased 'Chart::Plotly::Trace::Scattergl';
my $big_array = [ 1 .. 10000 ];
my $scattergl = Scattergl->new( x => $big_array, y => [ map { rand 100 } @$big_array ] );
show_plot([$scattergl]);
use Chart::Plotly qw(show_plot);
use PDL;
use aliased 'Chart::Plotly::Trace::Surface';
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.
[](https://travis-ci.org/pablrod/p5-Chart-Plotly)
[](https://ci.appveyor.com/project/pablrod/p5-chart-plotly/branch/master)
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/](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](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/](https://plot.ly/products/cloud/)
# AUTHOR
Pablo Rodríguez González
# 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
- stphnlyd
- weatherwax