% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/ggpubr-package.R
\docType{package}
\name{ggpubr-package}
\alias{ggpubr}
\alias{ggpubr-package}
\title{ggpubr: 'ggplot2' Based Publication Ready Plots}
\description{
The 'ggplot2' package is excellent and flexible for elegant data visualization in R. However the default generated plots require some formatting before we can send them for publication. Furthermore, to customize a 'ggplot', the syntax is opaque and this raises the level of difficulty for researchers with no advanced R programming skills. 'ggpubr' provides some easy-to-use functions for creating and customizing 'ggplot2'-based publication ready plots. This version includes modern R ecosystem compatibility updates and customizable p-value formatting presets (APA, AMA, NEJM, Lancet, GraphPad, and scientific notation) for publication workflows, plus robust sparse-subset handling in statistical annotation layers such as 'stat_compare_means()' and 'geom_pwc()', with informative per-group skip diagnostics for non-comparable subsets.
}
\details{
General resources:

\itemize{
\item \href{https://rpkgs.datanovia.com/ggpubr/}{ggpubr documentation}
\item \href{https://www.datanovia.com/en/blog/tag/ggpubr/}{ggpubr tutorials}
}
}
\section{P-Value Formatting}{


ggpubr provides customizable p-value formatting with predefined style presets
to match different journal and publication requirements. Use \code{\link{format_p_value}()}
for direct formatting, or set \code{p.format.style} in statistical functions.

Available styles: \code{"default"}, \code{"apa"}, \code{"nejm"}, \code{"lancet"},
\code{"ama"}, \code{"graphpad"}, \code{"scientific"}.

See \code{\link{list_p_format_styles}()} for details on each style.
}

\section{Package options}{


\describe{
\item{ggpubr.parse_aes}{logical indicating whether to parse aesthetic variable names.
Default is \code{TRUE}. For example, if you want \code{ggpubr} to handle non-standard column names, like \code{A-A},
without parsing, then set this option to \code{FALSE} using \code{options(ggpubr.parse_aes = FALSE)}.}
\item{ggpubr.null_device}{A function that creates an appropriate null device.
These include: \code{\link[cowplot:pdf_null_device]{cowplot::pdf_null_device}},
\code{\link[cowplot:png_null_device]{cowplot::png_null_device}},
\code{\link[cowplot:cairo_null_device]{cowplot::cairo_null_device}} and
\code{\link[cowplot:agg_null_device]{cowplot::agg_null_device}}. Default is
\code{\link[cowplot:pdf_null_device]{cowplot::pdf_null_device}}. This is used in
functions like \code{\link{as_ggplot}()}, which need to open a graphics
device to render ggplot objects into grid graphics objects. This function is
used to open a null device to avoid displaying an unnecessary blank page
when calling \code{\link{ggarrange}()} or \code{\link{as_ggplot}()}} }
}

\seealso{
Useful links:
\itemize{
  \item \url{https://rpkgs.datanovia.com/ggpubr/}
  \item \url{https://github.com/kassambara/ggpubr}
  \item Report bugs at \url{https://github.com/kassambara/ggpubr/issues}
}

}
\author{
\strong{Maintainer}: Alboukadel Kassambara \email{alboukadel.kassambara@gmail.com}

Other contributors:
\itemize{
  \item Laszlo Erdey \email{erdey.laszlo@econ.unideb.hu} (Faculty of Economics and Business, University of Debrecen, Hungary) [contributor]
}

}
\keyword{internal}
