land.dyn.mdl: Mediterranean Landscape Dynamic Model m

View source: R/land.dyn.mdl.r

land.dyn.mdlR Documentation

Mediterranean Landscape Dynamic Model m

Description

Run the Mediterranean Landscape Dynamic Model medLDM that includes the processes of land-cover changes wilfires, prescribed burns, fire suppression, timber and wood harvesting and vegetation dynamics.

Usage

land.dyn.mdl(
  is.land.cover.change = FALSE,
  is.harvest = FALSE,
  is.wildfire = FALSE,
  is.prescribed.burn = FALSE,
  is.drought = TRUE,
  is.postfire = TRUE,
  is.cohort.establish = TRUE,
  is.afforestation = TRUE,
  is.encroachment = TRUE,
  is.growth = TRUE,
  spin.up = TRUE,
  custom.params = NA,
  clim.proj = NA,
  nrun = 1,
  time.step = 1,
  clim.step = 10,
  time.horizon = 90,
  save.land = FALSE,
  out.seq = NA,
  out.path = NA,
  ...
)

Arguments

is.land.cover.change

A flag to indicate that land cover changes are simulated

is.harvest

A flag to indicate that harvesting for sawlogs and wood is simulated

is.wildfire

A flag to indicate that wildfires are simualted

is.prescribed.burn

A flag to indicate that prescribed burns are simulated

is.drought

A flag to indicate that prescribed burns are simulated

is.postfire

A flag to indicate that prescribed burns are simulated

is.cohort.establish

A flag to indicate that prescribed burns are simulated

is.afforestation

A flag to indicate that prescribed burns are simulated

is.encroachment

A flag to indicate that prescribed burns are simulated

is.growth

A flag to indicate that prescribed burns are simulated

spin.up

A flag to indicate if the observed 2010-2019 wildfires and land-cover changes are replicated

custom.params

List with the model paramaters and default and/or user-defined values

clim.proj

A list of data frames with projections of climatic variables (minimum temperature (in ºC), maximum temperature (in ºC), and annual precipitation (in mm)) for each clim.step

nrun

Number of replicates to run the model

time.step

Number of years of each time step

clim.step

Number of years of each climatic period

time.horizon

Number of years of the model simulation, it has to be a multiple time.step

save.land

A flag to save as a RDS file the landscape data frame at the time step indicated in out.seq

out.seq

Numeric vector with the time steps the landscape is saved

out.path

String with the directory path to save the landscape data frame at each time step indicated in out.seq

...

Other parameters of the function

Value

