<?xml version="1.0" encoding="UTF-8"?>
<!--
/******************************************************************************
 * Project:  GDAL/OGR
 * Purpose:  XML Schema for OGR VRT files.
 * Author:   Even Rouault, <even dot rouault at spatialys.com>
 *
 **********************************************************************
 * Copyright (c) 2012, Even Rouault
 *
 * SPDX-License-Identifier: MIT
 ****************************************************************************/
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" version="1.0">
    <xs:element name="OGRVRTDataSource">
        <xs:complexType>
            <xs:sequence>
                <xs:choice minOccurs="0" maxOccurs="unbounded">
                    <xs:element name="Metadata" type="MetadataType"/> <!-- may be repeated -->
                    <xs:element name="OGRVRTLayer" type="OGRVRTLayerType"/>
                    <xs:element name="OGRVRTWarpedLayer" type="OGRVRTWarpedLayerType"/>
                    <xs:element name="OGRVRTUnionLayer" type="OGRVRTUnionLayerType"/>
                </xs:choice>
            </xs:sequence>
        </xs:complexType>
    </xs:element>

    <xs:complexType name="MetadataType">
        <xs:sequence>
            <!--<xs:choice>-->
                <!--<xs:element name="MDI" type="MDIType" minOccurs="0" maxOccurs="unbounded"/>-->
                <xs:any processContents="skip" minOccurs="0" maxOccurs="unbounded"/>
            <!--</xs:choice>-->
        </xs:sequence>
        <xs:attribute name="domain" type="xs:string"/>
        <xs:attribute name="format" type="xs:string"/>
    </xs:complexType>

    <xs:complexType name="OGRVRTLayerType">
        <xs:sequence>
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element name="Metadata" type="MetadataType"/> <!-- may be repeated -->
                <xs:element name="SrcDataSource" type="SrcDataSourceType">
                    <xs:annotation>
                        <xs:documentation>Required element</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="OpenOptions" type="OpenOptionsType">
                    <xs:annotation>
                        <xs:documentation>Optional element</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="SrcLayer" type="nonEmptyStringType">
                    <xs:annotation>
                        <xs:documentation>SrcLayer or(eclusive) SrcSQL are required elements</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="SrcSQL">
                    <xs:complexType>
                        <xs:simpleContent>
                            <xs:extension base="nonEmptyStringType">
                                <xs:attribute name="dialect" type="nonEmptyStringType"/>
                            </xs:extension>
                        </xs:simpleContent>
                    </xs:complexType>
                </xs:element>
                <xs:element name="FID" type="FIDType"/>
                <xs:element name="Style" type="nonEmptyStringType"/>
                <xs:element name="GeometryType" type="GeometryTypeType">
                    <xs:annotation>
                        <xs:documentation>Use GeometryField.GeometryType for multi-geometry field support.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="LayerSRS" type="nonEmptyStringType">
                    <xs:annotation>
                        <xs:documentation>Use GeometryField.SRS for multi-geometry field support.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="Field" type="FieldType">
                    <xs:annotation>
                        <xs:documentation>May be repeated</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="GeometryField" type="GeometryFieldType">
                    <xs:annotation>
                        <xs:documentation>May be repeated</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="SrcRegion" type="SrcRegionType">
                    <xs:annotation>
                        <xs:documentation>Use GeometryField.SrcRegion for multi-geometry field support.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="attrFilterPassThrough" type="OGRBooleanType">
                    <xs:annotation>
                        <xs:documentation>Default to FALSE.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="FeatureCount" type="xs:integer"/>
                <xs:group ref="ExtentType">
                    <xs:annotation>
                        <xs:documentation>Use GeometryField.ExtentXMin, etc... for multi-geometry field support.</xs:documentation>
                    </xs:annotation>
                </xs:group>
            </xs:choice>
        </xs:sequence>
        <xs:attribute name="name" type="nonEmptyStringType" use="required"/>
    </xs:complexType>

    <xs:complexType name="OpenOptionsType">
        <xs:sequence>
            <xs:element name="OOI" type="OOIType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="OOIType">
        <xs:simpleContent>
            <xs:extension base="nonEmptyStringType">
                <xs:attribute name="key" type="xs:string"/>
            </xs:extension>
        </xs:simpleContent>
    </xs:complexType>

    <xs:complexType name="FIDType">
        <xs:simpleContent>
            <xs:extension base="xs:string">
                <xs:attribute name="name" type="xs:string">
                    <xs:annotation>
                        <xs:documentation>User-facing name of the FID column.</xs:documentation>
                    </xs:annotation>
                </xs:attribute>
            </xs:extension>
        </xs:simpleContent>
    </xs:complexType>

    <xs:group name="ExtentType">
        <xs:sequence>
            <xs:element name="ExtentXMin" type="xs:double" minOccurs="1" maxOccurs="1"/>
            <xs:element name="ExtentYMin" type="xs:double" minOccurs="1" maxOccurs="1"/>
            <xs:element name="ExtentXMax" type="xs:double" minOccurs="1" maxOccurs="1"/>
            <xs:element name="ExtentYMax" type="xs:double" minOccurs="1" maxOccurs="1"/>
        </xs:sequence>
    </xs:group>

    <xs:complexType name="SrcDataSourceType">
        <xs:simpleContent>
            <xs:extension base="nonEmptyStringType">
                <xs:attribute name="relativeToVRT" type="OGRBooleanType" default="FALSE">
                    <xs:annotation>
                        <xs:documentation>Default to FALSE.</xs:documentation>
                    </xs:annotation>
                </xs:attribute>
                <!-- alternate case -->
                <xs:attribute name="relativetoVRT" type="OGRBooleanType" default="FALSE">
                    <xs:annotation>
                        <xs:documentation>Default to FALSE.</xs:documentation>
                    </xs:annotation>
                </xs:attribute>
                <xs:attribute name="shared" type="OGRBooleanType"/>
            </xs:extension>
        </xs:simpleContent>
    </xs:complexType>

    <xs:simpleType name="nonEmptyStringType">
        <xs:restriction base="xs:string">
            <xs:minLength value="1"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="GeometryTypeType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="wkbNone"/>
            <xs:enumeration value="wkbUnknown"/>
            <xs:enumeration value="wkbPoint"/>
            <xs:enumeration value="wkbLineString"/>
            <xs:enumeration value="wkbPolygon"/>
            <xs:enumeration value="wkbMultiPoint"/>
            <xs:enumeration value="wkbMultiLineString"/>
            <xs:enumeration value="wkbMultiPolygon"/>
            <xs:enumeration value="wkbGeometryCollection"/>
            <xs:enumeration value="wkbCircularString"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbCompoundCurve"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbCurvePolygon"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbMultiCurve"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbMultiSurface"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbCurve"/> <!-- new in GDAL 2.1 -->
            <xs:enumeration value="wkbSurface"/> <!-- new in GDAL 2.1 -->
            <xs:enumeration value="wkbUnknown25D"/>
            <xs:enumeration value="wkbPoint25D"/>
            <xs:enumeration value="wkbLineString25D"/>
            <xs:enumeration value="wkbPolygon25D"/>
            <xs:enumeration value="wkbMultiPoint25D"/>
            <xs:enumeration value="wkbMultiLineString25D"/>
            <xs:enumeration value="wkbMultiPolygon25D"/>
            <xs:enumeration value="wkbGeometryCollection25D"/>
            <xs:enumeration value="wkbCircularStringZ"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbCompoundCurveZ"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbCurvePolygonZ"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbMultiCurveZ"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbMultiSurfaceZ"/> <!-- new in GDAL 2.0 -->
            <xs:enumeration value="wkbCurveZ"/> <!-- new in GDAL 2.1 -->
            <xs:enumeration value="wkbSurfaceZ"/> <!-- new in GDAL 2.1 -->

            <!-- below is new in GDAL 2.1 -->
            <xs:enumeration value="wkbPointM"/>
            <xs:enumeration value="wkbLineStringM"/>
            <xs:enumeration value="wkbPolygonM"/>
            <xs:enumeration value="wkbMultiPointM"/>
            <xs:enumeration value="wkbMultiLineStringM"/>
            <xs:enumeration value="wkbMultiPolygonM"/>
            <xs:enumeration value="wkbGeometryCollectionM"/>
            <xs:enumeration value="wkbCircularStringM"/>
            <xs:enumeration value="wkbCompoundCurveM"/>
            <xs:enumeration value="wkbCurvePolygonM"/>
            <xs:enumeration value="wkbMultiCurveM"/>
            <xs:enumeration value="wkbMultiSurfaceM"/>
            <xs:enumeration value="wkbCurveM"/>
            <xs:enumeration value="wkbSurfaceM"/>

            <xs:enumeration value="wkbPointZM"/>
            <xs:enumeration value="wkbLineStringZM"/>
            <xs:enumeration value="wkbPolygonZM"/>
            <xs:enumeration value="wkbMultiPointZM"/>
            <xs:enumeration value="wkbMultiLineStringZM"/>
            <xs:enumeration value="wkbMultiPolygonZM"/>
            <xs:enumeration value="wkbGeometryCollectionZM"/>
            <xs:enumeration value="wkbCircularStringZM"/>
            <xs:enumeration value="wkbCompoundCurveZM"/>
            <xs:enumeration value="wkbCurvePolygonZM"/>
            <xs:enumeration value="wkbMultiCurveZM"/>
            <xs:enumeration value="wkbMultiSurfaceZM"/>
            <xs:enumeration value="wkbCurveZM"/>
            <xs:enumeration value="wkbSurfaceZM"/>

            <!-- below is new in GDAL 2.2 -->
            <xs:enumeration value="wkbPolyhedralSurface"/>
            <xs:enumeration value="wkbTIN"/>
            <xs:enumeration value="wkbTriangle"/>
            <xs:enumeration value="wkbPolyhedralSurfaceZ"/>
            <xs:enumeration value="wkbTINZ"/>
            <xs:enumeration value="wkbTriangleZ"/>
            <xs:enumeration value="wkbPolyhedralSurfaceM"/>
            <xs:enumeration value="wkbTINM"/>
            <xs:enumeration value="wkbTriangleM"/>
            <xs:enumeration value="wkbPolyhedralSurfaceZM"/>
            <xs:enumeration value="wkbTINZM"/>
            <xs:enumeration value="wkbTriangleZM"/>

        </xs:restriction>
    </xs:simpleType>

    <xs:complexType name="FieldTypeWithoutSrc">
        <xs:attribute name="name" type="nonEmptyStringType" use="required"/>
        <xs:attribute name="type" type="OGRFieldTypeType" default="String"/>
        <xs:attribute name="subtype" type="OGRFieldSubTypeType" default="None"/>  <!-- new in GDAL 2.0 -->
        <xs:attribute name="width" type="xs:nonNegativeInteger"/>
        <xs:attribute name="precision" type="xs:nonNegativeInteger"/>
        <xs:attribute name="nullable" type="OGRBooleanType" default="true"/>  <!-- new in GDAL 2.0 -->
        <xs:attribute name="default" type="xs:string"/>  <!-- new in GDAL 2.0 -->
        <xs:attribute name="unique" type="OGRBooleanType" default="false"/>  <!-- new in GDAL 3.2 -->
        <xs:attribute name="alternativeName" type="xs:string"/>  <!-- new in GDAL 3.7 -->
        <xs:attribute name="comment" type="xs:string"/>  <!-- new in GDAL 3.7 -->
    </xs:complexType>

    <xs:complexType name="FieldType">
        <xs:complexContent>
            <xs:extension base="FieldTypeWithoutSrc">
                <xs:attribute name="src" type="nonEmptyStringType">
                    <xs:annotation>
                        <xs:documentation>Defaults to the value of "name" if not specified.</xs:documentation>
                    </xs:annotation>
                </xs:attribute>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>

    <xs:simpleType name="OGRFieldTypeType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="Integer"/>
            <xs:enumeration value="integer"/>
            <xs:enumeration value="Integer64"/>
            <xs:enumeration value="integer64"/>
            <xs:enumeration value="Real"/>
            <xs:enumeration value="real"/>
            <xs:enumeration value="String"/>
            <xs:enumeration value="string"/>
            <xs:enumeration value="IntegerList"/>
            <xs:enumeration value="integerlist"/>
            <xs:enumeration value="Integer64List"/>
            <xs:enumeration value="integer64list"/>
            <xs:enumeration value="RealList"/>
            <xs:enumeration value="reallist"/>
            <xs:enumeration value="StringList"/>
            <xs:enumeration value="stringlist"/>
            <xs:enumeration value="Binary"/>
            <xs:enumeration value="binary"/>
            <xs:enumeration value="Date"/>
            <xs:enumeration value="date"/>
            <xs:enumeration value="Time"/>
            <xs:enumeration value="time"/>
            <xs:enumeration value="DateTime"/>
            <xs:enumeration value="datetime"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="OGRFieldSubTypeType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="None"/>
            <xs:enumeration value="Boolean"/>
            <xs:enumeration value="Int16"/>
            <xs:enumeration value="Float32"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="EncodingType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="Direct"/>
            <xs:enumeration value="None"/>
            <xs:enumeration value="WKT"/>
            <xs:enumeration value="WKB"/>
            <xs:enumeration value="Shape"/>
            <xs:enumeration value="shape"/>
            <xs:enumeration value="PointFromColumns"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:attributeGroup name="GeometryFieldTypeAttrGroupWithoutSrc">
        <xs:attribute name="encoding" type="EncodingType">
            <xs:annotation>
                <xs:documentation>Defaults to Direct.</xs:documentation>
            </xs:annotation>
        </xs:attribute>
        <xs:attribute name="name" type="xs:string">
            <xs:annotation>
                <xs:documentation>Name of the geometry field</xs:documentation>
            </xs:annotation>
        </xs:attribute>
        <xs:attribute name="x" type="nonEmptyStringType">
            <xs:annotation>
                <xs:documentation>Only used if encoding = "PointFromColumns"</xs:documentation>
            </xs:annotation>
        </xs:attribute>
        <xs:attribute name="y" type="nonEmptyStringType">
            <xs:annotation>
                <xs:documentation>Only used if encoding = "PointFromColumns"</xs:documentation>
            </xs:annotation>
        </xs:attribute>
        <xs:attribute name="z" type="nonEmptyStringType">
            <xs:annotation>
                <xs:documentation>Only used if encoding = "PointFromColumns"</xs:documentation>
            </xs:annotation>
        </xs:attribute>
        <xs:attribute name="m" type="nonEmptyStringType">
            <xs:annotation>
                <xs:documentation>Only used if encoding = "PointFromColumns"</xs:documentation>
            </xs:annotation>
        </xs:attribute>
        <xs:attribute name="useSpatialSubquery" type="OGRBooleanType">
            <xs:annotation>
                <xs:documentation>Only used if encoding = "PointFromColumns". Defaults to TRUE.</xs:documentation>
            </xs:annotation>
        </xs:attribute>
        <xs:attribute name="reportSrcColumn" type="OGRBooleanType">
            <xs:annotation>
                <xs:documentation>Only used if no Field element is found at the OGRVRTLayer level</xs:documentation>
            </xs:annotation>
        </xs:attribute>
        <xs:attribute name="nullable" type="OGRBooleanType" default="true"/>  <!-- new in GDAL 2.0 -->
    </xs:attributeGroup>

    <xs:complexType name="GeometryFieldTypeWithoutSrc">
        <xs:sequence>
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element name="GeometryType" type="GeometryTypeType"/>
                <xs:element name="SrcRegion" type="SrcRegionType"/>
                <xs:element name="SRS" type="nonEmptyStringType"/>
                <xs:group ref="ExtentType"/>
                <xs:element name="XYResolution" type="xs:double" minOccurs="0" maxOccurs="1"/>
                <xs:element name="ZResolution" type="xs:double" minOccurs="0" maxOccurs="1"/>
                <xs:element name="MResolution" type="xs:double" minOccurs="0" maxOccurs="1"/>
            </xs:choice>
        </xs:sequence>
        <xs:attributeGroup ref="GeometryFieldTypeAttrGroupWithoutSrc"/>
    </xs:complexType>

    <xs:complexType name="GeometryFieldType">
        <xs:complexContent>
            <xs:extension base="GeometryFieldTypeWithoutSrc">
                <xs:attribute name="field" type="nonEmptyStringType">
                    <xs:annotation>
                        <xs:documentation>Used if encoding = "WKT", "WKB" or "Shape" to find
                        the attribute field of the source layer.
                        Used also in multiple geometry fields scenario to retrieve the
                        source geometry field matching the target VRT geometry field.</xs:documentation>
                    </xs:annotation>
                </xs:attribute>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>

    <xs:complexType name="SrcRegionType">
        <xs:simpleContent>
            <xs:extension base="PolygonOrMultiPolygonWKTType">
                <xs:attribute name="clip" type="OGRBooleanType">
                    <xs:annotation>
                        <xs:documentation>Defaults to FALSE.</xs:documentation>
                    </xs:annotation>
                </xs:attribute>
            </xs:extension>
        </xs:simpleContent>
    </xs:complexType>

    <xs:simpleType name="PolygonOrMultiPolygonWKTType">
        <xs:annotation>
            <xs:documentation>A valid WKT for a POLYGON or a MULTIPOLYGON</xs:documentation>
        </xs:annotation>
        <xs:restriction base="xs:string">
            <xs:pattern value="(MULTI)?POLYGON.*"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="OGRBooleanType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="1"/>
            <xs:enumeration value="0"/>
            <xs:enumeration value="ON"/>
            <xs:enumeration value="OFF"/>
            <xs:enumeration value="on"/>
            <xs:enumeration value="off"/>
            <xs:enumeration value="YES"/>
            <xs:enumeration value="NO"/>
            <xs:enumeration value="yes"/>
            <xs:enumeration value="no"/>
            <xs:enumeration value="TRUE"/>
            <xs:enumeration value="FALSE"/>
            <xs:enumeration value="true"/>
            <xs:enumeration value="false"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:complexType name="OGRVRTWarpedLayerType">
        <xs:sequence>
            <xs:choice minOccurs="1" maxOccurs="1">
                <xs:element name="OGRVRTLayer" type="OGRVRTLayerType"/>
                <xs:element name="OGRVRTWarpedLayer" type="OGRVRTWarpedLayerType"/>
                <xs:element name="OGRVRTUnionLayer" type="OGRVRTUnionLayerType"/>
            </xs:choice>
            <xs:element name="WarpedGeomFieldName" type="nonEmptyStringType" minOccurs="0" maxOccurs="1"/>
            <xs:element name="SrcSRS" type="nonEmptyStringType" minOccurs="0" maxOccurs="1"/>
            <xs:element name="TargetSRS" type="nonEmptyStringType" minOccurs="1" maxOccurs="1"/>
            <xs:group ref="ExtentType" minOccurs="0" maxOccurs="1"/>
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="OGRVRTUnionLayerType">
        <xs:sequence>
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element name="OGRVRTLayer" type="OGRVRTLayerType">
                    <xs:annotation>
                        <xs:documentation>May be repeated</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="OGRVRTWarpedLayer" type="OGRVRTWarpedLayerType">
                    <xs:annotation>
                        <xs:documentation>May be repeated</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="OGRVRTUnionLayer" type="OGRVRTUnionLayerType">
                    <xs:annotation>
                        <xs:documentation>May be repeated</xs:documentation>
                    </xs:annotation>
                </xs:element>

                <xs:element name="GeometryType" type="GeometryTypeType">
                    <xs:annotation>
                        <xs:documentation>Use GeometryField.GeometryType for multi-geometry field support.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="LayerSRS" type="nonEmptyStringType">
                    <xs:annotation>
                        <xs:documentation>Use GeometryField.SRS for multi-geometry field support.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="FieldStrategy" type="FieldStrategyType">
                    <xs:annotation>
                        <xs:documentation>Defaults to Union if no Field or GeometryField element is specified.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="Field" type="FieldTypeWithoutSrc">
                    <xs:annotation>
                        <xs:documentation>May be repeated</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="GeometryField" type="GeometryFieldTypeWithoutSrc">
                    <xs:annotation>
                        <xs:documentation>May be repeated</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="PreserveSrcFID" type="OGRBooleanType">
                    <xs:annotation>
                        <xs:documentation>Defaults to FALSE.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="SourceLayerFieldName" type="nonEmptyStringType">
                    <xs:annotation>
                        <xs:documentation>Name of fields in which to place the name of the source layer of each feature.</xs:documentation>
                    </xs:annotation>
                </xs:element>
                <xs:element name="FeatureCount" type="xs:integer"/>
                <xs:group ref="ExtentType">
                    <xs:annotation>
                        <xs:documentation>Use GeometryField.ExtentXMin, etc. for multi-geometry field support.</xs:documentation>
                    </xs:annotation>
                </xs:group>
            </xs:choice>
        </xs:sequence>
        <xs:attribute name="name" type="nonEmptyStringType" use="required"/>
    </xs:complexType>

    <xs:simpleType name="FieldStrategyType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="FirstLayer"/>
            <xs:enumeration value="Union"/>
            <xs:enumeration value="Intersection"/>
        </xs:restriction>
    </xs:simpleType>

</xs:schema>
