2. MET Release Information

2.1. MET Release Notes

When applicable, release notes are followed by the GitHub issue number which describes the bugfix, enhancement, or new feature (MET GitHub issues). Important issues are listed in bold for emphasis.

2.1.1. MET Version 12.0.1 Release Notes (20250131)

Bugfixes

  • Fix the PARUSR BUFRLIB failure when PB2NC is compiled with “-O2” optimization (#3054).

Repository, build, and test

  • Decouple the MET unit tests from the MET installation location (#3051).

2.1.2. MET Version 12.0.0 Release Notes (20241218)

Bugfixes

  • Fix the Grid-Stat configuration file to support the MET_SEEPS_GRID_CLIMO_NAME option (#2601).

  • Refine support for coordinate dimensions in CF-compliant NetCDF files (#2638).

  • Fix logic for computing the 100-th percentile (#2644).

  • Fix support for NSIDC v4 Climate Data Record data on Polar Stereographic grids in CF-compliant NetCDF files (#2652).

  • Correct the usage statement for Point2Grid (#2666).

  • Investigate unexpected number of derived HPBL observations in PB2NC (#2687).

  • Fix the wind-based diagnostics computations in TC-Diag (#2729).

  • Fix the Point-Stat CNT header line typo causing duplicate “SI_BCL” column names (#2730).

  • Fix Python embedding failure when providing a single point observation’ (#2755).

  • Fix MET to compile without the optional –enable-python configuration option (#2760).

  • Fix the parsing of level values for GRIB2 template 4.48 data (#2782).

  • Fix the TC-Diag and TC-RMW tools to correctly handle the range and azimuth settings in range/azimuth grids (#2833).

  • Fix TC-RMW to correct the tangential and radial wind computations (#2841).

  • Fix Ensemble-Stat’s handling of climo data when verifying ensemble-derived probabilities (#2856).

  • Fix Point2Grid’s handling of the -qc option for ADP input files (#2867).

  • Fix Stat-Analysis errors for jobs using the -dump_row option and the -line_type option with VCNT, RPS, DMAP, or SSIDX (#2888).

  • Fix inconsistent handling of point observation valid times processed through Python embedding (#2897).

  • Fix Point2Grid processing of GFS Ocean data input (#2936).

  • Fix contingency table statistic bugs in the CTS and NBRCTS line types for BAGSS, SEDI CI’s, ORSS, and ORSS CI’s (#2958).

  • Fix the grid dimensions used for point2grid_cice_set_attr_grid unit test (#2968).

  • Fix MTD to run on any MET-supported grid projection (#2979).

  • Fix Grid-Stat segfault when SEEPS is the only NetCDF output type requested (#3020).

Enhancements

  • Enhance Series-Analysis to read its own output and incrementally update output statistics over time (#1371).

  • Enhance the set_attr_grid processing logic to support input files lacking a grid definition (#1729).

  • Add support for NetCDF files following the UGRID convention (#2231).

  • Add support for new point_weight_flag to the Point-Stat and Ensemble-Stat tools (#2279).

  • Refine configuration options for defining bins in the verification of probabilistic forecasts (#2280).

  • Allow observation anomaly replacement in Anomaly Correlation Coefficient (ACC) calculation (#2308).

  • Enhance TC-Pairs to include storm diagnostics in consensus track output (#2476).

  • Add support for native WRF output files already on pressure levels (#2547).

  • Enhance TC-Diag to actually compute and write diagnostics (#2550).

  • Refine TC-Diag logic for handling missing data (#2609).

  • Update ioda2nc to support version 3 IODA files (#2640).

  • Enhance MODE CTS output file to include missing categorical statistics, including SEDI (#2648).

  • Enhance MET to compile and link against the Proj library (#2669).

  • Fix the SonarQube findings for MET v12.0 (#2673).

  • Change the default setting for the model string from “WRF” to “FCST” in the default MET configuration files (#2682).

  • Document the use of temporary files in MET and reduce it as much as reasonably possible (#2690).

  • Eliminate the use of temporary files in the vx_config library (#2691).

  • Refine TC-Pairs consensus diagnostics configuration options (#2699).

  • Enhance ASCII2NC to read ISMN point observations of soil moisture and temperature (#2701).

  • Enhance Multivariate MODE to support differing numbers of forecast and observation input fields (#2706).

  • Enhance Multivariate MODE to change the default “merge_flag” setting to NONE (#2708).

  • Documentation: Make Headers Consistent in All MET Guides (#2716).

  • Enhance MODE to use OpenMP to make the convolution step faster (#2724).

  • Major enhancements to multivariate MODE (#2745).

  • Enhance TC-Diag to use tc_diag_driver version 0.11.0 (#2769).

  • Switch from writing temporary Python files in NetCDF to JSON and NumPy serialization (#2772).

  • Revise the use of temporary files in PB2NC (#2792).

  • Enhance MET to make warnings messages about time differences configurable (#2801).

  • Enhance Stat-Analysis to apply the -set_hdr option to filter jobs (#2805).

  • Enhance MET to parse LAEA grids from the MET NetCDF file format (#2809).

  • Add new wind direction verification statistics for RMSE, Bias, and MAE (#2395).

  • Add new ECNT statistics that incorporate observational uncertainty as advised in Ferro (2017) (#2583).

  • Update ndbc_stations.xml after 7-character buoy ids are introduced in Aug/Sept 2023 (#2631).

  • Enhance ASCII2NC to support IABP/IPAB Arctic and Antarctic drifting buoy observations (#2654).

  • Enhance Multivariate MODE to read input data only once rather than multiple times (#2707).

  • Enhance the calculation of RPSS to support starting from probabilistic data (#2786).

  • Add convex hull to MODE output (#2819).

  • Add new wind direction verification statistics for RMSE, Bias, and MAE (#2395).

  • Document UGRID configuration options added to Point-Stat and Grid-Stat (#2748

  • Update GRIB tables in MET based on wgrib2 versions 3.1.4 and 3.4.0 (#2780).

  • Refine Point-Stat Warning message about fcst/obs level mismatch (#2795).

  • Enhance MET to parse the set_attr options prior reading data from gridded data files (#2826).

  • Add new -ugrid_config command line option for unstructured grid inputs to Grid-Stat and Point-Stat (#2842).

  • Enhance Point2Grid to support modified quality control settings for smoke/dust AOD data in GOES-16/17 as of April 16, 2024 (#2853).

  • Enhance Point2Grid to support a wider variety of input tripolar datasets (#2857).

  • Test NOAA Unstructured grids in MET-12.0.0 (#2860).

  • Enhance Ensemble-Stat and Gen-Ens-Prod to omit warning messages for the MISSING keyword (#2870).

  • Add new Python functionality to convert MET NetCDF observation data to a Pandas DataFrame (#2781).

  • Enhance Point2Grid to filter quality control strings with config file options (#2880).

  • Refine SEEPS processing logic and output naming conventions (#2882).

  • Enhance PCP-Combine to allow missing data (#2883).

  • Enhance MET to calculate weighted contingency table counts and statistics (#2887).

  • Enhance the OBTYPE header column for MPR and ORANK line types (#2893).

  • Enhance TC-Stat to support the -set_hdr job command option (#2911).

  • Refine ERROR messages written by PB2NC (#2912).

  • Enhance MET to support separate climatology datasets for both the forecast and observation inputs (#2924).

  • Refine PB2NC warning messages about changing Bufr center times (#2938).

  • Eliminate Point2Grid warning when no valid output data is found (#3000).

Documentation

  • Remove the double-quotes around keywords (#2023).

  • Enhance MTD documentation so that tables 21.3 and 21.4 have units (#2750).

  • Documentation: Provide instructions for compiling MET with the C++11 standard (#2949).

  • Update documentation about parsing grid information from CF-compliant NetCDF files (#3009).

  • Update the MET User’s Guide to specify the data types in each output line type table (#3032).

Repository, build, and test

  • Add GitHub action to run SonarQube for MET pull requests and feature branches (#2379).

  • Enhance MET to compile and link against the Atlas and ecKit libraries (#2574).

  • Enhance “compile_MET_all.sh” to support the new Intel oneAPI compilers and upgrade dependent library versions as needed (#2611).

  • Update the install_met_env.generic configuration file (#2643).

  • Switch SonarQube server (mandan to needham) (#2650).

  • Update GitHub issue and pull request templates to reflect the current development workflow details (#2659).

  • Update the unit test diff logic to handle SEEPS, SEEPS_MPR, and MODE CTS line type updates (#2665).

  • Enhance MET to compile and link against the Proj library (#2669).

  • Fix the SonarQube findings for MET version 12.0.0 (#2673).

  • Upgrade SonarQube server version from 9.8 to 10.2 (#2689).

  • Move namespace specifications below include directives (#2696).

  • Update the token for upgraded SonarQube server (#2702).

  • Reimplement and enhance the Perl-based (unit.pl) unit test control script in Python (#2717).

  • Update compilation script and configuration files as needed for supported platforms (#2753).

  • Remove the SonarQube token from the properties file (#2757).

  • Repository cleanup of stale code and configuration consistency (#2776).

  • Add new example installation configuration files for Intel compiler users (#2785).

  • Update GitHub actions workflows to switch from node 16 to node 20 (#2796).

  • Enhance GitHub action compilation options and testing workflows (#2815).

  • SonarQube: Replace “enum” to “enum class” (#2830).

  • Update tag used for the release checksum action (#2929).

  • Enhance the unit.py MET testing script to allow for expected failures (#2937).

  • Modify configure.ac to define C++17 as the default compilation standard (#2948).

METplus-Internal issues

METplus-Internal is a private repository where internal issues related to security are tracked.

  • MET: Enhance the MET testing framework to provide a mechanism for expected failure (METplus-Internal#23).

METbaseimage testing environment

METbaseimage is a public repository that provides the Docker environment in which automated testing of MET is performed.

  • Refine METbaseimage to compile dependent libraries from a single tar file (METbaseimage#9).

  • Update METbaseimage to complete the transition to the Debian 12 (bookworm) base image (METbaseimage#12).

  • Enhance METbaseimage to compile the ecKit and Atlas libraries (METbaseimage#13).

  • Enhance METbaseimage to install the YAML Python package (METbaseimage#15).

  • Enhance METbaseimage to install SciPy Python package needed by the MET TC-Diag tool (METbaseimage#20).

  • Fix METbaseimage environment to correct the ncdump runtime linker error (METbaseimage#24).

  • Update METbaseimage to use newer versions of Atlas and ecKit (METbaseimage#27).

2.2. MET Upgrade Instructions

2.2.1. MET Version 12.0.0 Upgrade Instructions

Note

Note that the #2833 bugfix affects all previously generated output from the TC-Diag and TC-RMW tools.

Note

Note that the GRIB table updates in #2780 modified some existing units strings for consistency and clarity.

Compilation dependencies

MET Version 12.0.0 introduces one new required and two new optional dependencies:

  • The Proj library is required (#2669).

  • The Atlas and ecKit libraries are optional and only required when configuring MET with the --enable-ugrid option (#2574).

Configuration file changes since version 11.1.0

MET Version 12.0.0 adds, modifies, or removes the following configuration options:

  • Configuration of all tools:

    • Adds new time_offset_warning option in ConfigConstants that can be overridden in tool-specific configuration files.

  • Point-Stat, Grid-Stat, Ensemble-Stat, and Series-Analysis configurations:

    • Enables climo_mean and climo_stdev to be defined separately within the fcst and obs dictionaries.

  • Point-Stat and Ensemble-Stat configurations:

    • Adds new obtype_as_group_val_flag option.

    • Adds new point_weight_flag option.

  • TC-Diag configuration:

    • Adds new override_diags option in the domain_info dictionary.

    • Adds new one_time_per_file_flag option.

    • Renames nc_rng_azi_flag option as nc_cyl_grid_flag.

    • Replaces output_prefix option with output_base_format.

  • MODE configuration:

    • Adds new multivar_intensity_compare_fcst and multivar_intensity_compare_obs options.

    • Adds new multivar_name and multivar_level options within the fcst and obs dictionaries.

  • PB2NC configuration:

    • Removes unused quality_mark_thresh option.

    • Adds new obs_quality_inc and obs_quality_exc options.

  • IODA2NC configuration:

    • Updates default metadata_map setting.

  • Unstructured Grid input files:

    • Adds new UGridConfig_lfric and UGridConfig_mpas to define model-specific metadata information.

Output line type changes since version 11.1.0

MET Version 12.0.0 adds or modifies the following ASCII output line types:

  • Matched Pair (MPR) line type from Point-Stat:

    • Renames existing CLIMO_MEAN, CLIMO_STDEV, and CLIMO_CDF columns as OBS_CLIMO_MEAN, OBS_CLIMO_STDEV, OBS_CLIMO_CDF, respectively.

    • Adds new FCST_CLIMO_MEAN and FCST_CLIMO_STDEV columns to the end of the line.

  • Vector Partial Sums (VL1L2) line type from Point-Stat and Grid-Stat:

    • Adds new TOTAL_DIR, DIR_ME, DIR_MAE, and DIR_MSE columns to the end of the line containing wind direction statistics.

  • Vector Anomaly Partial Sums (VAL1L2) line type from Point-Stat and Grid-Stat:

    • Adds new TOTAL_DIR, DIRA_ME, DIRA_MAE, and DIRA_MSE columns to the end of the line containing wind direction statistics.

  • Vector Continuous Statisics (VCNT) line type from Point-Stat and Grid-Stat:

    • Adds new TOTAL_DIR, DIR_ME, DIR_ME_BCL, DIR_ME_BCU, DIR_MAE, DIR_MAE_BCL, DIR_MAE_BCU, DIR_MSE, DIR_MSE_BCL, DIR_MSE_BCU, DIR_RMSE, DIR_RMSE_BCL, and DIR_RMSE_BCU columns to the end of the line containing wind direction statistics.

    • Note that no bootstrap confidence intervals are currently being computed so the BCL and BCU columns all contain NA.

  • Stable Equitable Error in Probability Space (SEEPS) line type from Point-Stat and Grid-Stat:

    • Renames existing S12, S13, S21, S23, S31, and S32 columns as ODFL, ODFH, OLFD, OLFH, OHFD, and OHFL, respectively, where O and F are for observation and forecast and D, L, and H are for dry, light, and heavy precipitation.

  • Observation Rank (ORANK) line type from Ensemble-Stat:

    • Renames existing CLIMO_MEAN and CLIMO_STDEV columns as OBS_CLIMO_MEAN and OBS_CLIMO_STDEV, respectively.

    • Adds new FCST_CLIMO_MEAN and FCST_CLIMO_STDEV columns to the end of the line.

  • Ensemble Continuous Statistics (ECNT) line type from Ensemble-Stat:

    • Adds new IGN_CONV_OERR and IGN_CORR_OERR columns to the end of the line.

  • MODE Continuous Statistics (MODE CTS) line type from MODE:

    • Adds new SEDS, EDI, SEDI, and BAGSS columns to the end of the line.