simulate_single_concept {care4cmodel}

Run a Simulation for a Single Silvicultural Concept

Description

Top level function for running a simulation and obtaining all fundamental results, i.e. the simulated area dynamics and all growth and yield related outcomes.

Usage

simulate_single_concept(
  concept_def,
  init_areas,
  time_span,
  risk_level = 1,
  detailed_init = FALSE,
  detailed_out = FALSE,
  ...
)

Arguments

concept_def

Silvicultural Concept definition to be used in the simulation; a c4c_concept object

init_areas

The initial areas for each stand development phase defined in concept_def (if detailed_init == FALSE, default) or the initial areas for each stand development subphase as defined in concept_def (if detailed_init == FALSE)

time_span

Time span to be covered by the simulation

risk_level

Risk level relative to the standard risk level as defined in concept_def. The default is 1 which means, the standard risk level will be applied. If risk_level == 0, no damaging events will happen; e.g. risk_level == 2 will increase damage probabilities as if the standard level risk events would occur two times.

detailed_init

Logical; is init_areas provided for each stand development phase (default, FALSE), or for each subphase (TRUE)?

detailed_out

Logical; should the output also include growth and yield pre-evaluation results (which are a very detailed interim evaluation output that is usally only required for internal efficiency)? The default is FALSE.

...

Additional arguments to sim_area_single_concept_with_risk

Details

The output of this function is an object of class c4c_base_result. There is no other way to generate such an object, therefore there is neither a constructor nor a validator available to the user.

Value

An object of class c4c_base_result which is actually a named list containing all information that was used to define and set up a simulation, as well as all fundamental simulation results, i.e. the simulated area dynamics, and all growth and yield related results.

Examples

  simulate_single_concept(
    pine_thinning_from_above_1,
    init_areas = c(1000, 0, 0, 0, 0, 0),
    time_span  = 200,
    risk_level = 3
  )