This function installs the latest numpy, earthengine-api, and geedim modules. The default uses pip for package installation. You can configure custom environments with pip=FALSE and additional arguments that are passed to reticulate::py_install().

gd_install(pip = TRUE, system = FALSE, force = FALSE, ...)



Use pip package manager? Default: TRUE. To use a virtual or conda environment specify method="virtualenv" or method="conda", respectively. See details.


Use a system() call to python -m pip install --user ... instead of reticulate::py_install(). Default: FALSE.


Force update (uninstall/reinstall) and ignore existing installed packages? Default: FALSE. Applies to pip=TRUE.


Additional arguments passed to reticulate::py_install()


NULL, or try-error (invisibly) on R code execution error.


This function provides a basic wrapper around reticulate::py_install(), except it defaults to using the Python package manager pip. If you specify method="virtualenv" or method="conda then the default envname is "r-reticulate" unless you set it to something else. If an environment of that name does not exist it is created.


if (FALSE) {

# install with pip (with reticulate)

# use virtual environment with default name "r-reticulate"
gd_install(method = "virtualenv")

# use "conda" environment named "foo"
gd_install(method = "conda", envname = "foo")

# install with pip (system() call)
gd_install(system = TRUE)