Raincloud Plots

[mkitti]

Raincloud plots are a combination of a half-violin plot, a boxplot, and a dotplot. Should this go into StatsPlots.jl or live in its own package?

Background

• https://github.com/RainCloudPlots/RainCloudPlots
• https://wellcomeopenresearch.org/articles/4-63

I've prototype a recipe as follows

	@recipe function f(
		::Type{Val{:raincloud}},
		plt::AbstractPlot;
	    trim = true, #violin
	    side = :right, # differs from violin default
	    show_mean = false,
	    show_median = false,
	    quantiles = Float64[],
            notch = false, # boxplot
	    whisker_range = 1.5,
	    outliers = true,
	    whisker_width = :half,
            mode = :density, # dotplot,
	    dotshift = 0.2, # raincloud
            boxshift = 0,
	    boxfillcolor = :same,
	    box_bar_width = 0.25,
	    dot_bar_width = 0.25
	)
		x = plotattributes[:x]
		y = plotattributes[:y]

		permute --> (:x, :y)
		markeralpha --> 0.5

		@series begin
			seriestype := violin
			side := side
			trim := trim
			show_mean := show_mean
			show_median := show_median
			quantiles := quantiles
			linecolor --> :match
			seriescolor := plotattributes[:series_plotindex]
			#bandwidth := bandwidth
		end

		for (k,v) in series_list[1].plotattributes
			println(k," = ", v)
		end

		@series begin
			primary := false
			label := :none
			seriestype := boxplot
			notch := notch
			whisker_range := whisker_range
			outliers := outliers
			whisker_width := whisker_width
			bar_width --> box_bar_width
			whisker_width --> :match
			seriescolor := plotattributes[:series_plotindex]
			if side == :right
				side := :left
				x := x .- boxshift
			elseif side == :left
				side := :right
				x := x .+ boxshift
			end
			if boxfillcolor != :same
				fillcolor := boxfillcolor
			end
		end

		@series begin
			primary := false
			seriestype := dotplot
			mode := mode
			seriescolor := plotattributes[:series_plotindex]
			bar_width --> dot_bar_width
			if side == :right
				side := :left
				x := x .- dotshift
			elseif side == :left
				side := :right
				x := x .+ dotshift
			end
		end
	end
	Plots.@shorthands raincloud

[mkitti]

@BeastyBlacksmith do you think a raincloud recipe would make sense to add directly to StatsPlots.jl or would it better for it to be a separate package?

[BeastyBlacksmith]

thats a bit on you. I would accept a PR adding this to StatsPlots.jl given that you're in for maintaining that.

[mkitti]

I might pursue a dual track strategy of providing a stable version of raincloud here but also iterating upon it more quickly in a distinct package.