Execute a Plan on the anvl backend (single process).

Runs every stage of a plan_lazy() plan in the current R session. collect() is the normal user entry point; call this directly only when executing a plan by hand.

Usage

execute_plan(plan, path = NULL, nodata = NULL, band_names = NULL, wspec = NULL)

Arguments

plan

A Plan.

path

Optional GTiff destination: the sink raster is written chunk by chunk instead of returned in memory.

nodata

Optional sentinel recorded in the output and used to demote NaN on write (required for integer outputs containing NaN).

band_names

Optional character vector of band descriptions written to the output bands (multiband GTiff).

wspec

Optional sink write spec from write_tif(): a list of dtype (output dtype override), scale/offset (quantization affine applied per chunk at the sink boundary) and options (creation options).

Value

The sink stage's value (matrix for raster sinks, scalar for global reductions), or path invisibly when writing. When options(garry.exec_stats = TRUE), in-memory results carry a garry_exec_stats attribute recording the distinct input shapes submitted per stage.

See also

collect(), execute_plan_mirai(), plan_lazy()