| name | aerj-tables-figures |
| description | 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. |
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
