explore_calibration_hist: Explore variable distribution for occurrence and background...

In kuenm2: Detailed Development of Ecological Niche Models

Explore variable distribution for occurrence and background points

Description

This function prepares data to generate overlaid histograms to visualize the distribution of predictor variables for occurrence (presence) and background points.

Usage

explore_calibration_hist(data, include_m = FALSE, raster_variables = NULL,
                         magnify_occurrences = 2, breaks = 15)

Arguments

data	an object of class prepared_data returned by the prepare_data() function.
include_m	(logical) whether to include data for plotting the histogram of the entire area from which background points were sampled. Default is FALSE, meaning only background and presence information will be plotted.
raster_variables	(SpatRaster) predictor variables used to prepared the data with prepared_data. Only applicable if include_m is TRUE.
magnify_occurrences	(numeric) factor by which the frequency of occurrences is magnified for better visualization. Default is 2, meaning occurrence frequencies in the plot will be doubled.
breaks	(numeric) a single number giving the desired number of intervals in the histogram.

Value

A list of with information to plot informative histograms to explore data to be used in the modeling process. Histogram plots can be plotted with the function plot_calibration_hist().

See Also

plot_calibration_hist()

Examples

# Import raster layers
var <- terra::rast(system.file("extdata", "Current_variables.tif",
                               package = "kuenm2"))

# Import occurrences
data(sp_swd, package = "kuenm2")

# Explore calibration data
calib_hist <- explore_calibration_hist(data = sp_swd,
                                       raster_variables = var,
                                       include_m = TRUE)

# To visualize results use the function plot_calibration_hist()

kuenm2 documentation built on April 21, 2026, 1:07 a.m.