OGC 07-041r1 Open Geospatial Consortium Inc. Date: 2007-05-8 Reference number of this OGC® project document: OGC 07-041r1 Version: 0.3.0 Category: OGC® Discussion Paper Editors: Ilya Zaslavsky, David Valentine, Tim Whiteaker CUAHSI WaterML Copyright notice Copyright © 2007 Open Geospatial Consortium. All rights reserved. Copyright © 2007 Open Geospatial Consortium. All rights reserved. To obtain additional rights of use, visit http://www.opengeospatial.org/legal/. Warning This document is not an OGC Standard. This document is an OGC Discussion Paper and is therefore not an official position of the OGC membership. It is distributed for review and comment. It is subject to change without notice and may not be referred to as an OGC Standard. Further, an OGC Discussion Paper should not be referenced as required or mandatory technology in or mandatory technology in procurements Document type: OGC® Publicly Available Draft Document subtype: Candidate Discussion Paper Document stage: Draft Document language: English OGC 07-041r1 . ii Copyright © 2007 Open Geospatial Consortium. All rights reserved. OGC 07-041r1 Contents i. Preface.................................................................................................................. vii ii. Submitting organizations ................................................................................... vii iii. Submission contact points ................................................................................. viii iv. Revision history.................................................................................................. viii v. Changes to the OGC® Abstract Specification ................................................. viii vi. Future work.......................................................................................................... ix Foreword.............................................................................................................................x Introduction...................................................................................................................... xi 1 Scope........................................................................................................................1 2 Conformance ..........................................................................................................1 3 Normative references.............................................................................................1 4 Terms and definitions............................................................................................2 5 Conventions ............................................................................................................5 5.1 Symbols (and abbreviated terms).........................................................................5 5.2 XML conventions...................................................................................................6 6 WaterML Core Concepts and Implementation Context....................................7 6.1 Introduction............................................................................................................7 6.2 Core concepts .........................................................................................................8 6.2.1 Space, Time, Variable............................................................................................8 6.2.2 Observation network, observation series...........................................................11 6.2.3 Types in WaterML...............................................................................................12 6.2.4 The basic content, and extensibility ...................................................................13 6.3 Implementation context.......................................................................................13 6.4 General issues of bridging with OGC specifications and best practices.........14 7 WaterML element descriptions ..........................................................................15 7.1 Element naming conventions in WaterML........................................................15 7.2 Namespace ............................................................................................................16 7.3 Elements dealing with space ...............................................................................16 7.3.1 General description..............................................................................................16 7.3.2 The SiteInfoType type .........................................................................................18 7.3.3 The DataSetInfoType type ..................................................................................19 7.3.4 The site element....................................................................................................20 7.3.5 The LatLonPointType type.................................................................................21 7.3.6 The LatLonBoxType type ...................................................................................22 Copyright © OGC 2007 – All rights reserved iii OGC 07-041r1 7.3.7 Notes on compatibility with OGC specifications...............................................23 7.4 Elements dealing with variables .........................................................................24 7.4.1 General description..............................................................................................24 7.4.2 The variable element............................................................................................25 7.4.3 Units element ........................................................................................................26 7.4.4 Notes on compatibility with OGC specifications...............................................27 7.5 Elements dealing with time and measured values ............................................27 7.5.1 General description..............................................................................................27 7.5.2 Values 28 7.5.3 Elements of TimePeriodType..............................................................................32 7.5.4 Notes on compatibility with OGC specifications...............................................35 7.6 Series and series catalogs.....................................................................................35 7.6.1 General description..............................................................................................35 7.6.2 Series 35 7.6.3 SeriesCatalog........................................................................................................38 7.6.4 Notes on compatibility with OGC specifications...............................................40 7.7 Elements dealing with web method queries.......................................................42 7.7.1 General description..............................................................................................42 7.7.2 SiteInfoResponse Type ........................................................................................43 7.7.3 VariablesResponse Type .....................................................................................46 7.7.4 TimeSeriesResponse Type...................................................................................47 7.7.5 QueryInfo Element ..............................................................................................50 8 Limitations, and future work..............................................................................51 8.1 Multiple siteCodes and variableCodes...............................................................51 8.2 Categorical Values ...............................................................................................51 8.3 Adding support for groups..................................................................................52 8.4 Terminology..........................................................................................................52 8.5 Metadata ...............................................................................................................52 ANNEX A (normative) Controlled Vocabularies (XML Enumerations) .............54 A1 Introduction..........................................................................................................54 A2 Censor Code CV: <CensorCodeCVEnumeration> ..........................................54 A3 DataType CV: <DataTypeCVEnumeration>....................................................54 A4 General Category CV: <GeneralCategoryCVEnumeration> .........................55 A5 Quality Control Levels CV: <QualityControlLevelEnumeration>.................55 A6 Sample Medium CV: <SampleMediumCVEnumeration> ..............................56 A7 Sample Type CV: <SampleTypeCVEnumeration>..........................................57 A8 Topic Category CV: <TopicCategoryCVEnumeration> .................................58 A9 Units CV: <UnitsCVEnumeration> ...................................................................58 A10 Value Type CV: <ValueTypeCVEnumeration> ...............................................64 A11 Variable Name CV: <VariableNameCVEnumeration>...................................64 A12 Vertical Datum CV: <VerticalDatumCVEnumeration> .................................67 A13 Spatial Reference Systems...................................................................................68 Annex B (informative) The Context of WaterML: CUAHSI HIS Services Oriented Architecture, Web Services, and Related