Default PDF now uses PGFPlots and BibLaTeX

Making plots and including references are integral parts of a scientific
paper. Therefore to demonstrate how cleanly they can be used within the
pipeline, they are now used to produce the final PDF.

To use PGFPlots a random dataset is made (using AWK's random function) and
is plotted using PGFPlots. The minimum and maximum values of the dataset
are also included in the text to further show how such calculations can go
into the macros and text.

For the references, the NoiseChisel paper was added as a reference to cite
when using this pipeline along with the MUSE UDF paper I, which uses this
pipeline for two sections. Following this discussion, citation is also
discussed in `README.md` and the NoiseChisel paper is also added as a
published work with a reproduction pipeline.

1 files changed, 73 insertions, 0 deletions

diff --git a/reproduce/src/make/delete-me.mk b/reproduce/src/make/delete-me.mk
new file mode 100644
index 0000000..a93c2d0
--- /dev/null
+++ b/reproduce/src/make/delete-me.mk
@@ -0,0 +1,73 @@
+# Dummy Makefile to create a random dataset for plotting.
+#
+# Original author:
+#     Mohammad Akhlaghi <mohammad@akhlaghi.org>
+# Contributing author(s):
+# Copyright (C) 2018, Your Name.
+#
+# This Makefile is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# This Makefile is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+#
+# A copy of the GNU General Public License is available at
+# <http://www.gnu.org/licenses/>.
+
+
+
+
+
+# Dummy dataset
+# -------------
+#
+# We will use AWK's random number generator to generate a random dataset to
+# be imported by PGFPlots for a plot in the paper.
+dmdir = $(texdir)/delete-me
+dm    = $(dmdir)/data.txt
+$(dmdir): | $(texdir); mkdir $@
+$(dm): $(pconfdir)/delete-me-num.mk | $(dmdir)
+
+        # When the plotted values are re-made, it is necessary to also
+        # delete the TiKZ externalized files so the plot is also re-made.
+	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(); }' > $@
+
+
+
+
+
+# TeX macros
+# ----------
+#
+# This is how we write the necessary parameters in the final PDF.
+#
+# NOTE: In LaTeX you cannot use any non-alphabetic character in a variable
+# name.
+$(mtexdir)/delete-me.tex: $(dm)
+
+        # Write the number of random values used.
+	echo "\newcommand{\deletemenum}{$(delete-me-num)}" > $@
+
+        # Note that since Make variables start with a `$(', if you want to
+        # use `$' within the shell (not Make), you have to quote any
+        # occurance of `$' with another `$'. That is why there are `$$' in
+        # the AWK command below.
+        #
+        # Here, we are first using AWK to find the minimum and maximum
+        # values, then using it again to read each separately to use in the
+        # macro definition.
+	mm=$$(awk 'BEGIN{min=99999; max=-min}                     \
+                   {if($$2>max) max=$$2; if($$2<min) min=$$2;}    \
+                   END{print min, max}' $(dm));                   \
+	v=$$(echo "$$mm" | awk '{printf "%.3f", $$1}');           \
+	echo "\newcommand{\deletememin}{$$v}"             >> $@;  \
+	v=$$(echo "$$mm" | awk '{printf "%.3f", $$2}');           \
+	echo "\newcommand{\deletememax}{$$v}"             >> $@