mantao/Gnuplot.jl
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Docs updated

Browse Source
This commit is contained in:
Giorgio Calderone 2020-04-10 14:35:07 +02:00
parent 5b554608c4
commit 7fa9a3af53
2 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/src/basic.md
View File

@ -245,6 +245,10 @@ Note that you can pass both the terminal name and its options via the `term=` ke
## Gnuplot scripts ## Gnuplot scripts
Besides exporting plots in a file **Gnuplot.jl** can also save a *script*, i.e. a file containing the minimum set of data and commands required to re-create a figure using just gnuplot. Besides exporting plots in a file **Gnuplot.jl** can also save a *script*, i.e. a file containing the minimum set of data and commands required to re-create a figure using just gnuplot.
The script allows a complete decoupling of plot data and aethetics, from the Julia code used to generate them. With scripts you can:
- modify all aesthetic details of a plot without re-running the (possibly complex and time-consuming) code used to generate it;
- share both data and plots with colleagues without the need to share the Julia code.
To generate a script for one of the examples above use: To generate a script for one of the examples above use:
```julia ```julia
save("script.gp") save("script.gp")

8
docs/src/index.md
View File

@ -19,12 +19,12 @@ The **Gnuplot.jl** package allows easy and fast use of [gnuplot](http://gnuplot.
- enhanced support for contour plots; - enhanced support for contour plots;
- export to a huge number of formats such as `pdf`, `png`, ``\LaTeX``, `svg`, etc. (actually all those supported by gnuplot); - export to a huge number of formats such as `pdf`, `png`, `gif`, ``\LaTeX``, `svg`, etc. (actually all those supported by gnuplot);
- save sessions into gnuplot scripts enables easy plot reproducibility and modifications. - save sessions into gnuplot scripts, to enable easy plot customization and reproducibility.
If you're unfamiliar with gnuplot have a look at: If you're unfamiliar with gnuplot have a look at:
- [Main *gnuplot site*](http://gnuplot.info/) - [Main gnuplot site](http://gnuplot.info/)
- [gnuplot FAQ](http://gnuplot.info/faq/index.html) - [gnuplot FAQ](http://gnuplot.info/faq/index.html)
@ -37,7 +37,7 @@ A powerful plotting framework is among the most important tool in the toolbox of
1. a well-documented framework, by taking advantage of all the gnuplot documentation, tutorials and examples available on the web; 1. a well-documented framework, by taking advantage of all the gnuplot documentation, tutorials and examples available on the web;
1. a fast response, by relying on an external program (rather than on a large Julia code base); 1. a fast response, by relying on an external program (rather than on a large Julia code base);
1. an interactive data exploration framework, by exposing a carefully designed, extremely concise and easy to remember syntax (at least for users with minimal gnuplot knowledge); 1. an interactive data exploration framework, by exposing a carefully designed, extremely concise and easy to remember syntax (at least for users with minimal gnuplot knowledge);
1. a procedure to foster plot reproducibility by sharing just the data and commands in the form of gnuplot scripts, rather than the original Julia code. 1. a procedure to decouple plot data and aesthetics from the Julia code used to generate them.
Unlike other packages **Gnuplot.jl** is not a pure Julia solution as it depends on an external package to actually generate plots. However, if gnuplot is not available on a given platform, the package could still be used in "*dry*" mode, and no error for a missing dependency will be raised (see [Dry sessions](@ref)). Unlike other packages **Gnuplot.jl** is not a pure Julia solution as it depends on an external package to actually generate plots. However, if gnuplot is not available on a given platform, the package could still be used in "*dry*" mode, and no error for a missing dependency will be raised (see [Dry sessions](@ref)).