counterfactual_explain

Uses DALEX ceteris-paribus profiles (`predict_profile`) to compute
counterfactual-style what-if explanations for a given observation.

Provides a guarded resampling workflow for training and evaluating machine-learning models.
When the guarded resampling path is used, preprocessing and model fitting are re-estimated within
each resampling split to reduce leakage risk. Supports multiple resampling schemes, integrates
with established engines in the 'tidymodels' ecosystem, and aims to improve evaluation reliability by
coordinating preprocessing, fitting, and evaluation within supported workflows. Offers a lightweight
AutoML-style workflow by automating model training, resampling, and tuning across multiple algorithms,
while keeping evaluation design explicit and user-controlled.

Selcuk Korkmaz

fastml

Guarded Resampling Workflows for Safe and Automated Machine
Learning in R

Dincer Goksuluk

Eda Karaismailoglu

counterfactual_explain function

<dl><dt>object</dt>
<dd>A `fastml` object.</dd>
<dt>observation</dt>
<dd>A single observation (data frame with one row) to compute
counterfactuals for.</dd>
<dt>variables</dt>
<dd>Optional character vector of candidate variables to vary.
Only numeric variables are used for counterfactual profiling.</dd>
<dt>data</dt>
<dd>Character string specifying which data to use for the explainer background:
<code>"train"</code> (default) or <code>"test"</code>.</dd>
<dt>positive_class</dt>
<dd>Optional string used to filter lines/points in the
resulting profiles for classification tasks.</dd>
<dt>event_class</dt>
<dd>Optional event class indicator propagated from
`fastml_prepare_explainer_inputs()` (kept for compatibility).</dd>
<dt>label_levels</dt>
<dd>Optional vector of label levels propagated from
`fastml_prepare_explainer_inputs()` (kept for compatibility).</dd>
<dt>...</dt>
<dd>Additional arguments passed to `DALEX::predict_profile`.</dd></dl>

Arguments

Generate counterfactual explanations for a fastml model — counterfactual_explain

<dl>

<dt>object</dt>
<dd>A `fastml` object.</dd>


<dt>observation</dt>
<dd>A single observation (data frame with one row) to compute
counterfactuals for.</dd>


<dt>variables</dt>
<dd>Optional character vector of candidate variables to vary.
Only numeric variables are used for counterfactual profiling.</dd>


<dt>data</dt>
<dd>Character string specifying which data to use for the explainer background:
<code>"train"</code> (default) or <code>"test"</code>.</dd>


<dt>positive_class</dt>
<dd>Optional string used to filter lines/points in the
resulting profiles for classification tasks.</dd>


<dt>event_class</dt>
<dd>Optional event class indicator propagated from
`fastml_prepare_explainer_inputs()` (kept for compatibility).</dd>


<dt>label_levels</dt>
<dd>Optional vector of label levels propagated from
`fastml_prepare_explainer_inputs()` (kept for compatibility).</dd>


<dt>...</dt>
<dd>Additional arguments passed to `DALEX::predict_profile`.</dd>

</dl>

counterfactual_explain: Generate counterfactual explanations for a fastml model

Description

Usage

Value

Arguments