ggfacto
0.4.0Graphs for Correspondence Analysis
Overview
Readable, complete and pretty graphs for multiple correspondence analysis, correspondence analysis and principal component analysis made with 'FactoMineR'. They can be rendered as interactive 'HTML' plots, showing useful information at mouse hover. The interest is not mainly visual but statistical. It helps the reader to keep in mind the data contained in the cross-table or Burt table while reading the correspondence analysis, thus preventing over-interpretation. Most graphs are made with 'ggplot2', which means that you can use the + syntax to manually add as many graphical pieces you want, or change theme elements. 3D graphs are made with 'plotly'.
One workflow for the three analyses: the analysis, interpret() for its axes, ggfacto() for its graph, hierarchical_clust() for its clusters. See the guide: <https://bricenocenti.github.io/ggfacto/articles/ggfacto.html>.
New functions
multiple_correspondence_analysis(),principal_component_analysis(),correspondence_analysis()(from atabxplor::tab()): the analyses, weights and variables selected as intab().interpret(): the table of an analysis' axes, with its eigenvalues below;eigenvalues()alone.ggfacto(): the graph of any of the three analyses;ggpca(), the individuals of a PCA and its biplot.hierarchical_clust():HCPC()'s clusters, in linear memory, written into the data withmutate();clust_tab()describes them.axis_coord(),is_in_analysis(): an analysis' coordinates, and its population, back into the data.name_axes()names the axes on graphs and tables.
New arguments and changes
excl =takes exact level names; missing answers become<VAR>.NAlevels, excluded by default (specific MCA).filter =analyses a subset; the whole data frame is then passed to every later function.clust =,names =,interactive =,lang =;options(ggfacto.widget_dir)writes widgets to their own file in documents.profiles = TRUEandactive_tables = "active"are the defaults: the crosstables of the Burt table are in the tooltips.
Show all changes in 0.4.0Hide the rest of the changes in 0.4.0
- The MCA is fitted on the distinct answer profiles (same results, much faster);
MCA2()keeps the 0.3.2 fit on individuals. - A missing value of a PCA sits at its variable's weighted mean.
- Requires R >= 4.3, ggplot2 >= 4.0 and tabxplor >= 2.0.1.
Deprecations and removals
HCPC_tab()(useclust_tab()), thecahanddatarguments (useclustanddata), and%>%are soft-deprecated.pers_or_plot()is removed;ggi(iframe =, pixel_width =)are ignored.
Bug corrections
- The
Frequencyline of a tooltip could exceed 100 %. - A question with levels
y/ndisappeared from the graphs and tables. - The ellipses of a weighted analysis ignored the weights.
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-30
- NOTE13 NOTE2026-06-09
- ERROR12 NOTE, 1 ERROR2026-06-07
- NOTE3 OK, 11 NOTE2026-03-10
Documentation
The repository also keeps web-only articles.
- Help pages
- 32 (3 internal)
- Examples that run
- 61%14 run in a plain check · 9 only when donttest examples are enabled (R CMD check --as-cran)
- Exported functions with examples
- 82%
- Documented parameters
- 95%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 37
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Releases over time
Issues over time
Commits over time
7 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/bricenocenti/ggfacto on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-09-22 · The repository has a site deploy workflow
pkgdown site last built 2026-09-22
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-08-29Named in .Rbuildignore: .claude, CLAUDE.mdPull request it wrote: opened by a project member
Dependencies
Installing ggfacto adds 115 packages (60 with compiled code, 109 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, data.table 5.7 MB.
Code & Tests
People & History
Pick two releases to compare their code metrics.
- 0.4.0Latest2026-09-22 · current release · diff ↗ ·
removed 1 export
pers_or_plotadded 12 exports
axis_coord, clust_tab, correspondence_analysis, eigenvalues, ggfacto, ggpca, hierarchical_clust, interpret, is_in_analysis, multiple_correspondence_analysis, name_axes, principal_component_analysis - RR 4.6.0 released · 2026-04-24
- RR 4.5.0 released · 2025-04-11
- 0.3.22024-10-02 · diff ↗
- 0.3.12024-08-30 · diff ↗
- RR 4.4.0 released · 2024-04-24
- 0.3.02024-03-08 · diff ↗ ·
added 9 exports
HCPC_tab, PCA2, ggmca_3d, ggmca_initial_dims, ggmca_with_base_ref, ggpca_3d, ggpca_cor_circle, mean_sd_tab, pca_interpret - unarchivedReturned to CRAN2024-01-25
- 0.2.3
- RR 4.3.0 released · 2023-04-21
- archivedRemoved from CRAN2022-09-04issues were not corrected in time
- RR 4.2.0 released · 2022-04-22
- 0.2.22021-10-22
- RR 4.1.0 released · 2021-05-18
Package metadata
- First published
- 2021-10-22
- Total releases
- 6 / 5 yrs
- License
- GPL (>= 3) OSI
- Minimum R
- ≥ 4.3.0
- Download size
- 212 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("ggfacto")The package provides a citation file that builds its entry when R runs it. Run citation() to see it.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-17, which the citation names so these numbers can be found later. More on citing and the projects behind them.