A list with the following 13 items:

  • Land: A data frame of tree species abundance, volume under bark, volume with bark, and carbon stock per age class, and area per non-forest land-cover types, with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • spp: Code of the tree species or land-cover type.

    • age.class: Code of the age class: young, mature, or old.

    • area: Area (in ha).

    • vol: Volume under bark in m^{3} for tree species and biomass in tonnes for shrublands.

    • volbark: Volume with bark in m^{3}.

    • carbon: Carbon content (in Mg).

  • LandSQI: A data frame of area and volumes per tree species and per SQI, with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • spp: Code of the tree species or land-cover type.

    • sqi: Code of SQI: 1 - low, 2 - good, 3 - optimal.

    • area: Area (in ha).

    • vol: Volume under bark in m^{3}.

    • volbark: Volume with bark in m^{3}.

  • Carbon: A data frame of carbon emissions and generation per type of process

    • run: Number of replicate.

    • year: Year YYYY.

    • type: Process involved in the generation or emission of Carbon dioxide.

    • carbon: Carbon dioxide quantity in g.

  • Harvest: A data frame of sawlog and wood volume harvested per species (included if is.harvesting), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • spp: Code of the species.

    • vol.sawlog: Harvested timber volume for sawlog in m^{3}.

    • vol.wood: Harvested timber volume for wood in m^{3}.

  • ForestArea: A data frame of areas for sustainable timber harvesting (included if is.harvesting), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • forest: Area of all tree species.

    • spp.harvestable: Area of harvestable tree species.

    • non.protect: Harvestable area without any protection status.

    • national.park: Harvestable area in a national park.

    • enpe: Harvestable area protected, but not in a national park.

    • no.park: Harvestable area not in a national park.

    • slope30.nopark: Harvestable area not in a national park with slope <= 30 pct.

    • slope30.nopark.distpath1.5: Harvestable area not in a national park with slope <= 30 pct and distance to roads or forest tracks <= 1.5 km.

    • slope30.nopark.distpath2.2: Harvestable area not in a national park with slope <= 30 pct and distance to roads or forest tracks <= 2.2 km.

  • HarvestArea: A data frame of area harvested per sylvicultural prescription and forest type (included if is.harvesting), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • todo: Sylvicultural prescription: prep.cut, removal.cut, seed.cut, or thinning.

    • fytpe: Forest type: conif or decid.

    • area: Area in ha.

  • HarvestVolume: A data frame of potential and total volum extracted per forest type (included if is.harvesting), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • fytpe: Forest type: conif or decid.

    • vol.potential.extract.sawlog: Potential harvesting volume for sawlog in m^{3}.

    • vol.potential.extract.wood: Potential harvesting volume for Wood in m^{3}.

    • vol.extract.sawlog: Harvested volume for sawlog in m^{3}.

    • vol.extract.wood: Harvested volume for wood in m^{3}.

    • pct.sawlog: Percentage of harvested volume for sawlog.

    • pct.wood: Percentage of harvested volume for wood.

  • Fires: A data frame of target, burnt and suppresed area per fire (included if is.wildfire), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • swc: Synoptic weather condition: 1 - wind, 2 - heat, 3 - regular.

    • clim.sever: Climatic severity: 0 - mild, 1 - severe, 2 - extreme.

    • fire.id: Fire event identificator.

    • fst: Fire spreading type: 1 - wind-driven, 2 - convective, 3 - topographic.

    • wind: Main wind direction in degrees.

    • atarget: Target area to be burnt (in ha).

    • aburnt.highintens: Area burnt in high intensity (in ha).

    • aburnt.lowintens: Area brunt in low intensity (in ha).

    • asupp.fuel: Area suppressed in low-fuel conditions (in ha).

    • asupp.sprd: Area suppressed in slow fire spread conditions (in ha).

    • rem: Remanent area, not burnt, neither suppressed (in ha).

  • BurntSpp: A data frame of burnt area and biomass per species or land-cover type (included if is.wildfire), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • fire.id: Fire event identificator.

    • spp: Code of the tree species or land-cover type.

    • aburnt: Area effectively burnt (in ha).

    • bburnt: Basal area effectively burnt (in m^{2}ha^{-1}).

  • PostFire: A data frame of species replacement after fire (included if is.wildfire), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • spp.out: Code of the tree species or land-cover type replaced.

    • spp.in: Code of the tree species or land-cover type after replacement.

    • area: Area (in ha).

  • Drought: A data frame of drought-induced mortality per tree species (included if is.drought), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • spp: Code of the tree species.

    • area: Area (in ha).

  • Cohort: A data frame of species replacement after drought-induced mortality (included if is.cohort.establish), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • spp.out: Code of the tree species replaced.

    • spp.in: Code of the tree species or land-cover type after replacement.

    • area: Area (in ha).

  • Afforest: A data frame of new tree species following shrubland colonization (included if is.afforestation), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • spp: Code of the tree species.

    • area: Area (in ha).

  • Encroach: A data frame of new shrubland area following encroachment (included if is.encroachment), with columns:

    • run: Number of replicate.

    • year: Year YYYY.

    • spp: Code of shrublands.

    • area: Area (in ha).

Examples


## Not run: 
library(medLDM)
# Run one single 90-year replicate with forest management
result = land.dyn.mdl(is.harvest = T)

## End(Not run)


nuaquilue/medLDM documentation built on April 15, 2022, 10:14 a.m.