compute_and_verify_rep_scores_wrt: Compute representation scores for candidate solution

In langfob/bdpg: Package For Building and Testing Biodiversity Problem Generators

Compute representation scores for candidate solution

Description

Scores are computed with respect to a reference spp occupancy matrix (i.e., COR or APP)

Usage

compute_and_verify_rep_scores_wrt(
  ref_spp_occ_matrix,
  cand_sol_PU_IDs,
  spp_rep_targets,
  num_spp
)

Arguments

ref_spp_occ_matrix	reference species occupancy matrix, e.g., correct or apparent species occupancy matrix
cand_sol_PU_IDs	vector of only the planning unit IDs that are included in the candidate solution
spp_rep_targets	numeric vector with a target abundance for each species in the problem
num_spp	integer number of species in the problem

Details

The species occupancy matrix is referred to as the "ref_spp_occ_matrix" to indicate that we're computing scores with respect to a given reference, i.e., either correct or apparent, rather than always computing the correct score.

This is to allow us to see the difference between how well a method is actually doing and how it might appear to be doing when its performance is measured against data of unknown correctness, which is how nearly all results are presented in the literature.

Value

list of solution vector scores

langfob/bdpg documentation built on Dec. 8, 2022, 5:33 a.m.