plot_kfre_metrics

Draws ROC and PR curves for the selected models and horizons. When
<code>mode</code> is "both", returns a list of ggplot objects. Otherwise, draws
the plots and returns <code>NULL</code> invisibly.

Implements the Kidney Failure Risk Equation
(KFRE; Tangri and colleagues (2011) <doi:10.1001/jama.2011.451>;
Tangri and colleagues (2016) <doi:10.1001/jama.2015.18202>) to compute
2- and 5-year kidney failure risk using 4-, 6-, and 8-variable models.
Includes helpers to append risk columns to data frames, classify
chronic kidney disease (CKD) stages and end-stage renal disease (ESRD)
outcomes, and evaluate and plot model performance.

Leonid Shpaner

kfre

Kidney Failure Risk Equation (KFRE) Tools

plot_kfre_metrics function

<dl><dt>df</dt>
<dd>Data frame containing model probabilities and outcomes.</dd>
<dt>num_vars</dt>
<dd>Integer vector, KFRE model sizes to plot, any of 4, 6, 8.</dd>
<dt>fig_size</dt>
<dd>Numeric length 2, plot device width and height.</dd>
<dt>mode</dt>
<dd>Character, "both" to return plots, otherwise draw only.</dd>
<dt>image_path_png</dt>
<dd>Optional directory to save PNGs.</dd>
<dt>image_path_svg</dt>
<dd>Optional directory to save SVGs.</dd>
<dt>image_prefix</dt>
<dd>Optional filename prefix.</dd>
<dt>bbox_inches</dt>
<dd>Character, passed through when saving.</dd>
<dt>plot_type</dt>
<dd>Character, which plots to render.</dd>
<dt>save_plots</dt>
<dd>Logical, save plots to disk if TRUE.</dd>
<dt>show_years</dt>
<dd>Integer vector, horizons to show, any of 2, 5.</dd>
<dt>plot_combinations</dt>
<dd>Logical, if TRUE draw pairwise overlays.</dd>
<dt>show_subplots</dt>
<dd>Logical, arrange subplots when TRUE.</dd>
<dt>decimal_places</dt>
<dd>Integer digits for annotations.</dd>
<dt>open_new_device</dt>
<dd>Logical, open device before plotting.</dd></dl>

Arguments

Plot ROC and Precision Recall curves for KFRE variants — plot_kfre_metrics

<dl>

<dt>df</dt>
<dd>Data frame containing model probabilities and outcomes.</dd>


<dt>num_vars</dt>
<dd>Integer vector, KFRE model sizes to plot, any of 4, 6, 8.</dd>


<dt>fig_size</dt>
<dd>Numeric length 2, plot device width and height.</dd>


<dt>mode</dt>
<dd>Character, "both" to return plots, otherwise draw only.</dd>


<dt>image_path_png</dt>
<dd>Optional directory to save PNGs.</dd>


<dt>image_path_svg</dt>
<dd>Optional directory to save SVGs.</dd>


<dt>image_prefix</dt>
<dd>Optional filename prefix.</dd>


<dt>bbox_inches</dt>
<dd>Character, passed through when saving.</dd>


<dt>plot_type</dt>
<dd>Character, which plots to render.</dd>


<dt>save_plots</dt>
<dd>Logical, save plots to disk if TRUE.</dd>


<dt>show_years</dt>
<dd>Integer vector, horizons to show, any of 2, 5.</dd>


<dt>plot_combinations</dt>
<dd>Logical, if TRUE draw pairwise overlays.</dd>


<dt>show_subplots</dt>
<dd>Logical, arrange subplots when TRUE.</dd>


<dt>decimal_places</dt>
<dd>Integer digits for annotations.</dd>


<dt>open_new_device</dt>
<dd>Logical, open device before plotting.</dd>

</dl>

plot_kfre_metrics: Plot ROC and Precision Recall curves for KFRE variants

Description

Value

Arguments