-
-
01 Nov 2020 20:14:57 UTC
- Distribution: Chart-Plotly
- Module version: 0.041
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues
- Testers (61 / 0 / 2)
- Kwalitee
Bus factor: 1- 43.43% Coverage
- License: mit
- Perl: v5.10.0
- Activity
24 month- Tools
- Download (4.89MB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
and 3 contributors-
Roy Storey
-
Stephan Loyd
-
weatherwax
- Dependencies
- Chart::Kaleido::Plotly
- Exporter
- File::ShareDir
- File::Which
- HTML::Show
- JSON
- LWP::UserAgent
- Module::Find
- Module::Load
- Moo::Role
- Moose
- Moose::Util::TypeConstraints
- MooseX::ExtraArgs
- Params::Validate
- Path::Tiny
- Ref::Util
- Role::Tiny
- Text::Template
- UUID::Tiny
- namespace::autoclean
- overload
- strict
- utf8
- vars
- warnings
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- NAME
- VERSION
- SYNOPSIS
- DESCRIPTION
- FUNCTIONS
- BUGS
- DISCLAIMER
- AUTHOR
- COPYRIGHT AND LICENSE
- CONTRIBUTORS
NAME
Chart::Plotly - Generate html/javascript charts from perl data using javascript library plotly.js
VERSION
version 0.041
SYNOPSIS
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.
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) 2020 by Pablo Rodríguez González.
This is free software, licensed under:
The MIT (X11) License
CONTRIBUTORS
Roy Storey <kiwiroy@users.noreply.github.com>
Stephan Loyd <stephanloyd9@gmail.com>
weatherwax <s.g.lobo@hotmail.com>
Module Install Instructions
To install Chart::Plotly, copy and paste the appropriate command in to your terminal.
cpanm Chart::Plotly
perl -MCPAN -e shell install Chart::Plotly
For more information on module installation, please visit the detailed CPAN module installation guide.