From 2af60e2d59c508c182a10ebc0de31b035b73cae8 Mon Sep 17 00:00:00 2001 From: Mohammad Akhlaghi 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. --- configure | 2 +- paper.tex | 16 +++++++++------- reproduce/src/make/delete-me.mk | 3 +-- tex/delete-me.tex | 4 ++-- 4 files changed, 13 insertions(+), 12 deletions(-) diff --git a/configure b/configure index c776d47..9233766 100755 --- a/configure +++ b/configure @@ -267,7 +267,7 @@ rm -f $ptconf $ptconf"~" # step(s) to take. echo if [ $ready = 1 ]; then - echo "This reproduction pipeline has been configured for this system." + echo "The reproduction pipeline has been configured for this system." echo "Please run the following command to start the pipeline:" else echo "AFTER MANUALLY EDITING THE FILE(S) ABOVE, please run the following" 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 diff --git a/reproduce/src/make/delete-me.mk b/reproduce/src/make/delete-me.mk index a93c2d0..de72873 100644 --- a/reproduce/src/make/delete-me.mk +++ b/reproduce/src/make/delete-me.mk @@ -37,8 +37,7 @@ $(dm): $(pconfdir)/delete-me-num.mk | $(dmdir) rm -f $(tikzdir)/delete-me.pdf # Generate the table of random values. - awk 'BEGIN { for (i = 1; i <= $(delete-me-num); i++) \ - print i, rand(); }' > $@ + awk 'BEGIN {for(i=1;i<=$(delete-me-num);i+=0.5) print i, i*i; }' > $@ diff --git a/tex/delete-me.tex b/tex/delete-me.tex index 495333a..32be11c 100644 --- a/tex/delete-me.tex +++ b/tex/delete-me.tex @@ -5,8 +5,8 @@ %% Settings of the plotted axis \begin{axis}[ width=\linewidth, - xlabel=Counter, - ylabel=Random value, + xlabel=$X$, + ylabel=$X^2$, ] %% A particular plot. -- cgit v1.2.1