% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/loss_factors.R
\name{aemo_dlf}
\alias{aemo_dlf}
\title{Distribution Loss Factors (DLF) by connection point}
\source{
AEMO MMSDM archive, LOSSFACTORMODEL table.
AEMO Copyright Permissions Notice.
}
\usage{
aemo_dlf(year = NULL, connection_point_id = NULL)
}
\arguments{
\item{year}{Financial year(s) as \code{"YYYY-YY"}. \code{NULL} returns
all available years.}

\item{connection_point_id}{Optional character vector of
connection point IDs.}
}
\value{
An \code{aemo_tbl} with at minimum \code{financial_year},
\code{connectionpointid}, and \code{dlf}.
}
\description{
Returns the Distribution Loss Factor for NEM connection
points from the MMSDM \code{LOSSFACTORMODEL} table. DLFs measure
the average energy loss on the distribution network between
a connection point and the transmission network boundary; a
DLF of 1.02 means the generator must produce 2\% more energy
than it delivers to the transmission system.
}
\details{
DLFs are published annually by AEMO (NER 3.6.3) and combined
with MLFs in settlement to give the total loss factor (TLF =
MLF x DLF) used in energy payments.
}
\examples{
\donttest{
op <- options(aemo.cache_dir = tempdir())
try({
  dlf <- aemo_dlf(year = "2024-25")
  head(dlf)
})
options(op)
}
}
\seealso{
Other reference: 
\code{\link{aemo_interconnectors}()},
\code{\link{aemo_mlf}()},
\code{\link{aemo_participants}()},
\code{\link{aemo_price_caps}()},
\code{\link{aemo_regions}()},
\code{\link{aemo_settlement}()},
\code{\link{aemo_snapshot}()},
\code{\link{aemo_units}()}
}
\concept{reference}
