decision-curve-analysis

1# Decision Curve Analysis
2 
3## When to Use
4 
5Use this skill when you need to:
6- evaluate whether a binary prediction model adds clinical net benefit across threshold probabilities;
7- visualize decision curves and clinical-impact curves from a clinical cohort;
8- export an auditable DCA model object together with summary text and PDFs.
9 
10Typical user requests:
11- "Run decision-curve analysis on this binary outcome and risk-score dataset."
12- "Generate DCA and clinical-impact plots for this prediction model."
13- "Compare net benefit across thresholds for this case-control cohort."
14 
15## When Not to Use
16 
17Do not use this skill for:
18- time-to-event or survival outcomes;
19- ROC-only discrimination analysis without decision-curve outputs;
20- nomogram construction or calibration-curve analysis;
21- multiclass outcomes or non-binary endpoints.
22 
23## When to Read External Files
24 
25| Situation | File to Read | Purpose |
26|-----------|--------------|---------|
27| Need algorithm details | `references/algorithm.md` | Statistical methods and formulas |
28| Need to run analysis | `scripts/main.R` | Get the complete command |
29| Encounter errors | `references/troubleshooting.md` | Find solutions |
30| Need CLI examples | `references/cli-guide.md` | Parameter usage examples |
31 
32---
33 
34## Usage
35 
36```bash
37Rscript scripts/main.R \
38  --data_file ./clinical_dca_data.csv \
39  --outcome_col fustat \
40  --predictor_col riskScore \
41  --output_dir ./output/
42```
43 
44---
45 
46## Arguments
47 
48| Short | Long | Type | Default | Description |
49…