Skip to content

Commit 1b52d26

Browse files
chriddypchriddyp
committed
first
0 parents  commit 1b52d26

File tree

13 files changed

+307
-0
lines changed

13 files changed

+307
-0
lines changed

‎plotly.zip‎

9.34 KB
Binary file not shown.

‎plotly/README.txt‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
Plotly - Create publication quality graphs, all in your web browser!
2+
------
3+
Plotly (https://plot.ly) is a browser-based data analysis and visualization tool that creates interactive, customizable, publication quality figures.
4+
5+
This API allows MATLAB users to generate Plotly graphs from their desktop MATLAB environment.
6+
7+
All graphs can be styled and shared through Plotly's interactive web application.
8+
To use, simply:
9+
1) sign-up,
10+
2) sign-in,
11+
3) call: >> plotly(x,y) with your data,
12+
4) View, style and share your plot in your browser at Plotly (https://plot.ly)
13+
14+
See full documentation and examples at https://plot.ly/API
15+
16+
17+
Example Graphs
18+
--------------
19+
Scatter - https://plot.ly/~chris/514/
20+
Scatter + Line - https://plot.ly/~jackp/614/
21+
Stacked Bar - https://plot.ly/~jackp/655/
22+
Grouped Bar - https://plot.ly/~jackp/540/700/500/
23+
2D Histogram + Scatter - https://plot.ly/~chris/497/
24+
1D Histogram - https://plot.ly/~chris/429/
25+
Line - https://plot.ly/~jackp/645/
26+
Area - https://plot.ly/~jackp/621/
27+
Heatmap - https://plot.ly/~jackp/620/
28+
Error Bars - https://plot.ly/~chris/421/
29+
30+
31+
Plotly Features
32+
---------------
33+
- Send data to your Plotly account through this API
34+
- Graphs are fully customizable through the Plotly web-app
35+
- Rich colour and styling options
36+
- View and style graphs interactively in your browser
37+
- Publication quality exports to PNG, SVG, EPS, PDF
38+
- Share graphs through links, Facebook, and Twitter
39+
40+
41+
Example Workflow
42+
----------------
43+
1. Collect or generate some data in your MATLAB environment
44+
2. Send data to your Plotly account through this Plotly-MATLAB API
45+
3. View interactive graph in your browser, e.g.: https://plot.ly/~chris/407/
46+
4. Style graph in the Plotly GUI
47+
5. Share graph by shortlink, Facebook, or Twitter
48+
6. Export to PNG, PDF, EPS, SVG
49+
50+
51+
Documentation
52+
-------------
53+
Full documentation and examples at https://plot.ly/API

‎plotly/plotly.m‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
function [response] = plotly(varargin)
2+
% plotly - create a graph in your plotly account
3+
% [response] = plotly(x1,y1,x2,y2,..., kwargs)
4+
% [response] = plotly({data1, data2, ...}, kwargs)
5+
% x1,y1 - arrays
6+
% data1 - a data struct with styling information
7+
% kwargs - an optional argument struct
8+
%
9+
% See also plotlylayout, plotlystyle, signin, signup
10+
%
11+
% For full documentation and examples, see https://plot.ly/api
12+
% check if signed in
13+
[un, key] = signin;
14+
if isempty(un) || isempty(key)
15+
error('Not signed in.')
16+
end
17+
18+
origin = 'plot';
19+
if isstruct(varargin{end})
20+
structargs = varargin{end};
21+
f = lower(fieldnames(structargs));
22+
if ~any(strcmp('filename',f))
23+
structargs.filename = NaN;
24+
end
25+
if ~any(strcmp('fileopt',f))
26+
structargs.fileopt = NaN;
27+
end
28+
args = varargin(1:(end-1));
29+
else
30+
structargs = struct('filename', NaN,'fileopt',NaN);
31+
args = varargin(1:end);
32+
end
33+
34+
response= makecall(args, un, key, origin, structargs);
35+
end

‎plotly/plotly_aux/cell2json.m‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
function str = cell2json(s)
2+
str = '';
3+
for i =1:length(s)
4+
val = s{i};
5+
valstr = m2json(val);
6+
str = [str ', ' valstr];
7+
end
8+
str = str(3:end); % snip leading comma
9+
str = ['[' str ']'];
10+
end

‎plotly/plotly_aux/json2struct.m‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
function st = json2struct(j)
2+
3+
% everything is between double quotes. sweet!
4+
st = struct();
5+
idx = strfind(j,'"');
6+
for i = 1:4:(length(idx)-2)
7+
jf = j( (idx(i)+1):(idx(i+1)-1) );
8+
jv = j( (idx(i+2)+1):(idx(i+3)-1) );
9+
st = setfield(st, jf, jv);
10+
end
11+
end

‎plotly/plotly_aux/m2json.m‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
function valstr = m2json(val)
2+
if isstruct(val)
3+
valstr = struct2json(val);
4+
elseif iscell(val)
5+
valstr = cell2json(val);
6+
elseif isa(val, 'numeric')
7+
sz = size(val);
8+
if length(find(sz>1))>1 % 2D or higher array
9+
valstr = '';
10+
for i = 1:sz(1)
11+
valsubstr = [sprintf('%d, ', val(i,:))];
12+
valsubstr = valsubstr(1:(end-2));
13+
valstr = [valstr ', [' valsubstr ']'];
14+
end
15+
valstr = valstr(3:end); % trail leading commas
16+
else
17+
valstr = [sprintf('%d, ', val)];
18+
valstr = valstr(1:(end-2));
19+
end
20+
if length(val)>1
21+
valstr = ['[' valstr ']'];
22+
end
23+
elseif ischar(val)
24+
valstr = ['"' val '"'];
25+
elseif islogical(val)
26+
if val
27+
valstr = 'true';
28+
else
29+
valstr = 'false';
30+
end
31+
else
32+
valstr = ''; % wtf is it?
33+
end
34+
valstr = strrep(valstr, 'Inf', 'null');
35+
valstr = strrep(valstr, 'NaN', 'null');

‎plotly/plotly_aux/makecall.m‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
function st = makecall(args, un, key, origin, structargs)
2+
version = '0.2';
3+
platform = 'MATLAB';
4+
5+
args = m2json(args);
6+
kwargs = m2json(structargs);
7+
url = 'https://plot.ly/clientresp';
8+
payload = {'platform', platform, 'version', version, 'args', args, 'un', un, 'key', key, 'origin', origin, 'kwargs', kwargs};
9+
10+
resp = urlread(url, 'Post', payload);
11+
st = json2struct(resp);
12+
13+
f = fieldnames(st);
14+
if any(strcmp(f,'error'))
15+
error(st.error)
16+
end
17+
if any(strcmp(f,'warning'))
18+
fprintf(st.warning)
19+
end
20+
if any(strcmp(f,'message'))
21+
fprintf(st.message)
22+
end
23+
if any(strcmp(f,'filename'))
24+
plotlysession(st.filename)
25+
end
26+
end

‎plotly/plotly_aux/plotlysession.m‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
function [filename] = plotlysession(varargin)
2+
% a function to save variables that are important to a plotly
3+
% users session.
4+
persistent FILENAME
5+
if nargin==1
6+
FILENAME = varargin{1};
7+
mlock;
8+
else
9+
filename = FILENAME;
10+
end
11+
end

‎plotly/plotly_aux/struct2json.m‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
function str = struct2json(s)
2+
f = fieldnames(s);
3+
str = '';
4+
for i = 1:length(fieldnames(s))
5+
val = s.(f{i});
6+
valstr = m2json(val);
7+
str = [str '"' f{i} '"' ': ' valstr ', ' ];
8+
end
9+
str = str(1:(end-2)); % trim trailing comma
10+
str = ['{' str '}'];
11+
end

‎plotly/plotlylayout.m‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
function [response] = plotlylayout(varargin)
2+
% plotlylayout- apply layout to a plotly plot
3+
% [response] = plotlylayout(layout, kwargs)
4+
% layout - struct specifying the layout
5+
% kwargs - an optional argument struct
6+
%
7+
% See also plotly, plotlystyle, signin, signup
8+
%
9+
% For full documentation and examples, see https://plot.ly/api
10+
% check if signed in
11+
[un, key] = signin;
12+
if isempty(un) || isempty(key)
13+
error('Not signed in.')
14+
end
15+
16+
%%%%%%%%%%%%%%%
17+
% call plotly %
18+
%%%%%%%%%%%%%%%
19+
origin = 'layout';
20+
args = varargin(1);
21+
if nargin==2
22+
if isstruct(varargin{end})
23+
structargs = varargin{end};
24+
f = lower(fieldnames(structargs));
25+
if ~any(strcmp('filename',f))
26+
structargs.filename = plotlysession;
27+
end
28+
if ~any(strcmp('fileopt',f))
29+
structargs.fileopt = NaN;
30+
end
31+
end
32+
else
33+
structargs = struct('filename', plotlysession,'fileopt',NaN);
34+
end
35+
36+
response = makecall(args, un, key, origin, structargs);
37+
end

0 commit comments

Comments
 (0)