Commit 88c75a11 authored by Tom's avatar Tom

repeated measures plot pretty much done, added support for rash density and rotation

parent 22afdba3
%% Raincloud lineplot for repeated-measures data
% it might be that 'patch' is a much better plotting function to plot the
% densities than 'area'; it seems to handle over-plotting of different
% areas with different zero lines very well. This would avoid the horrible
% gymnastics that the repeated measures raincloudplot currently has to deal
% with.
% This is a work-in-progress example inspired by this post on Matlab
% answers
% Use like: h = rm_raincloud(data, colours)
% Where 'data' is an M x N cell array of N data series and M measurements
% And 'colours' is an N x 3 array defining the colour to plot each data series
% h is a cell array containing handles of the various figure parts
%% TO-DO:
% Patch can create colour gradients using the 'interp' option to 'FaceColor'. Allow this?
function h = rm_raincloud(data, colours, plot_top_to_bottom, density_type, bandwidth)
%% check dimensions of data
[nper, nseries] = size(data);
% make sure we have enough colours
assert(all(size(colours) == [nseries 3]), 'number of colors does not match number of plot series');
if nargin < 3
plot_top_to_bottom = 0; % left-to-right plotting by default
if nargin < 4
density_type = 'ks';
if nargin < 5
bandwidth = [];
%% Calculate properties of density plots
% Probably okay to hard-code this as it just determines the granularity of
% the density estimate
nbins = repmat(200, nper, nseries);
% calculate kernel densities
for i = 1:nper
for j = 1:nseries
% TO-DO: Switch here to use alternative methods to estimate density (e.g. RASH)
switch density_type
case 'ks'
[ks{i,j}, x{i,j}] = ksdensity(data{i,j}, 'NumPoints', nbins(i,j), 'bandwidth', bandwidth);
case 'rash'
[x{i,j}, ks{i,j}] = rst_RASH(data{i,j});
% override default 'nbins' as rst_RASH determines number of bins
nbins(i,j) = size(ks{i,j},2);
% Define the faces to connect each adjacent f(x) and the corresponding points at y = 0.
q{i,j} = (1:nbins(i,j)-1)';
faces{i,j} = [q{i,j}, q{i,j} + 1, q{i,j} + nbins(i,j) + 1, q{i,j} + nbins(i,j)];
% keyboard
% determine spacing between plots
spacing = 2 * mean(mean(cellfun(@max,ks)));
ks_offsets = [0:nper-1] .* spacing;
% flip so first plot in series is plotted on the *top*
ks_offsets = fliplr(ks_offsets);
% calculate patch vertices from kernel density
for i = 1:nper
for j = 1:nseries
verts{i,j} = [x{i,j}', ks{i,j}' + ks_offsets(i); x{i,j}', ones(nbins(i,j),1) * ks_offsets(i)];
verts{i,j} = [x{i,j}', ks{i,j}' + ks_offsets(i); x{i,j}', ones(nbins(i,j),1) * ks_offsets(i)];
%% jitter for the raindrops
jitwidth = spacing / 8;
% TO-DO: This should probably not be hardcoded either...
sz = 100;
for i = 1:nper
for j = 1:nseries
jit{i,j} = jitwidth + rand(1, length(data{i,j})) * jitwidth;
%% means (for mean dots)
mnz = cellfun(@mean, data);
%% plot
% note - we *could* plot everything here in one big loop, but then
% different figure parts would overlay each other in a silly way.
hold on
% patches
for i = 1:nper
for j = 1:nseries
% plot patches
h.p{i,j} = patch('Faces', faces{i,j}, 'Vertices', verts{i,j}, 'FaceVertexCData', [colours(j,:)], 'FaceColor', 'flat', 'EdgeColor', 'none', 'FaceAlpha',0.5);
% scatter rainclouds
h.s{i,j} = scatter(data{i,j}, -jit{i,j} + ks_offsets(i), 'MarkerFaceColor', colours(j,:), 'MarkerEdgeColor', 'none', 'MarkerFaceAlpha', 0.5, 'SizeData', sz);
% plot mean lines
for i = 1:nper-1 % note 2, not 1. We have nper-1 lines because lines connect pairs of points
for j = 1:nseries
h.l(i,j) = line(mnz([i i+1],j), ks_offsets([i i+1]), 'LineWidth', 4, 'Color', colours(j,:));
% plot mean dots
for i = 1:nper
for j = 1:nseries
h.m(i,j) = scatter(mnz(i,j), ks_offsets(i), 'MarkerFaceColor', colours(j,:), 'MarkerEdgeColor', [0 0 0], 'MarkerFaceAlpha', 1, 'SizeData', sz*2, 'LineWidth', 2);
%% clear up axis labels
% 'YTick', likes values that *increase* as you go up the Y-axis, but we plot the first
% raincloud at the top. So flip the vector around
set(gca, 'YTick', fliplr(ks_offsets));
set(gca, 'YTickLabel', nper:-1:1);
%% determine plot rotation
% default option is left-to-right
% plot_top_to_bottom can be set to 1
% NOTE: Because it's easier, we actually prepare everything plotted
% top-to-bottom, then - by default - we rotate it here. That's why the
% logical is constructed the way it is.
% rotate and flip
if ~plot_top_to_bottom
view([90 -90]);
axis ij
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment