Add new history output dimension patch age x fuel size class

[glemieux]

This PR adds a new patch age x fuel size class multiplexed output dimension and includes and new history output variable FUEL_AMOUNT_AGEFUEL that utilizes this dimension.

Description:

This request came out of the California LDRD meeting where the desire to be able to track the per fuel class accumulation since a given disturbance. The corresponding CTSM side PR is ESCOMP/CTSM#1220.

A PR to ctsm_py has been created to update to the the fates_xarray_funcs module to include an fates_levagefuel expansion function: NCAR/ctsm_python_gallery#35

Collaborators:

@ckoven @JessicaNeedham @rgknox

Expectation of Answer Changes:

No answer changes expected

Checklist:

• My change requires a change to the documentation.
• I have updated the in-code documentation .AND. (the technical note .OR. the wiki) accordingly.
• I have read the CONTRIBUTING document.
• FATES PASS/FAIL regression tests were run
• If answers were expected to change, evaluation was performed and provided

Test Results:

TBD

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

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

FATES baseline hash-tag:

Test Output:

[glemieux]

A simple jupyter notebook looking at short, 1 year f10 grid case is available here: https://github.com/glemieux/fates-jupyter/blob/master/california/new-dimension-age_by_fuel.ipynb

[ckoven]

@glemieux this looks great. i also ran a case with it and output looks reasonable. thanks for adding the xarray unrolling function in NCAR/ctsm_python_gallery#35 as well!

[rgknox]

looks good @glemieux , couldn't find any issues

[glemieux]

Thanks @rgknox. I'll run the regression tests today.

[glemieux]

Regression tests are all PASS, except for the baseline comparison, which is expected. That said, during baseline comparison it appears that cprnc is crashing during the DIFF due to the new dimension. I'm not sure if this is expected behavior for cprnc; I'll look into it.

[glemieux]

Reran the cprnc tool from the cime fix in PR ESMCI/cime#3663. All expected pass B4B:

/glade/u/home/glemieux/scratch/clmed-tests/basegen.fates-sci.1.43.2_api.14.2.0-fates_main_api_14.0.0-C0392347e-F86e8f11c

Note that the cs.status script pulls from the TestStatus log and as such will not correctly report the manual run cprnc tests.