diff --git a/docs/gadfly_examples.md b/docs/gadfly_examples.md deleted file mode 100644 index bdee9f9c..00000000 --- a/docs/gadfly_examples.md +++ /dev/null @@ -1,249 +0,0 @@ -## Examples for backend: gadfly - -### Initialize - -```julia -using Plots -gadfly() -``` - -### Lines - -A simple line plot of the columns. - -```julia -plot(Plots.fakedata(50,5),w=3) -``` - -![](../img/gadfly/gadfly_example_1.png) - -### Functions, adding data, and animations - -Plot multiple functions. You can also put the function first, or use the form `plot(f, xmin, xmax)` where f is a Function or AbstractVector{Function}. - -Get series data: `x, y = plt[i]`. Set series data: `plt[i] = (x,y)`. Add to the series with `push!`/`append!`. - -Easily build animations. (`convert` or `ffmpeg` must be available to generate the animation.) Use command `gif(anim, filename, fps=15)` to save the animation. - -```julia -p = plot([sin,cos],zeros(0),leg=false) -anim = Animation() -for x = linspace(0,10π,200) # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 35: - push!(p,x,Float64[sin(x),cos(x)]) # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 36: - frame(anim) -end -``` - -![](../img/gadfly/gadfly_example_2.gif) - -### Parametric plots - -Plot function pair (x(u), y(u)). - -```julia -plot(sin,(x->begin # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 42: - sin(2x) - end),0,2π,line=4,leg=false,fill=(0,:orange)) -``` - -![](../img/gadfly/gadfly_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/gadfly/gadfly_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/gadfly/gadfly_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/gadfly/gadfly_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/gadfly/gadfly_example_7.png) - -### Build plot in pieces - -Start with a base plot... - -```julia -plot(rand(100) / 3,reg=true,fill=(0,:green)) -``` - -![](../img/gadfly/gadfly_example_8.png) - -### - -and add to it later. - -```julia -scatter!(rand(100),markersize=6,c=:orange) -``` - -![](../img/gadfly/gadfly_example_9.png) - -### Heatmaps - - - -```julia -heatmap(randn(10000),randn(10000),nbins=100) -``` - -![](../img/gadfly/gadfly_example_10.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/gadfly/gadfly_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/gadfly/gadfly_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/gadfly/gadfly_example_13.png) - -### Bar - -x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints) - -```julia -bar(randn(999)) -``` - -![](../img/gadfly/gadfly_example_14.png) - -### Histogram - - - -```julia -histogram(randn(1000),nbins=50) -``` - -![](../img/gadfly/gadfly_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/gadfly/gadfly_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(Plots.fakedata(100,10),n=4,palette=[:grays :blues :heat :lightrainbow],bg=[:orange :pink :darkblue :black]) -``` - -![](../img/gadfly/gadfly_example_17.png) - -### - - - -```julia -subplot!(Plots.fakedata(100,10)) -``` - -![](../img/gadfly/gadfly_example_18.png) - -### Annotations - -Currently only text annotations are supported. Pass in a tuple or vector-of-tuples: (x,y,text). `annotate!(ann)` is shorthand for `plot!(; annotation=ann)` - -```julia -y = rand(10) -plot(y,ann=(3,y[3],text("this is #3",:left))) -annotate!([(5,y[5],text("this is #5",16,:red,:center)),(10,y[10],text("this is #10",:right,20,"courier"))]) -``` - -![](../img/gadfly/gadfly_example_20.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/gadfly/gadfly_example_21.png) - -- Supported arguments: `annotation`, `background_color`, `color`, `color_palette`, `fillcolor`, `fillopacity`, `fillrange`, `foreground_color`, `grid`, `group`, `guidefont`, `label`, `layout`, `legend`, `legendfont`, `lineopacity`, `linestyle`, `linetype`, `linewidth`, `markercolor`, `markeropacity`, `markershape`, `markersize`, `n`, `nbins`, `nc`, `nr`, `show`, `size`, `smooth`, `tickfont`, `title`, `windowtitle`, `x`, `xflip`, `xlabel`, `xlims`, `xscale`, `xticks`, `y`, `yflip`, `ylabel`, `ylims`, `yscale`, `yticks`, `z` -- Supported values for axis: `:auto`, `:left` -- Supported values for linetype: `:bar`, `:heatmap`, `:hexbin`, `:hist`, `:hline`, `:line`, `:none`, `:ohlc`, `:path`, `:scatter`, `:steppost`, `:steppre`, `:sticks`, `:vline` -- Supported values for linestyle: `:auto`, `:dash`, `:dashdot`, `:dashdotdot`, `:dot`, `:solid` -- Supported values for marker: `:Plots.Shape`, `:auto`, `:cross`, `:diamond`, `:dtriangle`, `:ellipse`, `:heptagon`, `:hexagon`, `:none`, `:octagon`, `:pentagon`, `:rect`, `:star4`, `:star5`, `:star6`, `:star7`, `:star8`, `:utriangle`, `:xcross` -- Is `subplot`/`subplot!` supported? Yes - -(Automatically generated: 2015-10-26T13:59:43) \ No newline at end of file diff --git a/docs/immerse_examples.md b/docs/immerse_examples.md deleted file mode 100644 index 5003fb79..00000000 --- a/docs/immerse_examples.md +++ /dev/null @@ -1,235 +0,0 @@ -# Examples for backend: immerse - -- Supported arguments: `annotation`, `background_color`, `color`, `color_palette`, `fillrange`, `fillcolor`, `fillopacity`, `foreground_color`, `group`, `label`, `layout`, `legend`, `linestyle`, `linetype`, `linewidth`, `lineopacity`, `markershape`, `markercolor`, `markersize`, `markeropacity`, `n`, `nbins`, `nc`, `nr`, `smooth`, `show`, `size`, `title`, `windowtitle`, `x`, `xlabel`, `xlims`, `xticks`, `y`, `ylabel`, `ylims`, `yticks`, `xscale`, `yscale`, `xflip`, `yflip`, `z`, `tickfont`, `guidefont`, `legendfont`, `grid` -- Supported values for axis: `:auto`, `:left` -- Supported values for linetype: `:none`, `:line`, `:path`, `:steppre`, `:steppost`, `:sticks`, `:scatter`, `:heatmap`, `:hexbin`, `:hist`, `:bar`, `:hline`, `:vline`, `:ohlc` -- Supported values for linestyle: `:auto`, `:solid`, `:dash`, `:dot`, `:dashdot`, `:dashdotdot` -- Supported values for marker: `:none`, `:auto`, `:cross`, `:diamond`, `:dtriangle`, `:ellipse`, `:heptagon`, `:hexagon`, `:octagon`, `:pentagon`, `:rect`, `:star4`, `:star5`, `:star6`, `:star7`, `:star8`, `:utriangle`, `:xcross`, `:Plots.Shape` -- Is `subplot`/`subplot!` supported? Yes - -### Initialize - -```julia -using Plots -immerse() -``` - -### Lines - -A simple line plot of the columns. - -```julia -plot(fakedata(50,5),w=3) -``` - -![](../img/immerse/immerse_example_1.png) - -### Functions, adding data, and animations - -Plot multiple functions. You can also put the function first, or use the form `plot(f, xmin, xmax)` where f is a Function or AbstractVector{Function}. Set, get, and push/append to series data, and easily build animations. - -Note: ImageMagick's `convert` or `ffmpeg` must be runnable from pwd to generate the animation. - -```julia -p = plot([sin,cos],zeros(0)) -anim = Animation() -for x = linspace(0,10π,200) # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 43: - push!(p,x,Float64[sin(x),cos(x)]) # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 44: - frame(anim) -end -``` - -![](../img/immerse/immerse_example_2.gif) - -### - -Or make a parametric plot (i.e. plot: (fx(u), fy(u))) with plot(fx, fy, umin, umax). - -```julia -plot(sin,(x->begin # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 50: - sin(2x) - end),0,2π,line=4,leg=false,fill=(0,:orange)) -``` - -![](../img/immerse/immerse_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/immerse/immerse_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/immerse/immerse_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/immerse/immerse_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/immerse/immerse_example_7.png) - -### Build plot in pieces - -Start with a base plot... - -```julia -plot(rand(100) / 3,reg=true,fill=(0,:green)) -``` - -![](../img/immerse/immerse_example_8.png) - -### - -and add to it later. - -```julia -scatter!(rand(100),markersize=6,c=:orange) -``` - -![](../img/immerse/immerse_example_9.png) - -### Heatmaps - - - -```julia -heatmap(randn(10000),randn(10000),nbins=100) -``` - -![](../img/immerse/immerse_example_10.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/immerse/immerse_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/immerse/immerse_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=(12,:auto),lab=map(string,markers),bg=:linen) -``` - -![](../img/immerse/immerse_example_13.png) - -### Bar - -x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints) - -```julia -bar(randn(999)) -``` - -![](../img/immerse/immerse_example_14.png) - -### Histogram - - - -```julia -histogram(randn(1000),nbins=50) -``` - -![](../img/immerse/immerse_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/immerse/immerse_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/immerse/immerse_example_17.png) - -### - - - -```julia -subplot!(fakedata(100,10)) -``` - -![](../img/immerse/immerse_example_18.png) - -### Annotations - -Currently only text annotations are supported. Pass in a tuple or vector-of-tuples: (x,y,text). `annotate!(ann)` is shorthand for `plot!(; annotation=ann)` - -```julia -y = rand(10) -plot(y,ann=(3,y[3],text("this is #3",:left))) -annotate!([(5,y[5],text("this is #5",16,:red,:center)),(10,y[10],text("this is #10",:right,20,"courier"))]) -``` - -![](../img/immerse/immerse_example_20.png) - diff --git a/docs/pyplot_examples.md b/docs/pyplot_examples.md deleted file mode 100644 index 2c94e3cd..00000000 --- a/docs/pyplot_examples.md +++ /dev/null @@ -1,249 +0,0 @@ -## Examples for backend: pyplot - -### Initialize - -```julia -using Plots -pyplot() -``` - -### Lines - -A simple line plot of the columns. - -```julia -plot(Plots.fakedata(50,5),w=3) -``` - -![](../img/pyplot/pyplot_example_1.png) - -### Functions, adding data, and animations - -Plot multiple functions. You can also put the function first, or use the form `plot(f, xmin, xmax)` where f is a Function or AbstractVector{Function}. - -Get series data: `x, y = plt[i]`. Set series data: `plt[i] = (x,y)`. Add to the series with `push!`/`append!`. - -Easily build animations. (`convert` or `ffmpeg` must be available to generate the animation.) Use command `gif(anim, filename, fps=15)` to save the animation. - -```julia -p = plot([sin,cos],zeros(0),leg=false) -anim = Animation() -for x = linspace(0,10π,200) # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 35: - push!(p,x,Float64[sin(x),cos(x)]) # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 36: - frame(anim) -end -``` - -![](../img/pyplot/pyplot_example_2.gif) - -### Parametric plots - -Plot function pair (x(u), y(u)). - -```julia -plot(sin,(x->begin # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 42: - sin(2x) - end),0,2π,line=4,leg=false,fill=(0,:orange)) -``` - -![](../img/pyplot/pyplot_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/pyplot/pyplot_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/pyplot/pyplot_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/pyplot/pyplot_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/pyplot/pyplot_example_7.png) - -### Build plot in pieces - -Start with a base plot... - -```julia -plot(rand(100) / 3,reg=true,fill=(0,:green)) -``` - -![](../img/pyplot/pyplot_example_8.png) - -### - -and add to it later. - -```julia -scatter!(rand(100),markersize=6,c=:orange) -``` - -![](../img/pyplot/pyplot_example_9.png) - -### Heatmaps - - - -```julia -heatmap(randn(10000),randn(10000),nbins=100) -``` - -![](../img/pyplot/pyplot_example_10.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/pyplot/pyplot_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/pyplot/pyplot_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/pyplot/pyplot_example_13.png) - -### Bar - -x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints) - -```julia -bar(randn(999)) -``` - -![](../img/pyplot/pyplot_example_14.png) - -### Histogram - - - -```julia -histogram(randn(1000),nbins=50) -``` - -![](../img/pyplot/pyplot_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/pyplot/pyplot_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(Plots.fakedata(100,10),n=4,palette=[:grays :blues :heat :lightrainbow],bg=[:orange :pink :darkblue :black]) -``` - -![](../img/pyplot/pyplot_example_17.png) - -### - - - -```julia -subplot!(Plots.fakedata(100,10)) -``` - -![](../img/pyplot/pyplot_example_18.png) - -### Annotations - -Currently only text annotations are supported. Pass in a tuple or vector-of-tuples: (x,y,text). `annotate!(ann)` is shorthand for `plot!(; annotation=ann)` - -```julia -y = rand(10) -plot(y,ann=(3,y[3],text("this is #3",:left))) -annotate!([(5,y[5],text("this is #5",16,:red,:center)),(10,y[10],text("this is #10",:right,20,"courier"))]) -``` - -![](../img/pyplot/pyplot_example_20.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/pyplot/pyplot_example_21.png) - -- Supported arguments: `annotation`, `axis`, `background_color`, `color`, `color_palette`, `fillcolor`, `fillrange`, `foreground_color`, `group`, `guidefont`, `label`, `layout`, `legend`, `legendfont`, `linestyle`, `linetype`, `linewidth`, `markercolor`, `markershape`, `markersize`, `n`, `nbins`, `nc`, `nr`, `show`, `size`, `tickfont`, `title`, `windowtitle`, `x`, `xflip`, `xlabel`, `xlims`, `xscale`, `xticks`, `y`, `yflip`, `ylabel`, `ylims`, `yrightlabel`, `yscale`, `yticks`, `z` -- Supported values for axis: `:auto`, `:left`, `:right` -- Supported values for linetype: `:bar`, `:heatmap`, `:hexbin`, `:hist`, `:hline`, `:line`, `:none`, `:path`, `:scatter`, `:steppost`, `:steppre`, `:sticks`, `:vline` -- Supported values for linestyle: `:auto`, `:dash`, `:dashdot`, `:dot`, `:solid` -- Supported values for marker: `:Plots.Shape`, `:auto`, `:cross`, `:diamond`, `:dtriangle`, `:ellipse`, `:heptagon`, `:hexagon`, `:none`, `:octagon`, `:pentagon`, `:rect`, `:star4`, `:star5`, `:star6`, `:star7`, `:star8`, `:utriangle`, `:xcross` -- Is `subplot`/`subplot!` supported? Yes - -(Automatically generated: 2015-10-26T14:00:57) \ No newline at end of file diff --git a/docs/qwt_examples.md b/docs/qwt_examples.md deleted file mode 100644 index 5590685e..00000000 --- a/docs/qwt_examples.md +++ /dev/null @@ -1,238 +0,0 @@ -## Examples for backend: qwt - -### Initialize - -```julia -using Plots -qwt() -``` - -### Lines - -A simple line plot of the columns. - -```julia -plot(Plots.fakedata(50,5),w=3) -``` - -![](../img/qwt/qwt_example_1.png) - -### Functions, adding data, and animations - -Plot multiple functions. You can also put the function first, or use the form `plot(f, xmin, xmax)` where f is a Function or AbstractVector{Function}. - -Get series data: `x, y = plt[i]`. Set series data: `plt[i] = (x,y)`. Add to the series with `push!`/`append!`. - -Easily build animations. (`convert` or `ffmpeg` must be available to generate the animation.) Use command `gif(anim, filename, fps=15)` to save the animation. - -```julia -p = plot([sin,cos],zeros(0),leg=false) -anim = Animation() -for x = linspace(0,10π,200) # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 35: - push!(p,x,Float64[sin(x),cos(x)]) # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 36: - frame(anim) -end -``` - -![](../img/qwt/qwt_example_2.gif) - -### Parametric plots - -Plot function pair (x(u), y(u)). - -```julia -plot(sin,(x->begin # /home/tom/.julia/v0.4/Plots/docs/example_generation.jl, line 42: - sin(2x) - end),0,2π,line=4,leg=false,fill=(0,:orange)) -``` - -![](../img/qwt/qwt_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/qwt/qwt_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/qwt/qwt_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/qwt/qwt_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/qwt/qwt_example_7.png) - -### Build plot in pieces - -Start with a base plot... - -```julia -plot(rand(100) / 3,reg=true,fill=(0,:green)) -``` - -![](../img/qwt/qwt_example_8.png) - -### - -and add to it later. - -```julia -scatter!(rand(100),markersize=6,c=:orange) -``` - -![](../img/qwt/qwt_example_9.png) - -### Heatmaps - - - -```julia -heatmap(randn(10000),randn(10000),nbins=100) -``` - -![](../img/qwt/qwt_example_10.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/qwt/qwt_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/qwt/qwt_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/qwt/qwt_example_13.png) - -### Bar - -x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints) - -```julia -bar(randn(999)) -``` - -![](../img/qwt/qwt_example_14.png) - -### Histogram - - - -```julia -histogram(randn(1000),nbins=50) -``` - -![](../img/qwt/qwt_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/qwt/qwt_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(Plots.fakedata(100,10),n=4,palette=[:grays :blues :heat :lightrainbow],bg=[:orange :pink :darkblue :black]) -``` - -![](../img/qwt/qwt_example_17.png) - -### - - - -```julia -subplot!(Plots.fakedata(100,10)) -``` - -![](../img/qwt/qwt_example_18.png) - -### Annotations - -Currently only text annotations are supported. Pass in a tuple or vector-of-tuples: (x,y,text). `annotate!(ann)` is shorthand for `plot!(; annotation=ann)` - -```julia -y = rand(10) -plot(y,ann=(3,y[3],text("this is #3",:left))) -annotate!([(5,y[5],text("this is #5",16,:red,:center)),(10,y[10],text("this is #10",:right,20,"courier"))]) -``` - -![](../img/qwt/qwt_example_20.png) - -- Supported arguments: `annotation`, `axis`, `background_color`, `color`, `color_palette`, `fillcolor`, `fillrange`, `foreground_color`, `group`, `label`, `layout`, `legend`, `linestyle`, `linetype`, `linewidth`, `markercolor`, `markershape`, `markersize`, `n`, `nbins`, `nc`, `nr`, `pos`, `show`, `size`, `smooth`, `title`, `windowtitle`, `x`, `xlabel`, `xlims`, `xscale`, `xticks`, `y`, `ylabel`, `ylims`, `yrightlabel`, `yscale`, `yticks` -- Supported values for axis: `:auto`, `:left`, `:right` -- Supported values for linetype: `:bar`, `:heatmap`, `:hexbin`, `:hist`, `:hline`, `:line`, `:none`, `:path`, `:scatter`, `:steppost`, `:steppre`, `:sticks`, `:vline` -- Supported values for linestyle: `:auto`, `:dash`, `:dashdot`, `:dashdotdot`, `:dot`, `:solid` -- Supported values for marker: `:auto`, `:cross`, `:diamond`, `:dtriangle`, `:ellipse`, `:hexagon`, `:none`, `:rect`, `:star5`, `:star8`, `:utriangle`, `:xcross` -- Is `subplot`/`subplot!` supported? Yes - -(Automatically generated: 2015-10-26T14:02:19) \ No newline at end of file diff --git a/docs/unicodeplots_examples.md b/docs/unicodeplots_examples.md deleted file mode 100644 index abd77379..00000000 --- a/docs/unicodeplots_examples.md +++ /dev/null @@ -1,208 +0,0 @@ -## Examples for backend: unicodeplots - -### Initialize - -```julia -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` -- Supported values for linestyle: `:auto`, `:solid` -- Supported values for marker: `:auto`, `:ellipse`, `:none` -- Is `subplot`/`subplot!` supported? Yes - -(Automatically generated: 2015-10-18T00:07:46) \ No newline at end of file diff --git a/docs/winston_examples.md b/docs/winston_examples.md deleted file mode 100644 index 1c4babd4..00000000 --- a/docs/winston_examples.md +++ /dev/null @@ -1,164 +0,0 @@ -## Examples for backend: winston - -### Initialize - -```julia -using Plots -winston() -``` - -### Lines - -A simple line plot of the columns. - -```julia -plot(fakedata(50,5),w=3) -``` - -![](../img/winston/winston_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/winston/winston_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/winston/winston_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/winston/winston_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/winston/winston_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/winston/winston_example_7.png) - -### Build plot in pieces - -Start with a base plot... - -```julia -plot(rand(100) / 3,reg=true,fill=(0,:green)) -``` - -![](../img/winston/winston_example_8.png) - -### - -and add to it later. - -```julia -scatter!(rand(100),markersize=6,c=:orange) -``` - -![](../img/winston/winston_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/winston/winston_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/winston/winston_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/winston/winston_example_13.png) - -### Bar - -x is the midpoint of the bar. (todo: allow passing of edges instead of midpoints) - -```julia -bar(randn(999)) -``` - -![](../img/winston/winston_example_14.png) - -### Histogram - - - -```julia -histogram(randn(1000),nbins=50) -``` - -![](../img/winston/winston_example_15.png) - -- Supported arguments: `annotation`, `color`, `color_palette`, `fillcolor`, `fillrange`, `group`, `label`, `legend`, `linestyle`, `linetype`, `linewidth`, `markercolor`, `markershape`, `markersize`, `nbins`, `show`, `size`, `smooth`, `title`, `windowtitle`, `x`, `xlabel`, `xlims`, `xscale`, `y`, `ylabel`, `ylims`, `yscale` -- Supported values for axis: `:auto`, `:left` -- Supported values for linetype: `:bar`, `:hist`, `:line`, `:none`, `:path`, `:scatter`, `:sticks` -- Supported values for linestyle: `:auto`, `:dash`, `:dashdot`, `:dot`, `:solid` -- Supported values for marker: `:auto`, `:cross`, `:diamond`, `:dtriangle`, `:ellipse`, `:none`, `:rect`, `:star5`, `:utriangle`, `:xcross` -- Is `subplot`/`subplot!` supported? No - -(Automatically generated: 2015-10-18T00:50:13) \ No newline at end of file