source: RevitalizationWS/schemas/cim/trunk/src/main/resources/eu.metaforclimate/grids.xsd @ 7450

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/RevitalizationWS/schemas/cim/trunk/src/main/resources/eu.metaforclimate/grids.xsd@7450
Revision 7450, 46.6 KB checked in by mnagni, 10 years ago (diff)

Share project "cim" into " http://proj.badc.rl.ac.uk/svn/ndg/RevitalizationWS"

  • Property svn:mime-type set to text/plain
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!-- grids.xsd -->       
3<!-- generated: 23 August 2010, 9:24 -->       
4<xs:schema
5             elementFormDefault="qualified" attributeFormDefault="unqualified"
6             xmlns:xs="http://www.w3.org/2001/XMLSchema"
7             xmlns:xlink="http://www.w3.org/1999/xlink"
8             xmlns:gml="http://www.opengis.net/gml/3.2"
9             xmlns:gmd="http://www.isotc211.org/2005/gmd"
10            xmlns="http://www.metaforclimate.eu/schema/cim/1.5"
11            targetNamespace="http://www.metaforclimate.eu/schema/cim/1.5">       
12<!-- these relative paths could really be URLs, but accessing them online cripples performance -->       
13<xs:import xmlns:xs="http://www.w3.org/2001/XMLSchema"
14           namespace="http://www.w3.org/1999/xlink"
15           schemaLocation="../external_schemas/xlink/1.0.0/xlinks.xsd"/>
16<xs:import xmlns:xs="http://www.w3.org/2001/XMLSchema"
17           namespace="http://www.opengis.net/gml/3.2"
18           schemaLocation="../external_schemas/gml/3.2.1/gml.xsd"/>
19<xs:import xmlns:xs="http://www.w3.org/2001/XMLSchema"
20           namespace="http://www.isotc211.org/2005/gmd"
21           schemaLocation="../external_schemas/iso/19139/20070417/gmd/gmd.xsd"/>
22<xs:include xmlns:xs="http://www.w3.org/2001/XMLSchema" schemaLocation="activity.xsd"/>
23<xs:include xmlns:xs="http://www.w3.org/2001/XMLSchema" schemaLocation="data.xsd"/>
24<xs:include xmlns:xs="http://www.w3.org/2001/XMLSchema" schemaLocation="quality.xsd"/>
25<xs:include xmlns:xs="http://www.w3.org/2001/XMLSchema" schemaLocation="shared.xsd"/>
26<xs:include xmlns:xs="http://www.w3.org/2001/XMLSchema" schemaLocation="software.xsd"/>
27<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="CustomGridGeometry">
28   <xs:annotation>
29      <xs:documentation>This class may be used to provide a custom, i.e. local and non-standard, description of the grid geometry associated with a geophysical dataset. Use-cases for such a class have, however, yet to be identified and elaborated.</xs:documentation>
30   </xs:annotation>
31                                <xs:complexContent>
32                                <xs:extension base="gml:AbstractGeometryType">
33                            <xs:sequence>
34      <xs:element name="geometrySpec" minOccurs="1" maxOccurs="1" type="xs:string">
35         <xs:annotation>
36            <xs:documentation>This attribute is used to provide a free-text description of a locally-defined custom grid geometry. If serialised in XML format this attribute might contain either plain text, a nested hierarchy of XML elements, or possibly both.</xs:documentation>
37         </xs:annotation>
38      </xs:element>
39   </xs:sequence>
40   <xs:attribute name="id" use="optional" type="Identifier">
41      <xs:annotation>
42         <xs:documentation>The optional id attribute may be used to specify a CIM-specific identifier. Note, however, that this would be in addition to the mandatory gml:id attribute which is required for all GML-style geometry objects. The two attributes may of course be the same, though that would represent redundant usage.</xs:documentation>
43      </xs:annotation>
44   </xs:attribute> 
45                            </xs:extension>
46                            </xs:complexContent>
47                        </xs:complexType>
48<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridCellArray">
49   <xs:annotation>
50      <xs:documentation>Simple data type for encapsulating an array of grid cell definitions.</xs:documentation>
51   </xs:annotation>
52   <xs:sequence>
53      <xs:element name="gridCell" minOccurs="1" maxOccurs="unbounded" type="GridCell"/>
54   </xs:sequence>
55</xs:complexType>
56<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridMosaic">
57   <xs:annotation>
58      <xs:documentation>The GridMosaic class is used to define the geometry properties of an earth system model grid or an exchange grid. Such a grid definition may then be referenced by any number of earth system models. A GridMosaic object consists either of 1 or more child GridMosaics, or one or more child GridTiles, but not both. In the latter case the isLeaf property should be set to true, indicating that the mosaic is a leaf mosaic.</xs:documentation>
59   </xs:annotation>
60   <xs:sequence>
61      <xs:element name="shortName" minOccurs="1" maxOccurs="1" type="xs:string">
62         <xs:annotation>
63            <xs:documentation>Specifies the short name associated with a grid mosaic. The short name will typically be a convenient abbreviation used to refer to a grid mosaic, e.g. 'UM ATM N96'.</xs:documentation>
64         </xs:annotation>
65      </xs:element>
66      <xs:element name="longName" minOccurs="1" maxOccurs="1" type="xs:string">
67         <xs:annotation>
68            <xs:documentation>Specifies the long name associated with a grid mosaic. The long name will typically be a human-readable string, with acronyms expanded, used for labelling purposes.</xs:documentation>
69         </xs:annotation>
70      </xs:element>
71      <xs:element name="description" minOccurs="1" maxOccurs="1" type="xs:string">
72         <xs:annotation>
73            <xs:documentation>A free-text description of a grid mosaic.</xs:documentation>
74         </xs:annotation>
75      </xs:element>
76      <xs:element name="referenceList" minOccurs="0" maxOccurs="1" type="ReferenceList">
77         <xs:annotation>
78            <xs:documentation>Optional container element for specifying a list of references that describe the grid.</xs:documentation>
79         </xs:annotation>
80      </xs:element>
81      <xs:element name="gridMosaic" minOccurs="0" maxOccurs="unbounded" type="GridMosaic"/>
82      <xs:element name="gridTile" minOccurs="0" maxOccurs="unbounded" type="GridTile"/>
83   </xs:sequence>
84   <xs:attribute name="id" use="required" type="Identifier">
85      <xs:annotation>
86         <xs:documentation>Specifies a globally unique identifier for a grid mosaic instance. By globally we mean across all GridSpec instances/records within a given modelling activity (such as CMIP5).</xs:documentation>
87      </xs:annotation>
88   </xs:attribute>
89   <xs:attribute name="gridType" use="required" type="GridTypeEnum">
90      <xs:annotation>
91         <xs:documentation>Specifies the type of all the grid tiles contained in a grid mosaic. It is assumed that all of the tiles comprising a given grid mosaic are of the same type. The value domain is as per the specified enumeration list.</xs:documentation>
92      </xs:annotation>
93   </xs:attribute>
94   <xs:attribute name="congruentTiles" use="required" type="xs:boolean">
95      <xs:annotation>
96         <xs:documentation>Indicates whether or not all the tiles contained within a grid mosaic are congruent, that is, of the same size and shape.</xs:documentation>
97      </xs:annotation>
98   </xs:attribute>
99   <xs:attribute name="isLeaf" use="required" type="xs:boolean">
100      <xs:annotation>
101         <xs:documentation>Indicates whether or not a grid mosaic is a leaf mosaic, that is, it only contains child grid tiles not further mosaics.</xs:documentation>
102      </xs:annotation>
103   </xs:attribute>
104   <xs:attribute name="numTiles" use="optional" type="xs:integer">
105      <xs:annotation>
106         <xs:documentation>Specifies the number of tiles associated with a leaf grid mosaic. Set to zero if the grid mosaic is not a leaf mosaic, i.e. it contains child grid mosaics rather than tiles. (Added to align with equivalent ESG/Curator property.)</xs:documentation>
107      </xs:annotation>
108   </xs:attribute>
109   <xs:attribute name="numMosaics" use="optional" type="xs:integer">
110      <xs:annotation>
111         <xs:documentation>Specifies the number of mosaics associated with a non-leaf grid mosaic. Set to zero if the grid mosaic is a leaf mosaic, i.e. it contains child grid tiles not mosaics.</xs:documentation>
112      </xs:annotation>
113   </xs:attribute>
114</xs:complexType>
115<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="SimpleGridGeometry">
116   <xs:annotation>
117      <xs:documentation>This class may be used to encode the parameters needed to define a simple grid, i.e. a grid based on repeating square or rectangular grid cells.</xs:documentation>
118   </xs:annotation>
119   <xs:sequence>
120      <xs:element name="xcoords" minOccurs="1" maxOccurs="1" type="CoordList">
121         <xs:annotation>
122            <xs:documentation>Specifies the X (or i) coordinate of each 'vertical' grid line making up the grid mesh. For uniform grids (square or rectangular cells), only two X coordinates are required: the X coordinate of the initial grid node, plus the offset or spacing between successive grid nodes.</xs:documentation>
123         </xs:annotation>
124      </xs:element>
125      <xs:element name="ycoords" minOccurs="1" maxOccurs="1" type="CoordList">
126         <xs:annotation>
127            <xs:documentation>Specifies the Y (or j) coordinate of each 'horizontal' grid line making up the grid mesh. For uniform grids (square or rectangular cells), only two Y coordinates are required: the Y coordinate of the initial grid node, plus the offset or spacing between successive grid nodes.</xs:documentation>
128         </xs:annotation>
129      </xs:element>
130      <xs:element name="zcoords" minOccurs="0" maxOccurs="1" type="CoordList">
131         <xs:annotation>
132            <xs:documentation>For 3D grids, specifies the Z coordinates of the grid.</xs:documentation>
133         </xs:annotation>
134      </xs:element>
135   </xs:sequence>
136   <xs:attribute name="numDims" use="required" type="xs:integer">
137      <xs:annotation>
138         <xs:documentation>Specifies the number of dimensions (i.e. the rank) of the grid, e.g. 2 for 2D grids, 3 for 3D grids.</xs:documentation>
139      </xs:annotation>
140   </xs:attribute>
141   <xs:attribute name="dimOrder" use="optional" type="xs:string">
142      <xs:annotation>
143         <xs:documentation>Text string specifying the order in which the coordinate dimensions are traversed. This determines the ordering of grid cells defined by the grid parameters, e.g. row order or column order. The default is "yx" ("zyx" for 3D grids), i.e. row order for logically rectangular grids. This syntax follows CF conventions.</xs:documentation>
144      </xs:annotation>
145   </xs:attribute>
146   <xs:attribute name="isMesh" use="optional" type="xs:boolean">
147      <xs:annotation>
148         <xs:documentation>Set to True if the grid geometry defines a grid mesh that fully partitions a 2D or 3D space. Set to false (the default) if the grid geometry simply defines the locations of grid nodes, making no statement about the shape or extent of surrounding grid cells.</xs:documentation>
149      </xs:annotation>
150   </xs:attribute>
151</xs:complexType>
152<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="UnstructuredGridCell">
153   <xs:annotation>
154      <xs:documentation>This class is used to define grid cells that form the basis of unstructured triangular or polygonal grids, as per the gridspec paper. The grid cell boundary is defined by specifying three or more edges via the edgeArray property. Each edge member of this array is defined by specifying references to the start and end points of the edge.</xs:documentation>
155   </xs:annotation>
156                        <xs:complexContent>
157                        <xs:extension base="GridCell">
158                    <xs:sequence>
159      <xs:element name="edgeArray" minOccurs="1" maxOccurs="1" type="EdgeArray">
160         <xs:annotation>
161            <xs:documentation>The edgeArray attribute is used to specify three or more edges that define the boundary of the grid cell. Each edge member is specified by reference to two remotely-defined grid points. The latter may, for instance, have been defined as part of a SimpleGridCell definition.</xs:documentation>
162         </xs:annotation>
163      </xs:element>
164   </xs:sequence> 
165                            </xs:extension>
166                            </xs:complexContent>
167                        </xs:complexType>
168<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="ArcTypeEnum">
169   <xs:restriction base="xs:string">
170      <xs:enumeration value="geodesic"/>
171      <xs:enumeration value="great_circle"/>
172      <xs:enumeration value="small_circle"/>
173      <xs:enumeration value="complex"/>
174   </xs:restriction>
175</xs:simpleType>
176<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="CustomFeatureGeometry">
177   <xs:annotation>
178      <xs:documentation>This class may be used to provide a custom, i.e. local and non-standard, description of the feature geometry associated with a geophysical dataset. Use-cases for such a class have, however, yet to be identified and elaborated.</xs:documentation>
179   </xs:annotation>
180                                <xs:complexContent>
181                                <xs:extension base="gml:AbstractGeometryType">
182                            <xs:sequence>
183      <xs:element name="geometrySpec" minOccurs="1" maxOccurs="1" type="xs:string">
184         <xs:annotation>
185            <xs:documentation>This attribute is used to provide a free-text description of a locally-defined custom feature geometry. If serialised in XML format this attribute might contain either plain text, a nested hierarchy of XML elements, or possibly both.</xs:documentation>
186         </xs:annotation>
187      </xs:element>
188   </xs:sequence>
189   <xs:attribute name="id" use="optional" type="xs:string">
190      <xs:annotation>
191         <xs:documentation>The optional id attribute may be used to specify a CIM-specific identifier. Note, however, that this would be in addition to the mandatory gml:id attribute which is required for all GML-style geometry objects. The two attributes may of course be the same, though that would represent redundant usage.</xs:documentation>
192      </xs:annotation>
193   </xs:attribute> 
194                            </xs:extension>
195                            </xs:complexContent>
196                        </xs:complexType>
197<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="ExchangeGridCell">
198   <xs:annotation>
199      <xs:documentation>Intended usage is for defining cells in exchange grids. Such cells reference 'parent' grid cells in the two grids partaking in an exchange. The association isn't really a parent-child one, but the name seems to have stuck.</xs:documentation>
200   </xs:annotation>
201                        <xs:complexContent>
202                        <xs:extension base="GridCell">
203                    <xs:sequence>
204      <xs:element name="parentCell" minOccurs="2" maxOccurs="2" type="GridCellRef"/>
205   </xs:sequence> 
206                            </xs:extension>
207                            </xs:complexContent>
208                        </xs:complexType>
209<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="Identification">
210   <xs:sequence>
211      <xs:element name="name" minOccurs="1" maxOccurs="1" type="xs:string"/>
212      <xs:element name="id" minOccurs="1" maxOccurs="1" type="xs:integer"/>
213      <xs:element name="description" minOccurs="1" maxOccurs="1" type="xs:string"/>
214   </xs:sequence>
215</xs:complexType>
216<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="EdgeArray">
217   <xs:annotation>
218      <xs:documentation>Simple data type for encapsulating an array of grid cell edge definitions.</xs:documentation>
219   </xs:annotation>
220   <xs:sequence>
221      <xs:element name="edge" minOccurs="3" maxOccurs="unbounded" type="Edge"/>
222   </xs:sequence>
223</xs:complexType>
224<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GeometryTypeEnum">
225   <xs:restriction base="xs:string">
226      <xs:enumeration value="ellipsoid"/>
227      <xs:enumeration value="plane"/>
228      <xs:enumeration value="sphere"/>
229   </xs:restriction>
230</xs:simpleType>
231<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="VertexArray">
232   <xs:sequence>
233      <xs:element name="vertex" minOccurs="3" maxOccurs="unbounded" type="gml:PointPropertyType"/>
234   </xs:sequence>
235</xs:complexType>
236<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridCellRef">
237   <xs:annotation>
238      <xs:documentation>This data type is used to encode a reference to a grid cell defined as part of some other grid tile, which itself may be part of the same or an entirely separate grid mosaic.
239
240A GridCellRef object consists of a reference to a cell in a separately-defined grid tile, together with an optional fractional area that indicates the portion of the target cell 'occupied' by the referring cell. If this area is not specified, a default value of 1.0 is assumed. A cell reference can be specified either as a sequence of mosaic, tile and cell ID elements, or as a text string attribute (idPath) containing colon-separated ID values terminated with a number representing the fractional area (e.g. "m1:m2:m3:t1:c1:0.5").</xs:documentation>
241   </xs:annotation>
242   <xs:sequence>
243      <xs:element name="mosaicID" minOccurs="0" maxOccurs="unbounded" type="xs:string">
244         <xs:annotation>
245            <xs:documentation>Specifies the ID of a remotely-defined grid mosaic object.</xs:documentation>
246         </xs:annotation>
247      </xs:element>
248      <xs:element name="tileID" minOccurs="0" maxOccurs="1" type="xs:string">
249         <xs:annotation>
250            <xs:documentation>Specifies the ID of a remotely-defined grid tile object</xs:documentation>
251         </xs:annotation>
252      </xs:element>
253      <xs:element name="cellID" minOccurs="0" maxOccurs="1" type="xs:string">
254         <xs:annotation>
255            <xs:documentation>Specifies the ID of a remotely-defined grid cell object</xs:documentation>
256         </xs:annotation>
257      </xs:element>
258      <xs:element name="fractionalArea" minOccurs="0" maxOccurs="1" type="xs:double">
259         <xs:annotation>
260            <xs:documentation>This property is used to indicate that a fractional area of the referenced grid cell is to be used in computations using that grid cell. The actual geometry of the fractional part is not defined. If this property is not specified a default value of 1 is assumed.</xs:documentation>
261         </xs:annotation>
262      </xs:element>
263   </xs:sequence>
264   <xs:attribute name="idPath" use="optional" type="xs:string">
265      <xs:annotation>
266         <xs:documentation>The idPath property may be used as a more compact alternative to specifying a grid cell reference. The value of an idPath string is a colon-separated list comprising 1 or more mosaic IDs, a tile ID, a cell ID, and, optionally, a number representing the fractional part.</xs:documentation>
267      </xs:annotation>
268   </xs:attribute>
269</xs:complexType>
270<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="Edge">
271   <xs:annotation>
272      <xs:documentation>The Edge data type is used to define the topological edge between adjacent (touching) grid cells. </xs:documentation>
273   </xs:annotation>
274   <xs:sequence>
275      <xs:element name="vertex1" minOccurs="1" maxOccurs="1" type="gml:PointPropertyType">
276         <xs:annotation>
277            <xs:documentation>Specifies the position of the first (start) point of the edge.</xs:documentation>
278         </xs:annotation>
279      </xs:element>
280      <xs:element name="vertex2" minOccurs="1" maxOccurs="1" type="gml:PointPropertyType">
281         <xs:annotation>
282            <xs:documentation>Specifies the position of the second (end) point of the edge.</xs:documentation>
283         </xs:annotation>
284      </xs:element>
285      <xs:element name="length" minOccurs="0" maxOccurs="1" type="gml:MeasureType">
286         <xs:annotation>
287            <xs:documentation>Specifies the length of the edge in the units defined using the 'uom' attribute that is attached to the GML MeasureType data type.</xs:documentation>
288         </xs:annotation>
289      </xs:element>
290      <xs:element name="arrivalAngle" minOccurs="0" maxOccurs="1" type="gml:MeasureType"/>
291      <xs:element name="departureAngle" minOccurs="0" maxOccurs="1" type="gml:MeasureType"/>
292   </xs:sequence>
293   <xs:attribute name="arcType" use="required" type="ArcTypeEnum"/>
294</xs:complexType>
295<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="VerticalCSEnum">
296   <xs:restriction base="xs:string">
297      <xs:enumeration value="mass-based"/>
298      <xs:enumeration value="space-based"/>
299   </xs:restriction>
300</xs:simpleType>
301<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridCellRefArray">
302   <xs:annotation>
303      <xs:documentation>Simple data type for encapsulating an array of grid cell reference definitions.</xs:documentation>
304   </xs:annotation>
305   <xs:sequence>
306      <xs:element name="gridCellRef" minOccurs="1" maxOccurs="unbounded" type="GridCellRef"/>
307   </xs:sequence>
308</xs:complexType>
309<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridTypeEnum">
310   <xs:restriction base="xs:string">
311      <xs:enumeration value="cubed_sphere"/>
312      <xs:enumeration value="displaced_pole"/>
313      <xs:enumeration value="icosahedral_geodesic"/>
314      <xs:enumeration value="reduced_gaussian"/>
315      <xs:enumeration value="regular_lat_lon"/>
316      <xs:enumeration value="spectral_gaussian"/>
317      <xs:enumeration value="tripolar"/>
318      <xs:enumeration value="yin_yang"/>
319   </xs:restriction>
320</xs:simpleType>
321<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="HorizontalCSEnum">
322   <xs:restriction base="xs:string">
323      <xs:enumeration value="cartesian"/>
324      <xs:enumeration value="ellipsoidal"/>
325      <xs:enumeration value="polar"/>
326      <xs:enumeration value="spherical"/>
327   </xs:restriction>
328</xs:simpleType>
329<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="ReferenceList">
330   <xs:annotation>
331      <xs:documentation>Simple data type for specifying a list of references.</xs:documentation>
332   </xs:annotation>
333   <xs:sequence>
334      <xs:element name="reference" minOccurs="0" maxOccurs="unbounded" type="xs:string">
335         <xs:annotation>
336            <xs:documentation>A free-text description of a reference / citation.</xs:documentation>
337         </xs:annotation>
338      </xs:element>
339   </xs:sequence>
340</xs:complexType>
341<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridNodePositionEnum">
342   <xs:restriction base="xs:string">
343      <xs:enumeration value="centre"/>
344      <xs:enumeration value="north"/>
345      <xs:enumeration value="northeast"/>
346      <xs:enumeration value="east"/>
347      <xs:enumeration value="southeast"/>
348      <xs:enumeration value="south"/>
349      <xs:enumeration value="southwest"/>
350      <xs:enumeration value="west"/>
351      <xs:enumeration value="northwest"/>
352      <xs:enumeration value="undefined"/>
353   </xs:restriction>
354</xs:simpleType>
355<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="SimpleGridCell">
356   <xs:annotation>
357      <xs:documentation>The SimpleGridCell class is intended to be used to specify a grid cell of arbitrary polygonal shape. The vertices of the grid cell are specified using the vertexArray property, which contains three or more vertex definitions. Since a vertex is declared to be of type GML PointPropertyType, each vertex may be specified either as a coordinate tuple or as an xlink reference to a vertex defined elsewhere. Vertices should be specified as an ordered sequence, i.e. proceeding clockwise or counterclockwise around the perimeter of the grid cell. Clockwise vertex ordering is a common convention.</xs:documentation>
358   </xs:annotation>
359                        <xs:complexContent>
360                        <xs:extension base="GridCell">
361                    <xs:sequence>
362      <xs:element name="vertexArray" minOccurs="1" maxOccurs="1" type="VertexArray">
363         <xs:annotation>
364            <xs:documentation>The vertexArray attribute is used to specify an array of three or more vertices that define the perimeter of the grid cell. Each vertex member of the array may be specified either as a coordinate tuple or as a reference to a vertex defined remotely.</xs:documentation>
365         </xs:annotation>
366      </xs:element>
367   </xs:sequence> 
368                            </xs:extension>
369                            </xs:complexContent>
370                        </xs:complexType>
371<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridTileRef">
372   <xs:annotation>
373      <xs:documentation>This data type is used to encode a reference to a grid tile defined as part of some other grid mosaic, which may itself be part of the same hierarchy of grid mosaics or else part of an entirely separate mosaic (possibly even in a separate physical realisation, e.g. XML file or database table).
374
375A grid tile reference is a list of ID references from the top-level mosaic down to the grid tile itself. A tile reference can be specified either as a sequence of mosaic ID elements and a tile ID element, or as a text string attribute (idPath) containing colon-separated ID values (e.g. "m1:m2:m3:t1").</xs:documentation>
376   </xs:annotation>
377   <xs:sequence>
378      <xs:element name="mosaicID" minOccurs="0" maxOccurs="unbounded" type="xs:string">
379         <xs:annotation>
380            <xs:documentation>Specifies the ID of a remotely-defined grid mosaic object.</xs:documentation>
381         </xs:annotation>
382      </xs:element>
383      <xs:element name="tileID" minOccurs="0" maxOccurs="1" type="xs:string">
384         <xs:annotation>
385            <xs:documentation>Specifies the ID of a remotely-defined grid tile object.</xs:documentation>
386         </xs:annotation>
387      </xs:element>
388   </xs:sequence>
389   <xs:attribute name="idPath" use="optional" type="xs:string">
390      <xs:annotation>
391         <xs:documentation>The idPath property may be used as a more compact alternative to specifying a grid tile reference. The value of an idPath string is a colon-separated list comprising 1 or more mosaic IDs, and a tile ID.</xs:documentation>
392      </xs:annotation>
393   </xs:attribute>
394</xs:complexType>
395<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="DiscretizationEnum">
396   <xs:restriction base="xs:string">
397      <xs:enumeration value="logically_rectangular"/>
398      <xs:enumeration value="structured_triangular"/>
399      <xs:enumeration value="unstructured_triangular"/>
400      <xs:enumeration value="pixel-based_catchment"/>
401      <xs:enumeration value="unstructured_polygonal"/>
402   </xs:restriction>
403</xs:simpleType>
404<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridSpec">
405   <xs:annotation>
406      <xs:documentation>This is a container class for GridSpec objects. A GridSpec object can contain one or more esmModelGrid objects, and one or more esmExchangeGrid objects. These objects may be serialised to one or possibly several files according to taste. Since GridSpec is sub-typed from GML's AbstractGeometryType it can, and should, be identified using a gml:id attribute.</xs:documentation>
407   </xs:annotation>
408                                <xs:complexContent>
409                                <xs:extension base="gml:AbstractGeometryType">
410                            <xs:sequence>
411      <xs:element name="esmExchangeGrid" minOccurs="0" maxOccurs="unbounded" type="GridMosaic"/>
412      <xs:element name="esmModelGrid" minOccurs="0" maxOccurs="unbounded" type="GridMosaic"/>
413   </xs:sequence>
414   <xs:attribute name="id" use="optional" type="Identifier">
415      <xs:annotation>
416         <xs:documentation>The optional id attribute may be used to specify a CIM-specific identifier. Note, however, that this would be in addition to the mandatory gml:id attribute which is required for all GML-style geometry objects. The two attributes may of course be the same, though that would represent redundant usage.</xs:documentation>
417      </xs:annotation>
418   </xs:attribute>
419   <xs:attribute name="version" use="required" type="xs:string">
420      <xs:annotation>
421         <xs:documentation>Indicates the version of the GridSpec standard to which a grid specification instance conforms.</xs:documentation>
422      </xs:annotation>
423   </xs:attribute> 
424                            </xs:extension>
425                            </xs:complexContent>
426                        </xs:complexType>
427<xs:element xmlns:xs="http://www.w3.org/2001/XMLSchema" name="gridSpec">
428   <xs:annotation>
429      <xs:documentation>This is a container class for GridSpec objects. A GridSpec object can contain one or more esmModelGrid objects, and one or more esmExchangeGrid objects. These objects may be serialised to one or possibly several files according to taste. Since GridSpec is sub-typed from GML's AbstractGeometryType it can, and should, be identified using a gml:id attribute.</xs:documentation>
430   </xs:annotation>
431   <xs:complexType>
432      <xs:complexContent>
433         <xs:extension base="GridSpec">
434            <xs:sequence>
435               <xs:element name="documentID" minOccurs="1" maxOccurs="1" type="guid">
436                  <xs:annotation>
437                     <xs:documentation>a unique indentifier for this document</xs:documentation>
438                  </xs:annotation>
439               </xs:element>
440               <xs:element name="documentVersion" minOccurs="1" maxOccurs="1" type="version"/>
441               <xs:element name="metadataID" minOccurs="0" maxOccurs="1" type="xs:anyURI"/>
442               <xs:element name="metadataVersion" minOccurs="0" maxOccurs="1" type="version"/>
443               <xs:element name="externalID" minOccurs="0" maxOccurs="unbounded" type="StandardName">
444                  <xs:annotation>
445                     <xs:documentation>The id of this document as referenced by an external body (ie: DOI, or even IPSL)</xs:documentation>
446                  </xs:annotation>
447               </xs:element>
448               <xs:element name="documentAuthor" minOccurs="0" maxOccurs="1" type="ResponsibleParty">
449                  <xs:annotation>
450                     <xs:documentation>A contact for the author of this <i>document </i>(as opposed to the author of the artifact being described by this document; ie: the simulation or component or whatever).</xs:documentation>
451                  </xs:annotation>
452               </xs:element>
453               <xs:element name="documentCreationDate" minOccurs="1" maxOccurs="1" type="xs:dateTime">
454                  <xs:annotation>
455                     <xs:documentation>The date the <i>document </i>was created.</xs:documentation>
456                  </xs:annotation>
457               </xs:element>
458               <xs:element name="documentGenealogy" minOccurs="0" maxOccurs="1" type="Genealogy">
459                  <xs:annotation>
460                     <xs:documentation>Specifies the relationship of this document with another document. Various relationship types (depending on the type of document; ie: simulation, component, etc.) are supported.</xs:documentation>
461                  </xs:annotation>
462               </xs:element>
463               <xs:element name="quality" minOccurs="0" maxOccurs="unbounded" type="Quality">
464                  <xs:annotation>
465                     <xs:documentation>a (set of) quality record(s) for this document.</xs:documentation>
466                  </xs:annotation>
467               </xs:element>
468            </xs:sequence>
469            <xs:attribute name="documentStatus" use="optional" type="DocumentStatusType"/>
470         </xs:extension>
471      </xs:complexContent>
472   </xs:complexType>
473</xs:element>
474<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="CoordList">
475   <xs:annotation>
476      <xs:documentation>The CoordList type may be used to specify a list of coordinates, typically for the purpose of defining coordinates along the X, Y or Z axes. The length of the coordinate list is given by the attribute of that name. This may be used by software to allocate memory in advance of storing the coordinate values. The hasConstantOffset attribute may be used to indicate that the coordinate list consists of values with constant offset (spacing). In this case only the first coordinate value and the offset (spacing) value need to be specified; however, the length attribute must still define the final 'as-built' size of the coordinate list.</xs:documentation>
477   </xs:annotation>
478                                <xs:simpleContent>
479                                <xs:extension base="xs:string">
480                            <xs:attribute name="length" use="required" type="xs:integer">
481      <xs:annotation>
482         <xs:documentation>Specifies the length of the coordinate array. This should always be the final, as-built length of the array if the hasConstantOffset property is set to true and the compact notation (start coordinate plus offset) is used.</xs:documentation>
483      </xs:annotation>
484   </xs:attribute>
485   <xs:attribute name="hasConstantOffset" use="required" type="xs:boolean">
486      <xs:annotation>
487         <xs:documentation>Set to true if coordinates in the built array have constant offset.</xs:documentation>
488      </xs:annotation>
489   </xs:attribute>
490   <xs:attribute name="uom" use="required" type="xs:string">
491      <xs:annotation>
492         <xs:documentation>Units of measure used by the coordinates.</xs:documentation>
493      </xs:annotation>
494   </xs:attribute> 
495                            </xs:extension>
496                            </xs:simpleContent>
497                        </xs:complexType>
498<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="ContactTypeEnum">
499   <xs:restriction base="xs:string">
500      <xs:enumeration value="boundary"/>
501      <xs:enumeration value="overlap"/>
502   </xs:restriction>
503</xs:simpleType>
504<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="FeatureTypeEnum">
505   <xs:restriction base="xs:string">
506      <xs:enumeration value="point"/>
507      <xs:enumeration value="edge"/>
508   </xs:restriction>
509</xs:simpleType>
510<xs:simpleType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="RefinementTypeEnum">
511   <xs:restriction base="xs:string">
512      <xs:enumeration value="none">
513         <xs:annotation>
514            <xs:documentation>Tile boundaries have no refinement when the grid lines meeting at the tile boundary are continuous.</xs:documentation>
515         </xs:annotation>
516      </xs:enumeration>
517      <xs:enumeration value="integer">
518         <xs:annotation>
519            <xs:documentation>The refinement is integer when grid lines from the coarser grid are continuous on the finer grid, but not vice versa.</xs:documentation>
520         </xs:annotation>
521      </xs:enumeration>
522      <xs:enumeration value="rational">
523         <xs:annotation>
524            <xs:documentation>The refinement is rational when the adjacent or overlapping grid tiles have grid line counts that are coprime (i.e. no common factor other than 1).</xs:documentation>
525         </xs:annotation>
526      </xs:enumeration>
527   </xs:restriction>
528</xs:simpleType>
529<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridTile">
530   <xs:annotation>
531      <xs:documentation>The GridTile class is used to model an individual grid tile contained within a grid mosaic. A GridTile consists of an array of grid cells which may be defined in one of four ways: 1) for simple grids, by use of the SimpleGridGeometry data type; 2) by defining an array of GridCell objects; 3) by specifying an array of references to externally defined GridCell objects; or 4) by specifying a URI to a remote data file containing the grid cell definitions.
532
533For all but the simplest grid tiles, it is envisaged that method 4 above will be the most frequently used option. However, it should be remembered that the CIM is primarily concerned with encoding climate model metadata. Specifying the coordinates of individual grid tiles and cells will most likely not be required as part of such metadata descriptions.
534
535A GridTile object is associated with a geodetic or projected CRS via the horizontalCRS property, and with a vertical CRS via the verticalCRS property.</xs:documentation>
536   </xs:annotation>
537   <xs:sequence>
538      <xs:element name="shortName" minOccurs="1" maxOccurs="1" type="xs:string">
539         <xs:annotation>
540            <xs:documentation>Specifies the short name associated with a grid tile. The short name will typically be a convenient abbreviation used to refer to a grid tile, e.g. 'NEMO T-Grid'.</xs:documentation>
541         </xs:annotation>
542      </xs:element>
543      <xs:element name="longName" minOccurs="1" maxOccurs="1" type="xs:string">
544         <xs:annotation>
545            <xs:documentation>Specifies the long name associated with a grid tile. The long name will typically be a human-readable string, with acronyms expanded, used for labelling purposes.</xs:documentation>
546         </xs:annotation>
547      </xs:element>
548      <xs:element name="description" minOccurs="1" maxOccurs="1" type="xs:string">
549         <xs:annotation>
550            <xs:documentation>A free-text description of a grid tile.</xs:documentation>
551         </xs:annotation>
552      </xs:element>
553      <xs:element name="horizontalResolution" minOccurs="0" maxOccurs="1" type="xs:string">
554         <xs:annotation>
555            <xs:documentation>Provides an indication of the approximate spatial sampling size of the grid tile, i.e. the size of the underlying grid cells. (Note: the maximum spatial resolution of the grid is twice the sampling size (e.g. 2 km for a 1 km x 1 km grid pitch).</xs:documentation>
556         </xs:annotation>
557      </xs:element>
558      <xs:element name="verticalResolution" minOccurs="0" maxOccurs="1" type="xs:string">
559         <xs:annotation>
560            <xs:documentation>Provides an indication of the approximate resolution of the grid tile in the vertical dimension. (Added to align with corresponding ESG/Curator and DIF property).</xs:documentation>
561         </xs:annotation>
562      </xs:element>
563      <xs:element name="area" minOccurs="0" maxOccurs="1" type="gml:MeasureType">
564         <xs:annotation>
565            <xs:documentation>Specifies the area of the grid tile in the units defined by the 'uom' attribute that is attached to the GML MeasureType data type.</xs:documentation>
566         </xs:annotation>
567      </xs:element>
568      <xs:element name="gridNorthPole" minOccurs="0" maxOccurs="1" type="gml:PointPropertyType">
569         <xs:annotation>
570            <xs:documentation>If required, defines the lat-long position of the 'north pole' used by the grid tile in the case of rotated/displaced pole grids. Not to be confused with the coordinatePole property.</xs:documentation>
571         </xs:annotation>
572      </xs:element>
573      <xs:element name="coordinatePole" minOccurs="0" maxOccurs="unbounded"
574                  type="gml:PointPropertyType">
575         <xs:annotation>
576            <xs:documentation>The coordinatePole property may be used to specify the lat-long position of any coordinate poles (in the mathematical sense) that form part of the definition of a grid tile. Not to be confused with the gridNorthPole property.
577
578If required, two or more coordinate pole definitions may be distinguished by setting the gml:id attribute to appropriate values, such as "spole", "npole", etc.</xs:documentation>
579         </xs:annotation>
580      </xs:element>
581      <xs:element name="horizontalCRS" minOccurs="0" maxOccurs="1" type="gml:CRSPropertyType">
582         <xs:annotation>
583            <xs:documentation>Specifies the horizontal coordinate reference system used in the definition of the grid tile coordinates. This property should normally be an xlink reference to an external horizontal CRS definition (e.g. in a separate CRS dictionary). If required, however, the property may be defined in situ within a CIM document.</xs:documentation>
584         </xs:annotation>
585      </xs:element>
586      <xs:element name="verticalCRS" minOccurs="0" maxOccurs="1" type="gml:CRSPropertyType">
587         <xs:annotation>
588            <xs:documentation>Specifies the vertical coordinate reference system used in the definition of the grid tile coordinates. This property should normally be an xlink reference to an external vertical CRS definition (e.g. in a separate CRS dictionary). If required, however, the property may be defined in situ within a CIM document.</xs:documentation>
589         </xs:annotation>
590      </xs:element>
591      <xs:element name="simpleGridGeom" minOccurs="0" maxOccurs="1" type="SimpleGridGeometry">
592         <xs:annotation>
593            <xs:documentation>This property may be used to define the coordinates of the nodes or cells making up a simple (i.e. uniform or regular) grid tile. More details are provided in the description of the SimpleGridGeometry data type.</xs:documentation>
594         </xs:annotation>
595      </xs:element>
596      <xs:element name="cellArray" minOccurs="0" maxOccurs="1" type="GridCellArray">
597         <xs:annotation>
598            <xs:documentation>This property may be used to specify an array of grid cell definitions which together define the coordinate geometry of a grid tile. Depending on context, any of the existing sub-types of GridCell may be used. Mixing types is, however, not currently permitted.</xs:documentation>
599         </xs:annotation>
600      </xs:element>
601      <xs:element name="cellRefArray" minOccurs="0" maxOccurs="1" type="GridCellRefArray">
602         <xs:annotation>
603            <xs:documentation>This property may be used to define the coordinate geometry of a grid tile by specifying an array of references to remotely defined grid cells. Depending on context, any of the existing sub-types of GridCell may be referenced.</xs:documentation>
604         </xs:annotation>
605      </xs:element>
606      <xs:element name="coordFile" minOccurs="0" maxOccurs="1" type="xs:string">
607         <xs:annotation>
608            <xs:documentation>This property may be used to specify the URI of a file containing grid coordinates that define the geometry of a a grid tile. It is envisaged that this will be the preferred mechanism for specifying the geometry of complex grids.</xs:documentation>
609         </xs:annotation>
610      </xs:element>
611      <xs:element name="zcoords" minOccurs="0" maxOccurs="1" type="CoordList">
612         <xs:annotation>
613            <xs:documentation>This optional property may be used to specify the vertical coordinates (e.g. heights or model levels) at which a grid tile is utilised or realised. In the case of simple grid tiles the equivalent zcoords property on the SimpleGridGeometry data type would be used instead. The current property is intended to be used when the horizontal grid coordinates are defined by one of the other methods.</xs:documentation>
614         </xs:annotation>
615      </xs:element>
616   </xs:sequence>
617   <xs:attribute name="id" use="required" type="Identifier">
618      <xs:annotation>
619         <xs:documentation>Specifies an identifer for a grid tile that is unique within its parent grid mosaic. It is not required for this identifier to be unique either across all mosaics in a GridSpec or across all GridSpecs, though if that were the case it would not be detrimental.</xs:documentation>
620      </xs:annotation>
621   </xs:attribute>
622   <xs:attribute name="discretizationType" use="required" type="DiscretizationEnum">
623      <xs:annotation>
624         <xs:documentation>Indicates the type of discretization applied to the grid tile, e.g. "logically_rectangular".</xs:documentation>
625      </xs:annotation>
626   </xs:attribute>
627   <xs:attribute name="geometryType" use="required" type="GeometryTypeEnum">
628      <xs:annotation>
629         <xs:documentation>Indicates the geometric figure used to approximate the figure of the Earth, e.g. "sphere".</xs:documentation>
630      </xs:annotation>
631   </xs:attribute>
632   <xs:attribute name="isUniform" use="required" type="xs:boolean">
633      <xs:annotation>
634         <xs:documentation>If true, indicates that horizontal coordinates have fixed offsets in the X and Y directions. If the offset is the same in both directions then the grids are logically square, otherwise they are logically rectangular. The offsets can be specified by two scalar values (or three values in the case of 3D grids).</xs:documentation>
635      </xs:annotation>
636   </xs:attribute>
637   <xs:attribute name="isRegular" use="required" type="xs:boolean">
638      <xs:annotation>
639         <xs:documentation>If true, indicates that the horizontal coordinates of the grid can be defined using 1D arrays (vectors). This means that grid node locations are defined by the cartesian product of the X/Lon and Y/Lat coordinate vectors. It also means that grid cells are logically rectangular (they may also be physically rectangular in the case of projected coordinates).</xs:documentation>
640      </xs:annotation>
641   </xs:attribute>
642   <xs:attribute name="isConformal" use="optional" type="xs:boolean">
643      <xs:annotation>
644         <xs:documentation>This property is used to indicate if the grid tile is conformal, i.e. angle-preserving. If so, angles measured on the grid are equal to the equivalent angles on the Earth.</xs:documentation>
645      </xs:annotation>
646   </xs:attribute>
647   <xs:attribute name="isTerrainFollowing" use="optional" type="xs:boolean">
648      <xs:annotation>
649         <xs:documentation>Set to true if the vertical coordinate system is terrain-following even if, as is often the case, this only applies to the lower levels of the grid.</xs:documentation>
650      </xs:annotation>
651   </xs:attribute>
652   <xs:attribute name="nx" use="required" type="xs:integer">
653      <xs:annotation>
654         <xs:documentation>Specifies the length of the X, or longitude, dimension of the grid tile.</xs:documentation>
655      </xs:annotation>
656   </xs:attribute>
657   <xs:attribute name="ny" use="required" type="xs:integer">
658      <xs:annotation>
659         <xs:documentation>Specifies the length of the Y, or latitude, dimension of the grid tile.</xs:documentation>
660      </xs:annotation>
661   </xs:attribute>
662   <xs:attribute name="nz" use="required" type="xs:integer">
663      <xs:annotation>
664         <xs:documentation>Specifies the length of the Z, or height/level, dimension of the grid tile. The zcoords coordinate list property, if specified, should have this length.</xs:documentation>
665      </xs:annotation>
666   </xs:attribute>
667</xs:complexType>
668<xs:complexType xmlns:xs="http://www.w3.org/2001/XMLSchema" name="GridCell">
669   <xs:annotation>
670      <xs:documentation>This abstract base class is used to model various types of grid cells. Every GridCell object has its boundary defined by at least 3 vertices, though 4 will probably be more typical. Vertices are either defined directly (e.g. in the case of a SimpleGridCell object), or indirectly by referencing a remote grid cell (in the case of an ExchangeGridCell object).</xs:documentation>
671   </xs:annotation>
672   <xs:sequence>
673      <xs:element name="centroid" minOccurs="0" maxOccurs="1" type="gml:PointPropertyType">
674         <xs:annotation>
675            <xs:documentation>Optionally specifies the coordinate location of the centroid of a grid cell.</xs:documentation>
676         </xs:annotation>
677      </xs:element>
678      <xs:element name="area" minOccurs="0" maxOccurs="1" type="gml:MeasureType">
679         <xs:annotation>
680            <xs:documentation>Optionally specifies the area of a 2D grid cell (or the footprint of a 3D grid cell). The units used must be specified via the 'uom' attribute associated with GML's MeasureType class.</xs:documentation>
681         </xs:annotation>
682      </xs:element>
683      <xs:element name="volume" minOccurs="0" maxOccurs="1" type="gml:MeasureType">
684         <xs:annotation>
685            <xs:documentation>Optionally specifies the volume of a 3D grid cell.The units used must be specified via the 'uom' attribute associated with GML's MeasureType class.</xs:documentation>
686         </xs:annotation>
687      </xs:element>
688   </xs:sequence>
689   <xs:attribute name="id" use="required" type="Identifier">
690      <xs:annotation>
691         <xs:documentation>Specifies an identifer that uniquely identifies a cell within its parent grid tile.</xs:documentation>
692      </xs:annotation>
693   </xs:attribute>
694</xs:complexType>       
695</xs:schema>
Note: See TracBrowser for help on using the repository browser.