% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/priors-linear-density.R
\name{plot_transformed_prior}
\alias{plot_transformed_prior}
\title{Plot Transformed Prior Densities}
\usage{
plot_transformed_prior(
  prior_list,
  column_names,
  formula_scale = NULL,
  parameter,
  n_points = 1000,
  x_range = NULL,
  transformation = NULL,
  transformation_arguments = NULL,
  transformation_settings = FALSE,
  plot_type = c("base", "ggplot"),
  par_name = NULL,
  ...
)
}
\arguments{
\item{prior_list}{named list of prior distributions.}

\item{column_names}{character vector of coefficient column names defining the
fitted parameter space.}

\item{formula_scale}{optional nested formula-scale metadata, in the same shape
as \code{attr(fit, "formula_scale")}.}

\item{parameter}{coefficient name to plot.}

\item{n_points}{number of plotting points.}

\item{x_range}{optional plotting range on the untransformed scale.}

\item{transformation}{optional output transformation passed to the prior
plotting machinery.}

\item{transformation_arguments}{optional list of transformation arguments.}

\item{transformation_settings}{whether \code{x_range} is supplied on the
transformed scale.}

\item{plot_type}{either \code{"base"} or \code{"ggplot"}.}

\item{par_name}{optional plotting label.}

\item{...}{additional plotting arguments.}
}
\value{
For \code{plot_type = "base"}, invisibly returns base-plot metadata.
For \code{plot_type = "ggplot"}, returns a \code{ggplot} object. Returns
\code{NULL} when the requested parameter is an identity transform and no
output transformation was requested.
}
\description{
Plots a prior density after applying the same deterministic
coefficient transformation used for formula-scale back-transforms. The helper
supports continuous densities and point-mass priors in the same plot.
}
\seealso{
\code{\link[=plot_prior_list]{plot_prior_list()}} \code{\link[=transform_scale_samples]{transform_scale_samples()}}
}
