User’s Guide

Foreword: A note to METdataio users

This User’s guide is provided as an aid to users of METdataio. METdataio is a Python rewrite of the capabilities in METviewer. The METviewer tool reads MET verification statistics output from a database and creates plots using the R statistical package. METdataio is also a component of the unified METplus verification framework. More details about METplus can be found on the METplus website.

It is important to note here that METdataio is an evolving software package. This documentation describes the 2.1.0 release dated 2023-07-26. Intermediate releases may include bug fixes. METdataio is also able to accept new modules contributed by the community. If you have code you would like to contribute, we will gladly consider your contribution. Please create a post in the METplus GitHub Discussions Forum. We will then determine if we will be able to include the contribution in a future version.

Model Evaluation Tools Datadb (METdataio) TERMS OF USE - IMPORTANT!

Copyright 2023, UCAR/NCAR, NOAA, CSU/CIRA, and CU/CIRES Licensed under the Apache License, Version 2.0 (the “License”); You may not use this file except in compliance with the License.

You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


The citation for this User’s Guide should be:

Fisher, H., M. Win-Gildenmeister, V. Hagerty, and T. Burek, 2023: The METdataio Version 2.1.0 User’s Guide. Developmental Testbed Center. Available at:


We thank the the National Science Foundation (NSF) along with three organizations within the National Oceanic and Atmospheric Administration (NOAA): 1) Office of Atmospheric Research (OAR); 2) Next Generation Global Predition System project (NGGPS); and 3) United State Weather Research Program (USWRP) for their support of this work. Thanks also go to the staff at the Developmental Testbed Center for their help, advice, and many types of support. We released METplus Alpha in February 2017 and would not have made a decade of cutting-edge verification support without those who participated in DTC planning workshops and the NGGPS United Forecast System Strategic Implementation Plan Working Groups (NGGPS UFS SIP WGs).

The DTC is sponsored by the National Oceanic and Atmospheric Administration (NOAA), the United States Air Force, and the National Science Foundation (NSF). NCAR is sponsored by the National Science Foundation (NSF).

Indices and tables