Package: ggpubr 1.1.0

ggpubr: 'ggplot2' Based Publication Ready Plots

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 adds publication-ready figures for common analysis workflows: ROC curves with the area under the curve and its confidence interval ('ggrocplot()'), one- and two-way group comparison figures with brackets and an omnibus label ('ggcompare()'), volcano plots ('ggvolcano()'), forest and estimation plots ('ggestimates()'), raincloud plots ('ggraincloud()'), compact letter displays ('stat_cld()') and test labels ('add_test_label()'), together with automatic bracket packing for pairwise comparisons ('geom_pwc()').

Authors:Alboukadel Kassambara [aut, cre], Laszlo Erdey [ctb]

ggpubr_1.1.0.tar.gz
ggpubr_1.1.0.zip(r-4.7-any)ggpubr_1.1.0.zip(r-4.6-any)ggpubr_1.1.0.zip(r-4.5-any)
ggpubr_1.1.0.tgz(r-4.6-any)ggpubr_1.1.0.tgz(r-4.5-any)
ggpubr_1.1.0.tar.gz(r-4.7-any)ggpubr_1.1.0.tar.gz(r-4.6-any)
ggpubr_1.1.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
ggpubr/json (API)

# Install 'ggpubr' in R:
install.packages('ggpubr', repos = c('https://kassambara.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/kassambara/ggpubr/issues

Pkgdown/docs site:https://rpkgs.datanovia.com

Datasets:

On CRAN:

Conda:

19.70 score 1.3k stars 510 packages 104k scripts 206k downloads 856 mentions 143 exports 75 dependencies

Last updated from:e46af48626. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK411
source / vignettesOK244
linux-releaseOK481
macos-releaseOK355
macos-oldrelOK364
windows-develOK476
windows-releaseOK355
windows-oldrelOK497
wasm-releaseOK131

Exports:%>%add_cldadd_summaryadd_test_labeladd_xy_positionannotate_figureas_ggplotas_npcas_npcxas_npcybackground_imagebgcolorborderchange_paletteclean_lock_filesclean_table_themeclean_themecolnames_stylecolor_palettecompare_meanscreate_aescreate_p_labelcreate_test_labeldesc_statbyfacetfill_palettefontformat_p_valuegeom_bracketgeom_execgeom_pwcgeom_signifgeom_violin_halfGeomViolinHalfget_breaksget_coordget_legendget_p_format_styleget_paletteget_pwc_labelget_summary_statsget_test_labelggaddggadjust_pvalueggarrangeggballoonplotggbarplotggboxplotggcompareggdensityggdonutchartggdotchartggdotplotggecdfggerrorplotggestimatesggexportgghistogramgglineggmaplotggpairedggparggparagraphggpieggpubr_optionsggqqplotggraincloudggrocplotggscatterggscatterhistggstripchartggsummarystatsggsummarytableggtextggtexttableggviolinggvolcanogradient_colorgradient_fillgridsgroup_bylabs_pubrlist_p_format_stylesmean_cimean_rangemean_sdmean_se_median_hilow_median_iqrmedian_madmedian_q1q3median_rangemutatenpc_to_data_coordrotaterotate_x_textrotate_y_textrownames_stylerremoveset_paletteshow_line_typesshow_point_shapesstat_anova_teststat_bracketstat_central_tendencystat_chullstat_cldstat_compare_meansstat_conf_ellipsestat_corstat_friedman_teststat_kruskal_teststat_meanstat_overlay_normal_densitystat_pvalue_manualstat_pwcstat_regline_equationstat_starsstat_welch_anova_teststyle_scatterhiststyle_summarystatstab_add_bordertab_add_footnotetab_add_hlinetab_add_titletab_add_vlinetab_cell_crossouttab_ncoltab_nrowtable_cell_bgtable_cell_fonttbody_add_bordertbody_styletext_grobthead_add_bordertheme_classic2theme_clevelandtheme_pubcleantheme_pubrtheme_transparenttthemexscaleyscale

Dependencies:abindbackportsbootbroomcarcarDataclicolorspacecorrplotcowplotcpp11DerivdoBydplyrfarverforecastFormulafracdiffgenericsggplot2ggrepelggsciggsignifgluegridExtragtableisobandlabelinglatticelifecyclelme4lmtestmagrittrMASSMatrixMatrixModelsmgcvminqamodelrnlmenloptrnnetnumDerivpbkrtestpillarpkgconfigpolynompurrrquantregR6rbibutilsRColorBrewerRcppRcppArmadilloRcppEigenRdpackreformulasrlangrstatixS7scalesSparseMstringistringrsurvivaltibbletidyrtidyselecttimeDateurcautf8vctrsviridisLitewithrzoo

Adding Statistical Test Results to Plots
Pairwise brackets | Automatic bracket packing | Compact letter display | Brackets or letters? | The omnibus label | All three in one call
Rendered fromstatistical-annotations.Rmdusingknitr::rmarkdown

Last update: 2026-07-13
Started: 2026-07-13

Forest and Estimation Plots with ggestimates()
From a table of estimates | From a fitted model | Mean differences and linear coefficients | Sorting, banding, and the estimate column | A meta-analysis forest
Rendered fromforest-estimation-plots.Rmdusingknitr::rmarkdown

Last update: 2026-07-13
Started: 2026-07-13

ROC Curves and Diagnostic Accuracy with ggrocplot()
A single ROC curve | Which way round? The positive class and AUC below 0.5 | The optimal cut-point | Comparing several markers | Notes
Rendered fromroc-curves.Rmdusingknitr::rmarkdown

Last update: 2026-07-13
Started: 2026-07-13

Two-Way Comparison Figures with ggcompare()
The one-call two-way figure | It matches the by-hand analysis | Simple main effects on the plot | Customizing | Naming an effect on any plot
Rendered fromtwo-way-comparison.Rmdusingknitr::rmarkdown

Last update: 2026-07-13
Started: 2026-07-12

Combining ggpubr Plots with patchwork
Side by side, stacked, and nested | Controlling the layout | One shared legend | Titles and panel tags | Correlation matrices | See also
Rendered fromggpubr-with-patchwork.Rmdusingknitr::rmarkdown

Last update: 2026-07-12
Started: 2026-07-12

Readme and manuals

Help Manual

Help pageTopics
Add Summary Statistics onto a ggplot.add_summary mean_ci mean_range mean_sd mean_se_ median_hilow_ median_iqr median_mad median_q1q3 median_range
Add an Omnibus Test Label to a GGPlotadd_test_label
Annotate Arranged Figureannotate_figure
Storing grid.arrange() arrangeGrob() and plotsas_ggplot
Convert Character Coordinates into Normalized Parent Coordinates (NPC)as_npc as_npcx as_npcy
Change Axis Scale: log2, log10 and moreaxis_scale xscale yscale
Add Background Image to ggplot2background_image
Change ggplot Panel Background Colorbgcolor
Set ggplot Panel Border Lineborder
Clean up stale package lock filesclean_lock_files
Comparison of Meanscompare_means
Create Aes Mapping from a Listcreate_aes
Create P-Value Label with Proper Prefixcreate_p_label
Descriptive statistics by groupsdesc_statby
Differential gene expression analysis resultsdiff_express
Facet a ggplot into Multiple Panelsfacet
Change the Appearance of Titles and Axis Labelsfont
Format P-Values According to Style or Custom Settingsformat_p_value
Gene Citation Indexgene_citation
Gene Expression Datagene_expression
Execute ggplot2 functionsgeom_exec
Half Violin PlotGeomViolinHalf geom_violin_half
Easy Break Creation for Numeric Axesget_breaks
Checks and Returns Data Coordinates from Multiple Input Optionsget_coord
Extract Legends from a ggplot objectget_legend
Get P-Value Format Style Settingsget_p_format_style
Generate Color Palettesget_palette
Add Summary Statistics or a Geom onto a ggplotggadd
Adjust p-values Displayed on a GGPlotggadjust_pvalue
Arrange Multiple ggplotsggarrange
Balloon plotggballoonplot
Bar plotggbarplot
Box plotggboxplot
Publication-Ready Group Comparison Plotggcompare
Density plotggdensity
Donut chartggdonutchart
Cleveland's Dot Plotsggdotchart theme_cleveland
Dot plotggdotplot
Empirical cumulative density functionggecdf
Visualizing Errorggerrorplot
Forest Plot of Estimates and Confidence Intervalsggestimates
Export ggplotsggexport
Histogram plotgghistogram
Line plotggline
MA-plot from means and log fold changesggmaplot
Plot Paired Dataggpaired
Graphical parametersggpar
Draw a Paragraph of TextdrawDetails.splitText ggparagraph
Pie chartggpie
ggpubr General Arguments Descriptionggpubr_args
Global Options for ggpubrggpubr_options
QQ Plotsggqqplot
Raincloud Plotggraincloud
ROC Curveggrocplot
Scatter plotggscatter
Scatter Plot with Marginal Histogramsggscatterhist print.ggscatterhist
Stripchartsggstripchart
GGPlot with Summary Stats Table Under the Plotggsummarystats ggsummarytable print.ggsummarystats print.ggsummarystats_list
Textggtext
Draw a Textual Tablecolnames_style ggtexttable rownames_style table_cell_bg table_cell_font tab_add_border tab_add_footnote tab_add_hline tab_add_title tab_add_vline tab_cell_crossout tab_ncol tab_nrow tbody_add_border tbody_style thead_add_border ttheme
Violin plotggviolin
Volcano Plot of Differential Expression Resultsggvolcano
Set Gradient Colorgradient_color gradient_fill
Add Grids to a ggplotgrids
List Available P-Value Format Styleslist_p_format_styles
Convert NPC to Data Coordinatesnpc_to_data_coord
Rotate a ggplot Horizontallyrotate
Rotate Axes Textrotate_axis_text rotate_x_text rotate_y_text
Remove a ggplot Componentrremove
Set Color Palettechange_palette color_palette fill_palette set_palette
Line types available in Rshow_line_types
Point shapes available in Rshow_point_shapes
Add Anova Test P-values to a GGPlotstat_anova_test
Add Brackets with Labels to a GGPlotgeom_bracket stat_bracket
Add Central Tendency Measures to a GGPlotstat_central_tendency
Plot convex hull of a set of pointsstat_chull
Add Compact Letter Display to a GGPlotstat_cld
Add Mean Comparison P-values to a ggplotstat_compare_means
Plot confidence ellipses.stat_conf_ellipse
Add Correlation Coefficients with P-values to a Scatter Plotstat_cor
Add Friedman Test P-values to a GGPlotstat_friedman_test
Add Kruskal-Wallis Test P-values to a GGPlotstat_kruskal_test
Draw group mean pointsstat_mean
Overlay Normal Density Plotstat_overlay_normal_density
Add P-values Manually to a ggplotstat_pvalue_manual
Add Pairwise Comparisons P-values to a GGPlotgeom_pwc stat_pwc
Add Regression Line Equation and R-Square to a GGPlot.stat_regline_equation
Add Stars to a Scatter Plotstat_stars
Add Welch One-Way ANOVA Test P-values to a GGPlotstat_welch_anova_test
Restyle a ggscatterhist Compositestyle_scatterhist
Restyle a ggsummarystats Compositestyle_summarystats
Create a Text Graphical objecttext_grob
Publication ready themeclean_table_theme clean_theme labs_pubr theme_classic2 theme_pubclean theme_pubr
Create a ggplot with Transparent Backgroundtheme_transparent