% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/pep_download.R
\name{pep_download}
\alias{pep_download}
\title{Download Synthetic PEP725 Data}
\usage{
pep_download(url = NULL, cache = TRUE, force = FALSE, quiet = FALSE)
}
\arguments{
\item{url}{Character string specifying the URL to download from.
Default uses the official pep725 package data repository.}

\item{cache}{Logical. If \code{TRUE} (default), cache the downloaded data
locally for future use.}

\item{force}{Logical. If \code{TRUE}, force re-download even if cached
data exists. Default is \code{FALSE}.}

\item{quiet}{Logical. If \code{TRUE}, suppress download progress messages.
Default is \code{FALSE}.}
}
\value{
A \code{pep} object containing synthetic phenological data with
the same structure as original PEP725 data.
}
\description{
Downloads a pre-generated synthetic version of PEP725 phenological data
from an external repository. The data is cached locally after the first
download to avoid repeated downloads.
}
\details{
The synthetic data preserves the statistical properties and structure of
real PEP725 data (stations, species, phases, temporal patterns) while
ensuring data privacy. It is suitable for:
\itemize{
\item Learning and testing package functions
\item Reproducing examples from vignettes
\item Developing analysis workflows before accessing real data
}

The data is cached in the platform-appropriate user cache directory
determined by \code{\link[tools]{R_user_dir}("pep725", which = "cache")}.
Typical locations:
\itemize{
\item Windows: \code{\%LOCALAPPDATA\%/R/cache/R/pep725/}
\item macOS: \code{~/Library/Caches/org.R-project.R/R/pep725/}
\item Linux: \code{~/.cache/R/pep725/}
}
}
\section{Data Access}{

If you have access to real PEP725 data, you can import it using
\code{\link{pep_import}} instead.
}

\examples{
\donttest{
# Download synthetic data
pep <- pep_download()

# Explore the data
print(pep)
summary(pep)

# Force re-download
pep <- pep_download(force = TRUE)
}

}
\seealso{
\code{\link{pep_simulate}} for creating your own synthetic data,
\code{\link{pep_import}} for importing real PEP725 data
}
\author{
Matthias Templ
}
