Create a Progressor Function that Signals Progress Updates
progressor(
steps = length(along),
along = NULL,
offset = 0L,
scale = 1L,
transform = function(steps) scale * steps + offset,
message = character(0L),
label = NA_character_,
trace = FALSE,
initiate = TRUE,
auto_finish = TRUE,
on_exit = !identical(envir, globalenv()),
enable = getOption("progressr.enable", TRUE),
envir = parent.frame()
)
(integer) Number of progressing steps.
(vector; alternative) Alternative that sets
steps = length(along)
.
(integer; optional) scale and offset applying transform
steps <- scale * steps + offset
.
(function; optional) A function that takes the effective
number of steps
as input and returns another finite and non-negative
number of steps.
(character vector or a function) If a character vector, then
it is pasted together into a single string using an empty separator.
If a function, then the message is constructed by conditionMessage(p)
calling this function with the progression condition p
itself as the
first argument.
(character) A label.
(logical) If TRUE, then the call stack is recorded, otherwise not.
(logical) If TRUE, the progressor will signal a progression 'initiate' condition when created.
(logical) If TRUE, then the progressor will signal a progression 'finish' condition as soon as the last step has been reached.
(logical) If TRUE, then the created progressor will
signal a progression 'finish' condition when the calling frame exits.
This is ignored if the calling frame (envir
) is the global environment.
(logical) If TRUE, progression conditions are signaled when calling the progressor function created by this function. If FALSE, no progression conditions is signaled because the progressor function is an empty function that does nothing.
A function of class progressor
.