noresm3_0_022_cam6_4_121: Use CDEPS for CO2 fossil fuel and aircraft emissions

[mvertens]

Summary: Enable fossil fuel and aircraft co2 forcing that are currently on a 2 degree FV grid to be remapped online to the model grid and time interpolated to the model time using CDEPS in-line functionality. The grid mapping is currently hard-wired to be first order conservative.

@adagj @DirkOlivie @tjiputra - the following lists how you can get and use the new code (still in testing)

to get the current branch:

> git clone https://github.com/mvertens/NorESM noresm3_0_beta03b_co2refactor
> cd noresm3_0_beta03b_co2refactor
> git checkout feature/refactor_co2input 
> ./bin/git-fleximod update

compset and resolution

--compset 1850_CAM70%LT%NORESM%CAMoslo_CLM60%FATES_CICE_BLOM%HYB%ECO_MOSART_DGLC%NOEVOLVE_SWAV_SESP_BGC%BPRP
-res ne16pg3_tn14

user_nl_cam

• the key additions are in the namelist group co2flux_fuel_mesh, co2_flux_fuel_year_first, co2_flux_fuel_year_last, co2_flux_fuel_year_align

interpolate_nlat           = 96
interpolate_nlon           = 144
interpolate_output         = .true.
use_aerocom                = .false.
history_aerosol            = .false.
zmconv_c0_lnd              =  0.0075D0
zmconv_c0_ocn              =  0.0300D0
zmconv_ke                  =  5.0E-6
zmconv_ke_lnd              =  1.0E-5
clim_modal_aero_top_press  =  1.D-4
bndtvg                     = '/cluster/shared/noresm/inputdata/atm/cam/ggas/noaamisc.r8.nc'
dust_emis_method           = 'Leung_2023'
dust_emis_fact             = 6.1D0
rafsip_on                  = .true.
micro_mg_dcs               = 700.D-6
clubb_c8                   =  5.3
clubb_l_do_expldiff_rtm_thlm = .true.
!
co2_flag                = .true.
!
co2_readflux_aircraft   = .true.
aircraft_co2_datafile   = '/cluster/shared/noresm/inputdata/atm/cam/ggas/emissions-cmip6_CO2_anthro_ac_ScenarioMIP_IAMC-REMIND-MAGPIE-ssp534_201401-210112_fv_1.9x2.5_c20220809.nc'
aircraft_co2_fldname    = 'ac_CO2'
aircraft_co2_meshfile   = '/cluster/shared/noresm/inputdata/share/meshes/fv1.9x2.5_141008_ESMFmesh_c20191001.nc'
aircraft_co2_year_first = 2014
aircraft_co2_year_last  = 2101
aircraft_co2_year_align = 2014
aircraft_co2_tintaglo = 'linear'
aircraft_co2_taxmode    = 'limit'
!
co2_readflux_fuel       = .true.
!
co2flux_fuel_datafile   = '/cluster/projects/nn9560k/adagj/co2files/emissions-cmip6_CO2_anthro_surface_2xScenarioMIP_IAMC-REMIND-MAGPIE-ssp534_201401-210112_fv_1.9x2.5_c20220809.nc'
co2flux_fuel_meshfile   = '/cluster/shared/noresm/inputdata/share/meshes/fv1.9x2.5_141008_ESMFmesh_c20191001.nc'
co2flux_fuel_year_first = 2014
co2flux_fuel_year_last  = 2101
co2flux_fuel_year_align = 2014
co2flux_fuel_tintalgo = 'linear'
co2flux_fuel_taxmode    = 'limit'

Reviewers: @gold2718

Changes made to build system: None

Changes made to the namelist: The following are new namelist variables:
New namelist co2_ffuel_nl:

- co2flux_fuel_datafile, co2flux_fuel_meshfile, 
- co2flux_fuel_year_first, co2flux_fuel_year_last, co2flux_fuel_year_align
- co2flux_fuel_tintalgo, co2flux_fuel_taxmode

New namelist aircraft_emit_nl:

- aircraft_co2_datafile,  aircraft_co2_meshfile, 
- aircraft_co2_year_first,  aircraft_co2_year_last, aircraft_co2_year_align 
- aircraft_co2_tintalgo, aircraft_co2_taxmode
- aircraft_h2o_datafile, aircraft_h2o_meshfile,
- aircraft_h2o_year_first, aircraft_h2o_year_last, aircraft_h2o_year_align
- aircraft_h2o_tintalgo, aircraft_h2o_taxmode
- aircraft_slant_dist_datafile, aircraft_slant_dist_meshfile,
- aircraft_slant_dist_year_first, aircraft_slant_dist_year_last, aircraft_slant_dist_year_align
- aircraft_slant_dist_tintalgo, aircraft_slant_dist_taxmode

• to understand these definitions in more detail see
  https://escomp.github.io/CDEPS/versions/master/html/index.html
  https://escomp.github.io/CDEPS/versions/master/html/streams.html#data-model-stream-inline-api (this is the functionality used in co2_cycle.F90 and co2_data_flux.F90)

Changes to the defaults for the boundary datasets: None

Substantial timing or memory changes: [ describe or write 'None' ]

Validation:

• The left plot is the model output on day 16 (2 degree forcing mapped to ne16 and then mapped back out to 2 degree history output)
• The right plot is the forcing dataset /cluster/shared/noresm/inputdata/atm/cam/ggas/emissions-cmip6_CO2_anthro_surface_ScenarioMIP_IAMC-REMIND-MAGPIE-ssp534_201401-210112_fv_1.9x2.5_c20220809.nc on January 16

Testing:

• BFB: Tested aux_cam_noresm against NorESM 3.0 beta09 baseline with only namelist changes due to always having the co2_cycle_nl namelist in atm_in.

[tjiputra]

@mvertens, this command doesn't work
./bin/git-fleximod update

[mvertens]

@mvertens, this command doesn't work ./bin/git-fleximod update

@tjiputra - sorry about that - my checkout missed that you need to invoke
> git checkout feature/refactor_co2input
I've updated the documentation.

[adagj]

@mvertens Thank you Mariana! I will run a N1850 compset with 2xSSP534 CO2 flux data to see if we can track down the (potential) CO2 conservation issue in CAM

[gold2718]

I still have most of co2_cycle.F90 and nudging.F90 to review but here are some items I think should be changed.

[gold2718]

I think some or all of this should move into atm_shr.F90

[mvertens]

Done

[mvertens]

@gold2718 - I have removed nudging capability as part of this PR. I have also removed co2_readFlux_ocn from CAM as part of this PR. I think all of the comments above that refer to either of these changes are addressed as part of this removal.

[gold2718]

Thanks for this huge effort. I think we need another round of cleanup and many of my comments relate to restoring tintalgo to the namelist for various emission types.

[gold2718]

Thanks, that was a lot of clean. There are still some items on the original list plus maybe one new item. I know that GitHub is making it hard to see some of the comments so I recommented on several.

[mvertens]

@gold2718 - I think I've addressed all the changes you requested - but it was not always possible for me to respond to the suggestions. I'm happy to address any issues that have not yet been resolved.

[gold2718]

I think this is finally ready to go, yay!

[gold2718]

Tagged as noresm3_0_022_cam6_4_121