Tables & Figures (crim-tables-figures)
Exhibits are where an expert reviewer checks whether the crime result is real. Criminology has its own
signature figures — the age–crime curve, trajectory-group plots, survival curves, and crime maps — and
each 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. an online appendix/supplement
- A reviewer found an exhibit unclear, mislabeled, or non-self-contained
- Presenting a trajectory model, survival analysis, or spatial pattern
Principles
- Self-contained. A reader should understand each exhibit from its title, axis/column labels, and
note alone. State the crime measure, units (counts vs. rates per 100k), sample, N, and time window.
- Figures over dense tables for effects. Coefficient/forest plots, predicted counts/rate-ratio
plots, and marginal-effects plots beat a wall of coefficients. Always show intervals.
- Show the curve, not just the coefficient. Age–crime curves, trajectory-group plots (with group
shares and CIs), and Kaplan–Meier / cumulative-incidence recidivism curves communicate the
criminological story directly.
- Maps when place is the point. Hot-spot / kernel-density / choropleth maps for spatial variation;
label the unit (block, tract, agency) and the rate denominator; avoid misleading raw-count maps.
- Accessible. Colorblind-safe palettes; legible in grayscale; no chartjunk or 3D. Reviewers parse fast.
- Reproducible. Each exhibit is generated by the master script; numbers match the deposited package
exactly (see
crim-data-and-transparency).
Criminology-specific exhibits
- Trajectory plots: show group shares, posterior-probability summary, and CIs — not just mean lines.
- Survival/recidivism: report at-risk counts, censoring, and competing risks where relevant.
- For qualitative work: timelines, life-history charts, evidence tables linking claims to sources.
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. Criminology is observational — place/person panels where selection is pervasive; foreground DiD/IV/RDD and the selection objection.
- 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
- Maps or tables of raw crime counts where rates are needed (population not held constant)
- Trajectory plots that hide group shares or classification quality
- Reporting significance stars with no effect size or interval
- Cramming every robustness check into the main text instead of a supplement
- Exhibit numbers/values that don't match the deposited code output
Exhibit choice for the signature crime objects (decision table)
Each criminology figure carries a known probe; pick the exhibit that answers it.
| Criminological object |
Exhibit |
The probe it must survive |
| Age–crime curve |
line plot, offending rate by age |
rate denominator, cohort vs. period |
| Developmental paths |
trajectory plot w/ group shares + CIs |
groups reified? AvePP shown? |
| Recidivism timing |
Kaplan–Meier / cumulative incidence |
censoring and competing risks shown? |
| Spatial concentration |
hot-spot / choropleth, rate-based |
raw counts masquerading as risk? |
| Treatment effect |
coefficient/forest plot w/ intervals |
uncertainty visible, not stars? |
Worked micro-example: fixing a misleading hot-spot map (illustrative)
A draft maps raw burglary counts and the downtown tract glows red. A referee reads it as a risk claim
it does not support — downtown has 5x the nighttime population (illustrative). The fix: switch to a rate
per 1,000 ambient population, use a colorblind-safe sequential palette, label the unit and denominator
in the note, and move the raw-count version to the supplement. Now the exhibit shows concentration of
risk, the object the routine-activity argument claims.
Exhibit pass for Criminology
Treat this skill as an executable review pass, not a prose hint. First lock the crime/justice process, measurement validity, research design, and policy consequence; then judge whether the current manuscript answers the venue's real reader: criminology reviewers who expect theory-linked crime, justice, or harm mechanisms plus transparent measurement.
- Do the pass: For every table or figure, state the estimand or object, sample or case base, uncertainty display, and one sentence the exhibit proves for the venue audience.
- Return a ledger: give
claim / evidence / risk / manuscript location rows, so the next agent can edit rather than rediscover the issue.
- Sibling guard: compare against Justice Quarterly for applied justice, Journal of Quantitative Criminology for methods focus, Social Problems for broader sociological framing; if a sibling owns the contribution, recommend re-routing before polishing format.
- Stop condition: do not give submission-ready advice until the pack's
resources/official-source-map.md has been checked for volatile rules and the manuscript has one concrete fix for the largest venue-specific risk.
Output format
【Main exhibit】what it shows + why a figure/table/map
【Crime metric】counts vs. rates + denominator stated? [Y/N]
【Self-contained?】title + labels + note + N/units/time present? [Y/N]
【Accessible?】grayscale-legible + colorblind-safe? [Y/N]
【Main text vs supplement】split decided
【Reproducible?】generated by master script, matches package? [Y/N]
【Next】crim-writing-style
Supplementary resources
1---2name: crim-tables-figures3description: Use when building tables and figures for a Criminology (ASC / Wiley) manuscript so exhibits are self-contained, accessible, and communicate crime patterns clearly — age-crime curves, trajectory-group plots, recidivism survival curves, hot-spot maps, and effect plots. Designs exhibits; it does not run the analysis.4---56# Tables & Figures (crim-tables-figures)78Exhibits are where an expert reviewer checks whether the crime result is real. Criminology has its own9signature figures — the age–crime curve, trajectory-group plots, survival curves, and crime maps — and10each must earn its place and stand on its own.1112## When to trigger1314- Designing the main results table/figure or a key descriptive exhibit15- Deciding what belongs in the article vs. an online appendix/supplement16- A reviewer found an exhibit unclear, mislabeled, or non-self-contained17- Presenting a trajectory model, survival analysis, or spatial pattern1819## Principles20211. **Self-contained.** A reader should understand each exhibit from its title, axis/column labels, and22 note alone. State the crime measure, units (counts vs. rates per 100k), sample, N, and time window.232. **Figures over dense tables for effects.** Coefficient/forest plots, predicted counts/rate-ratio24 plots, and marginal-effects plots beat a wall of coefficients. Always show intervals.253. **Show the curve, not just the coefficient.** Age–crime curves, trajectory-group plots (with group26 shares and CIs), and Kaplan–Meier / cumulative-incidence recidivism curves communicate the27 criminological story directly.284. **Maps when place is the point.** Hot-spot / kernel-density / choropleth maps for spatial variation;29 label the unit (block, tract, agency) and the rate denominator; avoid misleading raw-count maps.305. **Accessible.** Colorblind-safe palettes; legible in grayscale; no chartjunk or 3D. Reviewers parse fast.316. **Reproducible.** Each exhibit is generated by the master script; numbers match the deposited package32 exactly (see `crim-data-and-transparency`).3334## Criminology-specific exhibits35- Trajectory plots: show group shares, posterior-probability summary, and CIs — not just mean lines.36- Survival/recidivism: report at-risk counts, censoring, and competing risks where relevant.37- For qualitative work: timelines, life-history charts, evidence tables linking claims to sources.3839## Execution bridge (StatsPAI / Stata MCP)4041Generate exhibits from the fitted result, not by retyping numbers (the usual source of42body-vs-supplement drift). Full map: [`execution-with-mcp`](../../../shared-resources/empirical-methods/execution-with-mcp.md). Criminology is observational — place/person panels where selection is pervasive; foreground DiD/IV/RDD and the selection objection.4344- **Tables:** `etable` (multi-model columns) or `did_summary_to_latex` straight from the45 `result_id`.46- **Figures:** `plot_from_result` / `enhanced_event_study_plot` / `event_study_table` —47 axis units and the SE/clustering note baked in.48- **Every note** names the estimator + clustering and states the effect size in49 interpretable units.5051See a full fitted-result → exhibit chain in the [JF execution walkthrough](../../../Journal-of-Finance-Skills/resources/worked-examples/02-execution-walkthrough.md).52## Anti-patterns5354- Maps or tables of raw crime counts where rates are needed (population not held constant)55- Trajectory plots that hide group shares or classification quality56- Reporting significance stars with no effect size or interval57- Cramming every robustness check into the main text instead of a supplement58- Exhibit numbers/values that don't match the deposited code output5960## Exhibit choice for the signature crime objects (decision table)6162Each criminology figure carries a known probe; pick the exhibit that answers it.6364| Criminological object | Exhibit | The probe it must survive |65|-----------------------|---------|---------------------------|66| Age–crime curve | line plot, offending rate by age | rate denominator, cohort vs. period |67| Developmental paths | trajectory plot w/ group shares + CIs | groups reified? AvePP shown? |68| Recidivism timing | Kaplan–Meier / cumulative incidence | censoring and competing risks shown? |69| Spatial concentration | hot-spot / choropleth, rate-based | raw counts masquerading as risk? |70| Treatment effect | coefficient/forest plot w/ intervals | uncertainty visible, not stars? |7172## Worked micro-example: fixing a misleading hot-spot map (illustrative)7374A draft maps raw burglary counts and the downtown tract glows red. A referee reads it as a risk claim75it does not support — downtown has 5x the nighttime population (illustrative). The fix: switch to a rate76per 1,000 ambient population, use a colorblind-safe sequential palette, label the unit and denominator77in the note, and move the raw-count version to the supplement. Now the exhibit shows concentration of78*risk*, the object the routine-activity argument claims.7980## Exhibit pass for Criminology8182Treat this skill as an executable review pass, not a prose hint. First lock the crime/justice process, measurement validity, research design, and policy consequence; then judge whether the current manuscript answers the venue's real reader: criminology reviewers who expect theory-linked crime, justice, or harm mechanisms plus transparent measurement.8384- **Do the pass:** For every table or figure, state the estimand or object, sample or case base, uncertainty display, and one sentence the exhibit proves for the venue audience.85- **Return a ledger:** give `claim / evidence / risk / manuscript location` rows, so the next agent can edit rather than rediscover the issue.86- **Sibling guard:** compare against Justice Quarterly for applied justice, Journal of Quantitative Criminology for methods focus, Social Problems for broader sociological framing; if a sibling owns the contribution, recommend re-routing before polishing format.87- **Stop condition:** do not give submission-ready advice until the pack's `resources/official-source-map.md` has been checked for volatile rules and the manuscript has one concrete fix for the largest venue-specific risk.8889## Output format9091```92【Main exhibit】what it shows + why a figure/table/map93【Crime metric】counts vs. rates + denominator stated? [Y/N]94【Self-contained?】title + labels + note + N/units/time present? [Y/N]95【Accessible?】grayscale-legible + colorblind-safe? [Y/N]96【Main text vs supplement】split decided97【Reproducible?】generated by master script, matches package? [Y/N]98【Next】crim-writing-style99```100101## Supplementary resources102103- [`../../resources/external_tools.md`](../../resources/external_tools.md) — plotting, mapping, trajectory, and survival packages104- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — formatting and double-spacing expectations