gdalcubes (version 0.2.5)

gdalcubes_options: Set or read global options of the gdalcubes package

Description

Set global package options to change the default behavior of gdalcubes. These include how many threads are used to process data cubes, how created netCDF files are compressed, and whether or not debug messages should be printed.

Usage

gdalcubes_options(
  ...,
  threads,
  ncdf_compression_level,
  debug,
  cache,
  ncdf_write_bounds
)

Arguments

...

not used

threads

number of threads used to process data cubes

ncdf_compression_level

integer; compression level for created netCDF files, 0=no compression, 1=fast compression, 9=small compression

debug

logical; print debug messages

cache

logical; TRUE if temporary data cubes should be cached to support fast reprocessing of the same cubes

ncdf_write_bounds

logical; write dimension bounds as additional variables in netCDF files

Details

Data cubes can be processed in parallel where one thread processes one chunk at a time. Setting more threads than the number of chunks of a cube thus has no effect and will not further reduce computation times.

Caching has no effect on disk or memory consumption, it simply tries to reuse existing temporary files where possible. For example, changing only parameters to plot will not require rerunning the full data cube operation chain.

Passing no arguments will return the current options as a list.

Examples

# NOT RUN {
gdalcubes_options(threads=4) # set the number of threads
gdalcubes_options() # print current options
# }