libproj (version 8.1.0-1)

libproj_version: PROJ configuration

Description

PROJ configuration

Usage

libproj_version()
libproj_has_libtiff()
libproj_has_libcurl()
libproj_default_writable_dir()
libproj_default_data_dir()
with_libproj_configuration(config, expr)
libproj_configuration()
warn_for_configuration()
libproj_configure(
  search_path = c(system.file("proj", package = "libproj"),
    getOption("libproj.search_path", libproj_default_data_dir())),
  db_path = getOption("libproj.db_path", system.file("proj/proj.db", package =
    "libproj")),
  ca_bundle_path = NA,
  network_endpoint = getOption("libproj.network_endpoint", "https://cdn.proj.org"),
  network_enabled = getOption("libproj.network_enabled", FALSE),
  log_level = getOption("libproj.log_level", 1L),
  restore_previous_on_error = TRUE
)

Arguments

config

A named list() with elements used to temporarily override elements of the current libproj_configuration().

expr

An expression to evaluate with the specified state

search_path

A character vector of paths where libproj will look for resource files (e.g., gridshift, database, init files). Defaults to the internal database and init files distributed with the PROJ source.

db_path

Independent of search_path, a character vector of SQLite databases that may contain updated or alternative coordinate operations from the default proj.db included in this package. You must specify at least one database as part of this configuration; do not rely on search_path to find this value for you.

ca_bundle_path

A directory that contains the certificate bundle when network is enabled. Can be NA.

network_endpoint

A mirror of the PROJ CDN of gridshift files. By default, this is set to https://cdn.proj.org.

network_enabled

Whether or not to download gridshift files on the fly. This defaults to FALSE.

log_level

An integer describing the log level: 0 (none), 1 (error), 2 (debug), 3 (trace), or 4 (tell)

restore_previous_on_error

Use FALSE to skip resetting the previous configuration if the configuration fails.

Value

• libproj_version(): A character vector of the proj release.

• libproj_has_libtiff(): TRUE if built against libtiff, FALSE otherwise.

• libproj_has_libcurl(): TRUE if built against curl, FALSE otherwise.

• libproj_default_writable_dir(): A character vector of the path where libproj-specific tempfiles are written.

• libproj_default_data_dir(): A character vector of the path where the default PROJ-data installation is kept.

• libproj_configuration(): A list() of values that can be passed to libproj_configure().

• with_libproj_configuration(): The value of expr.

• libproj_configure(): NULL, invisibly.

Examples

# NOT RUN {
libproj_version()
libproj_configuration()

# }