WaterML2 is a new data exchange standard in Hydrology which can basically be used to exchange many kinds of hydro-meteorological observations and measurements. WaterML2 has been initiated and designed over a period of several years by a group of major national and international organizations from public and private sector, such as CSIRO, CUAHSI, USGS, BOM, NOAA, KISTERS and others. WaterML2 has been developed within the OGC Hydrology Domain Working group which has a mandate by the WMO, too.

Objectives of WaterML2:

  • provide a common exchange format for hydrological time-series
  • build on existing standards like GML and Observations & Measurements
  • provide the option to fully store information including information regarding quality, validity/interpolation, and remarks
  • currently it is NOT an objective to provide a comprehensive format with a minimum of characters
Download PDF
Examples:
example.wml
example.wmz

Related links:
WaterML2 @ OGC
HydroDWG
SWG
GML
O&M

Small code example with explanations:

		
  1. <wml2:Collection xsi:schemaLocation="http://www.opengis.net/waterml/2.0 http://www.opengis.net/waterml/2.0/waterml2.xsd" gml:id="Ki.Col.1">
  2.     <gml:description>KISTERS KiWIS WaterML2.0</gml:description>
  3.     <wml2:metadata>
  4.         <wml2:DocumentMetadata gml:id="Ki.DocMD.1">
  5.             <wml2:generationDate>2012-06-12T12:10:12.670+00:00</wml2:generationDate>
  6.             <wml2:generationSystem>KISTERS KiWIS</wml2:generationSystem>
  7.         </wml2:DocumentMetadata>
  8.     </wml2:metadata>
  9.     <wml2:temporalExtent>
  10.         <gml:TimePeriod gml:id="Ki.TempExt.1">
  11.             <gml:beginPosition>1990-09-01T00:00:00.000+01:00</gml:beginPosition>
  12.             <gml:endPosition>1990-09-30T00:00:00.000+01:00</gml:endPosition>
  13.         </gml:TimePeriod>
  14.     </wml2:temporalExtent>
  15.     <wml2:observationMember>
  16.         <om:OM_Observation gml:id="Ki.OM_Obs.1">
  17.             <om:phenomenonTime>
  18.                 <gml:TimePeriod gml:id="Ki.ObsTime.1">
  19.                     <gml:beginPosition>1990-09-01T00:00:00.000+01:00</gml:beginPosition>
  20.                     <gml:endPosition>1990-09-30T00:00:00.000+01:00</gml:endPosition>
  21.                 </gml:TimePeriod>
  22.             </om:phenomenonTime>
  23.             <om:resultTime>
  24.                 <gml:TimeInstant gml:id="Ki.resTime.1">
  25.                     <gml:timePosition>1990-09-30T00:00:00.000+01:00</gml:timePosition>
  26.                 </gml:TimeInstant>
  27.             </om:resultTime>
  28.             <om:procedure xlink:href="http://kiwis.kisters.de/ts/Day.Cmd" xlink:title="10 - DailyMean"/>
  29.             <om:observedProperty xlink:href="http://kiwis.kisters.de/parameters/557" xlink:title="Q"/>
  30.             <om:featureOfInterest xlink:href="http://kiwis.kisters.de/stations/1732100" xlink:title="ATHIEME"/>
  31.             <om:result>
  32.                 <wml2:MeasurementTimeseries gml:id="Ki.Ts.132042">
  33.                     <wml2:temporalExtent>
  34.                         <gml:TimePeriod gml:id="Ki.TsTime.1">
  35.                             <gml:beginPosition>1990-09-01T00:00:00.000+01:00</gml:beginPosition>
  36.                             <gml:endPosition>1990-09-30T00:00:00.000+01:00</gml:endPosition>
  37.                         </gml:TimePeriod>
  38.                     </wml2:temporalExtent>
  39.                     <wml2:defaultPointMetadata>
  40.                         <wml2:DefaultTVPMeasurementMetadata>
  41.                             <wml2:interpolationType xlink:href="http://www.opengis.net/def/waterml/2.0/interpolationType/ConstPrec" xlink:title="Constant in preceding interval"/>
  42.                             <wml2:qualifier xlink:href="http://kiwis.kisters.de/statusCodes/40" xlink:title="40"/>
  43.                             <wml2:uom uom="cumec"/>
  44.                         </wml2:DefaultTVPMeasurementMetadata>
  45.                     </wml2:defaultPointMetadata>
  46.                     <wml2:point>
  47.                         <wml2:MeasurementTVP>
  48.                             <wml2:time>1990-09-01T00:00:00.000+01:00</wml2:time>
  49.                             <wml2:value>193.0</wml2:value>
  50.                         </wml2:MeasurementTVP>
  51.                     </wml2:point>
  52.                     <wml2:point>
  53.                         <wml2:MeasurementTVP>
  54.                             <wml2:time>1990-09-02T00:00:00.000+01:00</wml2:time>
  55.                             <wml2:value>182.0</wml2:value>
  56.                         </wml2:MeasurementTVP>
  57.                     </wml2:point>
  58.                     <wml2:point>
  59.                         <wml2:MeasurementTVP>
  60.                             <wml2:time>1990-09-03T00:00:00.000+01:00</wml2:time>
  61.                             <wml2:value>171.0</wml2:value>
  62.                         </wml2:MeasurementTVP>
  63.                     </wml2:point>
  64.                     <wml2:point>
  65.                         <wml2:MeasurementTVP>
  66.                             <wml2:time>1990-09-04T00:00:00.000+01:00</wml2:time>
  67.                             <wml2:value>119.0</wml2:value>
  68.                         </wml2:MeasurementTVP>
  69.                     </wml2:point>
  70.                     <wml2:point>
  71.                         <wml2:MeasurementTVP>
  72.                             <wml2:time>1990-09-05T00:00:00.000+01:00</wml2:time>
  73.                             <wml2:value>129.0</wml2:value>
  74.                         </wml2:MeasurementTVP>
  75.                     </wml2:point>
  76.                     <wml2:point>
  77.                         <wml2:MeasurementTVP>
  78.                             <wml2:time>1990-09-06T00:00:00.000+01:00</wml2:time>
  79.                             <wml2:value>125.0</wml2:value>
  80.                         </wml2:MeasurementTVP>
  81.                     </wml2:point>
  82.                     <wml2:point>
  83.                         <wml2:MeasurementTVP>
  84.                             <wml2:time>1990-09-07T00:00:00.000+01:00</wml2:time>
  85.                             <wml2:value>130.0</wml2:value>
  86.                         </wml2:MeasurementTVP>
  87.                     </wml2:point>
  88.                     <wml2:point>
  89.                         <wml2:MeasurementTVP>
  90.                             <wml2:time>1990-09-08T00:00:00.000+01:00</wml2:time>
  91.                             <wml2:value>108.0</wml2:value>
  92.                         </wml2:MeasurementTVP>
  93.                     </wml2:point>
  94.                     <wml2:point>
  95.                         <wml2:MeasurementTVP>
  96.                             <wml2:time>1990-09-09T00:00:00.000+01:00</wml2:time>
  97.                             <wml2:value>100.0</wml2:value>
  98.                         </wml2:MeasurementTVP>
  99.                     </wml2:point>
  100.                     <wml2:point>
  101.                         <wml2:MeasurementTVP>
  102.                             <wml2:time>1990-09-10T00:00:00.000+01:00</wml2:time>
  103.                             <wml2:value>89.0</wml2:value>
  104.                         </wml2:MeasurementTVP>
  105.                     </wml2:point>
  106.                     <wml2:point>
  107.                         <wml2:MeasurementTVP>
  108.                             <wml2:time>1990-09-11T00:00:00.000+01:00</wml2:time>
  109.                             <wml2:value>89.0</wml2:value>
  110.                         </wml2:MeasurementTVP>
  111.                     </wml2:point>
  112.                     <wml2:point>
  113.                         <wml2:MeasurementTVP>
  114.                             <wml2:time>1990-09-12T00:00:00.000+01:00</wml2:time>
  115.                             <wml2:value>106.0</wml2:value>
  116.                         </wml2:MeasurementTVP>
  117.                     </wml2:point>
  118.                     <wml2:point>
  119.                         <wml2:MeasurementTVP>
  120.                             <wml2:time>1990-09-13T00:00:00.000+01:00</wml2:time>
  121.                             <wml2:value>132.0</wml2:value>
  122.                         </wml2:MeasurementTVP>
  123.                     </wml2:point>
  124.                     <wml2:point>
  125.                         <wml2:MeasurementTVP>
  126.                             <wml2:time>1990-09-14T00:00:00.000+01:00</wml2:time>
  127.                             <wml2:value>145.0</wml2:value>
  128.                         </wml2:MeasurementTVP>
  129.                     </wml2:point>
  130.                     <wml2:point>
  131.                         <wml2:MeasurementTVP>
  132.                             <wml2:time>1990-09-15T00:00:00.000+01:00</wml2:time>
  133.                             <wml2:value>150.0</wml2:value>
  134.                         </wml2:MeasurementTVP>
  135.                     </wml2:point>
  136.                     <wml2:point>
  137.                         <wml2:MeasurementTVP>
  138.                             <wml2:time>1990-09-16T00:00:00.000+01:00</wml2:time>
  139.                             <wml2:value>152.0</wml2:value>
  140.                         </wml2:MeasurementTVP>
  141.                     </wml2:point>
  142.                     <wml2:point>
  143.                         <wml2:MeasurementTVP>
  144.                             <wml2:time>1990-09-17T00:00:00.000+01:00</wml2:time>
  145.                             <wml2:value>118.0</wml2:value>
  146.                         </wml2:MeasurementTVP>
  147.                     </wml2:point>
  148.                     <wml2:point>
  149.                         <wml2:MeasurementTVP>
  150.                             <wml2:time>1990-09-18T00:00:00.000+01:00</wml2:time>
  151.                             <wml2:value>92.0</wml2:value>
  152.                         </wml2:MeasurementTVP>
  153.                     </wml2:point>
  154.                     <wml2:point>
  155.                         <wml2:MeasurementTVP>
  156.                             <wml2:time>1990-09-19T00:00:00.000+01:00</wml2:time>
  157.                             <wml2:value>106.0</wml2:value>
  158.                         </wml2:MeasurementTVP>
  159.                     </wml2:point>
  160.                     <wml2:point>
  161.                         <wml2:MeasurementTVP>
  162.                             <wml2:time>1990-09-20T00:00:00.000+01:00</wml2:time>
  163.                             <wml2:value>129.0</wml2:value>
  164.                         </wml2:MeasurementTVP>
  165.                     </wml2:point>
  166.                     <wml2:point>
  167.                         <wml2:MeasurementTVP>
  168.                             <wml2:time>1990-09-21T00:00:00.000+01:00</wml2:time>
  169.                             <wml2:value>125.0</wml2:value>
  170.                         </wml2:MeasurementTVP>
  171.                     </wml2:point>
  172.                     <wml2:point>
  173.                         <wml2:MeasurementTVP>
  174.                             <wml2:time>1990-09-22T00:00:00.000+01:00</wml2:time>
  175.                             <wml2:value>152.0</wml2:value>
  176.                         </wml2:MeasurementTVP>
  177.                     </wml2:point>
  178.                     <wml2:point>
  179.                         <wml2:MeasurementTVP>
  180.                             <wml2:time>1990-09-23T00:00:00.000+01:00</wml2:time>
  181.                             <wml2:value>152.0</wml2:value>
  182.                         </wml2:MeasurementTVP>
  183.                     </wml2:point>
  184.                     <wml2:point>
  185.                         <wml2:MeasurementTVP>
  186.                             <wml2:time>1990-09-24T00:00:00.000+01:00</wml2:time>
  187.                             <wml2:value>120.0</wml2:value>
  188.                         </wml2:MeasurementTVP>
  189.                     </wml2:point>
  190.                     <wml2:point>
  191.                         <wml2:MeasurementTVP>
  192.                             <wml2:time>1990-09-25T00:00:00.000+01:00</wml2:time>
  193.                             <wml2:value>96.0</wml2:value>
  194.                         </wml2:MeasurementTVP>
  195.                     </wml2:point>
  196.                     <wml2:point>
  197.                         <wml2:MeasurementTVP>
  198.                             <wml2:time>1990-09-26T00:00:00.000+01:00</wml2:time>
  199.                             <wml2:value>123.0</wml2:value>
  200.                         </wml2:MeasurementTVP>
  201.                     </wml2:point>
  202.                     <wml2:point>
  203.                         <wml2:MeasurementTVP>
  204.                             <wml2:time>1990-09-27T00:00:00.000+01:00</wml2:time>
  205.                             <wml2:value>127.0</wml2:value>
  206.                         </wml2:MeasurementTVP>
  207.                     </wml2:point>
  208.                     <wml2:point>
  209.                         <wml2:MeasurementTVP>
  210.                             <wml2:time>1990-09-28T00:00:00.000+01:00</wml2:time>
  211.                             <wml2:value>130.0</wml2:value>
  212.                         </wml2:MeasurementTVP>
  213.                     </wml2:point>
  214.                     <wml2:point>
  215.                         <wml2:MeasurementTVP>
  216.                             <wml2:time>1990-09-29T00:00:00.000+01:00</wml2:time>
  217.                             <wml2:value>141.0</wml2:value>
  218.                         </wml2:MeasurementTVP>
  219.                     </wml2:point>
  220.                     <wml2:point>
  221.                         <wml2:MeasurementTVP>
  222.                             <wml2:time>1990-09-30T00:00:00.000+01:00</wml2:time>
  223.                             <wml2:value>139.0</wml2:value>
  224.                         </wml2:MeasurementTVP>
  225.                     </wml2:point>
  226.                 </wml2:MeasurementTimeseries>
  227.             </om:result>
  228.         </om:OM_Observation>
  229.     </wml2:observationMember>
  230. </wml2:Collection>

File extensions

  • XML: the typical file extension of an XML file
  • WML: the wml-extension is a typical abbreviation of WaterML2 and can be used as a file-extension as well
  • WMZ: similar to KML/KMZ we suggest to use the file extension "WMZ" to indicate that the file has been zipped

How to transport WaterML2

  • email, ftp, file-copy
  • any arbitrary http-transfer, or via standardized http transfer mechanism (e.g. OGC: SOS)
  • any other transfer option (the above just focus to internet use-cases)