Crim Tables Figures

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

# 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

1. **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.
2. **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.
3. **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.
4. **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.
5. **Accessible.** Colorblind-safe palettes; legible in grayscale; no chartjunk or 3D. Reviewers parse fast.
6. **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.

## 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

## 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

- [`../../resources/external_tools.md`](../../resources/external_tools.md) — plotting, mapping, trajectory, and survival packages
- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — formatting and double-spacing expectations