Skip to content

Conversation

@jibarozzo
Copy link
Collaborator

Increment to v1.0.0 from v0.1.0

New visualization functions bring new functionality to package and improve workflow. New workflow is captured in vignette and summarized in README.md. Some functionalities are still evolving, but this version represents a major change in workflow and API capabilities.

Highlights

Added functions:
R/

  • add_rarefaction_metrics()
  • plot_abundance_occupancy()
  • plot_core_distribution()
  • plot_rarefaction_metrics()
  • update_otu_table() (previously do_phyloseq())

vignettes/
Static vignette for package documentation. This avoids failures in GH actions (macos runners).

  • BRCore-vignette.Rmd
  • BRCore-vignette.Rmd.orig
  • images/
  • precompile.R
  • references.bib

Changed:
identify_core has improved progress messaging, and named list outputs
Tests:
Added suites for added functions.

Selected commits

  • 22d4b66: amending previous push: new plotting functions and minor fixes
  • 1b8232d: Finalized vignette for BRCore
  • 58d6d30: Gains overhaul package and NAMSPACE import in functions.
  • 8ef5c78 : Changed @examplesIf requireNamespace("phyloseq", quietly = TRUE) for the more explicit `@examples
  • c7e949b: Gains STATIC vignette

Contributors

Special thanks to @Gian77 for improvements in visualizations functions, tests, and vignette.

Gian77 and others added 30 commits October 1, 2025 23:48
…loseq was not working correctly, no I fixed it.
Add abundance occupancy and core distribution plot functions
… with 50 samples as a base test dataset for the package, other small fixes and check messaging implementations
new pre-rarefaction functions and other fixes
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
linewidth

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
refining some plot function and fixing minor errors
…`importFrom` more. Importing only what we use.

- Change from %>% pipe to |> base pipe. Plotting functions don't wrangle the data that much so we don't need the added benefits of %>%. This will be applied to other functions throughout.
- identify_core() gains some clarity in function description as well as header cleanup (this helps when viewing outline in VS Code or Positron).
- identify_core()'s "fo_diffs" output parameter updated to "elbow_slope_diffs" as it is more informative of the proccess applied to the data.
- identify_core() changes pipe from %>% to |>
- NAMESPACE cleans up a little bit after all this
- corresponding function tests reformatted usint Air styler
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
- Added imports via `importFrom` that were missing
- Removed %>% in other functions where it was unnecessary.
- Only `do-phyloseq()` retains %>% in subsection
- Updated NAMESPACE
…ction is due to failure to connect to Bioconductor.
…r the more explicit `@examples

#' \donttest{
#' library(phyloseq)
#' library(BRCore)` To convey the importance and relience of this package on "phyloseq".
- Kept \dontrun{} in some functions' documentation, like plot_neutral_model() that are only illustrative and depend on other functions.
- Changed name: `do_phyloseq()` is now `update_otu_table()
jibarozzo and others added 12 commits December 22, 2025 10:00
- `precompile.R` builds static vignette from "vignettes/BRCore-vignette.Rmd.orig" --> "vignettes/BRCore-vignette.Rmd
- `prcompile.R` cleans directory and moves images to necessary direcotry for `devtools::build_vignette()`
…art example

Co-authored-by: jibarozzo <64099468+jibarozzo@users.noreply.github.com>
Co-authored-by: jibarozzo <64099468+jibarozzo@users.noreply.github.com>
…adges

Create brief README.Rmd for GitHub rendering
@jibarozzo jibarozzo added this to the v.1.0.0 milestone Dec 23, 2025
@jibarozzo jibarozzo requested review from Gian77 and Copilot December 23, 2025 03:39
@jibarozzo jibarozzo self-assigned this Dec 23, 2025
@jibarozzo jibarozzo added the documentation Improvements or additions to documentation label Dec 23, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request upgrades BRCore from v0.1.0 to v1.0.0, introducing significant new functionality for microbiome core analysis and visualization. The major changes include new plotting functions, rarefaction utilities, and a comprehensive static vignette for package documentation.

  • Addition of five new visualization and analysis functions: add_rarefaction_metrics(), plot_abundance_occupancy(), plot_core_distribution(), plot_rarefaction_metrics(), and renamed update_otu_table() (formerly do_phyloseq())
  • Implementation of a static vignette system to avoid failures in GitHub Actions macOS runners
  • Enhanced test coverage for the new functions
  • Improved progress messaging in identify_core() with named list outputs

Reviewed changes

Copilot reviewed 50 out of 67 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
vignettes/BRCore-vignette.Rmd.orig Source file for the static vignette containing comprehensive documentation and examples
vignettes/precompile.R Script for pre-compiling the computationally intensive vignette and managing image files
vignettes/references.bib Bibliography file with references for rarefaction, neutral models, and core microbiome concepts
vignettes/images/*.png Pre-compiled visualization outputs for the vignette (4 image files)
vignettes/.gitignore Excludes HTML output from version control
tests/testthat/test-update_otu_table.R Updated tests using bcse dataset instead of test_phyloseq
tests/testthat/test-plot_*.R New and updated test files for plotting functions with improved formatting

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Collaborator Author

@jibarozzo jibarozzo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestions by Copilot resolved.

@jibarozzo jibarozzo marked this pull request as ready for review December 23, 2025 04:19
@jibarozzo
Copy link
Collaborator Author

jibarozzo commented Dec 23, 2025

@Gian77 once approved, I'll merge to main and then update develop in another PR. This brings all we have been working on with the addition of new content in DESCRIPTION file. Be sure to check that out.

Copy link
Collaborator

@Gian77 Gian77 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! What are we going to do for the vignette?

@jibarozzo
Copy link
Collaborator Author

Vignette #66 has already been merged to develop. It renders.

@jibarozzo jibarozzo merged commit 4e3a02a into main Dec 27, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants