aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMohammad Akhlaghi <mohammad@akhlaghi.org>2018-08-11 11:59:04 +0200
committerMohammad Akhlaghi <mohammad@akhlaghi.org>2018-08-11 11:59:04 +0200
commit2af60e2d59c508c182a10ebc0de31b035b73cae8 (patch)
tree55eb657717051994ac5f52e61d5e5ec6fd368b88
parentb42f7bdd034fbc888cf54d1d304c378592c31a8d (diff)
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.
-rwxr-xr-xconfigure2
-rw-r--r--paper.tex16
-rw-r--r--reproduce/src/make/delete-me.mk3
-rw-r--r--tex/delete-me.tex4
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.