# Plotly Graphing Library for MATLAB®

Version: 2.2.10

MATLAB is a registered trademarks of The MathWorks, Inc.

## Install

Once downloaded, run `plotlysetup_offline()` to get started
If you have a plotly bundle url of the form 'http://cdn.plot.ly/plotly-latest.min.js', then run instead
`plotlysetup_offline('plotly_bundle_url')

For online use, run `plotlysetup_online('your_username', 'your_api_key')` to get started.

NOTE: `plotlyupdate.m` is currently turned off.

of the wrapper by following the installation instructions above.

## Usage

Convert your MATLAB® figures into online Plotly graphs with a single line of code:

``` % Create some data for the two curves to be plotted
x  = 0:0.01:20;
y1 = 200*exp(-0.05*x).*sin(x);
y2 = 0.8*exp(-0.5*x).*sin(10*x);

% Create a plot with 2 y axes using the plotyy function
figure;
[ax, h1, h2] = plotyy(x, y1, x, y2, 'plot');

% Add title and x axis label
xlabel('Time (s)');
title('Frequency Response');

% Use the axis handles to set the labels of the y axes
set(get(ax(1), 'Ylabel'), 'String', 'Low Frequency');
set(get(ax(2), 'Ylabel'), 'String', 'High Frequency');

%--PLOTLY--%
p = fig2plotly; % <-- converts the yy-plot to an interactive, online version.

%--URL--%
% p.url = 'https://plot.ly/~matlab_user_guide/1522'
```

Also, access other Plotly services and graphs programatically. Like, publication-quality image export:

` saveplotlyfig(p, 'testimage.svg')`

and Plotly figure retrieval:

` p = getplotlyfig('chris', 1638) % downloads the graph data from https://plot.ly/~chris/1638`

## Documentation

This lives here: https://plot.ly/matlab

## Contribute

Please do! This is an open source project. Check out the issues or open a PR!

We want to encourage a warm, welcoming, and safe environment for contributing to this project. See the code of conduct for more information.