Placeholders
Warning
This page is under construction
Note
This section was adapted from the readme for the original tablefill.py
The template placeholders determine where the numbers from the input files are and how they will be displayed. Every table in the template file (if it is to be filled) must appear within a table environment. There can be several tabular environments within the table environment, but only ONE label per table environment.
While label names may appear more than once in both the template and input files, only the last instance of the label in the input files will be used. This because of the way the system is set up: The last label in the input file should be the most up to date version of that table. In the template file, repeated labels are filled with the same data.
By design, labels are NOT case-sensitive.
Placeholders
The values in the template file are parsed as follows:
| Placeholder | Format |
|---|---|
### |
Replace as is; input can be text (all other placeholders require numbers). |
#\d+# |
Round to \d+ digits. |
#\d+,# |
Round to \d+ digits; add thousands comma separator. |
#*# |
Interpret input as p-value and replce with a star corresponding so significance. Detault is * 0.1, **0.05, ***0.01. |
#\d+%# |
Round to \d+ digits; interpret as percentage. |
#|#|# |
Get the absolute value of the number. |
#{.*}# |
Arbitrary python format. Anything that string.format() will accept is allowed. In Python 2.6, you must prepend 0:, that is {0:.+}. |
Consider the following examples
abc + ### = abc
2309.2093 + ### = 2309.2093
2309.2093 + #4# = 2309.2093
2309.2093 + #5# = 2309.20930
2309.2093 + #20# = 2309.20930000000000000000
2309.2093 + #3# = 2309.209
2309.2093 + #2# = 2309.21
2309.2093 + #0# = 2309
2309.2093 + #0,# = 2,309
-2.23e-2 + #2# = -0.0223 + #2# = -0.02
-2.23e+10 + #7,# = -22300000000 + #7,# = -22,300,000,000.000000
2309.2093 + (#2#) = (2309.21)
2309.2093 + #2#** = 2309.21**
2309.2093 + ab#2#cd = ab2309.21cd
.2093 + #1%# = 20.9
-2.23e-2 + |#7#| = -0.0223 + |#7#| = 0.0223000
.1309 + #*# =
.0639 + #*# = *
.0139 + #*# = **
.0013 + #*# = ***
Note that there can be ANYTHING around the pattern and the engine will only match the pattern. Further, in LaTeX, the # character must be escaped, so the engine also matches #. Consider:
3234.43241 + \\beta Hi \$(\#\#\#)\%* = \\beta Hi \$(3234.43241)\%* 3234.43241 + & \\beta Hi \$(\##\#)\%* = \\beta Hi \$(3234.43241)\%* 3234.43241 + & \\beta Hi \$(\#\##)\%* = \\beta Hi \$(3234.43241)\%* 3234.43241 + & \\beta Hi \$(#\#\#)\% = \\beta Hi \$(3234.43241)\% 3234.43241 + & \\beta Hi \$(\###)*\% = \\beta Hi \$(3234.43241)*\% 3234.43241 + & \\beta Hi \$(\#0,\#)\%* = \\beta Hi \$(3,234)\%* 3234.43241 + & \\beta Hi \$(\#0,\#)\%* = \\beta Hi \$(3,234)\%* 3234.43241 + & \\beta Hi \$(\#0,#* = \\beta Hi \$(3,234* 3234.43241 + & \\beta Hi \$(#0,\#* = \\beta Hi \$(3,234* 3234.43241 + & \\beta Hi \$(\#0,#* = \\beta Hi \$(3,234*
Matrices
Simple Example
Input:
<tab:Test> 1 2 3 2 1 3 3 1 2
Template:
\label{tab:test}
\#\#\# & \#\#\# & \#\#\# \\\\
\#\#\# & \#\#\# & \#\#\# \\\\
\#\#\# & \#\#\# & \#\#\# \\\\
Output:
\label{tab:test}
1 2 3
2 1 3
3 1 2
Missing Values
Input:
<tab:Test> 1 . 3 2e-5 1 3.023 . -1 2 3
Template:
\label{tab:test}
(\#\#\#) & 2 & \#\#\# & \\\\
\#3\# & \#\#\# & \#1\# & \\\\
NA & \#\#\# & \#\#\# & \#\#\# \\\\
Output:
\label{tab:test}
(1) 2 3
0.000 1 3.0
NA -1 2 3
Important: Missing values in input and template need not line up.
Input:
<tab:Test> 1 . 3 2e-5 . 3.023 . -1 2
Template:
\label{tab:test}
\#\#\# & \#\#\# & abc \\\\
abc & \#2\# & \#3\# \\\\
NA & \#\#\# & \#\#\# \\\\
Output:
\label{tab:test}
1 3 abc
abc 0.00 3.023
NA -1 2
Text
Input:
<tab:Test> 1 1 2 1 1 3 2 -1 2
Template:
\label{tab:test}
\#\#\# & \#\#\# & \#\#\# \\\\
abc & abc & abc \\\\
\#\#\# & \#2\# & \#3\# \\\\
\#\#\# & \#\#\# & \#\#\# \\\\
Output:
\label{tab:test}
1 1 2
abc abc abc
1 1.00 3.000
2 -1 2