% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/stats_cv_sets_methods.R
\name{balanced_boot}
\alias{balanced_boot}
\title{Balanced bootstrap resampling strategy}
\usage{
balanced_boot(k, split, type = c("DA", "R"), probs = NULL)
}
\arguments{
\item{k}{Integer. Number of bootstrap resamples.}

\item{split}{Numeric. Fraction of samples drawn for the training set
(e.g. \code{2/3}). Sampling is performed with replacement.}

\item{type}{Character. Either \code{"DA"} (classification) or \code{"R"} (regression).}

\item{probs}{Numeric vector of quantile probabilities used to stratify continuous
\code{Y} when \code{type = "R"}.}
}
\value{
A named \code{list} with elements:
\describe{
\item{train}{List of integer vectors containing training set indices
for each resampling iteration.}
\item{strategy}{Character string indicating the resampling strategy.}
\item{n}{Integer. Number of samples in the dataset.}
\item{seed}{Integer. Random seed used to generate the resampling splits,
ensuring reproducibility.}
}
}
\description{
Balanced bootstrap resampling strategy
}
\details{
Generates \code{k} bootstrap samples (training sets sampled with replacement).
The remaining samples (the out-of-bag set) can be used as a test set.

Balancing ensures equal representation of strata in the training data:
\describe{
\item{\code{type = "DA"}}{
Class labels define the strata, and sampling is balanced across classes.
}
\item{\code{type = "R"}}{
The response is discretised into bins using quantiles defined by
\code{probs}, and each bin contributes equally to the training set.
}
}
}
\examples{
n <- 100
# bivariate outcome
thr <- 1.5
Y <- c(rnorm(80, thr-3, 0.3), rnorm(20, thr+3, 0.3))  # unbalanced low/high outcome
mean(Y>thr)

cv_k <- kfold(k = 10)
cv_boot <- balanced_boot(k = 10, split = 2/3, type = "R", probs = c(0, 0.8, 1))

k_inst <- metabom8:::.arg_check_cv(cv_pars=cv_k, model_type='R', n=n, Y_prepped=cbind(Y))
b_inst <- metabom8:::.arg_check_cv(cv_pars=cv_boot, model_type='R', n=n, Y_prepped=cbind(Y))

# balanced splits: proportion above global median stays ~0.5
q80 <- quantile(Y, 0.8)
round(sapply(k_inst$train, function(i) mean(Y[i] > q80)), 2) # resembles original Y distr.
round(sapply(b_inst$train, function(i) mean(Y[i] > q80)), 2) # balanced strata (low/high)
}
\seealso{
Other resampling strategies: 
\code{\link{balanced_mc}()},
\code{\link{kfold}()},
\code{\link{mc}()},
\code{\link{stratified_kfold}()}
}
\concept{resampling strategies}
