Tables & Figures (asr-tables-figures)
Exhibits are where a masked reviewer checks whether the result is real. ASR excludes tables and
figures from the 15,000-word limit (text, references, and footnotes count) — so you are not penalized
for a clear exhibit, but it must earn its place and stand on its own.
When to trigger
- Designing the main results table/figure or a key descriptive exhibit
- Deciding what belongs in the article vs. supplementary materials
- A reviewer found an exhibit unclear, mislabeled, or not self-contained
- Presenting qualitative or comparative-historical evidence in tabular/visual form
Principles
- Self-contained. Title, row/column labels, and a complete note make each exhibit intelligible
alone. State the sample, N, units, weighting, and what the estimate is.
- Show magnitude and uncertainty. Effect sizes and intervals — not stars alone. Coefficient and
marginal-effects plots often beat dense coefficient walls.
- Sociology-specific exhibits. Mobility/transition tables and flow diagrams; survival curves and
Lexis/age-period-cohort surfaces for demography; network graphs; sequence-analysis chronograms;
evidence tables linking claims to sources for comparative-historical/ethnographic work.
- Accessible. Colorblind-safe palettes; legible in grayscale; no chartjunk or 3D.
- Reproducible. Generated by the master script (quantitative) so numbers match shared materials;
for qualitative exhibits, excerpts must be faithful to the coded data.
Format
- Follow the ASA Style Guide for table/figure formatting and notes.
- Double-spaced manuscript, Times New Roman 12 pt; place tables/figures per the guidelines.
- Keep identifying information out of exhibits (masked review).
Exhibit conventions a masked ASR reviewer expects
The ASA flagship admits exhibits from every tradition but holds them to one standard: a reviewer who
may not share your method must be able to read the evidence unaided. Match the exhibit to the
tradition, then verify it carries magnitude and uncertainty.
| Tradition |
Workhorse exhibit |
The note must state |
| Quant / stratification |
coefficient/marginal-effects plot, mobility table |
N, weights, estimator, what the estimate is |
| Demography |
survival curve, Lexis surface, decomposition |
population, period, age structure |
| Comparative-historical |
evidence table (claim → sources), timeline |
case set, source provenance |
| Ethnographic |
coded-excerpt table with contrary instances |
coding scheme, anonymization |
| Network / computational |
graph, sequence chronogram, validation table |
boundary spec, validation against labels |
Worked micro-example (illustrative)
A main results table for an administrative-data study of gender wage gaps is redesigned for ASR.
Before: 6 columns of coefficients, stars only, no note → reviewer can't tell magnitude or sample
After: marginal-effects plot — adjusted gap 14.2% (95% CI 11.8–16.6), N=412,000, survey-weighted,
occupation + firm FE; grayscale-legible, colorblind-safe palette
Self-contained note (illustrative): "Predicted gap from a weighted model; bars are 95% CIs;
estimates reproduce from master.R, seed=11."
The redesign makes the exhibit stand alone, leads with the substantive magnitude an inequality scholar
cares about, and ties the numbers to the shared script.
Referee pushback → ASR-specific fix
- "I can't read this table without the text." → Add a complete note (sample, N, units, weighting,
what the estimate is) so it is intelligible alone.
- "Stars don't tell me if this matters." → Replace with effect sizes and intervals, ideally a
marginal-effects plot a generalist can scan.
- "Your figure dies in grayscale." → Re-encode with colorblind-safe, grayscale-legible channels;
drop chartjunk and 3D.
- "The qualitative table looks cherry-picked." → Include contrary excerpts and report the coding
scheme so the evidence reads as systematic.
Calibration anchors
- Exhibits are excluded from the word cap — use the room. ASR counts text, references, and
footnotes but not tables/figures, so a clear, self-contained exhibit costs nothing against length.
- Magnitude over significance. The flagship's broad readership wants to know how much, with what
uncertainty, not merely that a coefficient cleared a threshold.
- One reproducibility standard, two forms. Quantitative values must match the master script;
qualitative excerpts must be faithful to the coded data — both are checkable claims to a reviewer.
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. ASR is general sociology where observational designs dominate; foreground identification (DiD/IV/RDD), decomposition, and clustered inference.
- 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 that require the prose to be intelligible (not self-contained)
- Significance stars with no effect size or interval
- Decorative figures that add no evidence
- Color-only encoding that fails in grayscale or for colorblind readers
- Quantitative exhibit values that don't match the analysis script
Output format
【Main exhibit】what it shows + why a table/figure
【Self-contained?】title + labels + note + N/units/weights present? [Y/N]
【Magnitude + uncertainty shown?】[Y/N]
【Accessible?】grayscale-legible + colorblind-safe? [Y/N]
【Reproducible / faithful?】matches script or coded data? [Y/N]
【Next】asr-writing-style
Supplementary resources
Source: brycewang-stanford/Awesome-Journal-Skills → American-Sociological-Review-Skills/skills/asr-tables-figures/SKILL.md
1---2name: asr-tables-figures3description: Use when building tables and figures for an American Sociological Review (ASR) manuscript. ASR excludes tables and figures from the 15,000-word count but still expects them to be clear, self-contained, and ASA-formatted. Designs exhibits; it does not run the analysis.4---5
6
7# Tables & Figures (asr-tables-figures)
8
9Exhibits are where a masked reviewer checks whether the result is real. ASR **excludes tables and
10figures from the 15,000-word limit** (text, references, and footnotes count) — so you are not penalized
11for a clear exhibit, but it must earn its place and stand on its own.
12
13## When to trigger
14
15- Designing the main results table/figure or a key descriptive exhibit
16- Deciding what belongs in the article vs. supplementary materials
17- A reviewer found an exhibit unclear, mislabeled, or not self-contained
18- Presenting qualitative or comparative-historical evidence in tabular/visual form
19
20## Principles
21
221. **Self-contained.** Title, row/column labels, and a complete note make each exhibit intelligible
23 alone. State the sample, N, units, weighting, and what the estimate is.
242. **Show magnitude and uncertainty.** Effect sizes and intervals — not stars alone. Coefficient and
25 marginal-effects plots often beat dense coefficient walls.
263. **Sociology-specific exhibits.** Mobility/transition tables and flow diagrams; survival curves and
27 Lexis/age-period-cohort surfaces for demography; network graphs; sequence-analysis chronograms;
28 **evidence tables** linking claims to sources for comparative-historical/ethnographic work.
294. **Accessible.** Colorblind-safe palettes; legible in grayscale; no chartjunk or 3D.
305. **Reproducible.** Generated by the master script (quantitative) so numbers match shared materials;
31 for qualitative exhibits, excerpts must be faithful to the coded data.
32
33## Format
34
35- Follow the **ASA Style Guide** for table/figure formatting and notes.
36- Double-spaced manuscript, Times New Roman 12 pt; place tables/figures per the guidelines.
37- Keep identifying information out of exhibits (masked review).
38
39## Exhibit conventions a masked ASR reviewer expects
40
41The ASA flagship admits exhibits from every tradition but holds them to one standard: a reviewer who
42may not share your method must be able to read the evidence unaided. Match the exhibit to the
43tradition, then verify it carries magnitude and uncertainty.
44
45| Tradition | Workhorse exhibit | The note must state |
46|-----------|-------------------|----------------------|
47| Quant / stratification | coefficient/marginal-effects plot, mobility table | N, weights, estimator, what the estimate is |
48| Demography | survival curve, Lexis surface, decomposition | population, period, age structure |
49| Comparative-historical | evidence table (claim → sources), timeline | case set, source provenance |
50| Ethnographic | coded-excerpt table with contrary instances | coding scheme, anonymization |
51| Network / computational | graph, sequence chronogram, validation table | boundary spec, validation against labels |
52
53## Worked micro-example (illustrative)
54
55A main results table for an administrative-data study of gender wage gaps is redesigned for ASR.
56
57```
58Before: 6 columns of coefficients, stars only, no note → reviewer can't tell magnitude or sample
59After: marginal-effects plot — adjusted gap 14.2% (95% CI 11.8–16.6), N=412,000, survey-weighted,
60 occupation + firm FE; grayscale-legible, colorblind-safe palette
61Self-contained note (illustrative): "Predicted gap from a weighted model; bars are 95% CIs;
62 estimates reproduce from master.R, seed=11."
63```
64
65The redesign makes the exhibit stand alone, leads with the substantive magnitude an inequality scholar
66cares about, and ties the numbers to the shared script.
67
68## Referee pushback → ASR-specific fix
69
70- *"I can't read this table without the text."* → Add a complete note (sample, N, units, weighting,
71 what the estimate is) so it is intelligible alone.
72- *"Stars don't tell me if this matters."* → Replace with effect sizes and intervals, ideally a
73 marginal-effects plot a generalist can scan.
74- *"Your figure dies in grayscale."* → Re-encode with colorblind-safe, grayscale-legible channels;
75 drop chartjunk and 3D.
76- *"The qualitative table looks cherry-picked."* → Include contrary excerpts and report the coding
77 scheme so the evidence reads as systematic.
78
79## Calibration anchors
80
81- **Exhibits are excluded from the word cap — use the room.** ASR counts text, references, and
82 footnotes but not tables/figures, so a clear, self-contained exhibit costs nothing against length.
83- **Magnitude over significance.** The flagship's broad readership wants to know how much, with what
84 uncertainty, not merely that a coefficient cleared a threshold.
85- **One reproducibility standard, two forms.** Quantitative values must match the master script;
86 qualitative excerpts must be faithful to the coded data — both are checkable claims to a reviewer.
87
88## Execution bridge (StatsPAI / Stata MCP)
89
90Generate exhibits from the fitted result, not by retyping numbers (the usual source of
91body-vs-supplement drift). Full map: [`execution-with-mcp`](../../../shared-resources/empirical-methods/execution-with-mcp.md). ASR is general sociology where observational designs dominate; foreground identification (DiD/IV/RDD), decomposition, and clustered inference.
92
93- **Tables:** `etable` (multi-model columns) or `did_summary_to_latex` straight from the
94 `result_id`.
95- **Figures:** `plot_from_result` / `enhanced_event_study_plot` / `event_study_table` —
96 axis units and the SE/clustering note baked in.
97- **Every note** names the estimator + clustering and states the effect size in
98 interpretable units.
99
100See a full fitted-result → exhibit chain in the [JF execution walkthrough](../../../Journal-of-Finance-Skills/resources/worked-examples/02-execution-walkthrough.md).
101## Anti-patterns
102
103- Tables that require the prose to be intelligible (not self-contained)
104- Significance stars with no effect size or interval
105- Decorative figures that add no evidence
106- Color-only encoding that fails in grayscale or for colorblind readers
107- Quantitative exhibit values that don't match the analysis script
108
109## Output format
110
111```
112【Main exhibit】what it shows + why a table/figure
113【Self-contained?】title + labels + note + N/units/weights present? [Y/N]
114【Magnitude + uncertainty shown?】[Y/N]
115【Accessible?】grayscale-legible + colorblind-safe? [Y/N]
116【Reproducible / faithful?】matches script or coded data? [Y/N]
117【Next】asr-writing-style
118```
119
120## Supplementary resources
121
122- [`../../resources/external_tools.md`](../../resources/external_tools.md) — plotting, demography, and network visualization tools
123- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — word-count rule (tables/figures excluded) and ASA Style Guide
124
125---
126
127**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `American-Sociological-Review-Skills/skills/asr-tables-figures/SKILL.md`