2025.03

[2025.03] - 2025-06-24

Change

• updated aliases for functions missed in the libfms update (#158)

Fixed

• FULL: fixed small changes to ensure that valid surface temperature and moisture data are used for the coupled SHiELD (#153)

Tag Commit Hashes

• 2025.03-beta1 57c2538
• 2025.03-alpha1 ca85e56

2025.02

[2025.02] - 2025-04-28

Added

• FULL: Added calls to the added generic_exchange(gex) module which was added to FMS for this release. These modifications handle dry deposition on the land side, fix errors in ocean flux diagnositics with vmr tracers for ESM4p5, and pass fluxes between the land and atmosphehere. (#151)

Fixed

• SIMPLE: Added initialization call for generic_exchange module (#155)
• FULL: Add allocations to fix crashes in models that use _USE_LEGACY_LAND_ (#156)

Tag Commit Hashes

• 2025.02-beta2 88994b1
• 2025.02-beta1 57c2538
• 2025.02-alpha1 16ec1e4

2025.01

[2025.01] - 2025-01-30

Added

• FULL: Added ocean temperature and rough heat variables to land_ice_atmos_boundary to be used and populated on the exchange grid from ocean variables in sfc_boundary_layer, before running the atmos physics for shield coupling. (#143)

Tag Commit Hashes

• 2025.01-beta1 008399d
• 2025.01-alpha1 008399d

2024.03.01

[2024.03.01] - 2024-09-06

Fixed

• FULL: Adds conditionals to bypass coupler_generate_sfc_xgrid, flux_exchange_init, and flux exchange related stock routines. (#142)

Tag Commit Hashes

• 2024.03.01 e357d8f

2024.03

[2024.03] - 2024-08-22

Fixed

• FULL: Removes unused FREDB related code that was causing errors with SPEAR (#137)
• SHIELD: Fixed compile error from missing & in SHiELD coupler_main (#140)
• FULL: Fixes crashes when the do_flux namelist flag is false by adding conditionals for calls to coupler_flux_down_from_atmos, coupler_flux_up_to_atmos and coupler_flux_atmos_to_ocean (#134)
• SHIELD: Fixed a bug where data_override was not working correctly due to missing an argument during initialization. (#131)

Tag Commit Hashes

• 2024.03-beta1 8dc6eff

2024.02

[2024.02] - 2024-07-11

Known Issues

• SPEAR errors have been reported due to a string length being exceeded during the fredb section of the code in the full coupler before initialization. (#136)

Added

• SIMPLE: Adds option to obtain concurrent drag and heat transfer coefficents via monin_obukhov functions. To control the new option, new namelist options have been added to the surface_flux_nml. The rough_scheme_ocean in ocean_rough_nml must be set to hwrf17 for the options to be effective. (#113)
  • do_iter_monin_obukhov controls whether to iterate over ocean with updated roughness length
  • niter_monin_obukhov controls the number of times to iterate
  • use_u10_neutral if true uses 10m neutral wind rather than the standard 10m wind to obtain rough_mom, rough_heat, and rough_moist

Changed

• FULL: A number of changes have been made as part of a refactorization effort for the full coupler.
  • A module full_coupler_mod has been added and contains routines and imports previously included in the coupler_main.F90 file. (#104)
  • A new type, coupler_clock type, has been added to handle the usage of any clocks used in the full coupler. This will cause changes in the output order of clock statistics (#106)
  • Updates the written version number to use the version in file_version.h (#109)
  • Refactors atmos_ice_land_chksum and ocean_chksum calls into new routines in full_coupler_mod (#114)
  • Refactors flux_ocean_to_ice and flux_ice_to_ocean calls into new routines in full_coupler_mod (#117)
  • Refactors exchange updates for ice as well as setting ice surface fields and unpacking ocean ice boundary into new routines (#118)
  • Refactors ice surface exchange grid generation into a new routine (#119)
  • Adds a coupler_chksum_type used to compute checksums when do_chksum is true and adds wrapper routines for atmos_tracer_driver_gather_data and sfc_boundary_layer (#123)
  • Refactors update_atmos_model_dynamics, update_atmos_model_radiation, update_atmos_model_down, and flux_down_from_atmos into new routines (#124)
  • Refactors update_land_model_fast, update_ice_model_fast, update_atmos_model_up, flux_up_to_atmos, and update_atmos_model_state into new routines (#125)
  • Refactors unpack_land_ice_boundary, update_ice_model_slow_and_stocks, and update_ocean_model into new routines (#127)
  • Refactors routines for writing intermediate restarts and summarizing timesteps (#128)
• SHIELD: data_override has been enabled for nest domains (#102)

Removed

• FULL: Two variables that enabled bugged behaviour from past releases have been removed, ex_u_star_smooth_bug and sw1way_bug. (#99)

Tag Commit Hashes

• 2024.02-alpha1 eda97dd
• 2024.02-alpha2 2b59f6d
• 2024.02-beta1 2a51893
• 2024.02-beta2 0b2c914

2023.04.01

[2023.04.01] - 2024-06-20

Fixed

• SIMPLE COUPLER: Fixed issue where the anom_sst value used was not the correct value read in from the namelist. (#122)

Tag Commit Hashes

• 2023.04.01 6b4f8b5

2024.01

[2024.01] - 2024-05-03

Note: The 2024.01.01 and 2024.01.02 tags also point to this release, since the FMS patch releases should be used alongside this version of FMScoupler.

Added

• Adds option to run SHiELD with a gregorian calender (#105)
• Adds a diag_send_complete call for FMS diag_manager rewrite(#101)
• Adds documentation for the exchange grid (#98)

Tag Commit Hashes

• 2024.01-alpha1 6442d38
• 2024.01-alpha2 6442d38
• 2024.01-alpha3 f4782c2
• 2024.01-beta1 f4782c2
• 2024.01-beta2 f4782c2
• 2024.01-beta3 d15c35a
• 2024.01-alpha4 d15c35a
• 2024.01-alpha5 d15c35a
• 2024.01-alpha6 4dc9b0f
• 2024.01-beta4 4dc9b0f
• 2024.01-beta5 4dc9b0f

2023.04

[2023.04] - 2023-12-04

Added

• Adds additional output arguments thv_atm amd thv_surf to the surface_flux interface, as well as calls to xgrid and send data in order to use a new atmosphere boundary layer scheme.

Changed

• Routines using the data argument name explicictly have been updated to match corresponding FMS updates

Tag Commit Hashes

2023.04-beta1 93ce364

2023.03

No code changes were made to the coupler this release cycle, just tagging current main to be used alongside the corresponding FMS release.