Tables & Figures (aerj-tables-figures)
In AERJ, a reader should grasp each exhibit without hunting through the text, and every exhibit must
follow APA 7th-edition table/figure conventions. Because review is masked, exhibits must carry
no identifying clues (institution names, data-source giveaways in titles).
When to trigger
- Designing tables/figures or revising them after analysis
- A reviewer found an exhibit unreadable, mislabeled, or non-APA
- Preparing exhibits for a masked submission (no identifying content)
- Deciding what belongs in the body vs an appendix
Principles
- Self-contained. Title states what the exhibit shows; notes define every abbreviation, the
sample/N, the units, and significance/probability conventions. A reader should not need the text.
- APA 7th-edition format. Table number + italic title; horizontal rules only (no vertical rules);
figure number + title; a general note, then specific notes, then probability notes.
- Report estimates with uncertainty. Coefficients with SEs/CIs; for multilevel models, label
levels and random effects; mark the estimand, not just stars.
- Figures earn their place. Use a figure when it shows something a table cannot (trajectories,
interactions, distributions, RD/event-study, joint displays for mixed methods). Otherwise use a table.
- Accessibility. Colorblind-safe palettes; legible in grayscale; readable at print size; vector
output for line art.
- Qualitative exhibits. Coding trees, thematic maps, and evidence tables (theme → exemplar
quotation) are legitimate exhibits — anonymize participants and sites.
- Match the package. Exhibit numbers/values must match the analysis output and the deposited
materials (see
aerj-transparency-and-data-policy).
Execution bridge (StatsPAI / Stata MCP)
Generate exhibits from the fitted result, not by retyping numbers (the usual source of
body-vs-supplement drift). Full map: execution-with-mcp. AERJ is empirical education research — field experiments and observational school data; multilevel inference and many-outcome corrections are central.
- Tables:
etable (multi-model columns) or did_summary_to_latex straight from the
result_id.
- Figures:
plot_from_result / enhanced_event_study_plot / event_study_table —
axis units and the SE/clustering note baked in.
- Every note names the estimator + clustering and states the effect size in
interpretable units.
See a full fitted-result → exhibit chain in the JF execution walkthrough.
Anti-patterns
- Tables readable only with the surrounding paragraph
- Vertical rules, inconsistent decimals, undefined abbreviations (non-APA)
- Stars without effect sizes or intervals; no N or units
- Rainbow palettes that fail in grayscale or for colorblind readers
- Identifying clues in titles/notes that break masking
- Exhibit values that drift from the replication package
What AERJ exhibit referees check
Reviewers across AERJ's policy/institutional, teaching/learning, development, and cross-cutting lenses
read exhibits before they read prose, so an unreadable exhibit damages the paper
before the argument is even heard. Use this as a pre-submission exhibit triage.
| Exhibit type |
What an AERJ referee expects to see |
Desk-screen / first-round red flag |
| Multilevel results table |
Level-1 and level-2 coefficients separated, random-effect variances, ICC, N at each level |
One undifferentiated column that hides the nesting |
| Growth-model table |
Intercept/slope means, variance components, time coding stated |
Trajectories implied but no variance components reported |
| Quasi-experimental figure |
Event-study or RD plot with bandwidth, pre-trend, confidence band |
A bare bar chart of means with no uncertainty |
| Qualitative evidence table |
Theme → operational definition → exemplar excerpt → source (anonymized) |
A wall of quotations with no analytic column |
| Mixed-methods joint display |
Quant result and qual finding side by side with a meta-inference column |
Two stacked exhibits that never meet |
Worked exhibit vignette (illustrative)
Take an AERJ study of a middle-school reading-comprehension intervention in 40 schools.
The core table reports a treatment coefficient of 0.18 SD (95% CI [0.04, 0.32]), a school-level
ICC of 0.14, and N = 3,200 students in 40 schools (all numbers illustrative). A strong
AERJ exhibit puts the estimate, the interval, the ICC, and both N levels in one self-contained note;
a weak one prints "b = 0.18, p < .05" and forces the reader into the methods section to learn the
sample is clustered. The companion joint display pairs that 0.18 SD estimate with the qualitative
finding that teachers in higher-gain schools re-allocated time to discussion — the meta-inference
column is what earns the figure its place.
Referee pushback and the venue fix
- "I cannot tell which estimates are between- vs within-school." → Split the table by level and
label random effects; report the ICC explicitly.
- "The figure is unreadable in the printed (grayscale) issue." → Move from color-coded lines to
distinguishable markers/linetypes; SAGE print remains a constraint.
- "This exhibit could identify the district." → Strip site-revealing titles and notes; masked
review requires anonymized exhibits, not just an anonymized text body.
Output format
【Exhibit】table / figure — one-line purpose
【Self-contained?】title + notes define N, units, abbreviations, significance [Y/N]
【APA 7th format】[Y/N]
【Uncertainty shown】SE/CI + estimand labeled [Y/N]
【Accessible】colorblind-safe + grayscale-legible [Y/N]
【Masked】no identifying clues [Y/N]
【Next】aerj-writing-style
Supplementary resources
1---2name: aerj-tables-figures3description: Use when building tables and figures for an American Educational Research Journal (AERJ) manuscript. Exhibits must be self-contained, accessible, and formatted to APA 7th edition, and they must be anonymized for masked review. Improves exhibits; it does not generate data.4metadata:5 source: https://skillmd.com/skills/brycewang-stanford/aerj-tables-figures6---78# Tables & Figures (aerj-tables-figures)910In AERJ, a reader should grasp each exhibit **without hunting through the text**, and every exhibit must11follow **APA 7th-edition** table/figure conventions. Because review is **masked**, exhibits must carry12no identifying clues (institution names, data-source giveaways in titles).1314## When to trigger1516- Designing tables/figures or revising them after analysis17- A reviewer found an exhibit unreadable, mislabeled, or non-APA18- Preparing exhibits for a masked submission (no identifying content)19- Deciding what belongs in the body vs an appendix2021## Principles22231. **Self-contained.** Title states what the exhibit shows; notes define every abbreviation, the24 sample/N, the units, and significance/probability conventions. A reader should not need the text.252. **APA 7th-edition format.** Table number + italic title; horizontal rules only (no vertical rules);26 figure number + title; a general note, then specific notes, then probability notes.273. **Report estimates with uncertainty.** Coefficients with SEs/CIs; for multilevel models, label28 levels and random effects; mark the estimand, not just stars.294. **Figures earn their place.** Use a figure when it shows something a table cannot (trajectories,30 interactions, distributions, RD/event-study, joint displays for mixed methods). Otherwise use a table.315. **Accessibility.** Colorblind-safe palettes; legible in grayscale; readable at print size; vector32 output for line art.336. **Qualitative exhibits.** Coding trees, thematic maps, and evidence tables (theme → exemplar34 quotation) are legitimate exhibits — anonymize participants and sites.357. **Match the package.** Exhibit numbers/values must match the analysis output and the deposited36 materials (see `aerj-transparency-and-data-policy`).3738## Execution bridge (StatsPAI / Stata MCP)3940Generate exhibits from the fitted result, not by retyping numbers (the usual source of41body-vs-supplement drift). Full map: [`execution-with-mcp`](../../../shared-resources/empirical-methods/execution-with-mcp.md). AERJ is empirical education research — field experiments and observational school data; multilevel inference and many-outcome corrections are central.4243- **Tables:** `etable` (multi-model columns) or `did_summary_to_latex` straight from the44 `result_id`.45- **Figures:** `plot_from_result` / `enhanced_event_study_plot` / `event_study_table` —46 axis units and the SE/clustering note baked in.47- **Every note** names the estimator + clustering and states the effect size in48 interpretable units.4950See a full fitted-result → exhibit chain in the [JF execution walkthrough](../../../Journal-of-Finance-Skills/resources/worked-examples/02-execution-walkthrough.md).51## Anti-patterns5253- Tables readable only with the surrounding paragraph54- Vertical rules, inconsistent decimals, undefined abbreviations (non-APA)55- Stars without effect sizes or intervals; no N or units56- Rainbow palettes that fail in grayscale or for colorblind readers57- Identifying clues in titles/notes that break masking58- Exhibit values that drift from the replication package5960## What AERJ exhibit referees check6162Reviewers across AERJ's policy/institutional, teaching/learning, development, and cross-cutting lenses63read exhibits before they read prose, so an unreadable exhibit damages the paper64before the argument is even heard. Use this as a pre-submission exhibit triage.6566| Exhibit type | What an AERJ referee expects to see | Desk-screen / first-round red flag |67|--------------|-------------------------------------|------------------------------------|68| Multilevel results table | Level-1 and level-2 coefficients separated, random-effect variances, ICC, N at each level | One undifferentiated column that hides the nesting |69| Growth-model table | Intercept/slope means, variance components, time coding stated | Trajectories implied but no variance components reported |70| Quasi-experimental figure | Event-study or RD plot with bandwidth, pre-trend, confidence band | A bare bar chart of means with no uncertainty |71| Qualitative evidence table | Theme → operational definition → exemplar excerpt → source (anonymized) | A wall of quotations with no analytic column |72| Mixed-methods joint display | Quant result and qual finding side by side with a meta-inference column | Two stacked exhibits that never meet |7374## Worked exhibit vignette (illustrative)7576Take an AERJ study of a middle-school **reading-comprehension intervention** in 40 schools.77The core table reports a treatment coefficient of **0.18 SD** (95% CI [0.04, 0.32]), a school-level78ICC of **0.14**, and **N = 3,200** students in **40** schools (all numbers illustrative). A strong79AERJ exhibit puts the estimate, the interval, the ICC, and both N levels in one self-contained note;80a weak one prints "b = 0.18, p < .05" and forces the reader into the methods section to learn the81sample is clustered. The companion joint display pairs that 0.18 SD estimate with the qualitative82finding that teachers in higher-gain schools re-allocated time to discussion — the meta-inference83column is what earns the figure its place.8485## Referee pushback and the venue fix8687- *"I cannot tell which estimates are between- vs within-school."* → Split the table by level and88 label random effects; report the ICC explicitly.89- *"The figure is unreadable in the printed (grayscale) issue."* → Move from color-coded lines to90 distinguishable markers/linetypes; SAGE print remains a constraint.91- *"This exhibit could identify the district."* → Strip site-revealing titles and notes; masked92 review requires anonymized exhibits, not just an anonymized text body.9394## Output format9596```97【Exhibit】table / figure — one-line purpose98【Self-contained?】title + notes define N, units, abbreviations, significance [Y/N]99【APA 7th format】[Y/N]100【Uncertainty shown】SE/CI + estimand labeled [Y/N]101【Accessible】colorblind-safe + grayscale-legible [Y/N]102【Masked】no identifying clues [Y/N]103【Next】aerj-writing-style104```105106## Supplementary resources107108- [`../../resources/external_tools.md`](../../resources/external_tools.md) — plotting/exhibit tooling and APA table helpers109- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — APA style and masked-review requirements