Learn R Programming

care4cmodel

The goal of care4cmodel is to support comparisons of different silcultural concepts on the forest estate level with a focus on the CO2 uptake by wood growth and CO2 emissions by forest operations. For achieving this, a virtual forest estate area is split into the areas covered by typical phases of the silvicultural concept of interest. Given initial area shares of these phases, the dynamics of these areas is simulated. The typical carbon stocks and flows which are known for all phases are attributed post-hoc to the areas and upscaled to the estate level. CO2 emissions by forest operations are estimated based on the amounts and dimensions of the harvested timber. Probabilities of damage events are taken into account.

Installation

In order to work with care4cmodel you require an installation of R (version >= 4.2.0) on your system. The installation files for R itself are available here. The released version of care4cmodel can be installed from CRAN with:

install.packages("care4cmodel")

Example

The following code demonstrates a basic example of how to use care4cmodel:

library(care4cmodel)

# Run a simulation and store its base results in a variable sim_base_out
# call ?simulate_single_concept for details
sim_base_out <- simulate_single_concept(
    concept_def = pine_thinning_from_above_1, # use pre-defined concept
    init_areas  = c(800, 0, 0, 0, 0, 200),
    time_span   = 200,
    risk_level  = 3
)

# Evaluate the base results for carbon related information
# call ?fuel_and_co2_evaluation for details
carbon_out <- fuel_and_co2_evaluation(sim_base_out, road_density_m_ha = 35)
#> Joining with `by = join_by(phase_no, phase_name)`
#> Joining with `by = join_by(time, harvest_type, phase_no, phase_name)`
#> Joining with `by = join_by(time)`

# Plot results (check the documentation with ?plot.c4c_base_result, and
# ?plot.c4c_co2_result for all available options)
plot(sim_base_out) # Default plot: phase area development
plot(sim_base_out, variable = "vol_standing") # Plot standing volume
plot(carbon_out) # Default plot: CO2 emissions by emission type 

More Information

For more information and details we suggest to call the package’s vignette with:

vignette("getting-started-with-care4cmodel")

A detailed scientific article about the package has been published 2024 by the authors in Computers and Electronics in Agriculture. It is available online here.

Copy Link

Version

Install

install.packages('care4cmodel')

Monthly Downloads

174

Version

1.0.3

License

GPL (>= 3)

Maintainer

Peter Biber

Last Published

November 22nd, 2024

Functions in care4cmodel (1.0.3)

fuel_cons_harvester_2

Fuel Consumption of a Harvester per Cubic Meter Harvested Wood (Version #2)
is_c4c_base_result

Check if an Object is of Class c4c_base_result
setup_risk_events

setup_risk_events
setup_parms

Parameter Setup
validate_c4c_concept

Validator for a c4c_concept Object
wood_to_co2

Convert Wood Volume to CO2 Equivalents
pine_thinning_from_above_1

pine_thinning_from_above_1
fuel_cons_road_maintenance

Annual Fuel Consumption for Truck Road Network Maintenance
sim_area_single_concept_with_risk

sim_area_single_concept_with_risk
setup_statevars

State Variable Setup and Initialization Given a c4c_concept concept definition, and a matching vector of initial areas the state variables required for simulating the concept are set up and initialized.
is_c4c_co2_result

Check if an Object is of Class c4c_co2_result
survival_weibull

Weibull-Based Estimates of Stand Survival
simulate_single_concept

Run a Simulation for a Single Silvicultural Concept
co2_eval_moving

Fuel Consumption and CO2 Emissions for Moving Wood From the Felling Spot to the Forest Road
exp_decay_rate

Calculate an Exponential Decay Rate From Two Appropriate Pairs of Values
aggregate_raw_sim_rslt

Comprehensively Aggregate Raw Simulation Results
avg_extraction_distance

Estimate Average Wood Extraction Distance From Forest Road Density
c4c_concept

User-Friendly Construction of a c4c_concept Object
co2_eval_cutting

Fuel Consumption and CO2 Emissions for Cutting
fuel_cons_forwarder_1

Fuel Consumption of a Forwarder per Cubic Meter Harvested Wood (Version #1)
fuel_and_co2_evaluation

Overarching Evaluation of Fuel Consumption and CO2 Emissions
fuel_cons_forwarder_2

Fuel Consumption of a Forwarder per Cubic Meter Harvested Wood (Version #2)
fuel_cons_harvester_1

Fuel Consumption of a Harvester per Cubic Meter Harvested Wood (Version #1)
is_c4c_concept

Check if an Object is of Class c4c_concept
new_c4c_co2_result

Constructor for the Class c4c_co2_result
fuel_to_co2

Convert Fuel Consumption into CO2 Emission
new_c4c_concept

Constructor for a c4c_concept Object
plot.c4c_base_result

Plot Function for c4c_base_result Objects
new_c4c_base_result

Constructor for the Class c4c_base_result
growth_and_yield_evaluation

Extensive Growth and Yield Evaluation
plot.c4c_co2_result

Plot Function for c4c_co2_result Objects
pine_no_thinning_and_clearcut_1

pine_no_thinning_and_clearcut_1