From 48e61df320e7571e527049cd3eef5cf96b8cb491 Mon Sep 17 00:00:00 2001
From: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Date: Mon, 23 Mar 2020 03:16:06 +0000
Subject: Analysis and configuration file sections complete

With this commit a description of these two important parts have been added
to the project, along with several figures showing various parts of the
files that are discussed. I also done some other restructuring of the
figures and files to make things fit better into the the description of the
paper.
---
 tex/src/figure-src-format.tex | 59 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 tex/src/figure-src-format.tex

(limited to 'tex/src/figure-src-format.tex')

diff --git a/tex/src/figure-src-format.tex b/tex/src/figure-src-format.tex
new file mode 100644
index 0000000..ba4458e
--- /dev/null
+++ b/tex/src/figure-src-format.tex
@@ -0,0 +1,59 @@
+\begin{tcolorbox}[title=\inlinecode{\textcolor{white}{format.mk}}\hfill(Simplified contents)]
+  \footnotesize
+  \texttt{\mkcomment{1ST MAKE RULE: build the directory hosting the converted table.}}
+
+  \texttt{\mkvar{a1dir} = \$(\mkvar{BDIR})/format}
+
+  \texttt{\mktarget{\$(a1dir)}:}
+
+  \texttt{\mktab{}\mkprog{mkdir} \$@}
+
+  \vspace{2em}
+  \texttt{\mkcomment{2ND MAKE RULE: Convert the XLSX table to a simple plain-text table.}}
+
+  \texttt{\mkvar{mk20tab3} = \$(\mkvar{a1dir})/menke20-table-3.txt}
+
+  \texttt{\mktarget{\$(mk20tab3)}: \$(\mkvar{indir})/menke20.xlsx | \$(\mkvar{a1dir})}
+
+  \texttt{\recipecomment{Call XLSX I/O to convert all the spreadsheets into different CSV files.}}
+
+  \texttt{\recipecomment{We only want the `table-3' spreadsheet, but XLSX I/O doesn't allow setting its}}
+
+  \texttt{\recipecomment{output filename. For simplicity, let's assume its written in `table-3.csv'.}}
+
+  \texttt{\mktab{}\mkprog{xlsxio\_xlsx2csv} \$<}
+
+  \vspace{0.5em}
+  \texttt{\recipecomment{Use GNU AWK to keep the desired columns in space-separated, fixed-width format.}}
+
+  \texttt{\recipecomment{With `FPAT' commas within double quotes are not counted as columns.}}
+
+  \texttt{\mktab{}\mkprog{awk} 'NR>1\{printf("\%-10d\%-10d\%-10d \%s\textbackslash{}n", \$\$2, \$\$3, \$\$(NF-1)*\$\$NF, \$\$1)\}' \textbackslash}
+
+  \texttt{\mktab{}{ }{ }{ }{ }FPAT='([\^{},]+)|("[\^{}"]+")' table-3.csv > \$@}
+
+  \vspace{0.5em}
+  \texttt{\recipecomment{Delete the temporary CSV file.}}
+
+  \texttt{\mktab{}\mkprog{rm} table-3.csv}
+
+  \vspace{2em}
+  \texttt{\mkcomment{3RD MAKE RULE: Main LaTeX macro file for reported values.}}
+
+  \texttt{\mktarget{\$(mtexdir)/format.tex}: \$(\mkvar{mk20tab3)}}
+
+  \texttt{\recipecomment{Count the total number of papers in their study to report in this paper.}}
+
+  \texttt{\mktab{}v=\$\$(\mkprog{awk} '\!/\^{}\#/\{c+=\$\$2\} END\{print c\}' \$(\mkvar{mk20tab3)})}
+
+  \texttt{\mktab{}\mkprog{echo} "\textbackslash{}newcommand\{\textbackslash{}menkenumpapers\}\{\$\$v\}" > \$@}
+
+  \vspace{0.5em}
+  \texttt{\recipecomment{Count total number of journals in that study.}}
+
+  \texttt{\mktab{}v=\$\$(awk 'BEGIN{FIELDWIDTHS="31 10000"} !/\^\#/\{print \$\$2\}' \$(mk20tab3) \textbackslash}
+
+  \texttt{\mktab{ }{ }{ }{ }{ }{ }{ }{ }{ }{ }| uniq | wc -l)}
+
+  \texttt{\mktab{}\mkprog{echo} "\textbackslash{}newcommand\{\textbackslash{}menkenumjournals\}\{\$\$v\}" >> \$@}
+\end{tcolorbox}
-- 
cgit v1.2.1