Changes between Version 8 and Version 9 of cookbook/RADVOL-QC_BROAD


Ignore:
Timestamp:
11/06/13 12:49:17 (4 years ago)
Author:
jan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • cookbook/RADVOL-QC_BROAD

    v8 v9  
    1414 
    1515== '''3. ODIM metadata requirements for I/O''' == 
    16  * Top-level “how”: beamwidth, pulsewidth.  
     16 * Top-level “how”: beamwidth, pulsewidth. 
    1717 * Dataset-specific “what”: gain, offset, nodata, undetect. 
    1818 * Dataset-specific “where”: elangle, nbins, nrays, rscale. 
     
    2626 
    2727== '''5. Logical steps, using any of: text, flow charts, graphics, equations (or references to equations), conditional branches in “all possible cases”.''' == 
    28 The horizontal and vertical broadening of radar beam for each gate can be computed when its polar coordinates are known: ''ε'' (elevation angle), ''α'' (azimuth angle), and ''l'' (radial distance to radar site in km), and two parameters of radar beam: ''φ'' (beam width) and ''P,,L,,'' (measurement gate length in km) calculated from radar pulse length.  
     28The horizontal and vertical broadening of radar beam for each gate can be computed when its polar coordinates are known: ''ε'' (elevation angle), ''α'' (azimuth angle), and ''l'' (radial distance to radar site in km), and two parameters of radar beam: ''φ'' (beam width) and ''P,,L,,'' (measurement gate length in km) calculated from radar pulse length. 
    2929 
    3030[[Image(Fig_1_BROAD.gif)]] 
    3131 
    3232Set of the algorithm parameters: 
     33 
    3334|| ''Description'' || ''Denotation'' || ''Default value'' || 
    3435|| Maximum ''L,,H,,'' for which ''QI,,LH,,'' = 1 || BROAD_LhQI1 || 1.1 || 
    3536|| Minimum ''L,,H,,'' for which ''QI,,LH,,'' = 0 || BROAD_LhQI0 || 2.5 || 
    36 || Maximum ''L,,V,,'' for which ''QI,,LV,,'' = 1 || BROAD_LvQI1 || 1.5 || 
    37 || Minimum ''L,,V,,'' for which ''QI,,LV,,'' = 0 || BROAD_LvQI0 || 3.2 || 
    38 || Pulse length (km) || BROAD_Pulse || 0.3 || 
     37|| Maximum ''L,,V,,'' for which ''QI,,LV,,'' = 1 || BROAD_LvQI1 || 1.6 || 
     38|| Minimum ''L,,V,,'' for which ''QI,,LV,,'' = 0 || BROAD_LvQI0 || 4.3 || 
     39|| Pulse length (km) - radar parameter || BROAD_Pulse || 0.3 || 
    3940 
    40 At first the XML file is checked whether there exists group for a considered radar (based on the radar name read from "what"/source(NOD)), which contains the algorithm parameters. If "yes", then parameters are read from that XML group, but if it is impossible for a particular parameter, then default value from source code is taken. If the group does not exist, parameters are read from <default> group in XML file in analogous way.  
     41At first the XML file is checked whether there exists group for a considered radar (based on the radar name read from "what"/source(NOD)), which contains the algorithm parameters. If "yes", then parameters are read from that XML group, but if it is impossible for a particular parameter, then default value from source code is taken. If the group does not exist, parameters are read from <default> group in XML file in analogous way. 
    4142 
    42 If the algorithm is run by means of BALTRAD toolbox then all the algorirthm parameters for each specific radar should be placed in relevant XML file by the BALTRAD system admin. Parameters included in HDF5 file are used in cases they are not found in XML file. Default parameters are placed in the XML file by admin as well. Moreover, the algorithm default parameters are also included in software.  
     43If the algorithm is run by means of BALTRAD toolbox then all the algorirthm parameters for each specific radar should be placed in relevant XML file by the BALTRAD system admin. Parameters included in HDF5 file are used in cases they are not found in XML file. Default parameters are placed in the XML file by admin as well. Moreover, the algorithm default parameters are also included in software. 
    4344 
    4445The horizontal and vertical broadenings ''L,,H,,'' and ''L,,V,,'' are described by the following formulae calculated from vertical cross-section through radar beam: 
     
    5051$ {L_{V}} = ({l}+\frac{P_L}{2}) \sin(\epsilon+\frac{\phi}{2}) - ({l}-\frac{P_L}{2}) \sin(\epsilon-\frac{\phi}{2})  $. 
    5152}}} 
    52  
    53 Assuming linear relationships ''L,,H,,'' => ''QI,,LH,,'' and ''L,,V,,'' => ''QI,,LV,,'', the following formulas can be applied:  
     53Assuming linear relationships ''L,,H,,'' => ''QI,,LH,,'' and ''L,,V,,'' => ''QI,,LV,,'', the following formulas can be applied: 
    5454 
    5555{{{ 
     
    66660                                 & \textrm{for\ } L_V>\text{BROAD}\_\text{LvQI1}\end{cases} $. 
    6767}}} 
    68  
    6968where boundary values can be estimated empirically. 
    7069 
     
    7574$ QI_{BROAD} = QI_{LH} \cdot QI_{LV}  $ 
    7675}}} 
    77  
    7876== '''6. Output''' == 
    7977=== a) Quality index (''QI'') field === 
    80 Quality index (''QI'' = 0 for bad data, ''QI'' = 1 for excellent data) with "pl.imgw.radvolqc.broad" in quality-specific "how"/task, and the algorithm parameters in "how"/task_args.  
     78Quality index (''QI'' = 0 for bad data, ''QI'' = 1 for excellent data) with "pl.imgw.radvolqc.broad" in quality-specific "how"/task, and the algorithm parameters in "how"/task_args. 
    8179 
    8280== '''7. Outline of a test concept exemplifying the algorithm, as a suggestion for checking that an implementation has been successful.''' ==