stop_backend: Stop a Backend

In parabar: Progress Bar for Parallel Tasks

Stop a Backend

Description

This function can be used to stop a backend created by start_backend().

Usage

stop_backend(backend)

Arguments

backend

An object of class Backend as returned by the start_backend() function.

Details

This function is a convenience wrapper around the lower-lever API of parabar aimed at developers. More specifically, this function calls the stop method on the provided backend instance.

Value

The function returns void. It throws an error if:

• the value provided for the backend argument is not an instance of class Backend.

• the backend object provided is already stopped (i.e., is not active).

See Also

start_backend(), peek(), export(), evaluate(), clear(), configure_bar(), par_sapply(), par_apply(), par_lapply(), and BackendService.

Examples

# Create an asynchronous backend.
backend <- start_backend(cores = 2, cluster_type = "psock", backend_type = "async")

# Check that the backend is active.
backend$active

# Check if there is anything on the backend.
peek(backend)

# Create a dummy variable.
name <- "parabar"

# Export the `name` variable in the current environment to the backend.
export(backend, "name", environment())

# Remove the dummy variable from the current environment.
rm(name)

# Check the backend to see that the variable has been exported.
peek(backend)

# Run an expression on the backend.
# Note that the symbols in the expression are resolved on the backend.
evaluate(backend, {
    # Print the name.
    print(paste0("Hello, ", name, "!"))
})

# Clear the backend.
clear(backend)

# Check that there is nothing on the backend.
peek(backend)

# Use a basic progress bar (i.e., see `parabar::Bar`).
configure_bar(type = "basic", style = 3)

# Run a task in parallel (i.e., approx. 1.25 seconds).
output <- par_sapply(backend, x = 1:10, fun = function(x) {
    # Sleep a bit.
    Sys.sleep(0.25)

    # Compute and return.
    return(x + 1)
})

# Print the output.
print(output)

# Stop the backend.
stop_backend(backend)

# Check that the backend is not active.
backend$active

parabar documentation built on April 3, 2025, 6:01 p.m.