knitrProgressBar v1.1.0

0

0th

Percentile

Provides Progress Bars in 'knitr'

Provides a progress bar similar to 'dplyr' that can write progress out to a variety of locations, including stdout(), stderr(), or from file(). Useful when using 'knitr' or 'rmarkdown', and you still want to see progress of calculations in the terminal.

knitrProgressBar

This package supplies a progress bar (shamelessly borrowed from dplyr::progress_estimated) that has options to not have output captured inside a knitr chunk.

Installation

This package is not yet on CRAN. To install this package, use devtools:

devtools::install_github("rmflight/knitrProgressBar")


Problem

You want to use knitr or rmarkdown, but you want to see the progress of a longer running calculation in the chunk. You think that you can just use dplyr::progress_estimated. But if you do, all the output from the progress bar will be suppressed (by design, actually).

Solution

This package has two functions, progress_estimated, that creates a Progress object that has a connection object associated with it, and update_progress, that properly updates the progress object. The output from the progress will be written to that connection. This connection will be either stdout (default within an R session), stderr (default from within knitr), or to a log-file.

Examples

None of these are run in this document!

Setup

library(knitrProgressBar)

# borrowed from example by @hrbrmstr
arduously_long_nchar <- function(input_var, .pb=NULL) {

update_progress(.pb)

Sys.sleep(0.5)

nchar(input_var)

}


Let Function Decide

If you want the object to decide where to put output, do nothing. Just call the progress_estimated() function, which uses make_kpb_output_decisions():

pb <- progress_estimated(length(letters))

purrr::map_int(letters, arduously_long_nchar, .pb = pb)


See the help and the vignette for an explanation of how make_kpb_output_decisions() decides where to display the progress bar output.

Write to Specific Connection

If you want to write the progress out to a specific connection, just pass the connection to the progress_estimated() call:

pb <- progress_estimated(length(letters), progress_location = stdout())

purrr::map_int(letters, arduously_long_nchar, .pb = pb)


This includes specific files. You can then display the file, or use tailf or equivalent to watch the output of the file.

pb <- progress_estimated(length(letters), progress_location = file("progress.log", open = "w"))

purrr::map_int(letters, arduously_long_nchar, .pb = pb)


Connection Considerations

Each connection will display in specific situations, notably stdout() will not display to the terminal when run as part of a document being knitted.

Inspiration

This package (and the examples) was inspired by this post from Bob Rudis! Also, thanks to Hadley Wickham for the great Progress object and methods!

Website

Web accessible documentation is available here.

Bug Reports

Please submit bug reports using the GitHub issue tracker.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Functions in knitrProgressBar

 Name Description make_kpb_output_decisions Progress Output Location watch_progress_mp watch progress from multi process set_progress_mp multi process progress indicator update_progress updating progress bars progress_estimated Progress bar with estimated time. No Results!

Details

 Type Package BugReports https://github.com/rmflight/knitrProgressBar/issues URL https://rmflight.github.io/knitrProgressBar License MIT + file LICENSE Encoding UTF-8 LazyData true VignetteBuilder knitr RoxygenNote 6.0.1 NeedsCompilation no Packaged 2018-02-20 03:32:45 UTC; rmflight Repository CRAN Date/Publication 2018-02-20 04:04:54 UTC
 suggests covr , knitr , mockr , parallel , purrr , rmarkdown , testthat , withr imports R.oo , R6 Contributors Romain Francois, RStudio, Hadley Wickham, Kirill Mller, Lionel Henry