Skip to content

Conversation

@samsrabin
Copy link
Contributor

@samsrabin samsrabin commented Oct 8, 2025

Description:

This PR will remain a draft/WIP until scientific testing has been performed.

This PR builds upon #1432, which added diagnostic tracking of how much forest was in each "bin" of distance from nonforest "edge." (Note that unless and until that PR is merged, the diffs on this PR will include the diffs from that one as well.) Here, I add the option to enhance flammability based on edge bin, so that near-edge forest can have higher temperature, lower relative humidity, and higher wind speed. (Note that these ONLY apply for flammability calculations.) This can be done by both additive and multiplicative factors.

The way this is manifested in the model is by having each patch get its own fire weather, rather than each site. Forest patches can have area in multiple bins, so their actual fire weather will be an area-weighted average of each bin's fire weather.

The default parameter file contains all the new required parameters, but with no flammability enhancement. fates_params_edgeflam.cdl sets it so that all but "deep forest" (farthest from edge) will get +2°C, –30 p.p. RH, and +11% wind speed, based on data and literature review by @menglinmet.

Collaborators:

@menglinmet, @ckoven, @mpaiao

Expectation of Answer Changes:

Only if using flammability enhancement parameters (additive factors ≠ 0 and/or multiplicative factors ≠ 1) with hlm_use_edge_forest true.

Checklist

All checklist items must be checked to enable merging this pull request:

Contributor

  • The in-code documentation has been updated with descriptive comments
  • The documentation has been assessed to determine if updates are necessary

Integrator

  • FATES PASS/FAIL regression tests were run
  • Evaluation of test results for answer changes was performed and results provided
  • FATES-CLM6 Code Freeze: satellite phenology regression tests are b4b

If satellite phenology regressions are not b4b, please hold merge and notify the FATES development team.

Documentation

Test Results:

CTSM (or) E3SM (specify which) test hash-tag:

CTSM (or) E3SM (specify which) baseline hash-tag:

FATES baseline hash-tag:

Test Output:

samsrabin and others added 30 commits October 16, 2024 11:58
Add FatesEcotypesMod with is_patch_forest() function.

Updates new Patch logical is_forest based on tree fraction, immediately after total_tree_area is updated.

Set up for adding IS_FOREST outputs based on grass biomass.

(cherry picked from commit 7ee78b4dc44d31eecbd9e98cde264392131bf93d)
Add parameter file fates_params_shuman24.cdl.

As fates_params_default.cdl, but with only:
- broadleaf_evergreen_tropical_tree
- broadleaf_hydrodecid_tropical_tree
- c4_grass

Change shuman24 PFT names and some values.

More changes based on Shuman et al. (2024) Table 2.

Add params from fates_params_sci.1.45.0_api.15.0.0.cdl, for ref.

Add Jackie's parameter file, for reference.

Add fates_params_shuman24.20240819.cdl (just extracted PFTs).

Apply Jackie's parameter file changes.

To fates_params_shuman24.20240819.cdl. Minimal changes that match her CHANGES, not her VALUES.

(cherry picked from commit 6151cd9bd255e8c82ea572bde39d6742b9ae09c7)
- FATES_AREA_PLANTS_AP
- FATES_AREA_TREES_AP
- FATES_IS_FOREST
- FATES_IS_FOREST_AP
- FATES_IS_FOREST_PCT10
- FATES_IS_FOREST_PCT10_0GRASS
- FATES_IS_FOREST_PCT25
- FATES_IS_FOREST_PCT25_0GRASS
- FATES_IS_FOREST_PCT50
- FATES_IS_FOREST_PCT50_0GRASS
- FATES_IS_FOREST_PCT75
- FATES_IS_FOREST_PCT75_0GRASS
- FATES_IS_FOREST_PCT90
- FATES_IS_FOREST_PCT90_0GRASS
Uses new dimension, site x fates_levedgebin.
Global 4x5 test of this change (on a different branch): Results in absolute differences in bin area of < 0.0001 m2 in any given gridcell. Total sum of abs. differences < 0.22 m2.
It's actually now defined in EDParamsMod so it can be read from the parameter file. This instance was left over from the move to the parameter file.
This should be impossible because they all use the same netCDF dimension.
New sapwood, agb and leaf allometries for Grasses, by Xiulin Gao.
Patch level memory structures were refactor to be dynamic, paving the way for higher nclmax.

# Conflicts:
#	biogeochem/FatesPatchMod.F90
Fire-weather refactor (non-bfb)

This moves the effective wind speed and associated methods into the
site-level fire weather class.

When merging into edge-area-202410: Had added "currentPatch%is_forest = is_patch_forest()" and "call calculate_edge_area()" to subroutine wind_effect. These are now in subroutine CalculateTreeGrassAreaSite.
Changes the patch insertion method

This update changes the patch ordering method to account for landuse and
no comp pft label as well as patch age.
This was an attempt to resolve unexpected matching fireWeather in deep forest and other forest when edge flammability enhancement was requested. Didn't work.
This was another failed attempt to resolve unexpected matching fireWeather in deep forest and other forest when edge flammability enhancement was requested.
@samsrabin samsrabin self-assigned this Oct 8, 2025
@samsrabin samsrabin added type: enhancement science: fire parameters: new Pertaining to adding new parameters to the parameter file labels Oct 8, 2025
@samsrabin samsrabin changed the title Edge forest flammability enhancements [WIP] Edge forest flammability enhancements Oct 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

parameters: new Pertaining to adding new parameters to the parameter file science: fire type: enhancement

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

2 participants