From c27a1a2543098d73c2fd1ee4497fa4afa6e7210d Mon Sep 17 00:00:00 2001
From: dponti <dponti@usgs.gov>
Date: Thu, 12 Sep 2024 16:30:55 -0700
Subject: [PATCH] Update Piling.xsd

---
 Piling.xsd | 37 ++++++++++++++++++++++++-------------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/Piling.xsd b/Piling.xsd
index d63beeb3..37353ce3 100644
--- a/Piling.xsd
+++ b/Piling.xsd
@@ -28,19 +28,25 @@
                             <documentation>The date and time the pile was installed.</documentation>
                         </annotation>
                     </element>
+                    <element minOccurs="0" name="referenceElevation" type="eml:LengthMeasureExt">
+                        <annotation>
+                            <documentation>A true vertical control element, in the same vertical CRS as the referencePoint), that is used to set elevations for othe structural elements, and not the top of the piling. This property is used when groundSurfaceElevation is not used as the reference elevation.
+</documentation>
+                        </annotation>
+                    </element>
                     <element minOccurs="1" name="groundSurfaceElevation" type="eml:LengthMeasureExt">
                         <annotation>
-                            <documentation>Elevation of the ground surface relative to a specified datum.</documentation>
+                            <documentation>The elevation of the ground surface, in the same vertical CRS as the referencePoint. This point often serves as the pile's reference elevation.</documentation>
                         </annotation>
                     </element>
                     <element minOccurs="1" name="cutoffElevation" type="eml:LengthMeasureExt">
                         <annotation>
-                            <documentation>Elevation of the pile cutoff relative to a specified datum.</documentation>
+                            <documentation>Elevation of the pile cutoff in the same vertical CRS as the referencePoint.</documentation>
                         </annotation>
                     </element>
                     <element minOccurs="0" name="jettingElevation" type="eml:LengthMeasureExt">
                         <annotation>
-                            <documentation>Elevation that jetting reached relative to a specified datum.</documentation>
+                            <documentation>Elevation of the top of the pile in the same CRS as the referencePoint, that is reached by pile jetting.</documentation>
                         </annotation>
                     </element>
                     <element minOccurs="0" name="totalPileLength" type="eml:LengthMeasureExt">
@@ -84,13 +90,13 @@
                     <element form="qualified" maxOccurs="1" minOccurs="0" name="finalTipElevation"
                         type="eml:LengthMeasureExt">
                         <annotation>
-                            <documentation>The final elevation of the pile tip after driving, relative to a specified datum.</documentation>
+                            <documentation>The final elevation of the pile tip after driving, in the same CRS as the referencePoint</documentation>
                         </annotation>
                     </element>
-                    <element maxOccurs="unbounded" minOccurs="1" name="intervalData"
-                        type="diggs:IntervalDataPropertyType">
+                    <element maxOccurs="unbounded" minOccurs="1" name="taperInterval"
+                        type="diggs:TaperPropertyType">
                         <annotation>
-                            <documentation>A list of interval data properties for the pile that defines the pile diameter along the length of the pile along with other properties. The IntervalData object is used to define the parameters of any kind of pile taper.</documentation>
+                            <documentation>A list of intervals along the length of the pile that defines the pile diameter and other properties. The Taper object is used to define the parameters of any kind of pile taper.</documentation>
                         </annotation>
                     </element>
                     <element minOccurs="0" name="productionPile" type="boolean">
@@ -123,7 +129,7 @@
             <documentation>An abstract element that shall be substituted by one of its subtypes.</documentation>
         </annotation>
     </element>
-    <complexType name="IntervalDataType">
+    <complexType name="TaperType">
         <annotation>
             <documentation>Defines properties of the pile over a specified depth interval.</documentation>
         </annotation>
@@ -159,17 +165,17 @@
             </extension>
         </complexContent>
     </complexType>
-    <element name="IntervalData" type="diggs:IntervalDataType">
+    <element name="Taper" type="diggs:TaperType">
         <annotation>
-            <documentation>An IntervalData object, that includes pile properties over a depth interval.</documentation>
+            <documentation>An Taper object, that includes pile diameter an other properties over a depth interval.</documentation>
         </annotation>
     </element>
-    <complexType name="IntervalDataPropertyType">
+    <complexType name="TaperPropertyType">
         <annotation>
-            <documentation>A property with an IntervalData object as its value.</documentation>
+            <documentation>A property with an Taper object as its value.</documentation>
         </annotation>
         <sequence>
-            <element ref="diggs:IntervalData"/>
+            <element ref="diggs:Taper"/>
         </sequence>
     </complexType>
     <element name="Splice" substitutionGroup="diggs:AbstractComponentObjectBase"
@@ -263,6 +269,11 @@
         <complexContent>
             <extension base="diggs:AbstractPileType">
                 <sequence>
+                    <element name="pileSizeDesignation" type="gml:CodeType">
+                        <annotation>
+                            <documentation>A code or name identifying the pile size (typically diameter and weight/unit length) along with other shape parameters as applicable. Intended to come from a controlled list of terms, Example: <pileSizeDesignation codeSpace="ASTM A6 H-Piling">HP 200 x 64</pileSizeDesignation></documentation>
+                        </annotation>
+                    </element>
                     <element minOccurs="0" name="wallThickness" type="eml:LengthMeasureExt">
                         <annotation>
                             <documentation>The thickness of the pipe wall.</documentation>