Write Response Curve PNGs for All Variables

Generates response curve plots for each environmental variable and saves them as PNG files, replicating density/ResponsePlot.java::makeplot(). A full-size PNG and an optional thumbnail are written for every variable.

Usage

maxent_plot_response_curves(
  model,
  env_grids,
  feature_names,
  output_dir,
  species,
  var_indices = NULL,
  n_steps = 100L,
  thumbnail = TRUE,
  write_dat = FALSE
)

Arguments

model

External pointer to a trained FeaturedSpace object.

env_grids

List of external pointers to Grid<float> objects.

feature_names

Character vector of environment variable names (one entry per element of env_grids).

output_dir

Character: directory under which a plots/ sub-directory will be created.

species

Character: species name (used in file names).

var_indices

Integer vector of 0-based variable indices to plot. Defaults to all variables.

n_steps

Integer: number of steps in each curve (default 100).

thumbnail

Logical: also write a 210 x 140 pixel thumbnail PNG (default TRUE).

write_dat

Logical: also write a tab-delimited .dat file of the curve data (default FALSE).

Value

Invisibly returns a named list of file paths written.

Examples

# \donttest{
set.seed(42)
n <- 50L; idx <- c(5L, 15L, 25L, 35L, 45L)
env <- list(bio1 = runif(n), bio12 = runif(n))
feats <- maxent_generate_features(env, types = "linear")
model <- maxent_featured_space(n, idx, feats)
maxent_fit(model, max_iter = 100)
#> $loss
#> [1] 3.781356
#> 
#> $entropy
#> [1] 3.887762
#> 
#> $iterations
#> [1] 100
#> 
#> $converged
#> [1] FALSE
#> 
#> $lambdas
#> [1] 0.6202339 0.4108689
#> 
g1 <- maxent_grid_from_matrix(matrix(env$bio1, 5, 10),
        -120, 35, 1, name = "bio1")
g2 <- maxent_grid_from_matrix(matrix(env$bio12, 5, 10),
        -120, 35, 1, name = "bio12")
maxent_plot_response_curves(
  model, list(g1, g2), c("bio1", "bio12"),
  output_dir = tempdir(), species = "Sp1")
# }