bifrost 0.1.3
CRAN release: 2026-01-21
- Addressed CRAN reviewer feedback following review of 0.1.2:
- Added explicit return-value documentation (
@return/\value{}) for the exportedprint.bifrost_search()method, clarifying that the function returns the input object invisibly and is called for its printing side effects.
- Added explicit return-value documentation (
- Plotting:
-
plot_ic_acceptance_matrix()gains an optionalbaseline_icargument to plot and computediff(IC)relative to the true no-shift baseline (useful whenmatrix_databegins at the first evaluated shift model rather than the true baseline).
-
- Documentation / vignettes:
- Updated the jaw-shape vignette with additional static figures (evolutionary correlation heatmap, IC-trajectory plot, and branch-rate visualization) and improved plotting annotations.
bifrost 0.1.2
- Addressed CRAN reviewer feedback following review of 0.1.1:
-
plot_ic_acceptance_matrix()now saves and restores the user’s graphical parameters via an immediateon.exit()(prevents leakingpar()settings across calls).
-
- Plotting:
- Added
rate_limitsargument toplot_ic_acceptance_matrix()(defaultc(-400, 150)) to control the secondary y-axis limits for the rate-of-improvement overlay (validated numeric length-2, finite).
- Added
- Search results output:
- Added a
bifrost_searchS3 class andprint.bifrost_search()method forsearchOptimalConfiguration()results (compact console summary; optional ASCII IC-history plot viatxtplotwhenstore_model_fit_history = TRUE; prints IC weights when present). - Print output includes a citation hint (
citation("bifrost")); package citation metadata updated ininst/CITATION.
- Added a
- IC weights / no-shift behavior:
- Standardized
ic_weightsoutput across serial and parallel uncertainty-weight modes; always returns adata.framewith consistent columns, and returns an emptydata.framewith the same schema when no shifts are detected. - When no shifts are detected,
model_no_uncertaintynow returns the baselinemvglsmodel (instead ofNULL).
- Standardized
- Documentation / vignettes / tests:
- Updated jaw-shape vignette chunk printing of
ic_weightsto avoid RStudio paged/Unicode rendering issues. - Expanded and stabilized unit tests and CI configuration (including
Config/testthat/parallel: false).
- Updated jaw-shape vignette chunk printing of
bifrost 0.1.1
- Addressed CRAN reviewer feedback following review of 0.1.0:
- Replaced all uses of shorthand
T/FwithTRUE/FALSE. - Ensured all informational output is suppressible via
message()/warning()and controlled by averboseflag. - Redirected all on-disk output generated during model fitting to
tempdir()to comply with CRAN file system policies and avoid writing to the user’s working directory. - Ensured graphical parameters and global options are restored using immediate
on.exit()calls. - Refined parallelization behavior to be CRAN-safe and cross-platform:
- Parallel candidate evaluation uses
futurewithmulticoreon Unix outside RStudio andmultisessionotherwise. - BLAS/OpenMP threads are capped to one per worker during parallel execution to avoid CPU oversubscription.
- Sequential execution remains the default when
num_cores = 1.
- Parallel candidate evaluation uses
- Improved documentation clarity around parallel execution, verbosity, and model fit history storage.
- Replaced all uses of shorthand
