jk/color cycler 2 (#741)

Author: jkrumbiegel

docs/src/plotting_functions/barplot.md

@@ -77,7 +77,7 @@ barplot(tbl.x, tbl.height,
 
 ```@example bar
 let
-    colors = AbstractPlotting.wong_colors
+    colors = AbstractPlotting.wong_colors()
 
     # Figure and Axis
     fig = Figure()

docs/src/plotting_functions/errorbars.md

@@ -43,7 +43,9 @@ ys = 0.5 .* sin.(xs)
 lowerrors = fill(0.1, length(xs))
 higherrors = LinRange(0.1, 0.4, length(xs))
 
-errorbars!(xs, ys, lowerrors, higherrors, color = LinRange(0, 1, length(xs)))
+errorbars!(xs, ys, lowerrors, higherrors,
+    color = range(0, 1, length = length(xs)),
+    whiskerwidth = 10)
 
 # plot position scatters so low and high errors can be discriminated
 scatter!(xs, ys, markersize = 3, color = :black)

docs/src/plotting_functions/rangebars.md

@@ -37,7 +37,7 @@ lows = zeros(length(vals))
 highs = LinRange(0.1, 0.4, length(vals))
 
 rangebars!(vals, lows, highs, color = LinRange(0, 1, length(vals)),
-    whiskerwidth = 3, direction = :x)
+    whiskerwidth = 10, direction = :x)
 
 f
 ```

docs/src/theming.md

@@ -9,12 +9,14 @@ You can also reset your changes by calling `set_theme!()` without arguments.
 Let's create a plot with the default theme:
 
 ```@example 1
-using GLMakie
+using CairoMakie
+CairoMakie.activate!() # hide
+AbstractPlotting.inline!(true) # hide
 
 function example_plot()
     f = Figure()
     for i in 1:2, j in 1:2
-        lines(f[i, j], cumsum(randn(1000)))
+        lines(f[i, j], cumsum(randn(50)))
     end
     f
 end
@@ -53,6 +55,21 @@ with_theme(fontsize_theme, fontsize = 25) do
 end
 ```
 
+## Theming plot objects
+
+You can theme plot objects by using their uppercase type names as a key in your theme.
+
+```@example 1
+lines_theme = Theme(
+    Lines = (
+        linewidth = 4,
+        linestyle = :dash,
+    )
+)
+
+with_theme(example_plot, lines_theme)
+```
+
 ## Theming layoutable objects
 
 Every Layoutable such as `Axis`, `Legend`, `Colorbar`, etc. can be themed by using its type name as a key in your theme.
@@ -75,6 +92,61 @@ ggplot_theme = Theme(
 with_theme(example_plot, ggplot_theme)
 ```
 
-### Special attributes
+## Cycles
+
+Makie supports a variety of options for cycling plot attributes automatically.
+For a plot object to use cycling, either its default theme or the currently active theme must have the `cycle` attribute set.
+
+There are multiple ways to specify this attribute:
+
+```julia
+# You can either make a list of symbols
+cycle = [:color, :marker]
+# or map specific plot attributes to palette attributes
+cycle = [:linecolor => :color, :marker]
+# you can also map multiple attributes that should receive
+# the same cycle attribute
+cycle = [[:linecolor, :markercolor] => :color, :marker]
+```
+
+```@example
+using CairoMakie
+CairoMakie.activate!() # hide
+AbstractPlotting.inline!(true) # hide
+
+set_theme!() # hide
+
+f = Figure(resolution = (800, 800))
+
+Axis(f[1, 1], title = "Default cycle palette")
+
+for i in 1:6
+    density!(randn(50) .+ 2i)
+end
+
+Axis(f[2, 1],
+    title = "Custom cycle palette",
+    palette = (patchcolor = [:red, :green, :blue, :yellow, :orange, :pink],))
+
+for i in 1:6
+    density!(randn(50) .+ 2i)
+end
+
+set_theme!(Density = (cycle = [],))
+
+Axis(f[3, 1], title = "No cycle")
+
+for i in 1:6
+    density!(randn(50) .+ 2i)
+end
+
+set_theme!() # hide
+
+f
+```
+
+
+
+## Special attributes
 
 You can use the keys `rowgap` and `colgap` to change the default grid layout gaps.

src/basic_recipes/arrows.jl

@@ -34,7 +34,7 @@ $(ATTRIBUTES)
             align = :origin,
             normalize = false,
             lengthscale = 1f0,
-            colormap = :viridis,
+            colormap = theme(scene, :colormap),
             quality = 32,
             inspectable = theme(scene, :inspectable)
         )

src/basic_recipes/band.jl

@@ -12,7 +12,6 @@ $(ATTRIBUTES)
     Attributes(;
         default_theme(scene, Mesh)...,
         colorrange = automatic,
-        color = RGBAf0(0,0,0,0.2)
     )
 end
 

src/basic_recipes/barplot.jl

@@ -9,7 +9,7 @@ $(ATTRIBUTES)
 @recipe(BarPlot, x, y) do scene
     Attributes(;
         fillto = automatic,
-        color = theme(scene, :color),
+        color = theme(scene, :patchcolor),
         colormap = theme(scene, :colormap),
         colorrange = automatic,
         dodge = automatic,
@@ -18,12 +18,13 @@ $(ATTRIBUTES)
         dodge_gap = 0.03,
         marker = Rect,
         stack = automatic,
-        strokewidth = 0,
-        strokecolor = :white,
+        strokewidth = theme(scene, :patchstrokewidth),
+        strokecolor = theme(scene, :patchstrokecolor),
         width = automatic,
         direction = :y,
         visible = theme(scene, :visible),
-        inspectable = theme(scene, :inspectable)
+        inspectable = theme(scene, :inspectable),
+        cycle = [:color => :patchcolor],
     )
 end
 

src/basic_recipes/contourf.jl

@@ -22,7 +22,7 @@ $(ATTRIBUTES)
     Theme(
         levels = 10,
         mode = :normal,
-        colormap = :viridis,
+        colormap = theme(scene, :colormap),
         extendlow = nothing,
         extendhigh = nothing,
         inspectable = theme(scene, :inspectable)

src/basic_recipes/contours.jl

@@ -9,7 +9,7 @@ $(ATTRIBUTES)
 """
 @recipe(Contour) do scene
     default = default_theme(scene)
-    pop!(default, :color)
+    # pop!(default, :color)
     Attributes(;
         default...,
         color = nothing,

src/basic_recipes/error_and_rangebars.jl

@@ -19,12 +19,12 @@ $(ATTRIBUTES)
 """
 @recipe(Errorbars) do scene
     Theme(
-        whiskerwidth = 10,
-        color = :black,
-        linewidth = 1,
+        whiskerwidth = 0,
+        color = theme(scene, :linecolor),
+        linewidth = theme(scene, :linewidth),
         direction = :y,
         visible = theme(scene, :visible),
-        colormap = :viridis,
+        colormap = theme(scene, :colormap),
         inspectable = theme(scene, :inspectable)
     )
 end
@@ -45,12 +45,12 @@ $(ATTRIBUTES)
 """
 @recipe(Rangebars) do scene
     Theme(
-        whiskerwidth = 10,
-        color = :black,
-        linewidth = 1,
+        whiskerwidth = 0,
+        color = theme(scene, :linecolor),
+        linewidth = theme(scene, :linewidth),
         direction = :y,
         visible = theme(scene, :visible),
-        colormap = :viridis,
+        colormap = theme(scene, :colormap),
         inspectable = theme(scene, :inspectable)
     )
 end