METplus Wrappers Version 2.1.1 Automation for the Model Evaluation Tools Developmental Testbed Center Boulder, Colorado Daniel Adriaansen 1 , Minna Win-Gildenmeister 1,4 , James Frimel 2,4 , Julie Prestopnik 1,4 , Mallory Row 3 , John Halley Gotway 1,4 , George McCabe1,4 , Tara Jensen 1,4 , Jonathan Vigh 1,4 , Christina Kalb1 , and Hank Fisher 1 1 National Center for Atmospheric Research, Research Applications Laboratory 2 Cooperative Institute for Research in the Atmosphere at National Oceanic and Atmospheric Administration (NOAA) Earth System Research Laboratory 3 I.M. Systems Group at NOAA Environmental Modeling Center 4 Developmental Testbed Center June 2019 Contents 1 Overview 13 1.1 Purpose and organization of the User’s Guide........................... 13 1.2 The Developmental Testbed Center (DTC)............................ 13 1.3 METplus Wrappers goals and design philosophy.......................... 14 1.4 METplus Wrappers Components.................................. 14 1.5 Future development plans...................................... 14 1.6 Code support............................................. 15 2 Software Installation/Getting Started 16 2.1 Introduction.............................................. 16 2.2 Supported architectures....................................... 16 2.3 Programming/scripting languages.................................. 16 2.4 Pre-requisites............................................. 16 2.5 METplus Wrappers directory structure.............................. 17 2.6 Getting the METplus Wrappers source code............................ 18 2.6.1 Get the source code via your Web Browser........................ 18 2.6.2 Get the source code via Command line.......................... 21 2.7 Set up your environment...................................... 21 2.8 Set up METplus Wrappers Configuration files........................... 22 2.9 Running METplus Wrappers.................................... 23 1 CONTENTS 2 3 Python Wrappers 26 3.1 CyclonePlotter............................................ 26 3.1.1 Description.......................................... 26 3.1.2 Configuration......................................... 26 3.2 EnsembleStat............................................ 27 3.2.1 Description.......................................... 27 3.2.2 Configuration......................................... 27 3.3 ExtractTiles............................................. 28 3.3.1 Configuration........................................ 28 3.4 GempakToCF............................................ 29 3.4.1 Description.......................................... 29 3.4.2 Configuration......................................... 29 3.5 GridStat............................................... 29 3.5.1 Description.......................................... 29 3.5.2 Configuration......................................... 29 3.6 MakePlots.............................................. 30 3.6.1 Description.......................................... 30 3.6.2 Configuration......................................... 30 3.7 Mode................................................. 31 3.7.1 Description.......................................... 31 3.7.2 Configuration......................................... 32 3.8 MTD................................................. 33 3.8.1 Description.......................................... 33 3.8.2 Configuration......................................... 33 3.9 PB2NC................................................ 33 CONTENTS 3 3.9.1 Description.......................................... 33 3.9.2 Configuration......................................... 34 3.10 PcpCombine............................................. 35 3.10.1 Description.......................................... 35 3.10.2 Configuration......................................... 35 3.11 PointStat............................................... 36 3.11.1 Description.......................................... 36 3.11.2 Configuration......................................... 36 3.12 RegridDataPlane........................................... 38 3.12.1 Description.......................................... 38 3.12.2 Configuration......................................... 38 3.13 SeriesByInit............................................. 38 3.13.1 Description.......................................... 38 3.13.2 Configuration......................................... 39 3.14 SeriesByLead............................................. 39 3.14.1 Description.......................................... 39 3.14.2 Configuration......................................... 40 3.15 StatAnalysis............................................. 40 3.15.1 Description.......................................... 40 3.15.2 Configuration......................................... 41 3.16 TcPairs................................................ 43 3.16.1 Description.......................................... 43 3.16.2 Configuration......................................... 43 3.17 TcStat................................................ 44 3.17.1 Description.......................................... 44 CONTENTS 4 3.17.2 Configuration......................................... 44 3.18 TCMPRPlotter........................................... 45 3.18.1 Description.......................................... 45 3.18.2 Configuration......................................... 45 4 System Configuration 47 4.1 Config Best Practices......................................... 47 4.2 Config File Structure......................................... 48 4.3 Common Config Variables...................................... 48 4.3.1 Timing Control........................................ 48 4.3.1.1 LOOP_BY.................................... 48 4.3.1.2 Looping by Valid Time.............................. 49 4.3.1.3 Looping by Initialization Time.......................... 50 4.3.1.4 Looping over Forecast Leads........................... 51 4.3.1.5 Realtime Looping................................. 52 4.3.2 Field Info........................................... 54 4.3.3 Directory and Filename Template Info........................... 57 4.4 Config Quick Start Example..................................... 60 4.5 A-Z Config Glossary......................................... 63 4.5.1 A................................................ 63 4.5.2 B................................................ 64 4.5.3 C................................................ 66 4.5.4 D................................................ 68 4.5.5 E................................................ 70 4.5.6 F................................................ 74 CONTENTS 5 4.5.7 G............................................... 93 4.5.8 H................................................ 96 4.5.9 I................................................ 96 4.5.10 J................................................ 99 4.5.11 K................................................ 99 4.5.12 L................................................ 99 4.5.13 M............................................... 103 4.5.14 N................................................ 113 4.5.15 O................................................ 114 4.5.16 P................................................ 131 4.5.17 Q................................................ 139 4.5.18 R................................................ 139 4.5.19 S................................................ 141 4.5.20 T................................................ 147 4.5.21 U................................................ 157 4.5.22 V................................................ 157 4.5.23 W............................................... 160 4.5.24 X................................................ 161 4.5.25 Y................................................ 161 4.5.26 Z................................................ 162 4.6 User Defined Config......................................... 162 Foreword: A note to METplus Wrappers users This User’s Guide is provided as an aid to users of the Model Evaluation Tools (MET) and it’s companion package METplus Wrappers. MET is a set of verification tools developed and supported to community via the Developmental Testbed Center (DTC) for use by the numerical weather prediction community. METplus Wrappers is intended to be a suite of Python wrappers and ancillary scripts to enhance the user’s ability to quickly set-up and run MET. Over the next few years, METplus Wrappers will become the authoritative repository for verification of the Unified Forecast System. It is important to note here that METplus Wrappers is an evolving software package. Previous releases of METplus Wrappers have occurred since 2017. This documentation describes the 2.1 release in May 2019. Intermediate releases may include bug fixes. METplus Wrappers is also be able to accept new modules contributed by the community. If you have code you would like to contribute, we will gladly consider your contribution. While we are setting up our community contribution protocol, please send email to: [email protected] and inform us of your desired contribution. We will then determine the maturity of any new verification method and coordinate the inclusion of the new module in a future version. This User’s Guide was prepared by the developers of the METplus Wrappers, including Dan Adriaansen, Minna Win-Gildenmeister, Julie Prestopnik, Jim Frimel, Mallory Row, John Halley Gotway, George McCabe, Paul Prestopnik, Christana Kalb, Hank Fisher, Jonathan Vigh, Lisa Goodrich, Tara Jensen, Tatiana Burek, and Bonny Strong. New for METplus Wrappers v2.1 METplus Wrappers v2.1.1