From cd0f645a06e3796f81a133ed948cd2ec70fb5c7d Mon Sep 17 00:00:00 2001 From: Ivan Date: Wed, 11 Dec 2024 00:43:38 +0200 Subject: [PATCH] plots tutorial --- docs/make.jl | 3 +- docs/src/tutorial/plot_bar_gr.png | Bin 0 -> 21543 bytes docs/src/tutorial/plot_bar_pgf.png | Bin 0 -> 24627 bytes docs/src/tutorial/plot_sim_gr.png | Bin 0 -> 27061 bytes docs/src/tutorial/plot_sim_pgf.png | Bin 0 -> 38655 bytes docs/src/tutorial/plot_sim_plotly.png | Bin 0 -> 35105 bytes docs/src/tutorial/plots.md | 80 ++++++++++++++++++++++++++ 7 files changed, 82 insertions(+), 1 deletion(-) create mode 100644 docs/src/tutorial/plot_bar_gr.png create mode 100644 docs/src/tutorial/plot_bar_pgf.png create mode 100644 docs/src/tutorial/plot_sim_gr.png create mode 100644 docs/src/tutorial/plot_sim_pgf.png create mode 100644 docs/src/tutorial/plot_sim_plotly.png create mode 100644 docs/src/tutorial/plots.md diff --git a/docs/make.jl b/docs/make.jl index 6f3d9fc..e9fc38e 100644 --- a/docs/make.jl +++ b/docs/make.jl @@ -24,7 +24,8 @@ makedocs( "tutorial/sim.md", "tutorial/mc.md", "tutorial/fit.md", - "tutorial/gsa.md" + "tutorial/gsa.md", + "tutorial/plots.md" ], "API" => "api.md" ], diff --git a/docs/src/tutorial/plot_bar_gr.png b/docs/src/tutorial/plot_bar_gr.png new file mode 100644 index 0000000000000000000000000000000000000000..ddb828859df85f3472b75f381f779fef8d47aaa2 GIT binary patch literal 21543 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 CNa^DM literal 0 HcmV?d00001 diff --git a/docs/src/tutorial/plot_bar_pgf.png b/docs/src/tutorial/plot_bar_pgf.png new file mode 100644 index 0000000000000000000000000000000000000000..4d377a4d1c813b3a591fa3e404b57aa53f6dc74e GIT binary patch literal 24627 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 WtGgukkB_m$kc5S(HyGFLO8XCd2{3Q~ literal 0 HcmV?d00001 diff --git a/docs/src/tutorial/plot_sim_gr.png b/docs/src/tutorial/plot_sim_gr.png new file mode 100644 index 0000000000000000000000000000000000000000..abc07af66c4b081d1a674631f61aa44fa92331b1 GIT binary patch literal 27061 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�cTPJ*UjZkVhhU#6KE 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 literal 0 HcmV?d00001 diff --git a/docs/src/tutorial/plot_sim_pgf.png b/docs/src/tutorial/plot_sim_pgf.png new file mode 100644 index 0000000000000000000000000000000000000000..d8ff7813aca655e27411c18025fd39ddccc6b8e8 GIT binary patch literal 38655 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 literal 0 HcmV?d00001 diff --git a/docs/src/tutorial/plot_sim_plotly.png b/docs/src/tutorial/plot_sim_plotly.png new file mode 100644 index 0000000000000000000000000000000000000000..fdc2fc638a818dd0097fecc75f2cbd2c1fe57c4d GIT binary patch literal 35105 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 literal 0 HcmV?d00001 diff --git a/docs/src/tutorial/plots.md b/docs/src/tutorial/plots.md new file mode 100644 index 0000000..a904871 --- /dev/null +++ b/docs/src/tutorial/plots.md @@ -0,0 +1,80 @@ +# Plots + +This tutorial describes the following **Plots.jl** concepts: *backends*, *themes* and *color schemes*. +These settings are useful both for visualizing HetaSimulator objects and any other data. For detailed information on basic **Plots.jl** usage please consult the [documentation](https://docs.juliaplots.org/stable/). + +The following artificial data and functions will be used to illustrate the tutorial: + +``` +using Plots, StatsPlots, Distributions + +f(z) = z^2 +x = 5:21 +lenx = length(x) +y = [rand(Uniform(0.7,1))*f(xᵢ) for xᵢ in x] +yerr = (5*rand(lenx),10*rand(lenx)) +Ybar = rand(1:10, 5, 2) +Ybarerr = (rand(5, 2),rand(5, 2)) + +function simulation_plot(; kwargs...) + p = plot(; xticks = x, ytick=25:50:400, kwargs...) + plot!(p, x, f; label="simulation", lw=2) + scatter!(p, x, y; yerror=yerr, label="experiment") +end + +function groupedbar_plot(; kwargs...) + ctg = repeat(["Category 1", "Category 2"], inner = 5) + nam = repeat("G" .* string.(1:5), outer = 2) + + groupedbar(nam, Ybar, group=ctg, xlabel = "Groups", ylabel = "Scores", + title = "Scores by group and category", yerror=Ybarerr, framestyle = :box, kwargs...) +end + +``` + +## Backends + +**Plots.jl** is the single interface to different visualization backends (libraries). The choice of the backend depends on the task as each backend has it's strength and weaknesses. +The full list of supported backends is provided in [Plots backends documentation](https://docs.juliaplots.org/stable/backends/). You can find some advices on backends usage on [Julia discourse](https://discourse.julialang.org/t/comparison-of-plotting-packages/99860/2). Here we will focus on the most popular backends. + +### GR + +[GR backend](https://github.com/jheinen/GR.jl) is set by default. It is fast and simple and should be preferred for basic visualization. If you are looking for advanced features or publication quality plots it may not suit you. It is installed with: +``` +using Plots +gr() +simulation_plot() +groupedbar_plot() +``` +![plot-sim-gr](./plot_sim_gr.png) ![plot-sim-gr](./plot_bar_gr.png) + +### PlotlyJS + +[PlotlyJS](http://juliaplots.org/PlotlyJS.jl/stable/) backend is good for interactive plots or webpages. You can both visualize the data and interactively get the values of data point on the plot. +It can be installed with: +``` +using Plots +plotlyjs() +simulation_plot() +``` +![plot-sim-plotly](./plot_sim_plotly.png) + +### PGFPlotsX + +[PGFPlotsX](https://kristofferc.github.io/PGFPlotsX.jl/stable/) backend uses LaTeX and it is considered the backend suitable for publications. PGFPlotsX requires a LaTeX installation (e.g. [MiKTeX](https://miktex.org/)) +The package can be installed with: +``` +pgfplotsx() +simulation_plot() +groupedbar_plot() +``` +![plot-sim-pgf](./plot_sim_pgf.png) ![plot-sim-pgf](./plot_bar_pgf.png) + + +## Plot themes + +One can adjust plot themes (background, etc) by changing the default theme. Other themes are described in the [PlotThemes.jl documentation](https://docs.juliaplots.org/stable/generated/plotthemes/) + +## Color schemes + +To set the color palette one can use [ColorSchemes.jl package](https://docs.juliaplots.org/stable/colorschemes) \ No newline at end of file