diff --git a/docs/unicodeplots_examples.md b/docs/unicodeplots_examples.md index d3f7d581..abd77379 100644 --- a/docs/unicodeplots_examples.md +++ b/docs/unicodeplots_examples.md @@ -7,6 +7,197 @@ using Plots unicodeplots() ``` +### Lines + +A simple line plot of the columns. + +```julia +plot(fakedata(50,5),w=3) +``` + +![](../img/unicodeplots/unicodeplots_example_1.png) + +### Parametric plots + +Plot function pair (x(u), y(u)). + +```julia +plot(sin,(x->begin # /Users/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 50: + sin(2x) + end),0,2π,line=4,leg=false,fill=(0,:orange)) +``` + +![](../img/unicodeplots/unicodeplots_example_3.png) + +### Colors + +Access predefined palettes (or build your own with the `colorscheme` method). Line/marker colors are auto-generated from the plot's palette, unless overridden. Set the `z` argument to turn on series gradients. + +```julia +y = rand(100) +plot(0:10:100,rand(11,4),lab="lines",w=3,palette=:grays,fill=(0.5,:auto)) +scatter!(y,z=abs(y - 0.5),m=(10,:heat),lab="grad") +``` + +![](../img/unicodeplots/unicodeplots_example_4.png) + +### Global + +Change the guides/background/limits/ticks. Convenience args `xaxis` and `yaxis` allow you to pass a tuple or value which will be mapped to the relevant args automatically. The `xaxis` below will be replaced with `xlabel` and `xlims` args automatically during the preprocessing step. You can also use shorthand functions: `title!`, `xaxis!`, `yaxis!`, `xlabel!`, `ylabel!`, `xlims!`, `ylims!`, `xticks!`, `yticks!` + +```julia +plot(rand(20,3),xaxis=("XLABEL",(-5,30),0:2:20,:flip),background_color=RGB(0.2,0.2,0.2),leg=false) +title!("TITLE") +yaxis!("YLABEL",:log10) +``` + +![](../img/unicodeplots/unicodeplots_example_5.png) + +### Two-axis + +Use the `axis` arguments. + +Note: Currently only supported with Qwt and PyPlot + +```julia +plot(Vector[randn(100),randn(100) * 100],axis=[:l :r],ylabel="LEFT",yrightlabel="RIGHT") +``` + +![](../img/unicodeplots/unicodeplots_example_6.png) + +### Arguments + +Plot multiple series with different numbers of points. Mix arguments that apply to all series (marker/markersize) with arguments unique to each series (colors). Special arguments `line`, `marker`, and `fill` will automatically figure out what arguments to set (for example, we are setting the `linestyle`, `linewidth`, and `color` arguments with `line`.) Note that we pass a matrix of colors, and this applies the colors to each series. + +```julia +plot(Vector[rand(10),rand(20)],marker=(:ellipse,8),line=(:dot,3,[:black :orange])) +``` + +![](../img/unicodeplots/unicodeplots_example_7.png) + +### Build plot in pieces + +Start with a base plot... + +```julia +plot(rand(100) / 3,reg=true,fill=(0,:green)) +``` + +![](../img/unicodeplots/unicodeplots_example_8.png) + +### + +and add to it later. + +```julia +scatter!(rand(100),markersize=6,c=:orange) +``` + +![](../img/unicodeplots/unicodeplots_example_9.png) + +### Line types + + + +```julia +types = intersect(supportedTypes(),[:line,:path,:steppre,:steppost,:sticks,:scatter])' +n = length(types) +x = Vector[sort(rand(20)) for i = 1:n] +y = rand(20,n) +plot(x,y,line=(types,3),lab=map(string,types),ms=15) +``` + +![](../img/unicodeplots/unicodeplots_example_11.png) + +### Line styles + + + +```julia +styles = setdiff(supportedStyles(),[:auto])' +plot(cumsum(randn(20,length(styles)),1),style=:auto,label=map(string,styles),w=5) +``` + +![](../img/unicodeplots/unicodeplots_example_12.png) + +### Marker types + + + +```julia +markers = setdiff(supportedMarkers(),[:none,:auto,Shape])' +n = length(markers) +x = (linspace(0,10,n + 2))[2:end - 1] +y = repmat(reverse(x)',n,1) +scatter(x,y,m=(8,:auto),lab=map(string,markers),bg=:linen) +``` + +![](../img/unicodeplots/unicodeplots_example_13.png) + +### Bar + +x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints) + +```julia +bar(randn(999)) +``` + +![](../img/unicodeplots/unicodeplots_example_14.png) + +### Histogram + + + +```julia +histogram(randn(1000),nbins=50) +``` + +![](../img/unicodeplots/unicodeplots_example_15.png) + +### Subplots + + subplot and subplot! are distinct commands which create many plots and add series to them in a circular fashion. + You can define the layout with keyword params... either set the number of plots `n` (and optionally number of rows `nr` or + number of columns `nc`), or you can set the layout directly with `layout`. + + +```julia +subplot(randn(100,5),layout=[1,1,3],t=[:line :hist :scatter :step :bar],nbins=10,leg=false) +``` + +![](../img/unicodeplots/unicodeplots_example_16.png) + +### Adding to subplots + +Note here the automatic grid layout, as well as the order in which new series are added to the plots. + +```julia +subplot(fakedata(100,10),n=4,palette=[:grays :blues :heat :lightrainbow],bg=[:orange :pink :darkblue :black]) +``` + +![](../img/unicodeplots/unicodeplots_example_17.png) + +### + + + +```julia +subplot!(fakedata(100,10)) +``` + +![](../img/unicodeplots/unicodeplots_example_18.png) + +### Custom Markers + +A `Plots.Shape` is a light wrapper around vertices of a polygon. For supported backends, pass arbitrary polygons as the marker shapes. Note: The center is (0,0) and the size is expected to be rougly the area of the unit circle. + +```julia +verts = [(-1.0,1.0),(-1.28,0.6),(-0.2,-1.4),(0.2,-1.4),(1.28,0.6),(1.0,1.0),(-1.0,1.0),(-0.2,-0.6),(0.0,-0.2),(-0.4,0.6),(1.28,0.6),(0.2,-1.4),(-0.2,-1.4),(0.6,0.2),(-0.2,0.2),(0.0,-0.2),(0.2,0.2),(-0.2,-0.6)] +plot(0.1:0.2:0.9,0.7 * rand(5) + 0.15,l=(3,:dash,:lightblue),m=(Shape(verts),30,RGBA(0,0,0,0.2)),bg=:pink,fg=:darkblue,xlim=(0,1),ylim=(0,1),leg=false) +``` + +![](../img/unicodeplots/unicodeplots_example_21.png) + - Supported arguments: `group`, `label`, `legend`, `linestyle`, `linetype`, `markershape`, `nbins`, `show`, `size`, `title`, `windowtitle`, `x`, `xlabel`, `xlims`, `y`, `ylabel`, `ylims` - Supported values for axis: `:auto`, `:left` - Supported values for linetype: `:bar`, `:heatmap`, `:hexbin`, `:hist`, `:hline`, `:line`, `:none`, `:path`, `:scatter`, `:steppost`, `:sticks`, `:vline` @@ -14,4 +205,4 @@ unicodeplots() - Supported values for marker: `:auto`, `:ellipse`, `:none` - Is `subplot`/`subplot!` supported? Yes -(Automatically generated: 2015-10-17T23:51:17) \ No newline at end of file +(Automatically generated: 2015-10-18T00:07:46) \ No newline at end of file diff --git a/img/unicodeplots/unicodeplots_example_1.png b/img/unicodeplots/unicodeplots_example_1.png index e69de29b..7d661e57 100644 Binary files a/img/unicodeplots/unicodeplots_example_1.png and b/img/unicodeplots/unicodeplots_example_1.png differ diff --git a/img/unicodeplots/unicodeplots_example_11.png b/img/unicodeplots/unicodeplots_example_11.png index e69de29b..61e5ba84 100644 Binary files a/img/unicodeplots/unicodeplots_example_11.png and b/img/unicodeplots/unicodeplots_example_11.png differ diff --git a/img/unicodeplots/unicodeplots_example_12.png b/img/unicodeplots/unicodeplots_example_12.png index e69de29b..07201baf 100644 Binary files a/img/unicodeplots/unicodeplots_example_12.png and b/img/unicodeplots/unicodeplots_example_12.png differ diff --git a/img/unicodeplots/unicodeplots_example_13.png b/img/unicodeplots/unicodeplots_example_13.png index e69de29b..45a181ff 100644 Binary files a/img/unicodeplots/unicodeplots_example_13.png and b/img/unicodeplots/unicodeplots_example_13.png differ diff --git a/img/unicodeplots/unicodeplots_example_14.png b/img/unicodeplots/unicodeplots_example_14.png index e69de29b..eeae4524 100644 Binary files a/img/unicodeplots/unicodeplots_example_14.png and b/img/unicodeplots/unicodeplots_example_14.png differ diff --git a/img/unicodeplots/unicodeplots_example_15.png b/img/unicodeplots/unicodeplots_example_15.png index e69de29b..c479402b 100644 Binary files a/img/unicodeplots/unicodeplots_example_15.png and b/img/unicodeplots/unicodeplots_example_15.png differ diff --git a/img/unicodeplots/unicodeplots_example_16.png b/img/unicodeplots/unicodeplots_example_16.png index e69de29b..5d7603d9 100644 Binary files a/img/unicodeplots/unicodeplots_example_16.png and b/img/unicodeplots/unicodeplots_example_16.png differ diff --git a/img/unicodeplots/unicodeplots_example_17.png b/img/unicodeplots/unicodeplots_example_17.png index e69de29b..16dfc209 100644 Binary files a/img/unicodeplots/unicodeplots_example_17.png and b/img/unicodeplots/unicodeplots_example_17.png differ diff --git a/img/unicodeplots/unicodeplots_example_18.png b/img/unicodeplots/unicodeplots_example_18.png index e69de29b..35994913 100644 Binary files a/img/unicodeplots/unicodeplots_example_18.png and b/img/unicodeplots/unicodeplots_example_18.png differ diff --git a/img/unicodeplots/unicodeplots_example_21.png b/img/unicodeplots/unicodeplots_example_21.png index e69de29b..bfbf5112 100644 Binary files a/img/unicodeplots/unicodeplots_example_21.png and b/img/unicodeplots/unicodeplots_example_21.png differ diff --git a/img/unicodeplots/unicodeplots_example_3.png b/img/unicodeplots/unicodeplots_example_3.png index e69de29b..760f9fa3 100644 Binary files a/img/unicodeplots/unicodeplots_example_3.png and b/img/unicodeplots/unicodeplots_example_3.png differ diff --git a/img/unicodeplots/unicodeplots_example_4.png b/img/unicodeplots/unicodeplots_example_4.png index e69de29b..fd41fdb3 100644 Binary files a/img/unicodeplots/unicodeplots_example_4.png and b/img/unicodeplots/unicodeplots_example_4.png differ diff --git a/img/unicodeplots/unicodeplots_example_5.png b/img/unicodeplots/unicodeplots_example_5.png index e69de29b..adb3a0f6 100644 Binary files a/img/unicodeplots/unicodeplots_example_5.png and b/img/unicodeplots/unicodeplots_example_5.png differ diff --git a/img/unicodeplots/unicodeplots_example_6.png b/img/unicodeplots/unicodeplots_example_6.png index e69de29b..951d1bd9 100644 Binary files a/img/unicodeplots/unicodeplots_example_6.png and b/img/unicodeplots/unicodeplots_example_6.png differ diff --git a/img/unicodeplots/unicodeplots_example_7.png b/img/unicodeplots/unicodeplots_example_7.png index e69de29b..cba85690 100644 Binary files a/img/unicodeplots/unicodeplots_example_7.png and b/img/unicodeplots/unicodeplots_example_7.png differ diff --git a/img/unicodeplots/unicodeplots_example_8.png b/img/unicodeplots/unicodeplots_example_8.png index e69de29b..94ef2e45 100644 Binary files a/img/unicodeplots/unicodeplots_example_8.png and b/img/unicodeplots/unicodeplots_example_8.png differ diff --git a/img/unicodeplots/unicodeplots_example_9.png b/img/unicodeplots/unicodeplots_example_9.png index e69de29b..c36f8f0c 100644 Binary files a/img/unicodeplots/unicodeplots_example_9.png and b/img/unicodeplots/unicodeplots_example_9.png differ diff --git a/src/backends/unicodeplots.jl b/src/backends/unicodeplots.jl index 2d68ff75..5fbefbba 100644 --- a/src/backends/unicodeplots.jl +++ b/src/backends/unicodeplots.jl @@ -206,7 +206,11 @@ end # ------------------------------- # function savepng(::UnicodePlotsPackage, plt::PlottingObject, fn::@compat(AbstractString), args...) -function Base.writemime(io::IO, ::MIME"image/png", plt::PlottingObject{UnicodePlotsPackage}) +# function Base.writemime(io::IO, ::MIME"image/png", plt::PlottingObject{UnicodePlotsPackage}) + +# since this is such a hack, it's only callable using `png`... should error during normal `writemime` +function png(plt::PlottingObject{UnicodePlotsPackage}, fn::@compat(AbstractString)) + fn = addExtension(fn, "png") # make some whitespace and show the plot println("\n\n\n\n\n\n")