Quantile methods pre-release: QCEFF Table

Pre-release version of the quantile conserving and probit transform tools, including the new functionality of the QCEFF Table

The documentation for this branch is available online

Please contact [email protected] if you would like to develop scientific collaborations using these new capabilities.

Below is a list of the changes to quantile_methods that are included with this release:

• The QCEFF input table allows for the specification of QCEFF/probit input options, per QTY, at runtime.
• This replaces the functionality of using an algorithm_info_mod specific to the model, which meant editing algorithm_info_mod.f90 to specify which distribution should be used for which quantity.
• The algorithm_info_mod files for the lorenz_96_tracer_advection model examples have been replaced with set QCF tables (all_bnrhf_qcf_table.csv, all_eakf_qcf_table.csv, state_eakf_tracer_bnrhf_qcf_table.csv, neg_qcf_table.csv) and can be found in lorenz_96_tracer_advection/work.
• Removed the ‘global’ version of filter_kind from assim_tools_mod.f90 and the &assim_tools_nml

Hybrid EnKF-OI filter

A hybrid ensemble and optimal interpolation filter, combining flow-dependent ensemble covariances with time-invariant climatological backgrounds. The combination is done linearly and adaptively both in space and time.

For detail see El Gharamti, et al. (2024): Leveraging a Novel Hybrid Ensemble and Optimal Interpolation Approach for Enhanced Streamflow and Flood Prediction.

Note: This release is supported for WRF-Hydro only and is based on DART version v9.11.7

WRF-DART tutorial section on diagnostics

• Added a more complete diagnostics section to the WRF-DART Tutorial.
• Developer test for Mersenne twister random number generator. #499
• Bug-fix: 1D location subsetting fixed for obs_sequence_tool. #547 contributed by Henry Santer

Fluxnet observation converter and obs_def_rttov13_mod.f90 bug-fixes

Fluxnet obs converter (#478):

• Generates a new observation converter (Fluxnetfull_to_obs) for eddy covariance flux tower data (carbon, water energy fluxes)
• Documentation changes made to the older, deprecated ameriflux converter (level4_to_obs) and the broken links have been fixed
• New flux tower observation types added to accomodate the forward operator approach for time aggregated fluxes (daily through monthly)

obs_def_rttov13_mod.f90 bug-fixes:

• Added public get_channel to obs_def_rttov13_mod.f90 to compile WRF successfully with rttov13. #532
• Removed cloud_overlap (integer) from the function: get_rttov_option_logical #537

CAM-FV shell scripts

Performance improvements for CAM-FV shell scripts:

• Avoid listing files if the CAM_PHIS file already exists.
• Avoid using /var/tmp
• RUNDIR defined after CIME_OUTPUT_ROOT change.
• Warn if no inflation files found.

MPAS-ATM constants update and readthedocs fix

• MPAS-ATM model_mod.f90 constants updated to MPAS v5+ #251
  see mpas_atm for how to run with v4 constants.
• readthedocs build info updated. #526

Bug-fixes for MOM6 and WRF

• bug-fixes:

  • MOM6 read_model_time converts to dart time to match observation sequences #494
  • MOM6 salinity units converted to MSU during model_interpolate #509
  • WRF get_dist calculation fixed for observations with VERTISUNDEF #486

• doc-fixes:

  • WOD and GTSPP converter documentation notes about salinity units #509
  • MOM6 documentation for setting the Gregorian calendar in CESM #494
  • comment fix in filter_mod.f90 #508

CAM-DART observation preprocessor

• Tool to remove observations above a given CAM level from an obs sequence file #459
• bug-fixes:
  • MOM6 added check for too deep observations #490
  • test_interpolate_range write format corrected #487
  • removed unused code from mpas_atm directory #496 #498
• doc: removed outdated references to prep_buf.html #452

Smoother removal

• Dead smoother code removed. #479
• Documentation fix for quality control. #481
• Cray Compiler Environment mkmf.template #470

Please reach out to [email protected] if you are interested in implementing a smoother in DART Manhattan.

Documentation fix

conf.py changes for latest readthedocs. Fixes search and flyout menu. #471