priorCON (version 0.1.7)

basic_scenario: Basic scenario problem

Description

Solve an ordinary prioritizr prioritization problem.

Usage

basic_scenario(cost_raster, features_rasters, budget_perc, locked_in = NULL,
locked_out = NULL)

Value

A list containing input for get_outputs.

Arguments

cost_raster

SpatRaster object used as cost for prioritization. Its coordinates must correspond to the input given at preprocess_graphs.

features_rasters

features SpatRaster object used for prioritization. Its coordinates must correspond to the input given at preprocess_graphs.

budget_perc

numeric value \([0,1]\). It represents the budget percentage of the cost to be used for prioritization.

locked_in

SpatRaster object used as locked in constraints, where these planning units are selected in the solution, e.g. current protected areas. For details, see
prioritizr::add_locked_in_constraints.

locked_out

SpatRaster object used as locked out constraints, where these planning units are excluded from the solution, e.g. not appropriate for protected areas. For details, see prioritizr::add_locked_out_constraints.

Details

A basic prioritization problem is created and solved using prioritizr package. The solver used for solving the problems is the best available on the computer, following the solver hierarchy of prioritizr. By default, the highs package using the HiGHS solver is downloaded during package installation.

Features and connectivity rasters are min-max scaled before solving the prioritization problem.

References

Hanson, Jeffrey O, Richard Schuster, Nina Morrell, Matthew Strimas-Mackey, Brandon P M Edwards, Matthew E Watts, Peter Arcese, Joseph Bennett, and Hugh P Possingham. 2025. prioritizr: Systematic Conservation Prioritization in R. https://CRAN.R-project.org/package=prioritizr.

Hanson JO, Schuster R, Strimas‐Mackey M, Morrell N, Edwards BPM, Arcese P, Bennett JR, and Possingham HP. 2025, Systematic conservation prioritization with the prioritizr R package. Conservation Biology, 39: e14376. tools:::Rd_expr_doi("10.1111/cobi.14376")

Huangfu, Qi, and JA Julian Hall. 2018. Parallelizing the Dual Revised Simplex Method. Mathematical Programming Computation 10 (1): 119–42. tools:::Rd_expr_doi("10.1007/s12532-017-0130-5")

See Also

preprocess_graphs, get_metrics

Examples

# Read connectivity files from folder and combine them
combined_edge_list <- preprocess_graphs(system.file("external", package="priorCON"),
                                        header = FALSE, sep =";")

# Set seed for reproducibility
set.seed(42)

cost_raster <- get_cost_raster()
features_rasters <- get_features_raster()

# Solve an ordinary prioritizr prioritization problem
basic_solution <- basic_scenario(cost_raster=cost_raster,
features_rasters=features_rasters, budget_perc=0.1)

# Plot solution raster
terra::plot(basic_solution$solution, main="Basic Solution")