Skip to contents

Patch a dynamic-fire.txt in place with candidate calibration parameters

patch_fire_config.Rd

Surgical text replacements:

  • SeverityCalibrationFactor <x> (single scalar line).

  • FireSizesTable data rows: columns 8 (SpHiProp), 11 (SumHiProp), 14 (FallHiProp) replaced. Shared across all ecoregion rows – per-ecoregion HiProp calibration would require 6 params not 3.

  • FireSizesTable column 16 (NumFires): replaced by NumFires, or multiplied by NumFiresMultiplier. The two are alternatives – the first gives every ecoregion the same rate, the second preserves the rates' relative structure – and supplying both is an error.

  • FuelTypeTable data rows: column 4 (IgnProb) is multiplied by the base-type-specific candidate (e.g., IgnProb_Conifer for Base == "Conifer"). Default IgnProbs are mostly 1.0 (D1 = 0.5), so candidate range [0, 1.5] directly scales the relative-weighting.

  • FireDamageTable cohort-age column multiplied by DamageAgeMultiplier, rounded to whole percentages and forced strictly increasing. The paired severity-minus-tolerance column must be an integer, so it is left alone: shifting it offers only a few reachable outcomes and cannot be fitted, whereas the age column is a percentage of longevity and scales smoothly.

Usage

patch_fire_config(scenario_dir, par_vec)

Arguments

scenario_dir

Character. Directory containing dynamic-fire.txt.

par_vec

Numeric. Named vector keyed by calibration_par_names().

Value

Character scalar: absolute path to the patched dynamic-fire.txt.

Details

The file is patched in place; callers are expected to pass a per-trial copy of the template so trials don't collide.

See also

Other Dynamic Fire calibration helpers: apply_calibrated_damage_age(), apply_calibrated_hi_prop(), apply_calibrated_ignprob(), apply_calibrated_num_fires(), 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(), run_calibration_spinup(), run_calibration_validation(), save_observed_fire_targets(), sim_landis(), sim_mock(), sim_r_reimpl()