RapResults: Create RapResults object

View source: R/RapResults.R

RapResultsR Documentation

Create RapResults object

Description

This function creates a new RapResults() object.

Usage

RapResults(
  summary,
  selections,
  amount.held,
  space.held,
  logging.file,
  .cache = new.env()
)

Arguments

summary

base::data.frame() with summary information on solutions. See details below for more information.

selections

base::matrix() with binary selections. The cell x_{ij} denotes if planning unit j is selected in the i'th solution.

amount.held

base::matrix() with the amount held for each species in each solution.

space.held

base::matrix() with the proportion of attribute space sampled for each species in each solution.

logging.file

character Gurobi log files.

.cache

base::environment() used to cache calculations.

Details

The summary table follows Marxan conventions ( https://marxansolutions.org/). The columns are:

Run_Number

The index of each solution in the object.

Status

The status of the solution. The values in this column correspond to outputs from the Gurobi software package (https://www.gurobi.com/documentation/6.5/refman/optimization_status_codes.html).

Score

The objective function for the solution.

Cost

Total cost associated with a solution.

Planning_Units

Number of planning units selected in a solution.

Connectivity_Total

The total amount of shared boundary length between all planning units. All solutions in the same object should have equal values for this column.

Connectivity_In

The amount of shared boundary length among planning units selected in the solution.

Connectivity_Edge

The amount of exposed boundary length in the solution.

Connectivity_Out

The number of shared boundary length among planning units not selected in the solution.

Connectivity_Fraction

The ratio of shared boundary length in the solution (Connectivity_In) to the total amount of boundary length (Connectivity_Edge). This ratio is an indicator of solution quality. Solutions with a lower ratio will have less planning units and will be more efficient.

Value

RapResults object

Note

slot best is automatically determined based on data in summary.

See Also

RapResults read.RapResults().


raptr documentation built on March 31, 2023, 9:46 p.m.