Skip to contents

Apply a calibrated ignition rate to a FireSizesTable

apply_calibrated_num_fires.Rd

NumFires is the Poisson mean number of IGNITIONS per year for the ecoregion, each of which becomes a fire only if the initiation probability of the fuel on its cell says so, so it is not the same quantity as an observed count of fires.

Usage

apply_calibrated_num_fires(fire_size_table, calibrated_fire_params)

Arguments

fire_size_table

data.frame with a NumFires column, as a project's make_fire_size_table()-equivalent produces.

calibrated_fire_params

Named numeric vector. Used only if it holds NumFires or NumFiresMultiplier.

Value

A copy of fire_size_table, with NumFires replaced or scaled where calibrated.

Details

Two calibrated forms, and they are alternatives:

  • NumFires replaces the rate in every row with one value. Right where the rate is a property of the landscape as a whole.

  • NumFiresMultiplier scales each row's own rate by a common factor, so ecoregions that differ in ignition rate keep their relative structure. Right where the rate is measured per ecoregion and the correction being fitted – the gap between a count of observed fires and a count of ignitions – applies to all of them alike.

Supplying both is an error rather than a composition, and a vector carrying neither leaves the table alone.

See also

Other Dynamic Fire calibration helpers: apply_calibrated_damage_age(), apply_calibrated_hi_prop(), apply_calibrated_ignprob(), bc_fuel_code_to_base(), build_calibration_scenario_template(), build_calibration_spinup_scenario(), calibrate_dynamic_fire(), calibration_par_names(), dedup_community_snapshot(), default_severity_prior_sturtevant2009(), landis_overstory_mortality_share(), loss_from_stats(), observed_fire_sizes(), parse_dynamic_fire_logs(), patch_fire_config(), run_calibration_spinup(), run_calibration_validation(), save_observed_fire_targets(), sim_landis(), sim_mock(), sim_r_reimpl()

Other Dynamic Fire helpers: DynamicFire, apply_calibrated_damage_age(), apply_calibrated_hi_prop(), apply_calibrated_ignprob(), defaultFuelTypeTable(), insertBuildUpIndex(), insertFireSizesTable(), insertFuelTypeTable(), insertGroundSlopeFile(), insertSeasonTable(), insertUphillSlopeAzimuthMap(), prepDynamicEcoregionTable(), prepDynamicWeatherTable(), prepFireSizesTable(), prepInitialWeatherDatabase(), prepTopographyFile()