From 2af60e2d59c508c182a10ebc0de31b035b73cae8 Mon Sep 17 00:00:00 2001
From: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Date: Sat, 11 Aug 2018 11:59:04 +0200
Subject: Not using random distribution in demonstration plot

Different implementations of AWK may use different random number
generators, so even setting the seed will not ensure a reproducible
result. Because of this, the random plot may be different when the
pipeline runs on different systems and this can confuse early users
(its contrary to the exact reproducibility that is the whole purpose
of this pipeline).

The plot is just a simple X^2 plot, showing the squared value of the X
axis on the Y axis. It is very simple, but atleast it will be
identical on all systems. Also, there may be too many complicated
things in the pipeline already for an early user, and its just a
demonstration, so the easier/simpler, the better.
---
 paper.tex | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

(limited to 'paper.tex')

diff --git a/paper.tex b/paper.tex
index 83aab2a..00264e0 100644
--- a/paper.tex
+++ b/paper.tex
@@ -86,11 +86,13 @@ in this way, will let you focus clearly on your science and not have to
 worry about fixing this or that number/name in the text.
 
 Just as a demonstration of creating plots within \LaTeX{} (using the
-{\small PGFP}lots package), in Figure \ref{deleteme} we show a plot of
-\deletemenum{} random points that were generated by this pipeline using the
-text manipulation program {\small AWK} (which is not the best random number
-generator, but just used here to generate some values). The minimum value
-in this distribution is $\deletememin$ and $\deletememax$ is the maximum.
+{\small PGFP}lots package), in Figure \ref{deleteme} we show a simple
+plot, where the Y axis is the square of the X axis. The minimum value
+in this distribution is $\deletememin$, and $\deletememax$ is the
+maximum. Take a look into the \LaTeX{} source and you'll see these
+numbers are actually macros that were calculated from the same dataset
+(they will change if the dataset, or function that produced it,
+changes).
 
 The {\small PDF} file of Figure \ref{deleteme} is available in the
 directory \texttt{\bdir/tex/build/tikz/} and can be used in other contexts
@@ -111,8 +113,8 @@ your paper.
 \begin{figure}[t]
   \includetikz{delete-me}
 
-  \captionof{figure}{\label{deleteme} A random set of values plotted as a
-    demonstration of how to generate plots within LaTeX.}
+  \captionof{figure}{\label{deleteme} A very basic $X^2$ plot for
+    demonstration.}
 \end{figure}
 
 Furthermore, since {\small PGFP}lots is built by \LaTeX{} it respects all
-- 
cgit v1.2.1

