% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/iid_constructors.R
\name{order_statistic}
\alias{order_statistic}
\title{k-th order statistic of m iid components}
\usage{
order_statistic(d, k, m)
}
\arguments{
\item{d}{A \code{dist} object.}

\item{k}{The order statistic index (1 = min, m = max).}

\item{m}{Number of iid components.}
}
\value{
A \code{kofn_dist}.
}
\description{
Constructs a \code{kofn_dist} whose system lifetime equals \code{T_(k)}, the
k-th order statistic of \code{m} iid draws from \code{d}. Under the k-of-m
parametrization, the system fails at the \code{(m - k + 1)}-th component
failure; setting the threshold to \code{m - k + 1} makes the system lifetime
equal \code{T_(k)}.
}
\details{
The internal call is \code{kofn_dist(m - k + 1, ...)}: this maps the
order-statistic index \code{k} (where \code{k = 1} is the minimum, \code{k = m} is
the maximum) to the \verb{:G} convention used by \code{kofn_dist} (where the
\code{k_dist} argument is the number of functioning components required).
}
\examples{
# Median of 5 iid exponentials
sys <- order_statistic(algebraic.dist::exponential(1), k = 3, m = 5)
}
