diff --git a/docs/src/basic.md b/docs/src/basic.md index c6ce197..0bc8c66 100644 --- a/docs/src/basic.md +++ b/docs/src/basic.md @@ -245,6 +245,10 @@ Note that you can pass both the terminal name and its options via the `term=` ke ## 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. +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: ```julia save("script.gp") diff --git a/docs/src/index.md b/docs/src/index.md index eb73a48..637a492 100644 --- a/docs/src/index.md +++ b/docs/src/index.md @@ -19,12 +19,12 @@ The **Gnuplot.jl** package allows easy and fast use of [gnuplot](http://gnuplot. - 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: -- [Main *gnuplot site*](http://gnuplot.info/) +- [Main gnuplot site](http://gnuplot.info/) - [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 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. 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)).