MeteoIODoc  MeteoIODoc-2.9.0
mio::ProcUndercatch_WMO Class Reference

Detailed Description

Correct precipitation for undercatch in winter conditions.

This implements the standard methods for precipitation correction as described in "WMO Solid Precipitation Measurement Intercomparison", B. Goodison, P. Louie and D. Yang, 872, 1998 as well as the overview given by "Literature Study on the Correction of Precipitation Measurements", Annette Wagner, 2009. The correction parameters for the shielded Hellmann gauge (German version) are from "Wind-induced Precipitation Undercatch of the Hellmann Gauges", Daqing Yang et al, Nordic Hydrology, 30, 1999, pp 57-80 while the correction for Japanese RT-3 gauges comes from "Performance of Japanese precipitation gauges in winter", K. Yokoyama, H. Ohno, Y. Kominami, S. Inoue and T. Kawakata, Seppyo, 65, 2003, pp 303-316 (in Japanese with English summary). The correction for the Chinese Standard Precipitation Gauge is from "A Bias-Corrected Precipitation Climatology for China", B. Ye, Y. Daqing, D. Yongjian, H. Tianding, K. Toshio, 2004, Journal of Hydrometeorology, 5, 1147–1160.

These correction methods process pure snow and mixed precipitation differently, with the following thresholds:

  • pure snow below -2 C
  • mixed precipitation between -2 and +2 C
  • pure rain above 2 C

They also depend on the usage of a shield around the gauge as well as the type of rain gauge that does the measurements, therefore this type must be specified as an argument. The coefficients are not always available both for shielded and unshielded gauges, so most of the time only one variation will be available and is specified below.

The following arguments are supported:

  • TYPE: this gives the rain gauge and shield type. It must be one of:
    • cst - this applies a constant factor to the precipitation (the solid and mixed precipitation factor must be provided, see below);
    • Nipher - National standard rain gauge in Canada, shielded;
    • Tretyakov - Designed in USSR in the 1950s, deployed by some national networks in ex-USSR territories, shielded;
    • US8sh - US national 8" rain gauge, shielded (Alter shield);
    • US8unsh - US national 8" rain gauge, unshielded;
    • RT3_Jp - Japanese network RT-3 rain gauge. This uses an ad-hoc rain/snow splitting method;
    • Cspg - China Standard Precipitation Gauge, unshielded;
    • Geonorsh - Geonor rain gauge with Alter shield. The mixed precipitation is computed according to the same principles as in (Ye, 2004);
    • Hellmann - the most widely used rain gauge in the world, with some country specific variations, unshielded;
    • Hellmannsh - Hellmann rain gauge with shield, mixed precipitation from a fit on the published data;
  • SNOW: constant factor for solid precipitation for the CST type (mandatory);
  • MIXED: constant factor for mixed precipitation for the CST type (mandatory);
  • T_SNOW: solid precipitation temperature threshold for the CST type (in K, optional);
  • T_RAIN: liquid precipitation temperature threshold for the CST type (in K, optional);
PSUM::filter1 = undercatch_wmo
PSUM::arg1::type = cst
PSUM::arg1::snow = 1.3
PSUM::arg1::mixed = 1.1

#include <ProcUndercatch_WMO.h>

Public Member Functions

 ProcUndercatch_WMO (const std::vector< std::pair< std::string, std::string > > &vecArgs, const std::string &name)
 
virtual void process (const unsigned int &param, const std::vector< MeteoData > &ivec, std::vector< MeteoData > &ovec)
 
- Public Member Functions inherited from mio::ProcessingBlock
virtual ~ProcessingBlock ()
 
virtual void process (Date &dateStart, Date &dateEnd)
 
std::string getName () const
 
const ProcessingPropertiesgetProperties () const
 
const std::string toString () const
 
bool skipStation (const std::string &station_id) const
 
bool noStationsRestrictions () const
 

Additional Inherited Members

- Static Public Member Functions inherited from mio::ProcessingBlock
static void readCorrections (const std::string &filter, const std::string &filename, std::vector< double > &X, std::vector< double > &Y)
 
static void readCorrections (const std::string &filter, const std::string &filename, std::vector< double > &X, std::vector< double > &Y1, std::vector< double > &Y2)
 
static std::vector< double > readCorrections (const std::string &filter, const std::string &filename, const size_t &col_idx, const char &c_type, const double &init)
 
static std::vector< offset_specreadCorrections (const std::string &filter, const std::string &filename, const double &TZ, const size_t &col_idx=2)
 
static std::map< std::string, std::vector< dates_range > > readDates (const std::string &filter, const std::string &filename, const double &TZ)
 
static std::set< std::string > initStationSet (const std::vector< std::pair< std::string, std::string > > &vecArgs, const std::string &keyword)
 
- Protected Member Functions inherited from mio::ProcessingBlock
 ProcessingBlock (const std::vector< std::pair< std::string, std::string > > &vecArgs, const std::string &name)
 protected constructor only to be called by children More...
 
- Static Protected Member Functions inherited from mio::ProcessingBlock
static void extract_dbl_vector (const unsigned int &param, const std::vector< MeteoData > &ivec, std::vector< double > &ovec)
 
static void extract_dbl_vector (const unsigned int &param, const std::vector< const MeteoData *> &ivec, std::vector< double > &ovec)
 
- Protected Attributes inherited from mio::ProcessingBlock
const std::set< std::string > excluded_stations
 
const std::set< std::string > kept_stations
 
ProcessingProperties properties
 
const std::string block_name
 
- Static Protected Attributes inherited from mio::ProcessingBlock
static const double soil_albedo = .23
 
static const double snow_albedo = .85
 
static const double snow_thresh = .1
 parametrize the albedo from HS More...
 

Constructor & Destructor Documentation

◆ ProcUndercatch_WMO()

mio::ProcUndercatch_WMO::ProcUndercatch_WMO ( const std::vector< std::pair< std::string, std::string > > &  vecArgs,
const std::string &  name 
)

Member Function Documentation

◆ process()

void mio::ProcUndercatch_WMO::process ( const unsigned int &  param,
const std::vector< MeteoData > &  ivec,
std::vector< MeteoData > &  ovec 
)
virtual

Implements mio::ProcessingBlock.


The documentation for this class was generated from the following files: