diff --git a/Changes.md b/Changes.md
index b4de330..98a3d0c 100644
--- a/Changes.md
+++ b/Changes.md
@@ -1,5 +1,10 @@
 # Changes for FDSN StationXML format
 
+## Changes from version 1.1 to 1.2 (2022-02-25)
+
+Version 1.2 introduces no schema "as a schema" changes, other than the
+schemaVersion attribute. All changes are additions of annotations and other documentation.
+
 ## Changes from version 1.0 to 1.1 (2019-5-3)
 
 (Edited 2019-12-18 for small clarifications)
@@ -31,4 +36,3 @@
 * Add `<WaterLevel>` within `<Station>` and `<Channel>`
 
 * Add "subject" attribute to `<Comment>` to allow relating comments, make "id" attribute optional.
-
diff --git a/README.md b/README.md
index 38331a3..eb69977 100644
--- a/README.md
+++ b/README.md
@@ -35,3 +35,13 @@ described above, must be followed for any changes to the schema.
 
 Changes and issues should only be grouped together when logically
 related in order to streamline review and acceptance.
+
+## Translating StationXML 1.0 to 1.1 and later releases
+
+The vast majority of the StationXML 1.0 schema exists in the 1.1 schema, making most 1.0 documents compatible
+with the 1.1 schema.  There are a few small exceptions where 1.0 elements were removed from 1.1, in one
+important case to avoid the specification of incorrect metadata.
+
+An [XSLT definition for StationXML 1.0 to 1.1 conversion](StationXML-1.0to1.1.xslt) exists to assist
+with the systematic conversion of version 1.0 documents to the version 1.1 schema.  This is done by removing the
+elements no longer allowed in 1.1. A similar [XSLT for version 1.0/1.1 to 1.2](StationXML-1.0to1.2.xslt) also exists.
diff --git a/StationXML-1.0to1.1.xslt b/StationXML-1.0to1.1.xslt
new file mode 100644
index 0000000..bb0cd13
--- /dev/null
+++ b/StationXML-1.0to1.1.xslt
@@ -0,0 +1,39 @@
+<xsl:transform version="1.0"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fsx="http://www.fdsn.org/xml/station/1">
+
+    <!--
+    This XSLT 1.0 transform may be used to translate a StationXML version 1.0 document to version 1.1
+    Version: 2020-04-07
+
+    The document *must* declare the FDSN StationXML elements in a namespace of "http://www.fdsn.org/xml/station/1"
+
+    The following changes are applied by the transformation:
+    1) Change FDSNStationXML@schemaVersion from 1.0 to 1.1
+    2) Remove any .../Channel/StorageFormat elements, which are not allowed in 1.1
+    3) Remove any .../Channel/Response/Stage/StageGain elements when
+                  .../Channel/Response/Stage/Polynomial elements are present,
+         which are not allowed in 1.1 as they are nearly always incompatible.
+         Note: This tranformation assumes the StageGain elements are in the document by
+         error (to stricly conform to 1.0) and the Polynomial is the intended filter.
+    -->
+
+    <!-- Identity template: copy all input to output and apply the included templates -->
+    <xsl:template match="node() | @*">
+      <xsl:copy>
+         <xsl:apply-templates select="node() | @*"/>
+      </xsl:copy>
+    </xsl:template>
+
+    <!-- Change schemaVersion from 1.0 to 1.1 -->
+    <xsl:template match="/fsx:FDSNStationXML/@schemaVersion[. = '1.0']">
+      <xsl:attribute name="schemaVersion">1.1</xsl:attribute>
+    </xsl:template>
+
+    <!-- Remove StorageFormat -->
+    <xsl:template match="/fsx:FDSNStationXML/fsx:Network/fsx:Station/fsx:Channel/fsx:StorageFormat"/>
+
+    <!-- Remove StageGain element from Stage that contains Polynomial -->
+    <xsl:template match="/fsx:FDSNStationXML/fsx:Network/fsx:Station/fsx:Channel/fsx:Response/fsx:Stage[fsx:Polynomial]/fsx:StageGain"/>
+
+</xsl:transform>
diff --git a/StationXML-1.0to1.2.xslt b/StationXML-1.0to1.2.xslt
new file mode 100644
index 0000000..fc1fdb8
--- /dev/null
+++ b/StationXML-1.0to1.2.xslt
@@ -0,0 +1,46 @@
+<xsl:transform version="1.0"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fsx="http://www.fdsn.org/xml/station/1">
+
+    <!--
+    This XSLT 1.0 transform may be used to translate a StationXML
+    version 1.0 or 1.1 document to version 1.2
+    Version: 2022-02-25
+
+    The document *must* declare the FDSN StationXML elements in a namespace of
+    "http://www.fdsn.org/xml/station/1"
+
+    The following changes are applied by the transformation:
+    1) Change FDSNStationXML@schemaVersion from 1.0 to 1.2
+    2) Remove any .../Channel/StorageFormat elements, which are not allowed in 1.1
+    3) Remove any .../Channel/Response/Stage/StageGain elements when
+                  .../Channel/Response/Stage/Polynomial elements are present,
+         which are not allowed in 1.1 as they are nearly always incompatible.
+         Note: This tranformation assumes the StageGain elements are in the document by
+         error (to stricly conform to 1.0) and the Polynomial is the intended filter.
+    -->
+
+    <!-- Identity template: copy all input to output and apply the included templates -->
+    <xsl:template match="node() | @*">
+      <xsl:copy>
+         <xsl:apply-templates select="node() | @*"/>
+      </xsl:copy>
+    </xsl:template>
+
+    <!-- Change schemaVersion from 1.0 to 1.2 -->
+    <xsl:template match="/fsx:FDSNStationXML/@schemaVersion[. = '1.0']">
+      <xsl:attribute name="schemaVersion">1.2</xsl:attribute>
+    </xsl:template>
+
+    <!-- Also change schemaVersion from 1.1 to 1.2 -->
+    <xsl:template match="/fsx:FDSNStationXML/@schemaVersion[. = '1.1']">
+      <xsl:attribute name="schemaVersion">1.2</xsl:attribute>
+    </xsl:template>
+
+    <!-- Remove StorageFormat -->
+    <xsl:template match="/fsx:FDSNStationXML/fsx:Network/fsx:Station/fsx:Channel/fsx:StorageFormat"/>
+
+    <!-- Remove StageGain element from Stage that contains Polynomial -->
+    <xsl:template match="/fsx:FDSNStationXML/fsx:Network/fsx:Station/fsx:Channel/fsx:Response/fsx:Stage[fsx:Polynomial]/fsx:StageGain"/>
+
+</xsl:transform>
diff --git a/auditDocUpdate/.gitignore b/auditDocUpdate/.gitignore
new file mode 100644
index 0000000..ca15a89
--- /dev/null
+++ b/auditDocUpdate/.gitignore
@@ -0,0 +1,3 @@
+fdsn-station-1.1.xsd
+fdsn-station*.nodocs
+fdsn-station*.nodocs.tidy
diff --git a/auditDocUpdate/README.md b/auditDocUpdate/README.md
new file mode 100644
index 0000000..00e5797
--- /dev/null
+++ b/auditDocUpdate/README.md
@@ -0,0 +1,38 @@
+### Audit Documentation Changes
+
+Scripts to ensure addition of documentation does not make changes to the
+structure of the FDSN StationXML schema. Running compare.sh should produce no
+differences if the changes are confined to the documentation.
+
+transform.py uses nodocs.xslt to remove all annotations, then tidy
+cleans the output to remove non-structural changes like indentation.
+Finally diff shows the raw textual differences between the two versions.
+
+## Install
+
+lxml is used by transform.py, install with:
+
+```
+conda install lxml
+```
+
+# Run
+
+```
+./compare.sh
+```
+
+If there are no schema changes besides annotations, the output should look like:
+
+```
+% ./compare.sh
+Using: fdsn-station-1.1.xsd
+Writing transformed XML to fdsn-station-1.1.xsd.nodocs
+Writing transformed XML to fdsn-station-local.xsd.nodocs
+diff from fdsn-station-local.xsd to fdsn-station-1.1.xsd
+< is local tidy version, fdsn-station-local.xsd
+> is fdsn tidy version, fdsn-station-1.1.xsd
+Note line numbers are in nodocs.tidy,
+which will be different from original xsd files.
+
+```
diff --git a/auditDocUpdate/check_ascii.py b/auditDocUpdate/check_ascii.py
new file mode 100755
index 0000000..7ea65ae
--- /dev/null
+++ b/auditDocUpdate/check_ascii.py
@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+
+import sys
+import re
+
+opts = [opt for opt in sys.argv[1:] if opt.startswith("-")]
+args = [arg for arg in sys.argv[1:] if not arg.startswith("-")]
+
+if len(args) == 0:
+  print (f'Usage: {sys.argv[0]} inputXML ')
+  exit(0)
+
+# Load source document
+with open(args[0],'r') as doc:
+    for line_no, line in enumerate(doc):
+        non_ascii = re.sub('[\x00-\x7f]', '', line)
+        if len(non_ascii) > 0:
+            print(f"Found non-ascii chars of {non_ascii} on line {line_no}")
+
+
diff --git a/auditDocUpdate/compare.sh b/auditDocUpdate/compare.sh
new file mode 100755
index 0000000..711f41d
--- /dev/null
+++ b/auditDocUpdate/compare.sh
@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+# exit on error
+set -e
+
+XSD=fdsn-station-1.1.xsd
+echo Using: $XSD
+
+if [[ ! -f "$XSD" ]]; then
+  wget http://www.fdsn.org/xml/station/${XSD}
+fi
+
+/bin/rm -f ${XSD}.nodocs.tidy ${XSD}.nodocs
+python3 ./transform.py $XSD nodocs.xslt ${XSD}.nodocs
+tidy -xml -iq  -o ${XSD}.nodocs.tidy ${XSD}.nodocs
+/bin/rm -f ${XSD}.nodocs
+
+LOCALXSD=fdsn-station-local.xsd
+/bin/rm -f ${LOCALXSD}.nodocs ${LOCALXSD}.nodocs.tidy
+python3 ./transform.py ../fdsn-station.xsd nodocs.xslt ${LOCALXSD}.nodocs
+tidy -xml -iq -o ${LOCALXSD}.nodocs.tidy ${LOCALXSD}.nodocs
+/bin/rm -f ${LOCALXSD}.nodocs
+
+echo diff from ${LOCALXSD} to ${XSD}
+echo '<' is local tidy version, ${LOCALXSD}
+echo '>' is fdsn tidy version, ${XSD}
+echo Note line numbers are in nodocs.tidy,
+echo which will be different from original xsd files.
+echo
+
+diff -b ${LOCALXSD}.nodocs.tidy ${XSD}.nodocs.tidy
diff --git a/auditDocUpdate/nodocs.xslt b/auditDocUpdate/nodocs.xslt
new file mode 100644
index 0000000..7e8e1b0
--- /dev/null
+++ b/auditDocUpdate/nodocs.xslt
@@ -0,0 +1,26 @@
+<xsl:transform version="1.0"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema">
+
+    <!--
+    This XSLT 1.0 transform may be used to remove annotation/documentation elements from XML
+
+    Annotation/Documentation elements stripped are identified as:
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xs:annotation
+    -->
+
+    <!-- Identity template: copy all input to output and apply the included templates -->
+    <xsl:template match="node() | @*">
+      <xsl:copy>
+         <xsl:apply-templates select="node() | @*"/>
+      </xsl:copy>
+    </xsl:template>
+
+    <!-- Remove annotations -->
+    <xsl:template match="xs:annotation"/>
+
+    <!-- Remove comments (like this one) -->
+    <xsl:template match="comment()"/>
+
+</xsl:transform>
diff --git a/auditDocUpdate/transform.py b/auditDocUpdate/transform.py
new file mode 100644
index 0000000..c12a233
--- /dev/null
+++ b/auditDocUpdate/transform.py
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+
+from lxml import etree
+import sys
+
+opts = [opt for opt in sys.argv[1:] if opt.startswith("-")]
+args = [arg for arg in sys.argv[1:] if not arg.startswith("-")]
+
+if len(args) == 0:
+  print (f'Usage: {sys.argv[0]} inputXML [XSLTfile [outputXML]]')
+  exit(0)
+
+# Load source document
+doc = etree.parse(args[0])
+
+# Perform XSLT tranform
+if len(args) > 1:
+    xslt = etree.parse(args[1])
+    transform = etree.XSLT(xslt)
+    newdoc = transform(doc)
+
+    # force end tags to make for easier diff
+
+    for elem in newdoc.iter(tag=etree.Element):
+        if elem.text is not None:
+            elem.text = elem.text.strip()
+        if elem.text is None or len(elem.text) == 0:
+            elem.text = '\n'
+
+    # Write to output file
+    if len(args) > 2:
+        print (f'Writing transformed XML to {args[2]}')
+        newdoc.write(args[2], pretty_print=False, strip_text=True)
+        #newdoc.write_output(args[2]) #, pretty_print=False)
diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 0000000..934c404
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1,2 @@
+_build
+__pycache__/
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..da394a7
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,29 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+SCHEMA_FILE   = $(SOURCEDIR)/../fdsn-station.xsd
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# convert generates: level-network.rst level-station.rst level-channel.rst
+#                    level-response.rst warnings.rst
+convert:
+	python convert_xsd_to_rst.py "$(SCHEMA_FILE)" "$(SOURCEDIR)"
+
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile 
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
diff --git a/docs/Qx80_FIR_64.png b/docs/Qx80_FIR_64.png
new file mode 100644
index 0000000..463e010
Binary files /dev/null and b/docs/Qx80_FIR_64.png differ
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..869bce8
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,118 @@
+# stationxml-doc
+StationXML Documentation
+
+## To generate the html/pdf documents
+
+```
+make html
+```
+
+and/or
+
+```
+make latexpdf
+```
+
+or running sphinx-build manually
+
+```
+sphinx-build -b html . _build/html
+```
+
+This will update the html files in _build/html
+
+## Install sphinx
+
+```
+conda create -n sphinx python=3.9
+conda activate sphinx
+conda install sphinx
+conda install -c conda-forge sphinxcontrib-contentui
+pip install linuxdoc
+conda install sphinx_rtd_theme
+conda install xmlschema
+conda install elementpath
+```
+
+## To update ReStructuredText documentation generated from the StationXML schema file
+
+```
+python3 convert_xsd_to_rst.py ../fdsn-station.xsd . && make html
+```
+
+    or
+
+```
+conda run -n sphinx python3 convert_xsd_to_rst.py ../fdsn-station.xsd . && make html
+```
+
+This will re-generate the following files from the XSD schema document:
+ - level-preamble.rst
+ - level-network.rst
+ - level-station.rst
+ - level-channel.rst
+ - level-response.rst
+ - warnings.rst
+
+## Spell check
+```
+pip install sphinxcontrib-spelling
+```
+which require pyenchant and libenchant.
+
+See https://pyenchant.github.io/pyenchant/install.html
+
+For debian based linux:
+```
+sudo apt install libenchant-2-2
+```
+For MacOSX using homebrew (currently does not work on M1 processors):
+```
+brew install enchant
+```
+
+Then add `'sphinxcontrib.spelling'` to `extensions` in conf.py
+install libenchant library, see https://pyenchant.github.io/pyenchant/install.html
+
+then run:
+```
+make spelling
+```
+output will be in the _build/spelling directory.
+
+## To modify the look and feel of the auto-generated level docs
+
+ The following css divs are described in:
+ _static/css/custom.css
+
+  - hatnote - describes the gray box of each element
+  - crumb - the navigation trails
+  - description - contains the element description
+  - type - contains the element type
+  - example - contains the element example
+
+Example rst
+
+       <BeginEffectiveTime>
+       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+       .. container:: hatnote hatnote-gray
+
+       .. container:: crumb
+
+          crumb:Network-->Comment-->BeginEffectiveTime
+
+       .. container:: type
+
+          type::blue:`dateTime`
+
+       .. container:: example
+
+          **Example**: <BeginEffectiveTime>2008-09-15T00:00:00</BeginEffectiveTime>
+
+Hint: If you change the css without changing any .rst files, you must first do:
+
+```
+make clean   // deletes all the files in _build/
+```
+
+before doing the sphinx-build or it won't take.
diff --git a/docs/_static/FDSN-logo.png b/docs/_static/FDSN-logo.png
new file mode 100644
index 0000000..a22c4c7
Binary files /dev/null and b/docs/_static/FDSN-logo.png differ
diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css
new file mode 100644
index 0000000..30ea41c
--- /dev/null
+++ b/docs/_static/css/custom.css
@@ -0,0 +1,254 @@
+
+/* FDSN-style font baseline */
+body {
+  font-family: "Quattrocento Sans", Avenir, Helvetica, Arial, sans-serif;
+}
+
+/* Keep the logo from dominating the upper search pane */
+.logo {
+  max-height: 80px;
+}
+
+/* Set colors for search and navigation sidebar */
+.wy-side-nav-search,
+.wy-side-nav-search > a,
+.wy-side-nav-search > div.version,
+.wy-nav-top {
+  color: black;
+  background: white;
+}
+
+.wy-menu-vertical header,
+.wy-menu-vertical p.caption {
+  color: lightgray;
+  font-weight: bolder;
+}
+
+.wy-menu-vertical a,
+.wy-menu-vertical li.current > a {
+  color: white;
+}
+
+.wy-menu-vertical li.toctree-l2 a,
+.wy-menu-vertical li.toctree-l3 a,
+.wy-menu-vertical li.toctree-l4 a,
+.wy-menu-vertical li.toctree-l5 a,
+.wy-menu-vertical li.toctree-l6 a {
+  color: #404040;
+}
+
+.wy-nav-side {
+  color: black;
+  background: rgb(51,123,184); /* Darker blue */
+}
+
+.wy-menu-vertical li.toctree-l1.current > a,
+.wy-menu-vertical li.toctree-l1.current {
+  background: rgb(116,182,236); /* Medium blue */
+  border-bottom: rgb(116,182,236);
+  border-top: rgb(116,182,236);
+}
+
+.wy-menu-vertical li.toctree-l2.current > a,
+.wy-menu-vertical li.toctree-l2.current,
+.wy-menu-vertical li.toctree-l2.current li.toctree-l3 > a {
+  background: rgb(207,226,242); /* Light blue */
+}
+
+.wy-menu-vertical li.toctree-l2.current li.toctree-l3 a:hover {
+  background: #d6d6d6;
+}
+
+.wy-menu-vertical li.toctree-l2.current li.toctree-l3.current > a {
+  background: white;
+}
+
+/* Stuff ISTI set */
+h3, h4, h5, h6 {
+    display: block;
+    width: 100%;
+    background-color: #e8e8e8 ;
+    margin-bottom: 0 ;
+    margin-top: 0.9em ;
+    padding-left: 0.5em ;
+    padding-right: 0.5em ;
+    padding-top: 0.2em ;
+    padding-bottom: 0.2em ;
+}
+h2 {
+    display: block;
+    width: 100%;
+    /*background-color: #D6D6D6 ;*/
+    background-color: #e8e8e8 ;
+    margin-bottom: 0 ;
+    margin-top: 0.9em ;
+    padding-left: 0.5em ;
+    padding-right: 0.5em ;
+    padding-top: 0.2em ;
+    padding-bottom: 0.2em ;
+}
+h1 {
+    display: block;
+    width: 100%;
+    /*background-color: #2980b9 ;*/
+    background-color: #0088cc ;
+    margin-bottom: 0 ;
+    margin-top: 0.9em ;
+    padding-left: 0.5em ;
+    padding-right: 0.5em ;
+    padding-top: 0.2em ;
+    padding-bottom: 0.2em ;
+    color:white;
+}
+
+.MathJax_Display{
+}
+
+div.hatnote.hatnote-gray.docutils.container > div.description.docutils.container > blockquote > div > div > div {
+  font-size: 117% !important
+}
+
+.box
+{
+    border-color: #c8c8c8 ;
+    border-style: solid ;
+    border-width: 1px ;
+}
+
+.crumb {
+  height: 0;
+  position: relative;
+  left: 325px;
+  top: -25px;
+  color:#585858;
+}
+
+div.crumb > p {
+  font-size:small !important;
+}
+
+/* added to override rtd css rule that separated grey sections with white */
+.rst-content .toctree-wrapper > p.caption, .rst-content h1, .rst-content h2, .rst-content h3, .rst-content h4, .rst-content h5, .rst-content h6 {
+  margin-bottom: 0px;
+}
+
+.breadcrumb
+{
+  font-color:white;
+  font-size:medium;
+}
+
+.hatnote_table
+{
+    border-color: #c8c8c8 ;
+    border-style: solid ;
+    border-width: 1px ;
+    margin-left: 0 ;
+    margin-right: 0 ;
+    padding-left: 0px;
+    padding-right: 0px ;
+    padding-bottom: 0px ;
+    padding-top: 0px ;
+    margin-bottom: 0px ;
+    margin-top: 0px ;
+}
+
+.hatnote
+{
+    border-color: #e8e8e8 ;
+    border-width: 1px ;
+    border-style: solid ;
+  /*
+    border-color: #c8c8c8 ;
+    */
+    font-size: x-small ;
+    /*font-style: italic ;*/
+    margin-left: auto ;
+    margin-right: auto ;
+    padding-left: 2em;
+    padding-right: 0px ;
+    padding-bottom: 0px ;
+    padding-top: 0px ;
+    margin-bottom: 0px ;
+    margin-top: 0px ;
+}
+.hatnote_table-gray { background-color: #e8e8e8 ; color: #000000 ; }
+.hatnote-gray { background-color: #e8e8e8 ; color: #000000 ; }
+.hatnote-yellow { background-color: #ffffe8 ; color: #000000 ; }
+.hatnote-red { background-color: #ffe8e8 ; color: #000000 ; }
+.hatnote-icon { height: 16px ; width: 16px ; }
+
+.rst-content .myownstyle .admonition-title {
+   background: #b99976
+}
+
+.rst-content .myownstyle {
+   background: #e5d3b3
+}
+
+.white {
+  color:white;
+  font-style:italic;
+  font-size: medium;
+}
+
+.red {
+  color:red;
+}
+.blue {
+  color:blue;
+}
+.italic {
+  font-style:italic;
+}
+
+.pink {
+  height: 200px;
+  width: 100%;
+  width: 500px;
+  background-color: pink;
+}
+
+table {
+  width:100%;
+}
+
+table.rows {
+  margin:0px;
+  padding:0px;
+  /*
+  width: 100%;
+  */
+  font-size: x-small ;
+}
+
+table.rows th {
+    background-color: #909090;
+    border-style: solid solid solid solid;
+    border-width: 0px 0px 0px 0px;
+    border-color: #AAAAAA;
+    /*text-align: center;*/
+    text-align: left;
+}
+table.rows td {
+    border-style: solid solid solid solid;
+    border-width: 0px 0px 0px 0px;
+    border-color: #AAAAAA;
+}
+
+table.rows tr {
+    border-style: solid solid solid solid;
+    border-width: 0px 0px 0px 0px;
+    border-color: #AAAAAA;
+}
+
+table.rows tr:nth-child(even) {
+    background-color: #F3F3FF;
+}
+table.rows tr:nth-child(odd) {
+    background-color: #FFFFEE;
+}
+
+table.head {
+    margin-bottom:0px;
+}
diff --git a/docs/_static/css/theme_overrides.css b/docs/_static/css/theme_overrides.css
new file mode 100644
index 0000000..918080b
--- /dev/null
+++ b/docs/_static/css/theme_overrides.css
@@ -0,0 +1,13 @@
+/* override table width restrictions */
+@media screen and (min-width: 767px) {
+
+   .wy-table-responsive table td {
+      /* !important prevents the common CSS stylesheets from overriding
+         this as on RTD they are loaded after this stylesheet */
+      white-space: normal !important;
+   }
+
+   .wy-table-responsive {
+      overflow: auto !important;
+   }
+}
diff --git a/docs/_static/favicon.ico b/docs/_static/favicon.ico
new file mode 100644
index 0000000..18c6a1b
Binary files /dev/null and b/docs/_static/favicon.ico differ
diff --git a/docs/_static/js/sidebar_context.js b/docs/_static/js/sidebar_context.js
new file mode 100644
index 0000000..427863d
--- /dev/null
+++ b/docs/_static/js/sidebar_context.js
@@ -0,0 +1,86 @@
+
+window.onload = function() {
+
+  // cache the navigation links
+  var $navigationLinks = $('.reference.internal');
+
+  // cache (in reversed order) the sections
+  var $sections = $($(".headerlink").get().reverse());
+
+  // map each section id to their corresponding navigation link
+  var sectionIdToNavigationLink = {};
+  $sections.each(function() {
+      var href = $(this).attr('href');
+      sectionIdToNavigationLink[href] = $('.reference.internal[href=\\' + href + ']');
+  });
+
+
+  function highlightNavigation(decimalOff) {
+
+    // get the current vertical position of the scroll bar, along with the document and window's height
+    var scrollPosition = $(window).scrollTop();
+    var documentHeight=$(document).height();
+    var windowHeight=$(window).height()
+
+    // iterate the sections
+    $sections.each(function() {
+        var currentSection = $(this);
+
+        // get the position of the section
+        var sectionTop = currentSection.offset().top;
+
+        // when you are near the very top of the document, you will select the top one automatically
+        if (scrollPosition<windowHeight*.2){
+          setCurrents($sections.eq(-2));
+          return false;
+        }
+
+        // how much away from the top of the screen it will be
+        var offset=windowHeight*decimalOff;
+
+        // if the user has scrolled over the top of the section, or if at very bottom of page
+        if (scrollPosition+offset >= sectionTop || documentHeight==scrollPosition+windowHeight) {
+
+            setCurrents(currentSection);
+            return false;
+        }
+
+    });
+    //console.log("nothing here!")
+  }
+
+  function setCurrents(currentSection){
+    var href = currentSection.attr('href');
+    // get the corresponding navigation link
+    var $navigationLink = sectionIdToNavigationLink[href];
+    //console.log($navigationLink)
+
+    //sections
+    /*
+    $('.headerlink').parent().removeClass('current-section');
+    currentSection.parent().addClass('current-section');
+    */
+
+    //if section isn't already current, set it to be
+    if (!$navigationLink.parent().hasClass('current')&&$navigationLink.length) {
+      //navigation
+      $(".reference.internal").parent().removeClass('current');
+      addCurrent($navigationLink);
+
+    }
+  }
+
+  // add current to class and its parents
+  function addCurrent(navLink){
+    navLink.parent().addClass('current');
+
+    //finds the next one up
+    var parentNavLink=navLink.parent().parent().siblings(".reference.internal");
+
+    if (parentNavLink.length==1){
+      addCurrent(parentNavLink);
+    }
+  }
+
+  $(window).scroll( function (){highlightNavigation(.15) });
+}
diff --git a/docs/_static/readable rtd/parsedcss.txt b/docs/_static/readable rtd/parsedcss.txt
new file mode 100644
index 0000000..a699fce
--- /dev/null
+++ b/docs/_static/readable rtd/parsedcss.txt	
@@ -0,0 +1,3468 @@
+/* sphinx_rtd_theme version 0.4.3 | MIT license */
+/* Built 20190212 16:02 */
+*{-webkit-box-sizing:border-box;
+	-moz-box-sizing:border-box;
+	box-sizing:border-box}
+
+article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}
+
+audio,canvas,video{display:inline-block;
+	*display:inline;
+	*zoom:1}
+
+audio:not([controls]){display:none}
+
+[hidden]{display:none}
+
+*{-webkit-box-sizing:border-box;
+	-moz-box-sizing:border-box;
+	box-sizing:border-box}
+
+html{font-size:100%;
+	-webkit-text-size-adjust:100%;
+	-ms-text-size-adjust:100%}
+
+body{margin:0}
+
+a:hover,a:active{outline:0}
+
+abbr[title]{border-bottom:1px dotted}
+
+b,strong{font-weight:bold}
+
+blockquote{margin:0}
+
+dfn{font-style:italic}
+
+ins{background:#ff9;
+	color:#000;
+	text-decoration:none}
+
+mark{background:#ff0;
+	color:#000;
+	font-style:italic;
+	font-weight:bold}
+
+pre,code,.rst-content tt,.rst-content code,kbd,samp{font-family:monospace,serif;
+	_font-family:"courier new",monospace;
+	font-size:1em}
+
+pre{white-space:pre}
+
+q{quotes:none}
+
+q:before,q:after{content:"";
+	content:none}
+
+small{font-size:85%}
+
+sub,sup{font-size:75%;
+	line-height:0;
+	position:relative;
+	vertical-align:baseline}
+
+sup{top:-0.5em}
+
+sub{bottom:-0.25em}
+
+ul,ol,dl{margin:0;
+	padding:0;
+	list-style:none;
+	list-style-image:none}
+
+li{list-style:none}
+
+dd{margin:0}
+
+img{border:0;
+	-ms-interpolation-mode:bicubic;
+	vertical-align:middle;
+	max-width:100%}
+
+svg:not(:root){overflow:hidden}
+
+figure{margin:0}
+
+form{margin:0}
+
+fieldset{border:0;
+	margin:0;
+	padding:0}
+
+label{cursor:pointer}
+
+legend{border:0;
+	*margin-left:-7px;
+	padding:0;
+	white-space:normal}
+
+button,input,select,textarea{font-size:100%;
+	margin:0;
+	vertical-align:baseline;
+	*vertical-align:middle}
+
+button,input{line-height:normal}
+
+button,input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;
+	-webkit-appearance:button;
+	*overflow:visible}
+
+button[disabled],input[disabled]{cursor:default}
+
+input[type="checkbox"],input[type="radio"]{box-sizing:border-box;
+	padding:0;
+	*width:13px;
+	*height:13px}
+
+input[type="search"]{-webkit-appearance:textfield;
+	-moz-box-sizing:content-box;
+	-webkit-box-sizing:content-box;
+	box-sizing:content-box}
+
+input[type="search"]::-webkit-search-decoration,input[type="search"]::-webkit-search-cancel-button{-webkit-appearance:none}
+
+button::-moz-focus-inner,input::-moz-focus-inner{border:0;
+	padding:0}
+
+textarea{overflow:auto;
+	vertical-align:top;
+	resize:vertical}
+
+table{border-collapse:collapse;
+	border-spacing:0}
+
+td{vertical-align:top}
+
+.chromeframe{margin:.2em 0;
+	background:#ccc;
+	color:#000;
+	padding:.2em 0}
+
+.ir{display:block;
+	border:0;
+	text-indent:-999em;
+	overflow:hidden;
+	background-color:transparent;
+	background-repeat:no-repeat;
+	text-align:left;
+	direction:ltr;
+	*line-height:0}
+
+.ir br{display:none}
+
+.hidden{display:none !important;
+	visibility:hidden}
+
+.visuallyhidden{border:0;
+	clip:rect(0 0 0 0);
+	height:1px;
+	margin:-1px;
+	overflow:hidden;
+	padding:0;
+	position:absolute;
+	width:1px}
+
+.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;
+	height:auto;
+	margin:0;
+	overflow:visible;
+	position:static;
+	width:auto}
+
+.invisible{visibility:hidden}
+
+.relative{position:relative}
+
+big,small{font-size:100%}
+
+@media print{html,body,section{background:none !important}
+
+*{box-shadow:none !important;
+	text-shadow:none !important;
+	filter:none !important;
+	-ms-filter:none !important}
+
+a,a:visited{text-decoration:underline}
+
+.ir a:after,a[href^="javascript:"]:after,a[href^="#"]:after{content:""}
+
+pre,blockquote{page-break-inside:avoid}
+
+thead{display:table-header-group}
+
+tr,img{page-break-inside:avoid}
+
+img{max-width:100% !important}
+
+@page{margin:.5cm}
+
+p,h2,.rst-content .toctree-wrapper p.caption,h3{orphans:3;
+	widows:3}
+
+h2,.rst-content .toctree-wrapper p.caption,h3{page-break-after:avoid}
+
+}
+
+.fa:before,.wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content .code-block-caption .headerlink:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.rst-content .admonition,.btn,input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"],select,textarea,.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a,.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a,.wy-nav-top a{-webkit-font-smoothing:antialiased}
+
+.clearfix{*zoom:1}
+
+.clearfix:before,.clearfix:after{display:table;
+	content:""}
+
+.clearfix:after{clear:both}
+
+/*!
+ *  Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
+ *  License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
+ */@font-face{font-family:'FontAwesome';
+	src:url("../fonts/fontawesome-webfont.eot?v=4.7.0");
+	src:url("../fonts/fontawesome-webfont.eot?#iefix&v=4.7.0") format("embedded-opentype"),url("../fonts/fontawesome-webfont.woff2?v=4.7.0") format("woff2"),url("../fonts/fontawesome-webfont.woff?v=4.7.0") format("woff"),url("../fonts/fontawesome-webfont.ttf?v=4.7.0") format("truetype"),url("../fonts/fontawesome-webfont.svg?v=4.7.0#fontawesomeregular") format("svg");
+	font-weight:normal;
+	font-style:normal}
+
+.fa,.wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content .code-block-caption .headerlink,.rst-content tt.download span:first-child,.rst-content code.download span:first-child,.icon{display:inline-block;
+	font:normal normal normal 14px/1 FontAwesome;
+	font-size:inherit;
+	text-rendering:auto;
+	-webkit-font-smoothing:antialiased;
+	-moz-osx-font-smoothing:grayscale}
+
+.fa-lg{font-size:1.3333333333em;
+	line-height:.75em;
+	vertical-align:-15%}
+
+.fa-2x{font-size:2em}
+
+.fa-3x{font-size:3em}
+
+.fa-4x{font-size:4em}
+
+.fa-5x{font-size:5em}
+
+.fa-fw{width:1.2857142857em;
+	text-align:center}
+
+.fa-ul{padding-left:0;
+	margin-left:2.1428571429em;
+	list-style-type:none}
+
+.fa-ul>li{position:relative}
+
+.fa-li{position:absolute;
+	left:-2.1428571429em;
+	width:2.1428571429em;
+	top:.1428571429em;
+	text-align:center}
+
+.fa-li.fa-lg{left:-1.8571428571em}
+
+.fa-border{padding:.2em .25em .15em;
+	border:solid 0.08em #eee;
+	border-radius:.1em}
+
+.fa-pull-left{float:left}
+
+.fa-pull-right{float:right}
+
+.fa.fa-pull-left,.wy-menu-vertical li span.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-left.toctree-expand,.wy-menu-vertical li.current>a span.fa-pull-left.toctree-expand,.rst-content .fa-pull-left.admonition-title,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content dl dt .fa-pull-left.headerlink,.rst-content p.caption .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.rst-content code.download span.fa-pull-left:first-child,.fa-pull-left.icon{margin-right:.3em}
+
+.fa.fa-pull-right,.wy-menu-vertical li span.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-right.toctree-expand,.wy-menu-vertical li.current>a span.fa-pull-right.toctree-expand,.rst-content .fa-pull-right.admonition-title,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content dl dt .fa-pull-right.headerlink,.rst-content p.caption .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.rst-content code.download span.fa-pull-right:first-child,.fa-pull-right.icon{margin-left:.3em}
+
+.pull-right{float:right}
+
+.pull-left{float:left}
+
+.fa.pull-left,.wy-menu-vertical li span.pull-left.toctree-expand,.wy-menu-vertical li.on a span.pull-left.toctree-expand,.wy-menu-vertical li.current>a span.pull-left.toctree-expand,.rst-content .pull-left.admonition-title,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content dl dt .pull-left.headerlink,.rst-content p.caption .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content .code-block-caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.rst-content code.download span.pull-left:first-child,.pull-left.icon{margin-right:.3em}
+
+.fa.pull-right,.wy-menu-vertical li span.pull-right.toctree-expand,.wy-menu-vertical li.on a span.pull-right.toctree-expand,.wy-menu-vertical li.current>a span.pull-right.toctree-expand,.rst-content .pull-right.admonition-title,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content dl dt .pull-right.headerlink,.rst-content p.caption .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content .code-block-caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.rst-content code.download span.pull-right:first-child,.pull-right.icon{margin-left:.3em}
+
+.fa-spin{-webkit-animation:fa-spin 2s infinite linear;
+	animation:fa-spin 2s infinite linear}
+
+.fa-pulse{-webkit-animation:fa-spin 1s infinite steps(8);
+	animation:fa-spin 1s infinite steps(8)}
+
+@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);
+	transform:rotate(0deg)}
+
+100%{-webkit-transform:rotate(359deg);
+	transform:rotate(359deg)}
+
+}
+
+@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);
+	transform:rotate(0deg)}
+
+100%{-webkit-transform:rotate(359deg);
+	transform:rotate(359deg)}
+
+}
+
+.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";
+	-webkit-transform:rotate(90deg);
+	-ms-transform:rotate(90deg);
+	transform:rotate(90deg)}
+
+.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";
+	-webkit-transform:rotate(180deg);
+	-ms-transform:rotate(180deg);
+	transform:rotate(180deg)}
+
+.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";
+	-webkit-transform:rotate(270deg);
+	-ms-transform:rotate(270deg);
+	transform:rotate(270deg)}
+
+.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";
+	-webkit-transform:scale(-1, 1);
+	-ms-transform:scale(-1, 1);
+	transform:scale(-1, 1)}
+
+.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";
+	-webkit-transform:scale(1, -1);
+	-ms-transform:scale(1, -1);
+	transform:scale(1, -1)}
+
+:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270,:root .fa-flip-horizontal,:root .fa-flip-vertical{filter:none}
+
+.fa-stack{position:relative;
+	display:inline-block;
+	width:2em;
+	height:2em;
+	line-height:2em;
+	vertical-align:middle}
+
+.fa-stack-1x,.fa-stack-2x{position:absolute;
+	left:0;
+	width:100%;
+	text-align:center}
+
+.fa-stack-1x{line-height:inherit}
+
+.fa-stack-2x{font-size:2em}
+
+.fa-inverse{color:#fff}
+
+.fa-glass:before{content:""}
+
+.fa-music:before{content:""}
+
+.fa-search:before,.icon-search:before{content:""}
+
+.fa-envelope-o:before{content:""}
+
+.fa-heart:before{content:""}
+
+.fa-star:before{content:""}
+
+.fa-star-o:before{content:""}
+
+.fa-user:before{content:""}
+
+.fa-film:before{content:""}
+
+.fa-th-large:before{content:""}
+
+.fa-th:before{content:""}
+
+.fa-th-list:before{content:""}
+
+.fa-check:before{content:""}
+
+.fa-remove:before,.fa-close:before,.fa-times:before{content:""}
+
+.fa-search-plus:before{content:""}
+
+.fa-search-minus:before{content:""}
+
+.fa-power-off:before{content:""}
+
+.fa-signal:before{content:""}
+
+.fa-gear:before,.fa-cog:before{content:""}
+
+.fa-trash-o:before{content:""}
+
+.fa-home:before,.icon-home:before{content:""}
+
+.fa-file-o:before{content:""}
+
+.fa-clock-o:before{content:""}
+
+.fa-road:before{content:""}
+
+.fa-download:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before{content:""}
+
+.fa-arrow-circle-o-down:before{content:""}
+
+.fa-arrow-circle-o-up:before{content:""}
+
+.fa-inbox:before{content:""}
+
+.fa-play-circle-o:before{content:""}
+
+.fa-rotate-right:before,.fa-repeat:before{content:""}
+
+.fa-refresh:before{content:""}
+
+.fa-list-alt:before{content:""}
+
+.fa-lock:before{content:""}
+
+.fa-flag:before{content:""}
+
+.fa-headphones:before{content:""}
+
+.fa-volume-off:before{content:""}
+
+.fa-volume-down:before{content:""}
+
+.fa-volume-up:before{content:""}
+
+.fa-qrcode:before{content:""}
+
+.fa-barcode:before{content:""}
+
+.fa-tag:before{content:""}
+
+.fa-tags:before{content:""}
+
+.fa-book:before,.icon-book:before{content:""}
+
+.fa-bookmark:before{content:""}
+
+.fa-print:before{content:""}
+
+.fa-camera:before{content:""}
+
+.fa-font:before{content:""}
+
+.fa-bold:before{content:""}
+
+.fa-italic:before{content:""}
+
+.fa-text-height:before{content:""}
+
+.fa-text-width:before{content:""}
+
+.fa-align-left:before{content:""}
+
+.fa-align-center:before{content:""}
+
+.fa-align-right:before{content:""}
+
+.fa-align-justify:before{content:""}
+
+.fa-list:before{content:""}
+
+.fa-dedent:before,.fa-outdent:before{content:""}
+
+.fa-indent:before{content:""}
+
+.fa-video-camera:before{content:""}
+
+.fa-photo:before,.fa-image:before,.fa-picture-o:before{content:""}
+
+.fa-pencil:before{content:""}
+
+.fa-map-marker:before{content:""}
+
+.fa-adjust:before{content:""}
+
+.fa-tint:before{content:""}
+
+.fa-edit:before,.fa-pencil-square-o:before{content:""}
+
+.fa-share-square-o:before{content:""}
+
+.fa-check-square-o:before{content:""}
+
+.fa-arrows:before{content:""}
+
+.fa-step-backward:before{content:""}
+
+.fa-fast-backward:before{content:""}
+
+.fa-backward:before{content:""}
+
+.fa-play:before{content:""}
+
+.fa-pause:before{content:""}
+
+.fa-stop:before{content:""}
+
+.fa-forward:before{content:""}
+
+.fa-fast-forward:before{content:""}
+
+.fa-step-forward:before{content:""}
+
+.fa-eject:before{content:""}
+
+.fa-chevron-left:before{content:""}
+
+.fa-chevron-right:before{content:""}
+
+.fa-plus-circle:before{content:""}
+
+.fa-minus-circle:before{content:""}
+
+.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}
+
+.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}
+
+.fa-question-circle:before{content:""}
+
+.fa-info-circle:before{content:""}
+
+.fa-crosshairs:before{content:""}
+
+.fa-times-circle-o:before{content:""}
+
+.fa-check-circle-o:before{content:""}
+
+.fa-ban:before{content:""}
+
+.fa-arrow-left:before{content:""}
+
+.fa-arrow-right:before{content:""}
+
+.fa-arrow-up:before{content:""}
+
+.fa-arrow-down:before{content:""}
+
+.fa-mail-forward:before,.fa-share:before{content:""}
+
+.fa-expand:before{content:""}
+
+.fa-compress:before{content:""}
+
+.fa-plus:before{content:""}
+
+.fa-minus:before{content:""}
+
+.fa-asterisk:before{content:""}
+
+.fa-exclamation-circle:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.rst-content .admonition-title:before{content:""}
+
+.fa-gift:before{content:""}
+
+.fa-leaf:before{content:""}
+
+.fa-fire:before,.icon-fire:before{content:""}
+
+.fa-eye:before{content:""}
+
+.fa-eye-slash:before{content:""}
+
+.fa-warning:before,.fa-exclamation-triangle:before{content:""}
+
+.fa-plane:before{content:""}
+
+.fa-calendar:before{content:""}
+
+.fa-random:before{content:""}
+
+.fa-comment:before{content:""}
+
+.fa-magnet:before{content:""}
+
+.fa-chevron-up:before{content:""}
+
+.fa-chevron-down:before{content:""}
+
+.fa-retweet:before{content:""}
+
+.fa-shopping-cart:before{content:""}
+
+.fa-folder:before{content:""}
+
+.fa-folder-open:before{content:""}
+
+.fa-arrows-v:before{content:""}
+
+.fa-arrows-h:before{content:""}
+
+.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}
+
+.fa-twitter-square:before{content:""}
+
+.fa-facebook-square:before{content:""}
+
+.fa-camera-retro:before{content:""}
+
+.fa-key:before{content:""}
+
+.fa-gears:before,.fa-cogs:before{content:""}
+
+.fa-comments:before{content:""}
+
+.fa-thumbs-o-up:before{content:""}
+
+.fa-thumbs-o-down:before{content:""}
+
+.fa-star-half:before{content:""}
+
+.fa-heart-o:before{content:""}
+
+.fa-sign-out:before{content:""}
+
+.fa-linkedin-square:before{content:""}
+
+.fa-thumb-tack:before{content:""}
+
+.fa-external-link:before{content:""}
+
+.fa-sign-in:before{content:""}
+
+.fa-trophy:before{content:""}
+
+.fa-github-square:before{content:""}
+
+.fa-upload:before{content:""}
+
+.fa-lemon-o:before{content:""}
+
+.fa-phone:before{content:""}
+
+.fa-square-o:before{content:""}
+
+.fa-bookmark-o:before{content:""}
+
+.fa-phone-square:before{content:""}
+
+.fa-twitter:before{content:""}
+
+.fa-facebook-f:before,.fa-facebook:before{content:""}
+
+.fa-github:before,.icon-github:before{content:""}
+
+.fa-unlock:before{content:""}
+
+.fa-credit-card:before{content:""}
+
+.fa-feed:before,.fa-rss:before{content:""}
+
+.fa-hdd-o:before{content:""}
+
+.fa-bullhorn:before{content:""}
+
+.fa-bell:before{content:""}
+
+.fa-certificate:before{content:""}
+
+.fa-hand-o-right:before{content:""}
+
+.fa-hand-o-left:before{content:""}
+
+.fa-hand-o-up:before{content:""}
+
+.fa-hand-o-down:before{content:""}
+
+.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}
+
+.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}
+
+.fa-arrow-circle-up:before{content:""}
+
+.fa-arrow-circle-down:before{content:""}
+
+.fa-globe:before{content:""}
+
+.fa-wrench:before{content:""}
+
+.fa-tasks:before{content:""}
+
+.fa-filter:before{content:""}
+
+.fa-briefcase:before{content:""}
+
+.fa-arrows-alt:before{content:""}
+
+.fa-group:before,.fa-users:before{content:""}
+
+.fa-chain:before,.fa-link:before,.icon-link:before{content:""}
+
+.fa-cloud:before{content:""}
+
+.fa-flask:before{content:""}
+
+.fa-cut:before,.fa-scissors:before{content:""}
+
+.fa-copy:before,.fa-files-o:before{content:""}
+
+.fa-paperclip:before{content:""}
+
+.fa-save:before,.fa-floppy-o:before{content:""}
+
+.fa-square:before{content:""}
+
+.fa-navicon:before,.fa-reorder:before,.fa-bars:before{content:""}
+
+.fa-list-ul:before{content:""}
+
+.fa-list-ol:before{content:""}
+
+.fa-strikethrough:before{content:""}
+
+.fa-underline:before{content:""}
+
+.fa-table:before{content:""}
+
+.fa-magic:before{content:""}
+
+.fa-truck:before{content:""}
+
+.fa-pinterest:before{content:""}
+
+.fa-pinterest-square:before{content:""}
+
+.fa-google-plus-square:before{content:""}
+
+.fa-google-plus:before{content:""}
+
+.fa-money:before{content:""}
+
+.fa-caret-down:before,.wy-dropdown .caret:before,.icon-caret-down:before{content:""}
+
+.fa-caret-up:before{content:""}
+
+.fa-caret-left:before{content:""}
+
+.fa-caret-right:before{content:""}
+
+.fa-columns:before{content:""}
+
+.fa-unsorted:before,.fa-sort:before{content:""}
+
+.fa-sort-down:before,.fa-sort-desc:before{content:""}
+
+.fa-sort-up:before,.fa-sort-asc:before{content:""}
+
+.fa-envelope:before{content:""}
+
+.fa-linkedin:before{content:""}
+
+.fa-rotate-left:before,.fa-undo:before{content:""}
+
+.fa-legal:before,.fa-gavel:before{content:""}
+
+.fa-dashboard:before,.fa-tachometer:before{content:""}
+
+.fa-comment-o:before{content:""}
+
+.fa-comments-o:before{content:""}
+
+.fa-flash:before,.fa-bolt:before{content:""}
+
+.fa-sitemap:before{content:""}
+
+.fa-umbrella:before{content:""}
+
+.fa-paste:before,.fa-clipboard:before{content:""}
+
+.fa-lightbulb-o:before{content:""}
+
+.fa-exchange:before{content:""}
+
+.fa-cloud-download:before{content:""}
+
+.fa-cloud-upload:before{content:""}
+
+.fa-user-md:before{content:""}
+
+.fa-stethoscope:before{content:""}
+
+.fa-suitcase:before{content:""}
+
+.fa-bell-o:before{content:""}
+
+.fa-coffee:before{content:""}
+
+.fa-cutlery:before{content:""}
+
+.fa-file-text-o:before{content:""}
+
+.fa-building-o:before{content:""}
+
+.fa-hospital-o:before{content:""}
+
+.fa-ambulance:before{content:""}
+
+.fa-medkit:before{content:""}
+
+.fa-fighter-jet:before{content:""}
+
+.fa-beer:before{content:""}
+
+.fa-h-square:before{content:""}
+
+.fa-plus-square:before{content:""}
+
+.fa-angle-double-left:before{content:""}
+
+.fa-angle-double-right:before{content:""}
+
+.fa-angle-double-up:before{content:""}
+
+.fa-angle-double-down:before{content:""}
+
+.fa-angle-left:before{content:""}
+
+.fa-angle-right:before{content:""}
+
+.fa-angle-up:before{content:""}
+
+.fa-angle-down:before{content:""}
+
+.fa-desktop:before{content:""}
+
+.fa-laptop:before{content:""}
+
+.fa-tablet:before{content:""}
+
+.fa-mobile-phone:before,.fa-mobile:before{content:""}
+
+.fa-circle-o:before{content:""}
+
+.fa-quote-left:before{content:""}
+
+.fa-quote-right:before{content:""}
+
+.fa-spinner:before{content:""}
+
+.fa-circle:before{content:""}
+
+.fa-mail-reply:before,.fa-reply:before{content:""}
+
+.fa-github-alt:before{content:""}
+
+.fa-folder-o:before{content:""}
+
+.fa-folder-open-o:before{content:""}
+
+.fa-smile-o:before{content:""}
+
+.fa-frown-o:before{content:""}
+
+.fa-meh-o:before{content:""}
+
+.fa-gamepad:before{content:""}
+
+.fa-keyboard-o:before{content:""}
+
+.fa-flag-o:before{content:""}
+
+.fa-flag-checkered:before{content:""}
+
+.fa-terminal:before{content:""}
+
+.fa-code:before{content:""}
+
+.fa-mail-reply-all:before,.fa-reply-all:before{content:""}
+
+.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}
+
+.fa-location-arrow:before{content:""}
+
+.fa-crop:before{content:""}
+
+.fa-code-fork:before{content:""}
+
+.fa-unlink:before,.fa-chain-broken:before{content:""}
+
+.fa-question:before{content:""}
+
+.fa-info:before{content:""}
+
+.fa-exclamation:before{content:""}
+
+.fa-superscript:before{content:""}
+
+.fa-subscript:before{content:""}
+
+.fa-eraser:before{content:""}
+
+.fa-puzzle-piece:before{content:""}
+
+.fa-microphone:before{content:""}
+
+.fa-microphone-slash:before{content:""}
+
+.fa-shield:before{content:""}
+
+.fa-calendar-o:before{content:""}
+
+.fa-fire-extinguisher:before{content:""}
+
+.fa-rocket:before{content:""}
+
+.fa-maxcdn:before{content:""}
+
+.fa-chevron-circle-left:before{content:""}
+
+.fa-chevron-circle-right:before{content:""}
+
+.fa-chevron-circle-up:before{content:""}
+
+.fa-chevron-circle-down:before{content:""}
+
+.fa-html5:before{content:""}
+
+.fa-css3:before{content:""}
+
+.fa-anchor:before{content:""}
+
+.fa-unlock-alt:before{content:""}
+
+.fa-bullseye:before{content:""}
+
+.fa-ellipsis-h:before{content:""}
+
+.fa-ellipsis-v:before{content:""}
+
+.fa-rss-square:before{content:""}
+
+.fa-play-circle:before{content:""}
+
+.fa-ticket:before{content:""}
+
+.fa-minus-square:before{content:""}
+
+.fa-minus-square-o:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before{content:""}
+
+.fa-level-up:before{content:""}
+
+.fa-level-down:before{content:""}
+
+.fa-check-square:before{content:""}
+
+.fa-pencil-square:before{content:""}
+
+.fa-external-link-square:before{content:""}
+
+.fa-share-square:before{content:""}
+
+.fa-compass:before{content:""}
+
+.fa-toggle-down:before,.fa-caret-square-o-down:before{content:""}
+
+.fa-toggle-up:before,.fa-caret-square-o-up:before{content:""}
+
+.fa-toggle-right:before,.fa-caret-square-o-right:before{content:""}
+
+.fa-euro:before,.fa-eur:before{content:""}
+
+.fa-gbp:before{content:""}
+
+.fa-dollar:before,.fa-usd:before{content:""}
+
+.fa-rupee:before,.fa-inr:before{content:""}
+
+.fa-cny:before,.fa-rmb:before,.fa-yen:before,.fa-jpy:before{content:""}
+
+.fa-ruble:before,.fa-rouble:before,.fa-rub:before{content:""}
+
+.fa-won:before,.fa-krw:before{content:""}
+
+.fa-bitcoin:before,.fa-btc:before{content:""}
+
+.fa-file:before{content:""}
+
+.fa-file-text:before{content:""}
+
+.fa-sort-alpha-asc:before{content:""}
+
+.fa-sort-alpha-desc:before{content:""}
+
+.fa-sort-amount-asc:before{content:""}
+
+.fa-sort-amount-desc:before{content:""}
+
+.fa-sort-numeric-asc:before{content:""}
+
+.fa-sort-numeric-desc:before{content:""}
+
+.fa-thumbs-up:before{content:""}
+
+.fa-thumbs-down:before{content:""}
+
+.fa-youtube-square:before{content:""}
+
+.fa-youtube:before{content:""}
+
+.fa-xing:before{content:""}
+
+.fa-xing-square:before{content:""}
+
+.fa-youtube-play:before{content:""}
+
+.fa-dropbox:before{content:""}
+
+.fa-stack-overflow:before{content:""}
+
+.fa-instagram:before{content:""}
+
+.fa-flickr:before{content:""}
+
+.fa-adn:before{content:""}
+
+.fa-bitbucket:before,.icon-bitbucket:before{content:""}
+
+.fa-bitbucket-square:before{content:""}
+
+.fa-tumblr:before{content:""}
+
+.fa-tumblr-square:before{content:""}
+
+.fa-long-arrow-down:before{content:""}
+
+.fa-long-arrow-up:before{content:""}
+
+.fa-long-arrow-left:before{content:""}
+
+.fa-long-arrow-right:before{content:""}
+
+.fa-apple:before{content:""}
+
+.fa-windows:before{content:""}
+
+.fa-android:before{content:""}
+
+.fa-linux:before{content:""}
+
+.fa-dribbble:before{content:""}
+
+.fa-skype:before{content:""}
+
+.fa-foursquare:before{content:""}
+
+.fa-trello:before{content:""}
+
+.fa-female:before{content:""}
+
+.fa-male:before{content:""}
+
+.fa-gittip:before,.fa-gratipay:before{content:""}
+
+.fa-sun-o:before{content:""}
+
+.fa-moon-o:before{content:""}
+
+.fa-archive:before{content:""}
+
+.fa-bug:before{content:""}
+
+.fa-vk:before{content:""}
+
+.fa-weibo:before{content:""}
+
+.fa-renren:before{content:""}
+
+.fa-pagelines:before{content:""}
+
+.fa-stack-exchange:before{content:""}
+
+.fa-arrow-circle-o-right:before{content:""}
+
+.fa-arrow-circle-o-left:before{content:""}
+
+.fa-toggle-left:before,.fa-caret-square-o-left:before{content:""}
+
+.fa-dot-circle-o:before{content:""}
+
+.fa-wheelchair:before{content:""}
+
+.fa-vimeo-square:before{content:""}
+
+.fa-turkish-lira:before,.fa-try:before{content:""}
+
+.fa-plus-square-o:before,.wy-menu-vertical li span.toctree-expand:before{content:""}
+
+.fa-space-shuttle:before{content:""}
+
+.fa-slack:before{content:""}
+
+.fa-envelope-square:before{content:""}
+
+.fa-wordpress:before{content:""}
+
+.fa-openid:before{content:""}
+
+.fa-institution:before,.fa-bank:before,.fa-university:before{content:""}
+
+.fa-mortar-board:before,.fa-graduation-cap:before{content:""}
+
+.fa-yahoo:before{content:""}
+
+.fa-google:before{content:""}
+
+.fa-reddit:before{content:""}
+
+.fa-reddit-square:before{content:""}
+
+.fa-stumbleupon-circle:before{content:""}
+
+.fa-stumbleupon:before{content:""}
+
+.fa-delicious:before{content:""}
+
+.fa-digg:before{content:""}
+
+.fa-pied-piper-pp:before{content:""}
+
+.fa-pied-piper-alt:before{content:""}
+
+.fa-drupal:before{content:""}
+
+.fa-joomla:before{content:""}
+
+.fa-language:before{content:""}
+
+.fa-fax:before{content:""}
+
+.fa-building:before{content:""}
+
+.fa-child:before{content:""}
+
+.fa-paw:before{content:""}
+
+.fa-spoon:before{content:""}
+
+.fa-cube:before{content:""}
+
+.fa-cubes:before{content:""}
+
+.fa-behance:before{content:""}
+
+.fa-behance-square:before{content:""}
+
+.fa-steam:before{content:""}
+
+.fa-steam-square:before{content:""}
+
+.fa-recycle:before{content:""}
+
+.fa-automobile:before,.fa-car:before{content:""}
+
+.fa-cab:before,.fa-taxi:before{content:""}
+
+.fa-tree:before{content:""}
+
+.fa-spotify:before{content:""}
+
+.fa-deviantart:before{content:""}
+
+.fa-soundcloud:before{content:""}
+
+.fa-database:before{content:""}
+
+.fa-file-pdf-o:before{content:""}
+
+.fa-file-word-o:before{content:""}
+
+.fa-file-excel-o:before{content:""}
+
+.fa-file-powerpoint-o:before{content:""}
+
+.fa-file-photo-o:before,.fa-file-picture-o:before,.fa-file-image-o:before{content:""}
+
+.fa-file-zip-o:before,.fa-file-archive-o:before{content:""}
+
+.fa-file-sound-o:before,.fa-file-audio-o:before{content:""}
+
+.fa-file-movie-o:before,.fa-file-video-o:before{content:""}
+
+.fa-file-code-o:before{content:""}
+
+.fa-vine:before{content:""}
+
+.fa-codepen:before{content:""}
+
+.fa-jsfiddle:before{content:""}
+
+.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-saver:before,.fa-support:before,.fa-life-ring:before{content:""}
+
+.fa-circle-o-notch:before{content:""}
+
+.fa-ra:before,.fa-resistance:before,.fa-rebel:before{content:""}
+
+.fa-ge:before,.fa-empire:before{content:""}
+
+.fa-git-square:before{content:""}
+
+.fa-git:before{content:""}
+
+.fa-y-combinator-square:before,.fa-yc-square:before,.fa-hacker-news:before{content:""}
+
+.fa-tencent-weibo:before{content:""}
+
+.fa-qq:before{content:""}
+
+.fa-wechat:before,.fa-weixin:before{content:""}
+
+.fa-send:before,.fa-paper-plane:before{content:""}
+
+.fa-send-o:before,.fa-paper-plane-o:before{content:""}
+
+.fa-history:before{content:""}
+
+.fa-circle-thin:before{content:""}
+
+.fa-header:before{content:""}
+
+.fa-paragraph:before{content:""}
+
+.fa-sliders:before{content:""}
+
+.fa-share-alt:before{content:""}
+
+.fa-share-alt-square:before{content:""}
+
+.fa-bomb:before{content:""}
+
+.fa-soccer-ball-o:before,.fa-futbol-o:before{content:""}
+
+.fa-tty:before{content:""}
+
+.fa-binoculars:before{content:""}
+
+.fa-plug:before{content:""}
+
+.fa-slideshare:before{content:""}
+
+.fa-twitch:before{content:""}
+
+.fa-yelp:before{content:""}
+
+.fa-newspaper-o:before{content:""}
+
+.fa-wifi:before{content:""}
+
+.fa-calculator:before{content:""}
+
+.fa-paypal:before{content:""}
+
+.fa-google-wallet:before{content:""}
+
+.fa-cc-visa:before{content:""}
+
+.fa-cc-mastercard:before{content:""}
+
+.fa-cc-discover:before{content:""}
+
+.fa-cc-amex:before{content:""}
+
+.fa-cc-paypal:before{content:""}
+
+.fa-cc-stripe:before{content:""}
+
+.fa-bell-slash:before{content:""}
+
+.fa-bell-slash-o:before{content:""}
+
+.fa-trash:before{content:""}
+
+.fa-copyright:before{content:""}
+
+.fa-at:before{content:""}
+
+.fa-eyedropper:before{content:""}
+
+.fa-paint-brush:before{content:""}
+
+.fa-birthday-cake:before{content:""}
+
+.fa-area-chart:before{content:""}
+
+.fa-pie-chart:before{content:""}
+
+.fa-line-chart:before{content:""}
+
+.fa-lastfm:before{content:""}
+
+.fa-lastfm-square:before{content:""}
+
+.fa-toggle-off:before{content:""}
+
+.fa-toggle-on:before{content:""}
+
+.fa-bicycle:before{content:""}
+
+.fa-bus:before{content:""}
+
+.fa-ioxhost:before{content:""}
+
+.fa-angellist:before{content:""}
+
+.fa-cc:before{content:""}
+
+.fa-shekel:before,.fa-sheqel:before,.fa-ils:before{content:""}
+
+.fa-meanpath:before{content:""}
+
+.fa-buysellads:before{content:""}
+
+.fa-connectdevelop:before{content:""}
+
+.fa-dashcube:before{content:""}
+
+.fa-forumbee:before{content:""}
+
+.fa-leanpub:before{content:""}
+
+.fa-sellsy:before{content:""}
+
+.fa-shirtsinbulk:before{content:""}
+
+.fa-simplybuilt:before{content:""}
+
+.fa-skyatlas:before{content:""}
+
+.fa-cart-plus:before{content:""}
+
+.fa-cart-arrow-down:before{content:""}
+
+.fa-diamond:before{content:""}
+
+.fa-ship:before{content:""}
+
+.fa-user-secret:before{content:""}
+
+.fa-motorcycle:before{content:""}
+
+.fa-street-view:before{content:""}
+
+.fa-heartbeat:before{content:""}
+
+.fa-venus:before{content:""}
+
+.fa-mars:before{content:""}
+
+.fa-mercury:before{content:""}
+
+.fa-intersex:before,.fa-transgender:before{content:""}
+
+.fa-transgender-alt:before{content:""}
+
+.fa-venus-double:before{content:""}
+
+.fa-mars-double:before{content:""}
+
+.fa-venus-mars:before{content:""}
+
+.fa-mars-stroke:before{content:""}
+
+.fa-mars-stroke-v:before{content:""}
+
+.fa-mars-stroke-h:before{content:""}
+
+.fa-neuter:before{content:""}
+
+.fa-genderless:before{content:""}
+
+.fa-facebook-official:before{content:""}
+
+.fa-pinterest-p:before{content:""}
+
+.fa-whatsapp:before{content:""}
+
+.fa-server:before{content:""}
+
+.fa-user-plus:before{content:""}
+
+.fa-user-times:before{content:""}
+
+.fa-hotel:before,.fa-bed:before{content:""}
+
+.fa-viacoin:before{content:""}
+
+.fa-train:before{content:""}
+
+.fa-subway:before{content:""}
+
+.fa-medium:before{content:""}
+
+.fa-yc:before,.fa-y-combinator:before{content:""}
+
+.fa-optin-monster:before{content:""}
+
+.fa-opencart:before{content:""}
+
+.fa-expeditedssl:before{content:""}
+
+.fa-battery-4:before,.fa-battery:before,.fa-battery-full:before{content:""}
+
+.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}
+
+.fa-battery-2:before,.fa-battery-half:before{content:""}
+
+.fa-battery-1:before,.fa-battery-quarter:before{content:""}
+
+.fa-battery-0:before,.fa-battery-empty:before{content:""}
+
+.fa-mouse-pointer:before{content:""}
+
+.fa-i-cursor:before{content:""}
+
+.fa-object-group:before{content:""}
+
+.fa-object-ungroup:before{content:""}
+
+.fa-sticky-note:before{content:""}
+
+.fa-sticky-note-o:before{content:""}
+
+.fa-cc-jcb:before{content:""}
+
+.fa-cc-diners-club:before{content:""}
+
+.fa-clone:before{content:""}
+
+.fa-balance-scale:before{content:""}
+
+.fa-hourglass-o:before{content:""}
+
+.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}
+
+.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}
+
+.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}
+
+.fa-hourglass:before{content:""}
+
+.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}
+
+.fa-hand-stop-o:before,.fa-hand-paper-o:before{content:""}
+
+.fa-hand-scissors-o:before{content:""}
+
+.fa-hand-lizard-o:before{content:""}
+
+.fa-hand-spock-o:before{content:""}
+
+.fa-hand-pointer-o:before{content:""}
+
+.fa-hand-peace-o:before{content:""}
+
+.fa-trademark:before{content:""}
+
+.fa-registered:before{content:""}
+
+.fa-creative-commons:before{content:""}
+
+.fa-gg:before{content:""}
+
+.fa-gg-circle:before{content:""}
+
+.fa-tripadvisor:before{content:""}
+
+.fa-odnoklassniki:before{content:""}
+
+.fa-odnoklassniki-square:before{content:""}
+
+.fa-get-pocket:before{content:""}
+
+.fa-wikipedia-w:before{content:""}
+
+.fa-safari:before{content:""}
+
+.fa-chrome:before{content:""}
+
+.fa-firefox:before{content:""}
+
+.fa-opera:before{content:""}
+
+.fa-internet-explorer:before{content:""}
+
+.fa-tv:before,.fa-television:before{content:""}
+
+.fa-contao:before{content:""}
+
+.fa-500px:before{content:""}
+
+.fa-amazon:before{content:""}
+
+.fa-calendar-plus-o:before{content:""}
+
+.fa-calendar-minus-o:before{content:""}
+
+.fa-calendar-times-o:before{content:""}
+
+.fa-calendar-check-o:before{content:""}
+
+.fa-industry:before{content:""}
+
+.fa-map-pin:before{content:""}
+
+.fa-map-signs:before{content:""}
+
+.fa-map-o:before{content:""}
+
+.fa-map:before{content:""}
+
+.fa-commenting:before{content:""}
+
+.fa-commenting-o:before{content:""}
+
+.fa-houzz:before{content:""}
+
+.fa-vimeo:before{content:""}
+
+.fa-black-tie:before{content:""}
+
+.fa-fonticons:before{content:""}
+
+.fa-reddit-alien:before{content:""}
+
+.fa-edge:before{content:""}
+
+.fa-credit-card-alt:before{content:""}
+
+.fa-codiepie:before{content:""}
+
+.fa-modx:before{content:""}
+
+.fa-fort-awesome:before{content:""}
+
+.fa-usb:before{content:""}
+
+.fa-product-hunt:before{content:""}
+
+.fa-mixcloud:before{content:""}
+
+.fa-scribd:before{content:""}
+
+.fa-pause-circle:before{content:""}
+
+.fa-pause-circle-o:before{content:""}
+
+.fa-stop-circle:before{content:""}
+
+.fa-stop-circle-o:before{content:""}
+
+.fa-shopping-bag:before{content:""}
+
+.fa-shopping-basket:before{content:""}
+
+.fa-hashtag:before{content:""}
+
+.fa-bluetooth:before{content:""}
+
+.fa-bluetooth-b:before{content:""}
+
+.fa-percent:before{content:""}
+
+.fa-gitlab:before,.icon-gitlab:before{content:""}
+
+.fa-wpbeginner:before{content:""}
+
+.fa-wpforms:before{content:""}
+
+.fa-envira:before{content:""}
+
+.fa-universal-access:before{content:""}
+
+.fa-wheelchair-alt:before{content:""}
+
+.fa-question-circle-o:before{content:""}
+
+.fa-blind:before{content:""}
+
+.fa-audio-description:before{content:""}
+
+.fa-volume-control-phone:before{content:""}
+
+.fa-braille:before{content:""}
+
+.fa-assistive-listening-systems:before{content:""}
+
+.fa-asl-interpreting:before,.fa-american-sign-language-interpreting:before{content:""}
+
+.fa-deafness:before,.fa-hard-of-hearing:before,.fa-deaf:before{content:""}
+
+.fa-glide:before{content:""}
+
+.fa-glide-g:before{content:""}
+
+.fa-signing:before,.fa-sign-language:before{content:""}
+
+.fa-low-vision:before{content:""}
+
+.fa-viadeo:before{content:""}
+
+.fa-viadeo-square:before{content:""}
+
+.fa-snapchat:before{content:""}
+
+.fa-snapchat-ghost:before{content:""}
+
+.fa-snapchat-square:before{content:""}
+
+.fa-pied-piper:before{content:""}
+
+.fa-first-order:before{content:""}
+
+.fa-yoast:before{content:""}
+
+.fa-themeisle:before{content:""}
+
+.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}
+
+.fa-fa:before,.fa-font-awesome:before{content:""}
+
+.fa-handshake-o:before{content:""}
+
+.fa-envelope-open:before{content:""}
+
+.fa-envelope-open-o:before{content:""}
+
+.fa-linode:before{content:""}
+
+.fa-address-book:before{content:""}
+
+.fa-address-book-o:before{content:""}
+
+.fa-vcard:before,.fa-address-card:before{content:""}
+
+.fa-vcard-o:before,.fa-address-card-o:before{content:""}
+
+.fa-user-circle:before{content:""}
+
+.fa-user-circle-o:before{content:""}
+
+.fa-user-o:before{content:""}
+
+.fa-id-badge:before{content:""}
+
+.fa-drivers-license:before,.fa-id-card:before{content:""}
+
+.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}
+
+.fa-quora:before{content:""}
+
+.fa-free-code-camp:before{content:""}
+
+.fa-telegram:before{content:""}
+
+.fa-thermometer-4:before,.fa-thermometer:before,.fa-thermometer-full:before{content:""}
+
+.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}
+
+.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}
+
+.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}
+
+.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}
+
+.fa-shower:before{content:""}
+
+.fa-bathtub:before,.fa-s15:before,.fa-bath:before{content:""}
+
+.fa-podcast:before{content:""}
+
+.fa-window-maximize:before{content:""}
+
+.fa-window-minimize:before{content:""}
+
+.fa-window-restore:before{content:""}
+
+.fa-times-rectangle:before,.fa-window-close:before{content:""}
+
+.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}
+
+.fa-bandcamp:before{content:""}
+
+.fa-grav:before{content:""}
+
+.fa-etsy:before{content:""}
+
+.fa-imdb:before{content:""}
+
+.fa-ravelry:before{content:""}
+
+.fa-eercast:before{content:""}
+
+.fa-microchip:before{content:""}
+
+.fa-snowflake-o:before{content:""}
+
+.fa-superpowers:before{content:""}
+
+.fa-wpexplorer:before{content:""}
+
+.fa-meetup:before{content:""}
+
+.sr-only{position:absolute;
+	width:1px;
+	height:1px;
+	padding:0;
+	margin:-1px;
+	overflow:hidden;
+	clip:rect(0, 0, 0, 0);
+	border:0}
+
+.sr-only-focusable:active,.sr-only-focusable:focus{position:static;
+	width:auto;
+	height:auto;
+	margin:0;
+	overflow:visible;
+	clip:auto}
+
+.fa,.wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content .code-block-caption .headerlink,.rst-content tt.download span:first-child,.rst-content code.download span:first-child,.icon,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context{font-family:inherit}
+
+.fa:before,.wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content .code-block-caption .headerlink:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before{font-family:"FontAwesome";
+	display:inline-block;
+	font-style:normal;
+	font-weight:normal;
+	line-height:1;
+	text-decoration:inherit}
+
+a .fa,a .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li a span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,a .rst-content .admonition-title,.rst-content a .admonition-title,a .rst-content h1 .headerlink,.rst-content h1 a .headerlink,a .rst-content h2 .headerlink,.rst-content h2 a .headerlink,a .rst-content h3 .headerlink,.rst-content h3 a .headerlink,a .rst-content h4 .headerlink,.rst-content h4 a .headerlink,a .rst-content h5 .headerlink,.rst-content h5 a .headerlink,a .rst-content h6 .headerlink,.rst-content h6 a .headerlink,a .rst-content dl dt .headerlink,.rst-content dl dt a .headerlink,a .rst-content p.caption .headerlink,.rst-content p.caption a .headerlink,a .rst-content table>caption .headerlink,.rst-content table>caption a .headerlink,a .rst-content .code-block-caption .headerlink,.rst-content .code-block-caption a .headerlink,a .rst-content tt.download span:first-child,.rst-content tt.download a span:first-child,a .rst-content code.download span:first-child,.rst-content code.download a span:first-child,a .icon{display:inline-block;
+	text-decoration:inherit}
+
+.btn .fa,.btn .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .btn span.toctree-expand,.btn .wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.on a .btn span.toctree-expand,.btn .wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.current>a .btn span.toctree-expand,.btn .rst-content .admonition-title,.rst-content .btn .admonition-title,.btn .rst-content h1 .headerlink,.rst-content h1 .btn .headerlink,.btn .rst-content h2 .headerlink,.rst-content h2 .btn .headerlink,.btn .rst-content h3 .headerlink,.rst-content h3 .btn .headerlink,.btn .rst-content h4 .headerlink,.rst-content h4 .btn .headerlink,.btn .rst-content h5 .headerlink,.rst-content h5 .btn .headerlink,.btn .rst-content h6 .headerlink,.rst-content h6 .btn .headerlink,.btn .rst-content dl dt .headerlink,.rst-content dl dt .btn .headerlink,.btn .rst-content p.caption .headerlink,.rst-content p.caption .btn .headerlink,.btn .rst-content table>caption .headerlink,.rst-content table>caption .btn .headerlink,.btn .rst-content .code-block-caption .headerlink,.rst-content .code-block-caption .btn .headerlink,.btn .rst-content tt.download span:first-child,.rst-content tt.download .btn span:first-child,.btn .rst-content code.download span:first-child,.rst-content code.download .btn span:first-child,.btn .icon,.nav .fa,.nav .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .nav span.toctree-expand,.nav .wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.on a .nav span.toctree-expand,.nav .wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.current>a .nav span.toctree-expand,.nav .rst-content .admonition-title,.rst-content .nav .admonition-title,.nav .rst-content h1 .headerlink,.rst-content h1 .nav .headerlink,.nav .rst-content h2 .headerlink,.rst-content h2 .nav .headerlink,.nav .rst-content h3 .headerlink,.rst-content h3 .nav .headerlink,.nav .rst-content h4 .headerlink,.rst-content h4 .nav .headerlink,.nav .rst-content h5 .headerlink,.rst-content h5 .nav .headerlink,.nav .rst-content h6 .headerlink,.rst-content h6 .nav .headerlink,.nav .rst-content dl dt .headerlink,.rst-content dl dt .nav .headerlink,.nav .rst-content p.caption .headerlink,.rst-content p.caption .nav .headerlink,.nav .rst-content table>caption .headerlink,.rst-content table>caption .nav .headerlink,.nav .rst-content .code-block-caption .headerlink,.rst-content .code-block-caption .nav .headerlink,.nav .rst-content tt.download span:first-child,.rst-content tt.download .nav span:first-child,.nav .rst-content code.download span:first-child,.rst-content code.download .nav span:first-child,.nav .icon{display:inline}
+
+.btn .fa.fa-large,.btn .wy-menu-vertical li span.fa-large.toctree-expand,.wy-menu-vertical li .btn span.fa-large.toctree-expand,.btn .rst-content .fa-large.admonition-title,.rst-content .btn .fa-large.admonition-title,.btn .rst-content h1 .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.btn .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .btn .fa-large.headerlink,.btn .rst-content p.caption .fa-large.headerlink,.rst-content p.caption .btn .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.btn .rst-content .code-block-caption .fa-large.headerlink,.rst-content .code-block-caption .btn .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.rst-content tt.download .btn span.fa-large:first-child,.btn .rst-content code.download span.fa-large:first-child,.rst-content code.download .btn span.fa-large:first-child,.btn .fa-large.icon,.nav .fa.fa-large,.nav .wy-menu-vertical li span.fa-large.toctree-expand,.wy-menu-vertical li .nav span.fa-large.toctree-expand,.nav .rst-content .fa-large.admonition-title,.rst-content .nav .fa-large.admonition-title,.nav .rst-content h1 .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.nav .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.nav .rst-content p.caption .fa-large.headerlink,.rst-content p.caption .nav .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.nav .rst-content .code-block-caption .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.nav .rst-content code.download span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.nav .fa-large.icon{line-height:.9em}
+
+.btn .fa.fa-spin,.btn .wy-menu-vertical li span.fa-spin.toctree-expand,.wy-menu-vertical li .btn span.fa-spin.toctree-expand,.btn .rst-content .fa-spin.admonition-title,.rst-content .btn .fa-spin.admonition-title,.btn .rst-content h1 .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.btn .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .btn .fa-spin.headerlink,.btn .rst-content p.caption .fa-spin.headerlink,.rst-content p.caption .btn .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.btn .rst-content .code-block-caption .fa-spin.headerlink,.rst-content .code-block-caption .btn .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.rst-content tt.download .btn span.fa-spin:first-child,.btn .rst-content code.download span.fa-spin:first-child,.rst-content code.download .btn span.fa-spin:first-child,.btn .fa-spin.icon,.nav .fa.fa-spin,.nav .wy-menu-vertical li span.fa-spin.toctree-expand,.wy-menu-vertical li .nav span.fa-spin.toctree-expand,.nav .rst-content .fa-spin.admonition-title,.rst-content .nav .fa-spin.admonition-title,.nav .rst-content h1 .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.nav .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.nav .rst-content p.caption .fa-spin.headerlink,.rst-content p.caption .nav .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.nav .rst-content .code-block-caption .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.nav .rst-content code.download span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.nav .fa-spin.icon{display:inline-block}
+
+.btn.fa:before,.wy-menu-vertical li span.btn.toctree-expand:before,.rst-content .btn.admonition-title:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content dl dt .btn.headerlink:before,.rst-content p.caption .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.rst-content code.download span.btn:first-child:before,.btn.icon:before{opacity:.5;
+	-webkit-transition:opacity .05s ease-in;
+	-moz-transition:opacity .05s ease-in;
+	transition:opacity .05s ease-in}
+
+.btn.fa:hover:before,.wy-menu-vertical li span.btn.toctree-expand:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content p.caption .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.rst-content code.download span.btn:first-child:hover:before,.btn.icon:hover:before{opacity:1}
+
+.btn-mini .fa:before,.btn-mini .wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li .btn-mini span.toctree-expand:before,.btn-mini .rst-content .admonition-title:before,.rst-content .btn-mini .admonition-title:before,.btn-mini .rst-content h1 .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.btn-mini .rst-content dl dt .headerlink:before,.rst-content dl dt .btn-mini .headerlink:before,.btn-mini .rst-content p.caption .headerlink:before,.rst-content p.caption .btn-mini .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.rst-content tt.download .btn-mini span:first-child:before,.btn-mini .rst-content code.download span:first-child:before,.rst-content code.download .btn-mini span:first-child:before,.btn-mini .icon:before{font-size:14px;
+	vertical-align:-15%}
+
+.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.rst-content .admonition{padding:12px;
+	line-height:24px;
+	margin-bottom:24px;
+	background:#e7f2fa}
+
+.wy-alert-title,.rst-content .admonition-title{color:#fff;
+	font-weight:bold;
+	display:block;
+	color:#fff;
+	background:#6ab0de;
+	margin:-12px;
+	padding:6px 12px;
+	margin-bottom:12px}
+
+.wy-alert.wy-alert-danger,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.admonition{background:#fdf3f2}
+
+.wy-alert.wy-alert-danger .wy-alert-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .danger .wy-alert-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .danger .admonition-title,.rst-content .error .admonition-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition .admonition-title{background:#f29f97}
+
+.wy-alert.wy-alert-warning,.rst-content .wy-alert-warning.note,.rst-content .attention,.rst-content .caution,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.tip,.rst-content .warning,.rst-content .wy-alert-warning.seealso,.rst-content .admonition-todo,.rst-content .wy-alert-warning.admonition{background:#ffedcc}
+
+.wy-alert.wy-alert-warning .wy-alert-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .attention .wy-alert-title,.rst-content .caution .wy-alert-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .attention .admonition-title,.rst-content .caution .admonition-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .warning .admonition-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .admonition-todo .admonition-title,.rst-content .wy-alert-warning.admonition .admonition-title{background:#f0b37e}
+
+.wy-alert.wy-alert-info,.rst-content .note,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.rst-content .seealso,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.admonition{background:#e7f2fa}
+
+.wy-alert.wy-alert-info .wy-alert-title,.rst-content .note .wy-alert-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.rst-content .note .admonition-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .seealso .admonition-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition .admonition-title{background:#6ab0de}
+
+.wy-alert.wy-alert-success,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.warning,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.admonition{background:#dbfaf4}
+
+.wy-alert.wy-alert-success .wy-alert-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .hint .wy-alert-title,.rst-content .important .wy-alert-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .hint .admonition-title,.rst-content .important .admonition-title,.rst-content .tip .admonition-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition .admonition-title{background:#1abc9c}
+
+.wy-alert.wy-alert-neutral,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.admonition{background:#f3f6f6}
+
+.wy-alert.wy-alert-neutral .wy-alert-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition .admonition-title{color:#404040;
+	background:#e1e4e5}
+
+.wy-alert.wy-alert-neutral a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a{color:#2980B9}
+
+.wy-alert p:last-child,.rst-content .note p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.rst-content .seealso p:last-child,.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child{margin-bottom:0}
+
+.wy-tray-container{position:fixed;
+	bottom:0px;
+	left:0;
+	z-index:600}
+
+.wy-tray-container li{display:block;
+	width:300px;
+	background:transparent;
+	color:#fff;
+	text-align:center;
+	box-shadow:0 5px 5px 0 rgba(0,0,0,0.1);
+	padding:0 24px;
+	min-width:20%;
+	opacity:0;
+	height:0;
+	line-height:56px;
+	overflow:hidden;
+	-webkit-transition:all .3s ease-in;
+	-moz-transition:all .3s ease-in;
+	transition:all .3s ease-in}
+
+.wy-tray-container li.wy-tray-item-success{background:#27AE60}
+
+.wy-tray-container li.wy-tray-item-info{background:#2980B9}
+
+.wy-tray-container li.wy-tray-item-warning{background:#E67E22}
+
+.wy-tray-container li.wy-tray-item-danger{background:#E74C3C}
+
+.wy-tray-container li.on{opacity:1;
+	height:56px}
+
+@media screen and (max-width: 768px){.wy-tray-container{bottom:auto;
+	top:0;
+	width:100%}
+
+.wy-tray-container li{width:100%}
+
+}
+
+button{font-size:100%;
+	margin:0;
+	vertical-align:baseline;
+	*vertical-align:middle;
+	cursor:pointer;
+	line-height:normal;
+	-webkit-appearance:button;
+	*overflow:visible}
+
+button::-moz-focus-inner,input::-moz-focus-inner{border:0;
+	padding:0}
+
+button[disabled]{cursor:default}
+
+.btn{display:inline-block;
+	border-radius:2px;
+	line-height:normal;
+	white-space:nowrap;
+	text-align:center;
+	cursor:pointer;
+	font-size:100%;
+	padding:6px 12px 8px 12px;
+	color:#fff;
+	border:1px solid rgba(0,0,0,0.1);
+	background-color:#27AE60;
+	text-decoration:none;
+	font-weight:normal;
+	font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;
+	box-shadow:0px 1px 2px -1px rgba(255,255,255,0.5) inset,0px -2px 0px 0px rgba(0,0,0,0.1) inset;
+	outline-none:false;
+	vertical-align:middle;
+	*display:inline;
+	zoom:1;
+	-webkit-user-drag:none;
+	-webkit-user-select:none;
+	-moz-user-select:none;
+	-ms-user-select:none;
+	user-select:none;
+	-webkit-transition:all .1s linear;
+	-moz-transition:all .1s linear;
+	transition:all .1s linear}
+
+.btn-hover{background:#2e8ece;
+	color:#fff}
+
+.btn:hover{background:#2cc36b;
+	color:#fff}
+
+.btn:focus{background:#2cc36b;
+	outline:0}
+
+.btn:active{box-shadow:0px -1px 0px 0px rgba(0,0,0,0.05) inset,0px 2px 0px 0px rgba(0,0,0,0.1) inset;
+	padding:8px 12px 6px 12px}
+
+.btn:visited{color:#fff}
+
+.btn:disabled{background-image:none;
+	filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);
+	filter:alpha(opacity=40);
+	opacity:.4;
+	cursor:not-allowed;
+	box-shadow:none}
+
+.btn-disabled{background-image:none;
+	filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);
+	filter:alpha(opacity=40);
+	opacity:.4;
+	cursor:not-allowed;
+	box-shadow:none}
+
+.btn-disabled:hover,.btn-disabled:focus,.btn-disabled:active{background-image:none;
+	filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);
+	filter:alpha(opacity=40);
+	opacity:.4;
+	cursor:not-allowed;
+	box-shadow:none}
+
+.btn::-moz-focus-inner{padding:0;
+	border:0}
+
+.btn-small{font-size:80%}
+
+.btn-info{background-color:#2980B9 !important}
+
+.btn-info:hover{background-color:#2e8ece !important}
+
+.btn-neutral{background-color:#f3f6f6 !important;
+	color:#404040 !important}
+
+.btn-neutral:hover{background-color:#e5ebeb !important;
+	color:#404040}
+
+.btn-neutral:visited{color:#404040 !important}
+
+.btn-success{background-color:#27AE60 !important}
+
+.btn-success:hover{background-color:#295 !important}
+
+.btn-danger{background-color:#E74C3C !important}
+
+.btn-danger:hover{background-color:#ea6153 !important}
+
+.btn-warning{background-color:#E67E22 !important}
+
+.btn-warning:hover{background-color:#e98b39 !important}
+
+.btn-invert{background-color:#222}
+
+.btn-invert:hover{background-color:#2f2f2f !important}
+
+.btn-link{background-color:transparent !important;
+	color:#2980B9;
+	box-shadow:none;
+	border-color:transparent !important}
+
+.btn-link:hover{background-color:transparent !important;
+	color:#409ad5 !important;
+	box-shadow:none}
+
+.btn-link:active{background-color:transparent !important;
+	color:#409ad5 !important;
+	box-shadow:none}
+
+.btn-link:visited{color:#9B59B6}
+
+.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}
+
+.wy-btn-group{margin-bottom:24px;
+	*zoom:1}
+
+.wy-btn-group:before,.wy-btn-group:after{display:table;
+	content:""}
+
+.wy-btn-group:after{clear:both}
+
+.wy-dropdown{position:relative;
+	display:inline-block}
+
+.wy-dropdown-active .wy-dropdown-menu{display:block}
+
+.wy-dropdown-menu{position:absolute;
+	left:0;
+	display:none;
+	float:left;
+	top:100%;
+	min-width:100%;
+	background:#fcfcfc;
+	z-index:100;
+	border:solid 1px #cfd7dd;
+	box-shadow:0 2px 2px 0 rgba(0,0,0,0.1);
+	padding:12px}
+
+.wy-dropdown-menu>dd>a{display:block;
+	clear:both;
+	color:#404040;
+	white-space:nowrap;
+	font-size:90%;
+	padding:0 12px;
+	cursor:pointer}
+
+.wy-dropdown-menu>dd>a:hover{background:#2980B9;
+	color:#fff}
+
+.wy-dropdown-menu>dd.divider{border-top:solid 1px #cfd7dd;
+	margin:6px 0}
+
+.wy-dropdown-menu>dd.search{padding-bottom:12px}
+
+.wy-dropdown-menu>dd.search input[type="search"]{width:100%}
+
+.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;
+	text-transform:uppercase;
+	font-weight:500;
+	font-size:80%}
+
+.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}
+
+.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}
+
+.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;
+	top:auto;
+	left:auto;
+	right:0}
+
+.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;
+	margin-top:2px}
+
+.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}
+
+.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980B9;
+	color:#fff}
+
+.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;
+	left:auto;
+	text-align:right}
+
+.wy-dropdown-arrow:before{content:" ";
+	border-bottom:5px solid #f5f5f5;
+	border-left:5px solid transparent;
+	border-right:5px solid transparent;
+	position:absolute;
+	display:block;
+	top:-4px;
+	left:50%;
+	margin-left:-3px}
+
+.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}
+
+.wy-form-stacked select{display:block}
+
+.wy-form-aligned input,.wy-form-aligned textarea,.wy-form-aligned select,.wy-form-aligned .wy-help-inline,.wy-form-aligned label{display:inline-block;
+	*display:inline;
+	*zoom:1;
+	vertical-align:middle}
+
+.wy-form-aligned .wy-control-group>label{display:inline-block;
+	vertical-align:middle;
+	width:10em;
+	margin:6px 12px 0 0;
+	float:left}
+
+.wy-form-aligned .wy-control{float:left}
+
+.wy-form-aligned .wy-control label{display:block}
+
+.wy-form-aligned .wy-control select{margin-top:6px}
+
+fieldset{border:0;
+	margin:0;
+	padding:0}
+
+legend{display:block;
+	width:100%;
+	border:0;
+	padding:0;
+	white-space:normal;
+	margin-bottom:24px;
+	font-size:150%;
+	*margin-left:-7px}
+
+label{display:block;
+	margin:0 0 .3125em 0;
+	color:#333;
+	font-size:90%}
+
+input,select,textarea{font-size:100%;
+	margin:0;
+	vertical-align:baseline;
+	*vertical-align:middle}
+
+.wy-control-group{margin-bottom:24px;
+	*zoom:1;
+	max-width:68em;
+	margin-left:auto;
+	margin-right:auto;
+	*zoom:1}
+
+.wy-control-group:before,.wy-control-group:after{display:table;
+	content:""}
+
+.wy-control-group:after{clear:both}
+
+.wy-control-group:before,.wy-control-group:after{display:table;
+	content:""}
+
+.wy-control-group:after{clear:both}
+
+.wy-control-group.wy-control-group-required>label:after{content:" *";
+	color:#E74C3C}
+
+.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}
+
+.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds select{width:100%}
+
+.wy-control-group .wy-form-full input[type="text"],.wy-control-group .wy-form-full input[type="password"],.wy-control-group .wy-form-full input[type="email"],.wy-control-group .wy-form-full input[type="url"],.wy-control-group .wy-form-full input[type="date"],.wy-control-group .wy-form-full input[type="month"],.wy-control-group .wy-form-full input[type="time"],.wy-control-group .wy-form-full input[type="datetime"],.wy-control-group .wy-form-full input[type="datetime-local"],.wy-control-group .wy-form-full input[type="week"],.wy-control-group .wy-form-full input[type="number"],.wy-control-group .wy-form-full input[type="search"],.wy-control-group .wy-form-full input[type="tel"],.wy-control-group .wy-form-full input[type="color"],.wy-control-group .wy-form-halves input[type="text"],.wy-control-group .wy-form-halves input[type="password"],.wy-control-group .wy-form-halves input[type="email"],.wy-control-group .wy-form-halves input[type="url"],.wy-control-group .wy-form-halves input[type="date"],.wy-control-group .wy-form-halves input[type="month"],.wy-control-group .wy-form-halves input[type="time"],.wy-control-group .wy-form-halves input[type="datetime"],.wy-control-group .wy-form-halves input[type="datetime-local"],.wy-control-group .wy-form-halves input[type="week"],.wy-control-group .wy-form-halves input[type="number"],.wy-control-group .wy-form-halves input[type="search"],.wy-control-group .wy-form-halves input[type="tel"],.wy-control-group .wy-form-halves input[type="color"],.wy-control-group .wy-form-thirds input[type="text"],.wy-control-group .wy-form-thirds input[type="password"],.wy-control-group .wy-form-thirds input[type="email"],.wy-control-group .wy-form-thirds input[type="url"],.wy-control-group .wy-form-thirds input[type="date"],.wy-control-group .wy-form-thirds input[type="month"],.wy-control-group .wy-form-thirds input[type="time"],.wy-control-group .wy-form-thirds input[type="datetime"],.wy-control-group .wy-form-thirds input[type="datetime-local"],.wy-control-group .wy-form-thirds input[type="week"],.wy-control-group .wy-form-thirds input[type="number"],.wy-control-group .wy-form-thirds input[type="search"],.wy-control-group .wy-form-thirds input[type="tel"],.wy-control-group .wy-form-thirds input[type="color"]{width:100%}
+
+.wy-control-group .wy-form-full{float:left;
+	display:block;
+	margin-right:2.3576515979%;
+	width:100%;
+	margin-right:0}
+
+.wy-control-group .wy-form-full:last-child{margin-right:0}
+
+.wy-control-group .wy-form-halves{float:left;
+	display:block;
+	margin-right:2.3576515979%;
+	width:48.821174201%}
+
+.wy-control-group .wy-form-halves:last-child{margin-right:0}
+
+.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}
+
+.wy-control-group .wy-form-halves:nth-of-type(2n+1){clear:left}
+
+.wy-control-group .wy-form-thirds{float:left;
+	display:block;
+	margin-right:2.3576515979%;
+	width:31.7615656014%}
+
+.wy-control-group .wy-form-thirds:last-child{margin-right:0}
+
+.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}
+
+.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}
+
+.wy-control-group.wy-control-group-no-input .wy-control{margin:6px 0 0 0;
+	font-size:90%}
+
+.wy-control-no-input{display:inline-block;
+	margin:6px 0 0 0;
+	font-size:90%}
+
+.wy-control-group.fluid-input input[type="text"],.wy-control-group.fluid-input input[type="password"],.wy-control-group.fluid-input input[type="email"],.wy-control-group.fluid-input input[type="url"],.wy-control-group.fluid-input input[type="date"],.wy-control-group.fluid-input input[type="month"],.wy-control-group.fluid-input input[type="time"],.wy-control-group.fluid-input input[type="datetime"],.wy-control-group.fluid-input input[type="datetime-local"],.wy-control-group.fluid-input input[type="week"],.wy-control-group.fluid-input input[type="number"],.wy-control-group.fluid-input input[type="search"],.wy-control-group.fluid-input input[type="tel"],.wy-control-group.fluid-input input[type="color"]{width:100%}
+
+.wy-form-message-inline{display:inline-block;
+	padding-left:.3em;
+	color:#666;
+	vertical-align:middle;
+	font-size:90%}
+
+.wy-form-message{display:block;
+	color:#999;
+	font-size:70%;
+	margin-top:.3125em;
+	font-style:italic}
+
+.wy-form-message p{font-size:inherit;
+	font-style:italic;
+	margin-bottom:6px}
+
+.wy-form-message p:last-child{margin-bottom:0}
+
+input{line-height:normal}
+
+input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;
+	cursor:pointer;
+	font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;
+	*overflow:visible}
+
+input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"]{-webkit-appearance:none;
+	padding:6px;
+	display:inline-block;
+	border:1px solid #ccc;
+	font-size:80%;
+	font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;
+	box-shadow:inset 0 1px 3px #ddd;
+	border-radius:0;
+	-webkit-transition:border .3s linear;
+	-moz-transition:border .3s linear;
+	transition:border .3s linear}
+
+input[type="datetime-local"]{padding:.34375em .625em}
+
+input[disabled]{cursor:default}
+
+input[type="checkbox"],input[type="radio"]{-webkit-box-sizing:border-box;
+	-moz-box-sizing:border-box;
+	box-sizing:border-box;
+	padding:0;
+	margin-right:.3125em;
+	*height:13px;
+	*width:13px}
+
+input[type="search"]{-webkit-box-sizing:border-box;
+	-moz-box-sizing:border-box;
+	box-sizing:border-box}
+
+input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}
+
+input[type="text"]:focus,input[type="password"]:focus,input[type="email"]:focus,input[type="url"]:focus,input[type="date"]:focus,input[type="month"]:focus,input[type="time"]:focus,input[type="datetime"]:focus,input[type="datetime-local"]:focus,input[type="week"]:focus,input[type="number"]:focus,input[type="search"]:focus,input[type="tel"]:focus,input[type="color"]:focus{outline:0;
+	outline:thin dotted \9;
+	border-color:#333}
+
+input.no-focus:focus{border-color:#ccc !important}
+
+input[type="file"]:focus,input[type="radio"]:focus,input[type="checkbox"]:focus{outline:thin dotted #333;
+	outline:1px auto #129FEA}
+
+input[type="text"][disabled],input[type="password"][disabled],input[type="email"][disabled],input[type="url"][disabled],input[type="date"][disabled],input[type="month"][disabled],input[type="time"][disabled],input[type="datetime"][disabled],input[type="datetime-local"][disabled],input[type="week"][disabled],input[type="number"][disabled],input[type="search"][disabled],input[type="tel"][disabled],input[type="color"][disabled]{cursor:not-allowed;
+	background-color:#fafafa}
+
+input:focus:invalid,textarea:focus:invalid,select:focus:invalid{color:#E74C3C;
+	border:1px solid #E74C3C}
+
+input:focus:invalid:focus,textarea:focus:invalid:focus,select:focus:invalid:focus{border-color:#E74C3C}
+
+input[type="file"]:focus:invalid:focus,input[type="radio"]:focus:invalid:focus,input[type="checkbox"]:focus:invalid:focus{outline-color:#E74C3C}
+
+input.wy-input-large{padding:12px;
+	font-size:100%}
+
+textarea{overflow:auto;
+	vertical-align:top;
+	width:100%;
+	font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif}
+
+select,textarea{padding:.5em .625em;
+	display:inline-block;
+	border:1px solid #ccc;
+	font-size:80%;
+	box-shadow:inset 0 1px 3px #ddd;
+	-webkit-transition:border .3s linear;
+	-moz-transition:border .3s linear;
+	transition:border .3s linear}
+
+select{border:1px solid #ccc;
+	background-color:#fff}
+
+select[multiple]{height:auto}
+
+select:focus,textarea:focus{outline:0}
+
+select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{cursor:not-allowed;
+	background-color:#fafafa}
+
+input[type="radio"][disabled],input[type="checkbox"][disabled]{cursor:not-allowed}
+
+.wy-checkbox,.wy-radio{margin:6px 0;
+	color:#404040;
+	display:block}
+
+.wy-checkbox input,.wy-radio input{vertical-align:baseline}
+
+.wy-form-message-inline{display:inline-block;
+	*display:inline;
+	*zoom:1;
+	vertical-align:middle}
+
+.wy-input-prefix,.wy-input-suffix{white-space:nowrap;
+	padding:6px}
+
+.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;
+	padding:0 8px;
+	display:inline-block;
+	font-size:80%;
+	background-color:#f3f6f6;
+	border:solid 1px #ccc;
+	color:#999}
+
+.wy-input-suffix .wy-input-context{border-left:0}
+
+.wy-input-prefix .wy-input-context{border-right:0}
+
+.wy-switch{position:relative;
+	display:block;
+	height:24px;
+	margin-top:12px;
+	cursor:pointer}
+
+.wy-switch:before{position:absolute;
+	content:"";
+	display:block;
+	left:0;
+	top:0;
+	width:36px;
+	height:12px;
+	border-radius:4px;
+	background:#ccc;
+	-webkit-transition:all .2s ease-in-out;
+	-moz-transition:all .2s ease-in-out;
+	transition:all .2s ease-in-out}
+
+.wy-switch:after{position:absolute;
+	content:"";
+	display:block;
+	width:18px;
+	height:18px;
+	border-radius:4px;
+	background:#999;
+	left:-3px;
+	top:-3px;
+	-webkit-transition:all .2s ease-in-out;
+	-moz-transition:all .2s ease-in-out;
+	transition:all .2s ease-in-out}
+
+.wy-switch span{position:absolute;
+	left:48px;
+	display:block;
+	font-size:12px;
+	color:#ccc;
+	line-height:1}
+
+.wy-switch.active:before{background:#1e8449}
+
+.wy-switch.active:after{left:24px;
+	background:#27AE60}
+
+.wy-switch.disabled{cursor:not-allowed;
+	opacity:.8}
+
+.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#E74C3C}
+
+.wy-control-group.wy-control-group-error input[type="text"],.wy-control-group.wy-control-group-error input[type="password"],.wy-control-group.wy-control-group-error input[type="email"],.wy-control-group.wy-control-group-error input[type="url"],.wy-control-group.wy-control-group-error input[type="date"],.wy-control-group.wy-control-group-error input[type="month"],.wy-control-group.wy-control-group-error input[type="time"],.wy-control-group.wy-control-group-error input[type="datetime"],.wy-control-group.wy-control-group-error input[type="datetime-local"],.wy-control-group.wy-control-group-error input[type="week"],.wy-control-group.wy-control-group-error input[type="number"],.wy-control-group.wy-control-group-error input[type="search"],.wy-control-group.wy-control-group-error input[type="tel"],.wy-control-group.wy-control-group-error input[type="color"]{border:solid 1px #E74C3C}
+
+.wy-control-group.wy-control-group-error textarea{border:solid 1px #E74C3C}
+
+.wy-inline-validate{white-space:nowrap}
+
+.wy-inline-validate .wy-input-context{padding:.5em .625em;
+	display:inline-block;
+	font-size:80%}
+
+.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27AE60}
+
+.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#E74C3C}
+
+.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#E67E22}
+
+.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980B9}
+
+.rotate-90{-webkit-transform:rotate(90deg);
+	-moz-transform:rotate(90deg);
+	-ms-transform:rotate(90deg);
+	-o-transform:rotate(90deg);
+	transform:rotate(90deg)}
+
+.rotate-180{-webkit-transform:rotate(180deg);
+	-moz-transform:rotate(180deg);
+	-ms-transform:rotate(180deg);
+	-o-transform:rotate(180deg);
+	transform:rotate(180deg)}
+
+.rotate-270{-webkit-transform:rotate(270deg);
+	-moz-transform:rotate(270deg);
+	-ms-transform:rotate(270deg);
+	-o-transform:rotate(270deg);
+	transform:rotate(270deg)}
+
+.mirror{-webkit-transform:scaleX(-1);
+	-moz-transform:scaleX(-1);
+	-ms-transform:scaleX(-1);
+	-o-transform:scaleX(-1);
+	transform:scaleX(-1)}
+
+.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);
+	-moz-transform:scaleX(-1) rotate(90deg);
+	-ms-transform:scaleX(-1) rotate(90deg);
+	-o-transform:scaleX(-1) rotate(90deg);
+	transform:scaleX(-1) rotate(90deg)}
+
+.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);
+	-moz-transform:scaleX(-1) rotate(180deg);
+	-ms-transform:scaleX(-1) rotate(180deg);
+	-o-transform:scaleX(-1) rotate(180deg);
+	transform:scaleX(-1) rotate(180deg)}
+
+.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);
+	-moz-transform:scaleX(-1) rotate(270deg);
+	-ms-transform:scaleX(-1) rotate(270deg);
+	-o-transform:scaleX(-1) rotate(270deg);
+	transform:scaleX(-1) rotate(270deg)}
+
+@media only screen and (max-width: 480px){.wy-form button[type="submit"]{margin:.7em 0 0}
+
+.wy-form input[type="text"],.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:.3em;
+	display:block}
+
+.wy-form label{margin-bottom:.3em;
+	display:block}
+
+.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:0}
+
+.wy-form-aligned .wy-control-group label{margin-bottom:.3em;
+	text-align:left;
+	display:block;
+	width:100%}
+
+.wy-form-aligned .wy-control{margin:1.5em 0 0 0}
+
+.wy-form .wy-help-inline,.wy-form-message-inline,.wy-form-message{display:block;
+	font-size:80%;
+	padding:6px 0}
+
+}
+
+@media screen and (max-width: 768px){.tablet-hide{display:none}
+
+}
+
+@media screen and (max-width: 480px){.mobile-hide{display:none}
+
+}
+
+.float-left{float:left}
+
+.float-right{float:right}
+
+.full-width{width:100%}
+
+.wy-table,.rst-content table.docutils,.rst-content table.field-list{border-collapse:collapse;
+	border-spacing:0;
+	empty-cells:show;
+	margin-bottom:24px}
+
+.wy-table caption,.rst-content table.docutils caption,.rst-content table.field-list caption{color:#000;
+	font:italic 85%/1 arial,sans-serif;
+	padding:1em 0;
+	text-align:center}
+
+.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td,.wy-table th,.rst-content table.docutils th,.rst-content table.field-list th{font-size:90%;
+	margin:0;
+	overflow:visible;
+	padding:8px 16px}
+
+.wy-table td:first-child,.rst-content table.docutils td:first-child,.rst-content table.field-list td:first-child,.wy-table th:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list th:first-child{border-left-width:0}
+
+.wy-table thead,.rst-content table.docutils thead,.rst-content table.field-list thead{color:#000;
+	text-align:left;
+	vertical-align:bottom;
+	white-space:nowrap}
+
+.wy-table thead th,.rst-content table.docutils thead th,.rst-content table.field-list thead th{font-weight:bold;
+	border-bottom:solid 2px #e1e4e5}
+
+.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td{background-color:transparent;
+	vertical-align:middle}
+
+.wy-table td p,.rst-content table.docutils td p,.rst-content table.field-list td p{line-height:18px}
+
+.wy-table td p:last-child,.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child{margin-bottom:0}
+
+.wy-table .wy-table-cell-min,.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min{width:1%;
+	padding-right:0}
+
+.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox]{margin:0}
+
+.wy-table-secondary{color:gray;
+	font-size:90%}
+
+.wy-table-tertiary{color:gray;
+	font-size:80%}
+
+.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td,.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td{background-color:#f3f6f6}
+
+.wy-table-backed{background-color:#f3f6f6}
+
+.wy-table-bordered-all,.rst-content table.docutils{border:1px solid #e1e4e5}
+
+.wy-table-bordered-all td,.rst-content table.docutils td{border-bottom:1px solid #e1e4e5;
+	border-left:1px solid #e1e4e5}
+
+.wy-table-bordered-all tbody>tr:last-child td,.rst-content table.docutils tbody>tr:last-child td{border-bottom-width:0}
+
+.wy-table-bordered{border:1px solid #e1e4e5}
+
+.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}
+
+.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}
+
+.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}
+
+.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px 0;
+	border-bottom:1px solid #e1e4e5}
+
+.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}
+
+.wy-table-responsive{margin-bottom:24px;
+	max-width:100%;
+	overflow:auto}
+
+.wy-table-responsive table{margin-bottom:0 !important}
+
+.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}
+
+a{color:#2980B9;
+	text-decoration:none;
+	cursor:pointer}
+
+a:hover{color:#3091d1}
+
+a:visited{color:#9B59B6}
+
+html{height:100%;
+	overflow-x:hidden}
+
+body{font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;
+	font-weight:normal;
+	color:#404040;
+	min-height:100%;
+	overflow-x:hidden;
+	background:#edf0f2}
+
+.wy-text-left{text-align:left}
+
+.wy-text-center{text-align:center}
+
+.wy-text-right{text-align:right}
+
+.wy-text-large{font-size:120%}
+
+.wy-text-normal{font-size:100%}
+
+.wy-text-small,small{font-size:80%}
+
+.wy-text-strike{text-decoration:line-through}
+
+.wy-text-warning{color:#E67E22 !important}
+
+a.wy-text-warning:hover{color:#eb9950 !important}
+
+.wy-text-info{color:#2980B9 !important}
+
+a.wy-text-info:hover{color:#409ad5 !important}
+
+.wy-text-success{color:#27AE60 !important}
+
+a.wy-text-success:hover{color:#36d278 !important}
+
+.wy-text-danger{color:#E74C3C !important}
+
+a.wy-text-danger:hover{color:#ed7669 !important}
+
+.wy-text-neutral{color:#404040 !important}
+
+a.wy-text-neutral:hover{color:#595959 !important}
+
+h1,h2,.rst-content .toctree-wrapper p.caption,h3,h4,h5,h6,legend{margin-top:0;
+	font-weight:700;
+	font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif}
+
+p{line-height:24px;
+	margin:0;
+	font-size:16px;
+	margin-bottom:24px}
+
+h1{font-size:175%}
+
+h2,.rst-content .toctree-wrapper p.caption{font-size:150%}
+
+h3{font-size:125%}
+
+h4{font-size:115%}
+
+h5{font-size:110%}
+
+h6{font-size:100%}
+
+hr{display:block;
+	height:1px;
+	border:0;
+	border-top:1px solid #e1e4e5;
+	margin:24px 0;
+	padding:0}
+
+code,.rst-content tt,.rst-content code{white-space:nowrap;
+	max-width:100%;
+	background:#fff;
+	border:solid 1px #e1e4e5;
+	font-size:75%;
+	padding:0 5px;
+	font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;
+	color:#E74C3C;
+	overflow-x:auto}
+
+code.code-large,.rst-content tt.code-large{font-size:90%}
+
+.wy-plain-list-disc,.rst-content .section ul,.rst-content .toctree-wrapper ul,article ul{list-style:disc;
+	line-height:24px;
+	margin-bottom:24px}
+
+.wy-plain-list-disc li,.rst-content .section ul li,.rst-content .toctree-wrapper ul li,article ul li{list-style:disc;
+	margin-left:24px}
+
+.wy-plain-list-disc li p:last-child,.rst-content .section ul li p:last-child,.rst-content .toctree-wrapper ul li p:last-child,article ul li p:last-child{margin-bottom:0}
+
+.wy-plain-list-disc li ul,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li ul,article ul li ul{margin-bottom:0}
+
+.wy-plain-list-disc li li,.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,article ul li li{list-style:circle}
+
+.wy-plain-list-disc li li li,.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,article ul li li li{list-style:square}
+
+.wy-plain-list-disc li ol li,.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,article ul li ol li{list-style:decimal}
+
+.wy-plain-list-decimal,.rst-content .section ol,.rst-content ol.arabic,article ol{list-style:decimal;
+	line-height:24px;
+	margin-bottom:24px}
+
+.wy-plain-list-decimal li,.rst-content .section ol li,.rst-content ol.arabic li,article ol li{list-style:decimal;
+	margin-left:24px}
+
+.wy-plain-list-decimal li p:last-child,.rst-content .section ol li p:last-child,.rst-content ol.arabic li p:last-child,article ol li p:last-child{margin-bottom:0}
+
+.wy-plain-list-decimal li ul,.rst-content .section ol li ul,.rst-content ol.arabic li ul,article ol li ul{margin-bottom:0}
+
+.wy-plain-list-decimal li ul li,.rst-content .section ol li ul li,.rst-content ol.arabic li ul li,article ol li ul li{list-style:disc}
+
+.wy-breadcrumbs{*zoom:1}
+
+.wy-breadcrumbs:before,.wy-breadcrumbs:after{display:table;
+	content:""}
+
+.wy-breadcrumbs:after{clear:both}
+
+.wy-breadcrumbs li{display:inline-block}
+
+.wy-breadcrumbs li.wy-breadcrumbs-aside{float:right}
+
+.wy-breadcrumbs li a{display:inline-block;
+	padding:5px}
+
+.wy-breadcrumbs li a:first-child{padding-left:0}
+
+.wy-breadcrumbs li code,.wy-breadcrumbs li .rst-content tt,.rst-content .wy-breadcrumbs li tt{padding:5px;
+	border:none;
+	background:none}
+
+.wy-breadcrumbs li code.literal,.wy-breadcrumbs li .rst-content tt.literal,.rst-content .wy-breadcrumbs li tt.literal{color:#404040}
+
+.wy-breadcrumbs-extra{margin-bottom:0;
+	color:#b3b3b3;
+	font-size:80%;
+	display:inline-block}
+
+@media screen and (max-width: 480px){.wy-breadcrumbs-extra{display:none}
+
+.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}
+
+}
+
+@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}
+
+}
+
+html{font-size:16px}
+
+.wy-affix{position:fixed;
+	top:1.618em}
+
+.wy-menu a:hover{text-decoration:none}
+
+.wy-menu-horiz{*zoom:1}
+
+.wy-menu-horiz:before,.wy-menu-horiz:after{display:table;
+	content:""}
+
+.wy-menu-horiz:after{clear:both}
+
+.wy-menu-horiz ul,.wy-menu-horiz li{display:inline-block}
+
+.wy-menu-horiz li:hover{background:rgba(255,255,255,0.1)}
+
+.wy-menu-horiz li.divide-left{border-left:solid 1px #404040}
+
+.wy-menu-horiz li.divide-right{border-right:solid 1px #404040}
+
+.wy-menu-horiz a{height:32px;
+	display:inline-block;
+	line-height:32px;
+	padding:0 16px}
+
+.wy-menu-vertical{width:300px}
+
+.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#3a7ca8;
+	height:32px;
+	display:inline-block;
+	line-height:32px;
+	padding:0 1.618em;
+	margin:12px 0 0 0;
+	display:block;
+	font-weight:bold;
+	text-transform:uppercase;
+	font-size:85%;
+	white-space:nowrap}
+
+.wy-menu-vertical ul{margin-bottom:0}
+
+.wy-menu-vertical li.divide-top{border-top:solid 1px #404040}
+
+.wy-menu-vertical li.divide-bottom{border-bottom:solid 1px #404040}
+
+.wy-menu-vertical li.current{background:#e3e3e3}
+
+.wy-menu-vertical li.current a{color:gray;
+	border-right:solid 1px #c9c9c9;
+	padding:.4045em 2.427em}
+
+.wy-menu-vertical li.current a:hover{background:#d6d6d6}
+
+.wy-menu-vertical li code,.wy-menu-vertical li .rst-content tt,.rst-content .wy-menu-vertical li tt{border:none;
+	background:inherit;
+	color:inherit;
+	padding-left:0;
+	padding-right:0}
+
+.wy-menu-vertical li span.toctree-expand{display:block;
+	float:left;
+	margin-left:-1.2em;
+	font-size:.8em;
+	line-height:1.6em;
+	color:#4d4d4d}
+
+.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a{color:#404040;
+	padding:.4045em 1.618em;
+	font-weight:bold;
+	position:relative;
+	background:#fcfcfc;
+	border:none;
+	padding-left:1.618em -4px}
+
+.wy-menu-vertical li.on a:hover,.wy-menu-vertical li.current>a:hover{background:#fcfcfc}
+
+.wy-menu-vertical li.on a:hover span.toctree-expand,.wy-menu-vertical li.current>a:hover span.toctree-expand{color:gray}
+
+.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand{display:block;
+	font-size:.8em;
+	line-height:1.6em;
+	color:#333}
+
+.wy-menu-vertical li.toctree-l1.current>a{border-bottom:solid 1px #c9c9c9;
+	border-top:solid 1px #c9c9c9}
+
+.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a{color:#404040}
+
+.wy-menu-vertical li.toctree-l1.current li.toctree-l2>ul,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>ul{display:none}
+
+.wy-menu-vertical li.toctree-l1.current li.toctree-l2.current>ul,.wy-menu-vertical li.toctree-l2.current li.toctree-l3.current>ul{display:block}
+
+.wy-menu-vertical li.toctree-l2.current>a{background:#c9c9c9;
+	padding:.4045em 2.427em}
+
+.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{display:block;
+	background:#c9c9c9;
+	padding:.4045em 4.045em}
+
+.wy-menu-vertical li.toctree-l2 a:hover span.toctree-expand{color:gray}
+
+.wy-menu-vertical li.toctree-l2 span.toctree-expand{color:#a3a3a3}
+
+.wy-menu-vertical li.toctree-l3{font-size:.9em}
+
+.wy-menu-vertical li.toctree-l3.current>a{background:#bdbdbd;
+	padding:.4045em 4.045em}
+
+.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{display:block;
+	background:#bdbdbd;
+	padding:.4045em 5.663em}
+
+.wy-menu-vertical li.toctree-l3 a:hover span.toctree-expand{color:gray}
+
+.wy-menu-vertical li.toctree-l3 span.toctree-expand{color:#969696}
+
+.wy-menu-vertical li.toctree-l4{font-size:.9em}
+
+.wy-menu-vertical li.current ul{display:block}
+
+.wy-menu-vertical li ul{margin-bottom:0;
+	display:none}
+
+.wy-menu-vertical li ul li a{margin-bottom:0;
+	color:#d9d9d9;
+	font-weight:normal}
+
+.wy-menu-vertical a{display:inline-block;
+	line-height:18px;
+	padding:.4045em 1.618em;
+	display:block;
+	position:relative;
+	font-size:90%;
+	color:#d9d9d9}
+
+.wy-menu-vertical a:hover{background-color:#4e4a4a;
+	cursor:pointer}
+
+.wy-menu-vertical a:hover span.toctree-expand{color:#d9d9d9}
+
+.wy-menu-vertical a:active{background-color:#2980B9;
+	cursor:pointer;
+	color:#fff}
+
+.wy-menu-vertical a:active span.toctree-expand{color:#fff}
+
+.wy-side-nav-search{display:block;
+	width:300px;
+	padding:.809em;
+	margin-bottom:.809em;
+	z-index:200;
+	background-color:#2980B9;
+	text-align:center;
+	padding:.809em;
+	display:block;
+	color:#fcfcfc;
+	margin-bottom:.809em}
+
+.wy-side-nav-search input[type=text]{width:100%;
+	border-radius:50px;
+	padding:6px 12px;
+	border-color:#2472a4}
+
+.wy-side-nav-search img{display:block;
+	margin:auto auto .809em auto;
+	height:45px;
+	width:45px;
+	background-color:#2980B9;
+	padding:5px;
+	border-radius:100%}
+
+.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a{color:#fcfcfc;
+	font-size:100%;
+	font-weight:bold;
+	display:inline-block;
+	padding:4px 6px;
+	margin-bottom:.809em}
+
+.wy-side-nav-search>a:hover,.wy-side-nav-search .wy-dropdown>a:hover{background:rgba(255,255,255,0.1)}
+
+.wy-side-nav-search>a img.logo,.wy-side-nav-search .wy-dropdown>a img.logo{display:block;
+	margin:0 auto;
+	height:auto;
+	width:auto;
+	border-radius:0;
+	max-width:100%;
+	background:transparent}
+
+.wy-side-nav-search>a.icon img.logo,.wy-side-nav-search .wy-dropdown>a.icon img.logo{margin-top:.85em}
+
+.wy-side-nav-search>div.version{margin-top:-.4045em;
+	margin-bottom:.809em;
+	font-weight:normal;
+	color:rgba(255,255,255,0.3)}
+
+.wy-nav .wy-menu-vertical header{color:#2980B9}
+
+.wy-nav .wy-menu-vertical a{color:#b3b3b3}
+
+.wy-nav .wy-menu-vertical a:hover{background-color:#2980B9;
+	color:#fff}
+
+[data-menu-wrap]{-webkit-transition:all .2s ease-in;
+	-moz-transition:all .2s ease-in;
+	transition:all .2s ease-in;
+	position:absolute;
+	opacity:1;
+	width:100%;
+	opacity:0}
+
+[data-menu-wrap].move-center{left:0;
+	right:auto;
+	opacity:1}
+
+[data-menu-wrap].move-left{right:auto;
+	left:-100%;
+	opacity:0}
+
+[data-menu-wrap].move-right{right:-100%;
+	left:auto;
+	opacity:0}
+
+.wy-body-for-nav{background:#fcfcfc}
+
+.wy-grid-for-nav{position:absolute;
+	width:100%;
+	height:100%}
+
+.wy-nav-side{position:fixed;
+	top:0;
+	bottom:0;
+	left:0;
+	padding-bottom:2em;
+	width:300px;
+	overflow-x:hidden;
+	overflow-y:hidden;
+	min-height:100%;
+	color:#9b9b9b;
+	background:#343131;
+	z-index:200}
+
+.wy-side-scroll{width:320px;
+	position:relative;
+	overflow-x:hidden;
+	overflow-y:scroll;
+	height:100%}
+
+.wy-nav-top{display:none;
+	background:#2980B9;
+	color:#fff;
+	padding:.4045em .809em;
+	position:relative;
+	line-height:50px;
+	text-align:center;
+	font-size:100%;
+	*zoom:1}
+
+.wy-nav-top:before,.wy-nav-top:after{display:table;
+	content:""}
+
+.wy-nav-top:after{clear:both}
+
+.wy-nav-top a{color:#fff;
+	font-weight:bold}
+
+.wy-nav-top img{margin-right:12px;
+	height:45px;
+	width:45px;
+	background-color:#2980B9;
+	padding:5px;
+	border-radius:100%}
+
+.wy-nav-top i{font-size:30px;
+	float:left;
+	cursor:pointer;
+	padding-top:inherit}
+
+.wy-nav-content-wrap{margin-left:300px;
+	background:#fcfcfc;
+	min-height:100%}
+
+.wy-nav-content{padding:1.618em 3.236em;
+	height:100%;
+	max-width:800px;
+	margin:auto}
+
+.wy-body-mask{position:fixed;
+	width:100%;
+	height:100%;
+	background:rgba(0,0,0,0.2);
+	display:none;
+	z-index:499}
+
+.wy-body-mask.on{display:block}
+
+footer{color:gray}
+
+footer p{margin-bottom:12px}
+
+footer span.commit code,footer span.commit .rst-content tt,.rst-content footer span.commit tt{padding:0px;
+	font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;
+	font-size:1em;
+	background:none;
+	border:none;
+	color:gray}
+
+.rst-footer-buttons{*zoom:1}
+
+.rst-footer-buttons:before,.rst-footer-buttons:after{width:100%}
+
+.rst-footer-buttons:before,.rst-footer-buttons:after{display:table;
+	content:""}
+
+.rst-footer-buttons:after{clear:both}
+
+.rst-breadcrumbs-buttons{margin-top:12px;
+	*zoom:1}
+
+.rst-breadcrumbs-buttons:before,.rst-breadcrumbs-buttons:after{display:table;
+	content:""}
+
+.rst-breadcrumbs-buttons:after{clear:both}
+
+#search-results .search li{margin-bottom:24px;
+	border-bottom:solid 1px #e1e4e5;
+	padding-bottom:24px}
+
+#search-results .search li:first-child{border-top:solid 1px #e1e4e5;
+	padding-top:24px}
+
+#search-results .search li a{font-size:120%;
+	margin-bottom:12px;
+	display:inline-block}
+
+#search-results .context{color:gray;
+	font-size:90%}
+
+.genindextable li>ul{margin-left:24px}
+
+@media screen and (max-width: 768px){.wy-body-for-nav{background:#fcfcfc}
+
+.wy-nav-top{display:block}
+
+.wy-nav-side{left:-300px}
+
+.wy-nav-side.shift{width:85%;
+	left:0}
+
+.wy-side-scroll{width:auto}
+
+.wy-side-nav-search{width:auto}
+
+.wy-menu.wy-menu-vertical{width:auto}
+
+.wy-nav-content-wrap{margin-left:0}
+
+.wy-nav-content-wrap .wy-nav-content{padding:1.618em}
+
+.wy-nav-content-wrap.shift{position:fixed;
+	min-width:100%;
+	left:85%;
+	top:0;
+	height:100%;
+	overflow:hidden}
+
+}
+
+@media screen and (min-width: 1100px){.wy-nav-content-wrap{background:rgba(0,0,0,0.05)}
+
+.wy-nav-content{margin:0;
+	background:#fcfcfc}
+
+}
+
+@media print{.rst-versions,footer,.wy-nav-side{display:none}
+
+.wy-nav-content-wrap{margin-left:0}
+
+}
+
+.rst-versions{position:fixed;
+	bottom:0;
+	left:0;
+	width:300px;
+	color:#fcfcfc;
+	background:#1f1d1d;
+	font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;
+	z-index:400}
+
+.rst-versions a{color:#2980B9;
+	text-decoration:none}
+
+.rst-versions .rst-badge-small{display:none}
+
+.rst-versions .rst-current-version{padding:12px;
+	background-color:#272525;
+	display:block;
+	text-align:right;
+	font-size:90%;
+	cursor:pointer;
+	color:#27AE60;
+	*zoom:1}
+
+.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;
+	content:""}
+
+.rst-versions .rst-current-version:after{clear:both}
+
+.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version span.toctree-expand,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content p.caption .headerlink,.rst-content p.caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .icon{color:#fcfcfc}
+
+.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}
+
+.rst-versions .rst-current-version .icon-book{float:left}
+
+.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;
+	color:#fff}
+
+.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;
+	color:#000}
+
+.rst-versions.shift-up{height:auto;
+	max-height:100%;
+	overflow-y:scroll}
+
+.rst-versions.shift-up .rst-other-versions{display:block}
+
+.rst-versions .rst-other-versions{font-size:90%;
+	padding:12px;
+	color:gray;
+	display:none}
+
+.rst-versions .rst-other-versions hr{display:block;
+	height:1px;
+	border:0;
+	margin:20px 0;
+	padding:0;
+	border-top:solid 1px #413d3d}
+
+.rst-versions .rst-other-versions dd{display:inline-block;
+	margin:0}
+
+.rst-versions .rst-other-versions dd a{display:inline-block;
+	padding:6px;
+	color:#fcfcfc}
+
+.rst-versions.rst-badge{width:auto;
+	bottom:20px;
+	right:20px;
+	left:auto;
+	border:none;
+	max-width:300px;
+	max-height:90%}
+
+.rst-versions.rst-badge .icon-book{float:none}
+
+.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none}
+
+.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}
+
+.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}
+
+.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}
+
+.rst-versions.rst-badge .rst-current-version{width:auto;
+	height:30px;
+	line-height:30px;
+	padding:0 6px;
+	display:block;
+	text-align:center}
+
+@media screen and (max-width: 768px){.rst-versions{width:85%;
+	display:none}
+
+.rst-versions.shift{display:block}
+
+}
+
+.rst-content img{max-width:100%;
+	height:auto}
+
+.rst-content div.figure{margin-bottom:24px}
+
+.rst-content div.figure p.caption{font-style:italic}
+
+.rst-content div.figure p:last-child.caption{margin-bottom:0px}
+
+.rst-content div.figure.align-center{text-align:center}
+
+.rst-content .section>img,.rst-content .section>a>img{margin-bottom:24px}
+
+.rst-content abbr[title]{text-decoration:none}
+
+.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;
+	content:"";
+	color:#b3b3b3;
+	vertical-align:super;
+	font-size:60%;
+	margin:0 .2em}
+
+.rst-content blockquote{margin-left:24px;
+	line-height:24px;
+	margin-bottom:24px}
+
+.rst-content pre.literal-block{white-space:pre;
+	margin:0;
+	padding:12px 12px;
+	font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;
+	display:block;
+	overflow:auto}
+
+.rst-content pre.literal-block,.rst-content div[class^='highlight']{border:1px solid #e1e4e5;
+	overflow-x:auto;
+	margin:1px 0 24px 0}
+
+.rst-content pre.literal-block div[class^='highlight'],.rst-content div[class^='highlight'] div[class^='highlight']{padding:0px;
+	border:none;
+	margin:0}
+
+.rst-content div[class^='highlight'] td.code{width:100%}
+
+.rst-content .linenodiv pre{border-right:solid 1px #e6e9ea;
+	margin:0;
+	padding:12px 12px;
+	font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;
+	user-select:none;
+	pointer-events:none}
+
+.rst-content div[class^='highlight'] pre{white-space:pre;
+	margin:0;
+	padding:12px 12px;
+	display:block;
+	overflow:auto}
+
+.rst-content div[class^='highlight'] pre .hll{display:block;
+	margin:0 -12px;
+	padding:0 12px}
+
+.rst-content pre.literal-block,.rst-content div[class^='highlight'] pre,.rst-content .linenodiv pre{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;
+	font-size:12px;
+	line-height:1.4}
+
+.rst-content .code-block-caption{font-style:italic;
+	font-size:85%;
+	line-height:1;
+	padding:1em 0;
+	text-align:center}
+
+@media print{.rst-content .codeblock,.rst-content div[class^='highlight'],.rst-content div[class^='highlight'] pre{white-space:pre-wrap}
+
+}
+
+.rst-content .note .last,.rst-content .attention .last,.rst-content .caution .last,.rst-content .danger .last,.rst-content .error .last,.rst-content .hint .last,.rst-content .important .last,.rst-content .tip .last,.rst-content .warning .last,.rst-content .seealso .last,.rst-content .admonition-todo .last,.rst-content .admonition .last{margin-bottom:0}
+
+.rst-content .admonition-title:before{margin-right:4px}
+
+.rst-content .admonition table{border-color:rgba(0,0,0,0.1)}
+
+.rst-content .admonition table td,.rst-content .admonition table th{background:transparent !important;
+	border-color:rgba(0,0,0,0.1) !important}
+
+.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha li{list-style:lower-alpha}
+
+.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha li{list-style:upper-alpha}
+
+.rst-content .section ol p,.rst-content .section ul p{margin-bottom:12px}
+
+.rst-content .section ol p:last-child,.rst-content .section ul p:last-child{margin-bottom:24px}
+
+.rst-content .line-block{margin-left:0px;
+	margin-bottom:24px;
+	line-height:24px}
+
+.rst-content .line-block .line-block{margin-left:24px;
+	margin-bottom:0px}
+
+.rst-content .topic-title{font-weight:bold;
+	margin-bottom:12px}
+
+.rst-content .toc-backref{color:#404040}
+
+.rst-content .align-right{float:right;
+	margin:0px 0px 24px 24px}
+
+.rst-content .align-left{float:left;
+	margin:0px 24px 24px 0px}
+
+.rst-content .align-center{margin:auto}
+
+.rst-content .align-center:not(table){display:block}
+
+.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content .toctree-wrapper p.caption .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content .code-block-caption .headerlink{visibility:hidden;
+	font-size:14px}
+
+.rst-content h1 .headerlink:after,.rst-content h2 .headerlink:after,.rst-content .toctree-wrapper p.caption .headerlink:after,.rst-content h3 .headerlink:after,.rst-content h4 .headerlink:after,.rst-content h5 .headerlink:after,.rst-content h6 .headerlink:after,.rst-content dl dt .headerlink:after,.rst-content p.caption .headerlink:after,.rst-content table>caption .headerlink:after,.rst-content .code-block-caption .headerlink:after{content:"";
+	font-family:FontAwesome}
+
+.rst-content h1:hover .headerlink:after,.rst-content h2:hover .headerlink:after,.rst-content .toctree-wrapper p.caption:hover .headerlink:after,.rst-content h3:hover .headerlink:after,.rst-content h4:hover .headerlink:after,.rst-content h5:hover .headerlink:after,.rst-content h6:hover .headerlink:after,.rst-content dl dt:hover .headerlink:after,.rst-content p.caption:hover .headerlink:after,.rst-content table>caption:hover .headerlink:after,.rst-content .code-block-caption:hover .headerlink:after{visibility:visible}
+
+.rst-content table>caption .headerlink:after{font-size:12px}
+
+.rst-content .centered{text-align:center}
+
+.rst-content .sidebar{float:right;
+	width:40%;
+	display:block;
+	margin:0 0 24px 24px;
+	padding:24px;
+	background:#f3f6f6;
+	border:solid 1px #e1e4e5}
+
+.rst-content .sidebar p,.rst-content .sidebar ul,.rst-content .sidebar dl{font-size:90%}
+
+.rst-content .sidebar .last{margin-bottom:0}
+
+.rst-content .sidebar .sidebar-title{display:block;
+	font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif;
+	font-weight:bold;
+	background:#e1e4e5;
+	padding:6px 12px;
+	margin:-24px;
+	margin-bottom:24px;
+	font-size:100%}
+
+.rst-content .highlighted{background:#F1C40F;
+	display:inline-block;
+	font-weight:bold;
+	padding:0 6px}
+
+.rst-content .footnote-reference,.rst-content .citation-reference{vertical-align:baseline;
+	position:relative;
+	top:-0.4em;
+	line-height:0;
+	font-size:90%}
+
+.rst-content table.docutils.citation,.rst-content table.docutils.footnote{background:none;
+	border:none;
+	color:gray}
+
+.rst-content table.docutils.citation td,.rst-content table.docutils.citation tr,.rst-content table.docutils.footnote td,.rst-content table.docutils.footnote tr{border:none;
+	background-color:transparent !important;
+	white-space:normal}
+
+.rst-content table.docutils.citation td.label,.rst-content table.docutils.footnote td.label{padding-left:0;
+	padding-right:0;
+	vertical-align:top}
+
+.rst-content table.docutils.citation tt,.rst-content table.docutils.citation code,.rst-content table.docutils.footnote tt,.rst-content table.docutils.footnote code{color:#555}
+
+.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}
+
+.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}
+
+.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}
+
+.rst-content table.docutils th{border-color:#e1e4e5}
+
+.rst-content table.docutils td .last,.rst-content table.docutils td .last :last-child{margin-bottom:0}
+
+.rst-content table.field-list{border:none}
+
+.rst-content table.field-list td{border:none}
+
+.rst-content table.field-list td p{font-size:inherit;
+	line-height:inherit}
+
+.rst-content table.field-list td>strong{display:inline-block}
+
+.rst-content table.field-list .field-name{padding-right:10px;
+	text-align:left;
+	white-space:nowrap}
+
+.rst-content table.field-list .field-body{text-align:left}
+
+.rst-content tt,.rst-content tt,.rst-content code{color:#000;
+	font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;
+	padding:2px 5px}
+
+.rst-content tt big,.rst-content tt em,.rst-content tt big,.rst-content code big,.rst-content tt em,.rst-content code em{font-size:100% !important;
+	line-height:normal}
+
+.rst-content tt.literal,.rst-content tt.literal,.rst-content code.literal{color:#E74C3C}
+
+.rst-content tt.xref,a .rst-content tt,.rst-content tt.xref,.rst-content code.xref,a .rst-content tt,a .rst-content code{font-weight:bold;
+	color:#404040}
+
+.rst-content pre,.rst-content kbd,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace}
+
+.rst-content a tt,.rst-content a tt,.rst-content a code{color:#2980B9}
+
+.rst-content dl{margin-bottom:24px}
+
+.rst-content dl dt{font-weight:bold;
+	margin-bottom:12px}
+
+.rst-content dl p,.rst-content dl table,.rst-content dl ul,.rst-content dl ol{margin-bottom:12px !important}
+
+.rst-content dl dd{margin:0 0 12px 24px;
+	line-height:24px}
+
+.rst-content dl:not(.docutils){margin-bottom:24px}
+
+.rst-content dl:not(.docutils) dt{display:table;
+	margin:6px 0;
+	font-size:90%;
+	line-height:normal;
+	background:#e7f2fa;
+	color:#2980B9;
+	border-top:solid 3px #6ab0de;
+	padding:6px;
+	position:relative}
+
+.rst-content dl:not(.docutils) dt:before{color:#6ab0de}
+
+.rst-content dl:not(.docutils) dt .headerlink{color:#404040;
+	font-size:100% !important}
+
+.rst-content dl:not(.docutils) dl dt{margin-bottom:6px;
+	border:none;
+	border-left:solid 3px #ccc;
+	background:#f0f0f0;
+	color:#555}
+
+.rst-content dl:not(.docutils) dl dt .headerlink{color:#404040;
+	font-size:100% !important}
+
+.rst-content dl:not(.docutils) dt:first-child{margin-top:0}
+
+.rst-content dl:not(.docutils) tt,.rst-content dl:not(.docutils) tt,.rst-content dl:not(.docutils) code{font-weight:bold}
+
+.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) code.descclassname{background-color:transparent;
+	border:none;
+	padding:0;
+	font-size:100% !important}
+
+.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname{font-weight:bold}
+
+.rst-content dl:not(.docutils) .optional{display:inline-block;
+	padding:0 4px;
+	color:#000;
+	font-weight:bold}
+
+.rst-content dl:not(.docutils) .property{display:inline-block;
+	padding-right:8px}
+
+.rst-content .viewcode-link,.rst-content .viewcode-back{display:inline-block;
+	color:#27AE60;
+	font-size:80%;
+	padding-left:24px}
+
+.rst-content .viewcode-back{display:block;
+	float:right}
+
+.rst-content p.rubric{margin-bottom:12px;
+	font-weight:bold}
+
+.rst-content tt.download,.rst-content code.download{background:inherit;
+	padding:inherit;
+	font-weight:normal;
+	font-family:inherit;
+	font-size:inherit;
+	color:inherit;
+	border:inherit;
+	white-space:inherit}
+
+.rst-content tt.download span:first-child,.rst-content code.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}
+
+.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before{margin-right:4px}
+
+.rst-content .guilabel{border:1px solid #7fbbe3;
+	background:#e7f2fa;
+	font-size:80%;
+	font-weight:700;
+	border-radius:4px;
+	padding:2.4px 6px;
+	margin:auto 2px}
+
+.rst-content .versionmodified{font-style:italic}
+
+@media screen and (max-width: 480px){.rst-content .sidebar{width:100%}
+
+}
+
+span[id*='MathJax-Span']{color:#404040}
+
+.math{text-align:center}
+
+@font-face{font-family:"Lato";
+	src:url("../fonts/Lato/lato-regular.eot");
+	src:url("../fonts/Lato/lato-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-regular.woff2") format("woff2"),url("../fonts/Lato/lato-regular.woff") format("woff"),url("../fonts/Lato/lato-regular.ttf") format("truetype");
+	font-weight:400;
+	font-style:normal}
+
+@font-face{font-family:"Lato";
+	src:url("../fonts/Lato/lato-bold.eot");
+	src:url("../fonts/Lato/lato-bold.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-bold.woff2") format("woff2"),url("../fonts/Lato/lato-bold.woff") format("woff"),url("../fonts/Lato/lato-bold.ttf") format("truetype");
+	font-weight:700;
+	font-style:normal}
+
+@font-face{font-family:"Lato";
+	src:url("../fonts/Lato/lato-bolditalic.eot");
+	src:url("../fonts/Lato/lato-bolditalic.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-bolditalic.woff2") format("woff2"),url("../fonts/Lato/lato-bolditalic.woff") format("woff"),url("../fonts/Lato/lato-bolditalic.ttf") format("truetype");
+	font-weight:700;
+	font-style:italic}
+
+@font-face{font-family:"Lato";
+	src:url("../fonts/Lato/lato-italic.eot");
+	src:url("../fonts/Lato/lato-italic.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-italic.woff2") format("woff2"),url("../fonts/Lato/lato-italic.woff") format("woff"),url("../fonts/Lato/lato-italic.ttf") format("truetype");
+	font-weight:400;
+	font-style:italic}
+
+@font-face{font-family:"Roboto Slab";
+	font-style:normal;
+	font-weight:400;
+	src:url("../fonts/RobotoSlab/roboto-slab.eot");
+	src:url("../fonts/RobotoSlab/roboto-slab-v7-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.ttf") format("truetype")}
+
+@font-face{font-family:"Roboto Slab";
+	font-style:normal;
+	font-weight:700;
+	src:url("../fonts/RobotoSlab/roboto-slab-v7-bold.eot");
+	src:url("../fonts/RobotoSlab/roboto-slab-v7-bold.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.ttf") format("truetype")}
+
+
diff --git a/docs/_static/readable rtd/parsedjs.txt b/docs/_static/readable rtd/parsedjs.txt
new file mode 100644
index 0000000..7fad20f
--- /dev/null
+++ b/docs/_static/readable rtd/parsedjs.txt	
@@ -0,0 +1,106 @@
+/* sphinx_rtd_theme version 0.4.3 | MIT license */
+/* Built 20190212 16:02 */
+require=function r(s,a,l){function c(e,n){if(!a[e]){if(!s[e]){var i="function"==typeof require&&require;
+	if(!n&&i)return i(e,!0);
+	if(u)return u(e,!0);
+	var t=new Error("Cannot find module '"+e+"'");
+	throw t.code="MODULE_NOT_FOUND",t}
+
+var o=a[e]={exports:{}
+
+}
+
+;
+	s[e][0].call(o.exports,function(n){return c(s[e][1][n]||n)}
+
+,o,o.exports,r,s,a,l)}
+
+return a[e].exports}
+
+for(var u="function"==typeof require&&require,n=0;
+	n<l.length;
+	n++)c(l[n]);
+	return c}
+
+({"sphinx-rtd-theme":[function(n,e,i){var jQuery="undefined"!=typeof window?window.jQuery:n("jquery");
+	e.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(e){var i=this;
+	void 0===e&&(e=!0),i.isRunning||(i.isRunning=!0,jQuery(function(n){i.init(n),i.reset(),i.win.on("hashchange",i.reset),e&&i.win.on("scroll",function(){i.linkScroll||i.winScroll||(i.winScroll=!0,requestAnimationFrame(function(){i.onScroll()}
+
+))}
+
+),i.win.on("resize",function(){i.winResize||(i.winResize=!0,requestAnimationFrame(function(){i.onResize()}
+
+))}
+
+),i.onResize()}
+
+))}
+
+,enableSticky:function(){this.enable(!0)}
+
+,init:function(i){i(document);
+	var t=this;
+	this.navBar=i("div.wy-side-scroll:first"),this.win=i(window),i(document).on("click","[data-toggle='wy-nav-top']",function(){i("[data-toggle='wy-nav-shift']").toggleClass("shift"),i("[data-toggle='rst-versions']").toggleClass("shift")}
+
+).on("click",".wy-menu-vertical .current ul li a",function(){var n=i(this);
+	i("[data-toggle='wy-nav-shift']").removeClass("shift"),i("[data-toggle='rst-versions']").toggleClass("shift"),t.toggleCurrent(n),t.hashChange()}
+
+).on("click","[data-toggle='rst-current-version']",function(){i("[data-toggle='rst-versions']").toggleClass("shift-up")}
+
+),i("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),i("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),i("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),i(".wy-menu-vertical ul").not(".simple").siblings("a").each(function(){var e=i(this);
+	expand=i('<span class="toctree-expand"></span>'),expand.on("click",function(n){return t.toggleCurrent(e),n.stopPropagation(),!1}
+
+),e.prepend(expand)}
+
+)}
+
+,reset:function(){var n=encodeURI(window.location.hash)||"#";
+	try{var e=$(".wy-menu-vertical"),i=e.find('[href="'+n+'"]');
+	if(0===i.length){var t=$('.document [id="'+n.substring(1)+'"]').closest("div.section");
+	0===(i=e.find('[href="#'+t.attr("id")+'"]')).length&&(i=e.find('[href="#"]'))}
+
+0<i.length&&($(".wy-menu-vertical .current").removeClass("current"),i.addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l1").parent().addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l2").addClass("current"),i.closest("li.toctree-l3").addClass("current"),i.closest("li.toctree-l4").addClass("current"),i[0].scrollIntoView())}
+
+catch(o){console.log("Error expanding nav for anchor",o)}
+
+}
+
+,onScroll:function(){this.winScroll=!1;
+	var n=this.win.scrollTop(),e=n+this.winHeight,i=this.navBar.scrollTop()+(n-this.winPosition);
+	n<0||e>this.docHeight||(this.navBar.scrollTop(i),this.winPosition=n)}
+
+,onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()}
+
+,hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",function(){this.linkScroll=!1}
+
+)}
+
+,toggleCurrent:function(n){var e=n.closest("li");
+	e.siblings("li.current").removeClass("current"),e.siblings().find("li.current").removeClass("current"),e.find("> ul li.current").removeClass("current"),e.toggleClass("current")}
+
+}
+
+,"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:e.exports.ThemeNav,StickyNav:e.exports.ThemeNav}
+
+),function(){for(var r=0,n=["ms","moz","webkit","o"],e=0;
+	e<n.length&&!window.requestAnimationFrame;
+	++e)window.requestAnimationFrame=window[n[e]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[n[e]+"CancelAnimationFrame"]||window[n[e]+"CancelRequestAnimationFrame"];
+	window.requestAnimationFrame||(window.requestAnimationFrame=function(n,e){var i=(new Date).getTime(),t=Math.max(0,16-(i-r)),o=window.setTimeout(function(){n(i+t)}
+
+,t);
+	return r=i+t,o}
+
+),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(n){clearTimeout(n)}
+
+)}
+
+()}
+
+,{jquery:"jquery"}
+
+]}
+
+,{}
+
+,["sphinx-rtd-theme"]);
+	
\ No newline at end of file
diff --git a/docs/_templates/breadcrumbs.html b/docs/_templates/breadcrumbs.html
new file mode 100644
index 0000000..e69de29
diff --git a/docs/_templates/template.html b/docs/_templates/template.html
new file mode 100644
index 0000000..edd59d9
--- /dev/null
+++ b/docs/_templates/template.html
@@ -0,0 +1,7 @@
+{% extends "!layout.html" %}
+
+{%- block extrahead %}
+ <!--jquery-->
+ <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"/>
+
+{% endblock %}
diff --git a/docs/analog_stage_comparison.png b/docs/analog_stage_comparison.png
new file mode 100644
index 0000000..76bc8e1
Binary files /dev/null and b/docs/analog_stage_comparison.png differ
diff --git a/docs/appendices.rst b/docs/appendices.rst
new file mode 100644
index 0000000..0b337d8
--- /dev/null
+++ b/docs/appendices.rst
@@ -0,0 +1,138 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+   :file: StationXMLtoSEEDmapping.html
+   .. raw:: html
+   .. include:: blockette_map.rst
+
+
+*******************************************
+Appendices
+*******************************************
+
+Mapping SEED blockettes to StationXML
+===========================================
+
+B34 Units Abbreviations
+-----------------------------------------
+
+.. include:: blockettes/b34_table.rst
+
+B50 Station Identifier
+-----------------------------------------
+
+.. include:: blockettes/b50_table.rst
+
+B52 Channel Identifier
+-----------------------------------------
+
+.. include:: blockettes/b52_table.rst
+
+B53 Response Poles & Zeros
+-----------------------------------------
+
+.. include:: blockettes/b53_table.rst
+
+B55 Response List
+-----------------------------------------
+
+.. include:: blockettes/b55_table.rst
+
+B57 Decimation
+-----------------------------------------
+
+.. include:: blockettes/b57_table.rst
+
+B58 Channel Sensitivity/Gain
+-----------------------------------------
+
+.. include:: blockettes/b58_table.rst
+
+B61 FIR Response
+-----------------------------------------
+
+.. include:: blockettes/b61_table.rst
+
+B62 Response Polynomial
+-----------------------------------------
+
+.. include:: blockettes/b62_table.rst
+
+Embedded Schema Keywords
+===========================================
+
+.. include:: schema-keywords.rst
+
+Identifiers and codes
+===========================================
+
+For information on Network, Station, Location, and Channel codes, in addition to
+their combination into Source Identifiers, used in StationXML see:
+
+http://docs.fdsn.org/projects/source-identifiers
+
+Unit Naming Rules
+===========================================
+The FDSN strongly recommends the use of SI unit names whenever possible. For
+details see the SI brochure at:
+
+   `<https://www.bipm.org/en/publications/si-brochure>`_
+
+* Use SI units, base or derivative, and their standard symbols whenever possible. Spell out and avoid abbreviations of non-SI units.
+
+* Exponents for powers are specified with `**`, e.g. `s**2`.
+
+* Multiplication is specified using `*` while division is specified with `/`. For example `hit/(cm**2*hour)`.
+
+* Use parentheses sparingly, only when FORTRAN-like precedence would not be correct.
+
+* Unit definitions are singular, not plural, e.g. use `second` not `seconds`.
+
+* Unit names should not mix symbols and full names, use one or the other, e.g. use `m/s` or `meter/second` but not `meter/s` or `m/second`.
+
+* Units should be used case sensitively, using the case specified by SI rules.
+
+* SI symbols are preferred over names to avoid language differences, for example `m/s` is preferred over `meter/second` or `metre/second`
+
+* Singular lowercase `count` is preferred for digital counts, do not use `counts` or `COUNT`
+
+* Description is only needed when the unit name is not a well know
+  SI unit or there is need for clarification. Prefer not to use a
+  Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+In the SEED format all unit names are recommended to be uppercase and
+SI when possible.  For this reason, some unit documentation and
+required declarations in StationXML are in "uppercase SI" and these
+remain in order to maintain backward compatibility with the initial
+schema version.  With the next major change to the specification the
+FDSN will very likely remove these "uppercase SI" unit names in favor
+of proper SI unit names.
+
+Specifying Dates and Times
+===========================================
+Dates and times should be specified using the ISO 8601 specification, limited
+to the following subtypes:
+
+* "YYYY-MM-DDZ" when only a day is needed, for example in Network startDate
+* "YYYY-MM-DDThh:mm:ssZ" when second precision is sufficient
+* "YYYY-MM-DDThh:mm:ss.SSSZ" when subsecond precision is required, 3, 6 or 9 decimal digits may be used.
+
+The SEED specification limited times to 4 decimal digit precision, tenth of millisecond,
+but is recommended that the number of subsecond digits be a multiple of 3, corresponding
+to SI unit powers.
+
+Note that in ISO 8601 a time without a "Z" appended is generally assumed
+by most string to time conversion routines to be
+in local time. Because all times in StationXML should be UTC,
+the FDSN strongly recommends that dates and times
+have the "Z" timezone specifier appended to avoid this ambiguity.
+
+For further information see the XML Schema recommendation from W3C at
+https://www.w3.org/TR/xmlschema-2/#isoformats
+
+
+.. _type-glossary:
+
+Type Glossary
+===========================================
+
+.. include:: type-glossary.rst
diff --git a/docs/blockettes/b34_table.rst b/docs/blockettes/b34_table.rst
new file mode 100644
index 0000000..1d12182
--- /dev/null
+++ b/docs/blockettes/b34_table.rst
@@ -0,0 +1,32 @@
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 20
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+   * - B034F03
+     - Unit Lookup Code
+     - Multiple Mappings
+     - ..
+     - ..
+
+   * - B034F04
+     - Unit Name
+     - Multiple Mappings
+     - ..
+     -  * B053F05, B053F06,
+        * B055F04, B055F05,
+        * B061F06, B055F07,
+        * B062F05, B062F06
+
+   * - B034F05
+     - Unit Description
+     - Multiple Mappings
+     - ..
+     - ..
diff --git a/docs/blockettes/b50_table.rst b/docs/blockettes/b50_table.rst
new file mode 100644
index 0000000..f8e6b19
--- /dev/null
+++ b/docs/blockettes/b50_table.rst
@@ -0,0 +1,96 @@
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 20
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+
+   * - B050F03
+     - Station Call Letters
+     - :ref:`Station<station>`
+     -  code
+     - ..
+
+   * - B050F04
+     - Station Latitude
+     - :ref:`Station/Latitude<station-latitude>`
+     - ..
+     - ..
+
+   * - B050F05
+     - Station Longitude
+     - :ref:`Station/Longitude<station-longitude>`
+     - ..
+     - ..
+
+   * - B050F06
+     - Station Elevation
+     - :ref:`Station/Elevation<station-elevation>`
+     - ..
+     - ..
+
+   * - B050F07
+     - Number Of Channels
+     - :ref:`Station/TotalNumberChannels<station-totalnumberchannels>`
+     - ..
+     - ..
+
+   * - B050F08
+     - Number Of Station Comments
+     - :ref:`Station/Comments <station-comment>`
+     - ..
+     - ..
+
+   * - B050F09
+     - Site Name
+     - :ref:`Station/Site/Name<station-site-name>`
+     - ..
+     - ..
+
+   * - B050F10
+     - Network Identifier Code
+     - No Mapping
+     - ..
+     - ..
+
+   * - B050F11
+     - 32-bit Word Order
+     - No Mapping
+     - ..
+     - ..
+
+   * - B050F12
+     - 16-bit Word Order
+     - No Mapping
+     - ..
+     - ..
+
+   * - B050F13
+     - Start Effective Date
+     - :ref:`Station<station>`
+     - startDate
+     - ..
+
+   * - B050F14
+     - End Effective Date
+     - :ref:`Station<station>`
+     - endDate
+     - ..
+
+   * - B050F15
+     - Update Flag
+     - No Mapping
+     - ..
+     - ..
+
+   * - B050F16
+     - Network Code
+     - :ref:`Network<network>`
+     - code
+     - ..
diff --git a/docs/blockettes/b52_table.rst b/docs/blockettes/b52_table.rst
new file mode 100644
index 0000000..d5f9d66
--- /dev/null
+++ b/docs/blockettes/b52_table.rst
@@ -0,0 +1,143 @@
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 20
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+   * - B052F03
+     - Location Identifier
+     - :ref:`Channel<channel>`
+     - locationCode
+     - ..
+
+   * - B052F04
+     - Channel Identifier
+     - :ref:`Channel<channel>`
+     - code
+     - ..
+
+   * - B052F05
+     - Subchannel Identifier
+     - No Mapping
+     - ..
+     - ..
+
+   * - B052F06
+     - Instrument Identifier
+     - No Mapping
+     - ..
+     - ..
+
+   * - B052F07
+     - Optional Comment
+     - :ref:`Channel/Comment<channel-comment>`
+     - ..
+     - ..
+
+   * - B052F08
+     - Units Of Signal Response
+     - No Mapping
+     - ..
+     - ..
+
+   * - B052F09
+     - Units Of Calibration Input
+     - :ref:`Channel/CalibrationUnits/Name<channel-calibrationunits-name>`
+     - ..
+     - ..
+
+   * - B052F10
+     - Latitude
+     - :ref:`Channel/Latitude<channel-latitude>`
+     - ..
+     - ..
+
+   * - B052F11
+     - Longitude
+     - :ref:`Channel/Longitude<channel-longitude>`
+     - ..
+     - ..
+
+   * - B052F12
+     - Elevation
+     - :ref:`Channel/Elevation<channel-elevation>`
+     - ..
+     - ..
+
+   * - B052F13
+     - Local Depth
+     - :ref:`Channel/Depth<channel-depth>`
+     - ..
+     - ..
+
+   * - B052F14
+     - Azimuth
+     - :ref:`Channel/Azimuth<channel-azimuth>`
+     - ..
+     - ..
+
+   * - B052F15
+     - Dip
+     - :ref:`Channel/Dip<channel-dip>`
+     - ..
+     - ..
+
+   * - B052F16
+     - Data Format Identifier Code
+     - No Mapping
+     - ..
+     - ..
+
+   * - B052F17
+     - Data Record Length
+     - No Mapping
+     - ..
+     - ..
+
+   * - B052F18
+     - Sample Rate
+     - :ref:`Channel/SampleRate<channel-samplerate>`
+     - ..
+     - ..
+
+   * - B052F19
+     - Max Clock Drift
+     - :ref:`Channel/ClockDrift<channel-clockdrift>`
+     - ..
+     - ..
+
+   * - B052F20
+     - Number Of Comments
+     - No Mapping
+     - ..
+     - ..
+
+   * - B052F21
+     - Channel Flags
+     - No Mapping
+     - ..
+     - ..
+
+   * - B052F22
+     - Start Date
+     - :ref:`Channel<channel>`
+     - startDate
+     - ..
+
+   * - B052F23
+     - End Date
+     - :ref:`Channel<channel>`
+     - endDate
+     - ..
+
+   * - B052F24
+     - Update Flags
+     - No Mapping
+     - ..
+     - ..
diff --git a/docs/blockettes/b53_table.rst b/docs/blockettes/b53_table.rst
new file mode 100644
index 0000000..8440e5b
--- /dev/null
+++ b/docs/blockettes/b53_table.rst
@@ -0,0 +1,113 @@
+
+.. tabularcolumns:: |L|p{70pt}|L|p{50pt}|p{40pt}|
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 20
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+   * - B053F03
+     - Transfer Function Type
+     - :ref:`Response/Stage/PolesZeros/PzTransferFunctionType<response-stage-poleszeros-pztransferfunctiontype>`
+     - ..
+     - ..
+
+   * - B053F04
+     - Stage Sequence Number
+     - :ref:`Response/Stage/PolesZeros<response-stage-poleszeros>`
+     - number
+     - ..
+
+   * - B053F05
+     - Stage Signal Input Units
+     - :ref:`Response/Stage/PolesZeros/InputUnits/Name<response-stage-poleszeros-inputunits-name>`
+     - ..
+     - B034F04, B043F06
+
+   * - B053F06
+     - Stage Signal Output Units
+     - :ref:`Response/Stage/PolesZeros/OutputUnits/Name<response-stage-poleszeros-outputunits-name>`
+     - ..
+     - B034F04, B043F07
+
+   * - B053F07
+     - A0 Normalization Factor
+     - :ref:`Response/Stage/PolesZeros/NormalizationFactor<response-stage-poleszeros-normalizationfactor>`
+     - ..
+     - ..
+
+   * - B053F08
+     - Normalization Frequency
+     - :ref:`Response/Stage/PolesZeros/NormalizationFrequency<response-stage-poleszeros-normalizationfrequency>`
+     - ..
+     - ..
+
+   * - B053F09
+     - Number Of Complex Zeros
+     - No Mapping
+     - ..
+     - ..
+
+   * - B053F10
+     - Real Zero
+     - :ref:`Response/Stage/PolesZeros/Zero/Real<response-stage-poleszeros-zero-real>`
+     - ..
+     - ..
+
+   * - B053F11
+     - Imaginary Zero
+     - :ref:`Response/Stage/PolesZeros/Zero/Imaginary<response-stage-poleszeros-zero-imaginary>`
+     - ..
+     - ..
+
+   * - B053F12
+     - Real Zero Error
+     - :ref:`Response/Stage/PolesZeros/Zero/Real<response-stage-poleszeros-zero-real>`
+     - minusError
+       plusError
+     - ..
+
+   * - B053F13
+     - Imaginary Zero Error
+     - :ref:`Response/Stage/PolesZeros/Zero/Imaginary<response-stage-poleszeros-zero-imaginary>`
+     - minusError
+       plusError
+     - ..
+
+   * - B053F14
+     - Number Of Complex Poles
+     - No Mapping
+     - ..
+     - ..
+
+   * - B053F15
+     - Real Pole
+     - :ref:`Response/Stage/PolesZeros/Pole/Real<response-stage-poleszeros-pole-real>`
+     - ..
+     - ..
+
+   * - B053F16
+     - Imaginary Pole
+     - :ref:`Response/Stage/PolesZeros/Pole/Imaginary<response-stage-poleszeros-pole-imaginary>`
+     - ..
+     - ..
+
+   * - B053F17
+     - Real Pole Error
+     - :ref:`Response/Stage/PolesZeros/Pole/Real<response-stage-poleszeros-pole-real>`
+     - minusError
+       plusError
+     - ..
+
+   * - B053F18
+     - Imaginary Pole Error
+     - :ref:`Response/Stage/PolesZeros/Pole/Imaginary<response-stage-poleszeros-pole-imaginary>`
+     - minusError
+       plusError
+     - ..
diff --git a/docs/blockettes/b55_table.rst b/docs/blockettes/b55_table.rst
new file mode 100644
index 0000000..d668832
--- /dev/null
+++ b/docs/blockettes/b55_table.rst
@@ -0,0 +1,69 @@
+
+.. tabularcolumns:: |p{38pt}|p{48pt}|L|p{42pt}|p{40pt}|
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 20
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+   * - B055F03
+     - Stage Sequence Number
+     - :ref:`Response/Stage/ResponseList<response-stage-responselist>`
+     - name
+     - ..
+
+   * - B055F04
+     - Signal Input Units
+     - :ref:`Response/Stage/ResponseList/InputUnits/Name<response-stage-responselist-inputunits-name>`
+     - ..
+     - B034F04, B045F05
+
+   * - B055F05
+     - Signal Output Units
+     - :ref:`Response/Stage/ResponseList/OutputUnits/Name<response-stage-responselist-outputunits-name>`
+     - ..
+     - B034F04, B045F06
+
+   * - B055F06
+     - Number Of Responses Listed
+     - No Mapping
+     - ..
+     - ..
+
+   * - B055F07
+     - Frequency
+     - :ref:`Response/Stage/ResponseList/ResponseListElement/Frequency<response-stage-responselist-responselistelement-frequency>`
+     - ..
+     - ..
+
+   * - B055F08
+     - Amplitude
+     - :ref:`Response/Stage/ResponseList/ResponseListElement/Amplitude<response-stage-responselist-responselistelement-amplitude>`
+     - ..
+     - ..
+
+   * - B055F09
+     - Amplitude Error
+     - :ref:`Response/Stage/ResponseList/ResponseListElement/Amplitude<response-stage-responselist-responselistelement-amplitude>`
+     - minusError
+       plusError
+     - ..
+
+   * - B055F10
+     - Phase Angle
+     - :ref:`Response/Stage/ResponseList/ResponseListElement/Phase<response-stage-responselist-responselistelement-phase>`
+     - ..
+     - ..
+
+   * - B055F11
+     - Phase Angle Error
+     - :ref:`Response/Stage/ResponseList/ResponseListElement/Phase<response-stage-responselist-responselistelement-phase>`
+     - minusError
+       plusError
+     - ..
diff --git a/docs/blockettes/b57_table.rst b/docs/blockettes/b57_table.rst
new file mode 100644
index 0000000..3f9c32c
--- /dev/null
+++ b/docs/blockettes/b57_table.rst
@@ -0,0 +1,49 @@
+
+.. tabularcolumns:: |L|L|L|p{40pt}|p{40pt}|
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 20
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+   * - B057F03
+     - Stage Sequence Number
+     - :ref:`Response/Stage/Decimation<response-stage-decimation>`
+     - number
+     - ..
+
+   * - B057F04
+     - Input Sample Rate
+     - :ref:`Response/Stage/Decimation/InputSampleRate<response-stage-decimation-inputsamplerate>`
+     - ..
+     - ..
+
+   * - B057F05
+     - Decimation Factor
+     - :ref:`Response/Stage/Decimation/Factor<response-stage-decimation-factor>`
+     - ..
+     - ..
+
+   * - B057F06
+     - Decimation Offset
+     - :ref:`Response/Stage/Decimation/Offset<response-stage-decimation-offset>`
+     - ..
+     - ..
+
+   * - B057F07
+     - Estimated Delay
+     - :ref:`Response/Stage/Decimation/Delay<response-stage-decimation-delay>`
+     - ..
+     - ..
+
+   * - B057F08
+     - Correction Applied
+     - :ref:`Response/Stage/Decimation/Correction<response-stage-decimation-correction>`
+     - ..
+     - ..
diff --git a/docs/blockettes/b58_table.rst b/docs/blockettes/b58_table.rst
new file mode 100644
index 0000000..6f7fd93
--- /dev/null
+++ b/docs/blockettes/b58_table.rst
@@ -0,0 +1,57 @@
+
+
+
+.. tabularcolumns:: |L|L|L|p{40pt}|p{40pt}|
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 20
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+   * - B058F03
+     - Stage Sequence Number
+     - No Mapping
+     - ..
+     - ..
+
+   * - B058F04
+     - Sensitivity/Gain
+     - :ref:`Response/InstrumentSensitivity/Value<response-instrumentsensitivity-value>`
+     - ..
+     - ..
+
+   * - B058F05
+     - Frequency
+     - :ref:`Response/InstrumentSensitivity/Frequency<response-instrumentsensitivity-frequency>`
+     - ..
+     - ..
+
+   * - B058F06
+     - Number Of History Values
+     - No Mapping
+     - ..
+     - ..
+
+   * - B058F07
+     - Sensitivity For Calibration
+     - No Mapping
+     - ..
+     - ..
+
+   * - B058F08
+     - Frequency Of Calibration
+     - No Mapping
+     - ..
+     - ..
+
+   * - B058F09
+     - Time Of Calibration
+     - No Mapping
+     - ..
+     - ..
diff --git a/docs/blockettes/b61_table.rst b/docs/blockettes/b61_table.rst
new file mode 100644
index 0000000..724ed07
--- /dev/null
+++ b/docs/blockettes/b61_table.rst
@@ -0,0 +1,55 @@
+
+.. tabularcolumns:: |L|L|L|L|p{50pt}|
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 10
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+   * - B061F03
+     - Stage Sequence Number
+     - :ref:`Response/Stage/FIR<response-stage-fir>`
+     - number
+     - ..
+
+   * - B061F04
+     - Response Name
+     - :ref:`Response/Stage/FIR<response-stage-fir>`
+     - name
+     - ..
+
+   * - B061F05
+     - Symmetry
+     - :ref:`Response/Stage/FIR/Symmetry<response-stage-fir-symmetry>`
+     -
+     -
+
+   * - B061F06
+     - Signal In Units
+     - :ref:`Response/Stage/FIR/InputUnits/Name<response-stage-fir-inputunits-name>`
+     - ..
+     - B034F04, B041F06
+
+   * - B061F07
+     - Signal Out Units
+     - :ref:`Response/Stage/FIR/OutputUnits/Name<response-stage-fir-outputunits-name>`
+     - ..
+     - B034F04, B041F07
+
+   * - B061F08
+     - Number of Coefficients
+     - No Mapping
+     - ..
+     - ..
+
+   * - B061F09
+     - FIR Coefficient
+     - :ref:`Response/Stage/FIR/NumeratorCoefficient<response-stage-fir-numeratorcoefficient>`
+     - ..
+     - ..
diff --git a/docs/blockettes/b62_table.rst b/docs/blockettes/b62_table.rst
new file mode 100644
index 0000000..ccbf426
--- /dev/null
+++ b/docs/blockettes/b62_table.rst
@@ -0,0 +1,94 @@
+
+.. tabularcolumns:: |L|p{70pt}|L|p{45pt}|p{40pt}|
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 20 30 20 20
+
+   * - Field
+     - Field Name
+     - StationXML Element
+     - Attribute
+     - Dictionary Field(s)
+
+   * .. row body 1 / this is a comment
+
+     - B062F03
+     - Transfer Function Type
+     - No Mapping
+     - ..
+     - ..
+
+   * - B062F04
+     - Stage Sequence Number
+     - :ref:`Response/Stage/Polynomial<response-stage-polynomial>`
+     - number
+     - ..
+
+   * - B062F05
+     - Stage Signal Input Units
+     - :ref:`Response/Stage/Polynomial/InputUnits/Name<response-stage-polynomial-inputunits-name>`
+     - ..
+     - B034F04, B042F06
+
+   * - B062F06
+     - Stage Signal Output Units
+     - :ref:`Response/Stage/Polynomial/OutputUnits/Name<response-stage-polynomial-outputunits-name>`
+     - ..
+     - B034F04, B042F07
+
+   * - B062F07
+     - Polynomial Approximation Type
+     - :ref:`Response/Stage/Polynomial/ApproximationType<response-stage-polynomial-approximationtype>`
+     - ..
+     - ..
+
+   * - B062F08
+     - Valid Frequency Units
+     - No Mapping
+     - ..
+     - ..
+
+   * - B062F09
+     - Lower Valid Frequency Bound
+     - :ref:`Response/Stage/Polynomial/FrequencyLowerBound<response-stage-polynomial-frequencylowerbound>`
+     - ..
+     - ..
+
+   * - B062F10
+     - Upper Valid Frequency Bound
+     - :ref:`Response/Stage/Polynomial/FrequencyUpperBound<response-stage-polynomial-frequencyupperbound>`
+     - ..
+     - ..
+
+   * - B062F11
+     - Lower Bound Of Approximation
+     - :ref:`Response/Stage/Polynomial/ApproximationLowerBound<response-stage-polynomial-approximationlowerbound>`
+     - ..
+     - ..
+
+   * - B062F12
+     - Upper Bound Of Approximation
+     - :ref:`Response/Stage/Polynomial/ApproximationUpperBound<response-stage-polynomial-approximationupperbound>`
+     - ..
+     - ..
+
+   * - B062F13
+     - Maximum Absolute Error
+     - :ref:`Response/Stage/Polynomial/MaximumError<response-stage-polynomial-maximumerror>`
+     - ..
+     - ..
+
+   * - B062F14
+     - Number Of Polynomial Coefficients
+     - No Mapping
+     - ..
+     - ..
+
+   * - B062F15
+     - Polynomial Coefficient Error
+     - :ref:`Response/Stage/Polynomial/Coefficient<response-stage-polynomial-coefficient>`
+     - minusError
+       plusError
+     - ..
diff --git a/docs/changelog.rst b/docs/changelog.rst
new file mode 100644
index 0000000..fe14b99
--- /dev/null
+++ b/docs/changelog.rst
@@ -0,0 +1,86 @@
+
+Changes from version 1.1 to 1.2 (2022-2-25)
+-------------------------------------------
+
+The 1.2 revision of StationXML makes no changes to the schema proper, only
+changing the schema version and adding
+documentation via `<xs:annotation>` and `<xs:documentation>` elements, as well
+as external files. Any existing code that works with 1.1 should work with
+1.2 without modification. We recommend that services generating StationXML
+or distributing it, such as FDSNWS Station web services, update the
+`schemaVersion` attribute to '1.2' at the next convenient opportunity.
+
+Note that the documentation makes recommendations in many cases and services
+that generate 1.2 StationXML should attempt to follow these recommendations
+where possible. These recommendations include:
+
+
+- Dates and times should be `W3C/ISO 8601 <https://www.w3.org/TR/xmlschema-2/#truncatedformats>`_
+  and should always include a timezone of 'Z' to indicate UTC
+
+- Do not use `endDate` in the future, it should not be present when currently active
+
+- Originators of StationXML use `<Source>` and distributors use `<Sender>`
+
+- Network, Station and Channel `sourceId` should use the FDSN Source Identifiers
+  specification, http://docs.fdsn.org/projects/source-identifiers
+
+- Use SI symbols for unit name, like `m/s`, along with singular lowercase "count" for digital counts.
+
+- Avoid SEED-style uppercase unit symbols
+
+- Omit `Description` for common units like `m/s`, `m/s**2`, `count`, etc.
+
+- Use empty `Response` element when response is unknown or not applicable.
+
+- For low pass FIR filters, use gain at zero frequency (sum of coefficients)
+
+- Gain-only analog Stages should use PolesZeros with no poles or zeros
+
+- Gain-only digital Stages should use FIR with a single numerator of value 1
+
+Changes from version 1.0 to 1.1 (2019-5-3)
+------------------------------------------
+(Edited 2019-12-18 for small clarifications)
+
+- Add (persistent) <Identifier> element to all base nodes (Network, Station, Channel)
+
+- Unify response elements, allow "number" and disallow "unit" attribute to <Numerator> and <Denominator>
+
+- Allow <CreationDate> to be optional
+
+- Use xs:double for <ApproximationLowerBound>, <ApproximationUpperBound> and <MaximumError>
+
+- Include data availability elements described in the fdsn-station+availability-1.0.xsd extension schema as optional elements of the main schema
+
+- Remove <StorageFormat> from <Channel>
+
+- Limit each <Operator> to a single <Agency>
+
+- Allow more than a single <Equipment> occurrence in <Channel>, same as in <Station>
+
+- Allow <Operator> at the <Network> level, same as in <Station>
+
+- Add "sourceID" attribute, with URI value, to the base node type for <Network>,<Station>,<Channel>
+
+- Do not require and disallow <StageGain> and <Decimation> for <Polynomial> response stages
+
+- Add "measurementMethod" attribute to "uncertaintyDouble" attribute group used by azimuth, dip, distance, latitude, longitude, elevation, etc. types
+
+- Add <WaterLevel> within <Station> and <Channel>
+
+- Add "subject" attribute to <Comment> to allow relating comments, make "id" attribute optional.
+
+The vast majority of the StationXML 1.0 schema exists in the 1.1 schema, making most 1.0 documents compatible
+with the 1.1 schema.  There are a few small exceptions where 1.0 elements were removed from 1.1, in one
+important case to avoid the specification of incorrect metadata.
+
+An `XSLT definition for StationXML 1.0 to 1.1 conversion <https://github.com/FDSN/StationXML/blob/master/StationXML-1.0to1.1.xslt>`_ exists to assist
+with the systematic conversion of version 1.0 documents to the version 1.1 schema.  This is done by removing the
+elements no longer allowed in 1.1.
+
+Potential Future Changes
+----------------------------------
+
+
+.. include:: warnings.rst
diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644
index 0000000..54903e0
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1,128 @@
+
+
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- Project information -----------------------------------------------------
+
+project = 'StationXML'
+copyright = '2022, International FDSN'
+author = 'International FDSN'
+
+# The full version, including alpha/beta/rc tags
+version = '1.2'
+
+# Documentation version, schema + date
+# ALSO UPDATE the release documentation version in overview.rst
+doc_version = version + ' (2022-02-25)'
+
+# Allow |doc_version| to be used in RST
+rst_epilog = '.. |doc_version| replace:: %s' % doc_version
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = ['sphinxcontrib.contentui',
+              'linuxdoc.rstFlatTable',      # Implementation of the 'flat-table' reST-directive
+              #'sphinxcontrib.spelling',
+             ]
+
+spelling_word_list_filename=['spelling/text_words.txt',
+                             'spelling/schema_words.txt',
+                             ]
+
+latex_maketitle = r'''
+  \noindent\rule{\textwidth}{1pt}\par
+    \begingroup % for PDF information dictionary
+       \def\endgraf{ }\def\and{\& }%
+       \pdfstringdefDisableCommands{\def\\{, }}% overwrite hyperref setup
+       \hypersetup{pdfauthor={'''+author+r'''}, pdftitle={'''+project+r'''}}%
+    \endgroup
+  \begin{flushright}
+    \sphinxlogo
+    \sffamily\bfseries
+    {\Huge '''+project+r''' }\par
+    {\itshape\large '''+doc_version+r''' \releaseinfo}\par
+    \vspace{25pt}
+    {\Large
+      \begin{tabular}[t]{c}
+        '''+author+r'''
+      \end{tabular}\kern-\tabcolsep}\par
+    \vspace{25pt}
+    \par
+  \end{flushright}
+  \setcounter{footnote}{0}
+  \let\thanks\relax\let\maketitle\relax
+'''
+
+latex_elements = {
+    'preamble': r'''
+\input{mystyle.tex.txt}
+\setlength{\tymin}{70pt}
+    ''', #adds some macros and sets min width of most tables
+    'classoptions': ',openany,oneside', #removes extra pages
+    'maxlistdepth':'10',
+    'maketitle': latex_maketitle
+}
+
+latex_additional_files = ["mystyle.tex.txt"]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+# Note, some of these, like level-*, are included from other .rst files
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store','examples',
+                    'level-preamble.rst','level-network.rst','level-channel.rst',
+                    'level-response.rst','level-station.rst','response-practical.rst']
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'sphinx_rtd_theme'
+html_theme_options = {
+    'navigation_depth': 0,
+    'sticky_navigation': False,
+}
+html_logo='_static/FDSN-logo.png'
+html_favicon = '_static/favicon.ico'
+html_title = 'FDSN StationXML'
+html_show_sphinx = False
+html_search_language = 'en'
+
+navigation_depth = -2
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+html_css_files = [
+  'css/custom.css',
+  'css/theme_overrides.css',
+]
+
+html_js_files = [
+  'js/sidebar_context.js'
+]
diff --git a/docs/convert_xsd_to_rst.py b/docs/convert_xsd_to_rst.py
new file mode 100755
index 0000000..6e1b188
--- /dev/null
+++ b/docs/convert_xsd_to_rst.py
@@ -0,0 +1,784 @@
+#!/usr/bin/env python3
+
+"""
+Scan an FDSN StationXML XSD schema file, extract documentation values,
+and convert them to ReStructuredText format with html/latex where needed.
+
+Output is written to 4 files for each main level of the schema:
+  Preamble (root), Network, Station, Channel, Response
+"""
+
+import shutil
+import os
+import sys
+import argparse
+
+import xmlschema
+from xmlschema.validators import XsdComplexType
+from xmlschema.validators.wildcards import XsdAnyElement
+from xmlschema.validators.elements import XsdElement
+from xmlschema.validators.simple_types import XsdAtomicBuiltin, XsdAtomicRestriction
+from xmlschema.validators.groups import XsdGroup
+from xmlschema.validators.attributes import XsdAttributeGroup, XsdAnyAttribute
+from xmlschema.validators.complex_types import XsdComplexType
+from xmlschema.validators.facets import *
+
+from xml.etree import ElementTree
+
+def write_tree(element, stop_element, outfile, first_time = True):
+    """Convert to RST and write element and children to output file.
+
+    Starting at `element` recursively operate on all child elements,
+    converting them to ReStructured Text and writing to output file.
+
+    `outfile` specifies the output file as used with print(, file=outfile)
+    `first_time` flag denoting the first element, original caller should
+    not set this.
+    """
+
+    headings = ['=', '-', '^', '\'', '\"', '+']
+
+    space = (element.level - 1) * 10
+    space *= " "
+
+    if first_time:
+        print(".. Auto-generated rst file from scan of fdsn xsd\n", file=outfile)
+
+        for role in ('blue', 'red'): #blue doesn't need to be here atm
+            print(".. role:: %s" % role, file=outfile)
+        print(".. role::  raw-html(raw)\n\t:format: html", file=outfile)
+        print(".. role::  raw-latex(raw)\n\t:format: latex", file=outfile)
+        print(file=outfile)
+    else:
+        print("\n:raw-latex:`\\noindent\\rule{\\textwidth}{1pt}`\n", file=outfile)
+
+    href = element.crumb[0].lower()
+    for c in element.crumb[1:]:
+        href = href + "-" + c.lower()
+
+    print(".. _%s:\n" % href, file=outfile)
+
+    # MTH: Hack to fix: SampleRate is not required *unless* SampleRateRatio is present:
+    # Polynomial not required in Stage as in choice
+    elements_in_groups = ['SampleRate', 'SampleRateRatio', 'FrequencyStart', 'FrequencyEnd',
+                          'FrequencyDBVariation', 'Polynomial']
+    if element.name in elements_in_groups:
+        element.required = False
+
+    if element.isRequired():
+        print("<%s>     :red:`required`" % (element.name), file=outfile)
+    else:
+        print("<%s>" % element.name, file=outfile)
+
+    if element.level > len(headings):
+        print(f"level > headings: {element.level} {len(headings)}  {element.name}  {href}")
+    print(headings[element.level - 1]*60, file=outfile)
+
+    print(".. container:: hatnote hatnote-gray\n", file=outfile)
+
+    crumb = element.crumb[0]
+    simplecrumb = f" <{crumb}>"
+    for c in element.crumb[1:]:
+        crumb = crumb + " :raw-html:`&rarr;`:raw-latex:`$\\rightarrow$` " + c
+        simplecrumb += f" <{c}>"
+
+    if not first_time:
+        print("   .. container:: crumb\n", file=outfile)
+        print("      %s\n" % crumb, file=outfile)
+        #print("      crumb:%s\n" % crumb, file=outfile)
+
+    description = ""
+    stored_description_default=False
+    level_char = element.crumb[0][0].upper()
+
+    if element.annotation:
+        ann_has_level_choice = list(filter(lambda a: a.tag == "levelDesc" and a.get("LevelChoice") == level_char , element.annotation))
+        if len(ann_has_level_choice) != 0:
+            ann_list = ann_has_level_choice
+        else:
+            ann_list = list(filter(lambda a: a.tag != "levelDesc" , element.annotation))
+        ann_list_lines = []
+        for ann in ann_list:
+            lines = ann.text.strip().replace('\t', '  ').split("\n")
+            if len(lines) > 1:
+                # second non-empty line often has space indent, first can be on element line
+                leading_whitespace=0
+                for l in lines[1:]:
+                    if len(l.strip()) > 0:
+                        leading_whitespace = len(l)-len(l.lstrip(' '))
+                        break
+                white = " "*leading_whitespace
+                lines[0] = white+lines[0].strip()
+                for l in lines:
+                    if len(l.strip()) != 0:
+                        if l[:leading_whitespace] != white:
+                            raise ValueError(f"removing more spaces than there are! {leading_whitespace} from {l}")
+                        l = l[leading_whitespace:]
+                    else:
+                        l = ""
+                    ann_list_lines.append(f"      {l}\n")
+            else:
+                ann_list_lines.append(f"      {lines[0]}\n")
+            # blank line between annotations
+            ann_list_lines.append("\n")
+#        description = " ".join(map(lambda note: " ".join(note.text.split()) , ann_list))
+        description = "".join(ann_list_lines)
+
+    num_el_attr_warnings = len(element.warning)
+    for attrib in element.attributes:
+        num_el_attr_warnings += len(attrib.warning)
+    if num_el_attr_warnings > 0:
+        with open("warnings.rst", "a") as warnfile:
+            for warning in element.warning:
+                single_line_warning = " ".join(warning.text.strip().split())
+                print("   .. admonition:: Warning, Future Change\n", file=outfile)
+                print(f"      <{element.name}>: {single_line_warning}\n", file=outfile)
+
+                print(f"\n\n", file=warnfile)
+                print(f"  -    {simplecrumb} : \n", file=warnfile)
+                print("     .. admonition:: Warning, Future Change\n", file=warnfile)
+                print(f"       <{element.name}>: {single_line_warning}\n", file=warnfile)
+            for attrib in element.attributes:
+                for warning in attrib.warning:
+                    single_line_warning = " ".join(warning.text.strip().split())
+                    print( "   .. admonition:: Warning, Future Change\n", file=outfile)
+                    print(f"      {attrib.name}: {single_line_warning}\n", file=outfile)
+
+                    print(f"\n\n", file=warnfile)
+                    print(f"  -    {simplecrumb} {attrib.name} : \n", file=warnfile)
+                    print("     .. admonition:: Warning, Future Change\n", file=warnfile)
+                    print(f"       {attrib.name}: {single_line_warning}\n", file=warnfile)
+
+
+    if element.type:
+        print("   .. container:: type\n", file=outfile)
+        latex_words="\t\t\t.. only:: latex\n\n"
+        html_words="\t\t\t.. only:: html\n\n"
+
+        latex_words+="\t\t\t\t\tcontent type: :ref:`%s<type-glossary>`" % (element.type)
+        html_words+="\t\t\t\t\tcontent type: `%s <appendices.html#glossary-%s>`_" % (element.type,element.type.lower())
+        if element.range_string:
+            splitElements=element.range_string.split(" ")
+
+            result=[]
+            for el in splitElements:
+                if (el[0].isalpha() or el[0].isdigit() or el[0]=="-"):
+                    result.append(el)
+                else:
+                    result.append(":math:`%s`" % el)
+            result=" ".join(result)
+
+            latex_words+="\n\n\t\t\t\t\trange: "+result+"\n"
+            html_words+="\n\n\t\t\t\t\trange: "+result+"\n"
+
+        else:
+            latex_words+="\n"
+            html_words+="\n"
+
+        print(latex_words, file=outfile)
+        print(html_words, file=outfile)
+
+    if len(description) > 0:
+
+        # If the annotation involves multiple options depending on its location
+
+        description=urlInserter(description)
+        description=mathBlock(description,element.level)
+
+        print("   .. container:: description\n", file=outfile)
+        print("%s\n" % description, file=outfile)
+
+    for example in element.example:
+        exampleStr = ""
+        if isinstance(example, ElementTree.Element):
+            if example.get('ElementChoice') is not None and element.parent is not None:
+                if example.get('ElementChoice') != element.parent.name:
+                    # skip this example as wrong level
+                    continue
+            if example.get('LevelChoice') is not None and element.parent is not None:
+                if example.get('LevelChoice') != level_char:
+                    # skip this example as wrong level
+                    continue
+            if example.tag == "example":
+                for ee in example:
+                    exampleStr += ElementTree.tostring(ee, encoding='unicode', method='xml')
+            else:
+                exampleStr = ElementTree.tostring(example, encoding='unicode', method='xml')
+        else:
+            exampleStr = example
+        exampleStr = exampleStr.strip()
+        print("   .. container:: example\n", file=outfile)
+        if exampleStr.find('\n') != -1:
+            # multiline example
+            print("      **Example**::\n", file=outfile)
+            lines = exampleStr.splitlines()
+            for l in lines:
+                print(f"        {l.rstrip()}", file=outfile)
+        else:
+            if (exampleStr[-1]==">" or exampleStr[-1]=="."):
+                print("      **Example**: %s\n" % exampleStr, file=outfile)
+            else:
+                print("     **Example**: %s.\n" % exampleStr, file=outfile)
+
+    if element.attributes:
+        print("\n\n", file=outfile)
+        print(f"   **Attributes of <{element.name}>**: \n", file=outfile)
+        print("   .. tabularcolumns::|l|l|l|1|1| \n", file=outfile)
+        print("   .. csv-table::", file=outfile)
+        print("      :class: rows", file=outfile)
+        print("      :escape: \ ", file=outfile)
+        print('      :header: "attribute", "type", "required", "description", "example"', file=outfile)
+        print("      :widths: auto\n", file=outfile)
+
+        for attrib in element.attributes:
+            required = "no"
+            if attrib.required == "required":
+                required = ":red:`yes`"
+
+            description = ""
+            example = ""
+            if len(attrib.example) != 0:
+                # use first example unless ElementChoice is attribute of example
+                DQ='"'
+                example = f"{attrib.name}=\{DQ}{attrib.example[0].text}\{DQ}"
+                for ex in attrib.example:
+                    if ex.get("ElementChoice") is not None and ex.get("ElementChoice") == element.name:
+                        example = f"{attrib.name}=\{DQ}{ex.text}\{DQ}"
+                    if ex.get("LevelChoice") is not None and ex.get("LevelChoice") == level_char:
+                        example = f"{attrib.name}=\{DQ}{ex.text}\{DQ}"
+            if len(attrib.annotation) != 0:
+                    ann_has_level_choice = list(filter(lambda a: a.tag == "levelDesc" and a.get("LevelChoice") == level_char , attrib.annotation))
+                    if len(ann_has_level_choice) != 0:
+                        ann_list = ann_has_level_choice
+                    else:
+                        ann_list = list(filter(lambda a: a.tag != "levelDesc" , attrib.annotation))
+                    description = " ".join(map(lambda note: " ".join(note.text.split()) , ann_list))
+
+            description = " ".join(description.split())
+            print("      **%s**, :ref:`%s<type-glossary>`, %s, \"%s\", \"%s\" " % (attrib.name, attrib.type,required, description, example), file=outfile)
+
+        print(file=outfile)
+
+    if element.children:
+        print("\n\n", file=outfile)
+        print(f"   **Sub Elements of <{element.name}>**: \n", file=outfile)
+        print("   .. tabularcolumns::|l|l|l|l| \n", file=outfile)
+        print("   .. csv-table::", file=outfile)
+        print("      :class: rows", file=outfile)
+        print("      :escape: \ ", file=outfile)
+        print('      :header: "element", "type", "number"', file=outfile)
+        print("      :widths: auto\n", file=outfile)
+        for child in element.children:
+            parentRef = ""
+            if child.name != stop_element:
+                for c in element.crumb:
+                    parentRef += c+"-"
+            required = ""
+            if child.isRequired():
+                required = ":red:`required`"
+                if child.max_occurs == "unbounded" or child.max_occurs is None:
+                    required = ":red:`required, many`"
+            else:
+                if child.min_occurs == 0:
+                    if child.max_occurs == "unbounded" or child.max_occurs is None:
+                        required = "optional, many"
+                    else:
+                        required = "optional"
+                elif child.max_occurs == 1:
+                    required = "optional"
+                elif child.max_occurs == "unbounded" or child.max_occurs is None:
+                    required = "many"
+                else:
+                    required = f"{child.min_occurs}/{child.max_occurs}"
+
+            range = ""
+            if child.range_string is not None:
+                range = child.range_string
+            type = ""
+            if child.type is not None:
+                type = child.type
+
+            #print(f"      **{child.local_name}**, :ref:`{child.local_name}`, {child.type}, \"{child.required}\", \"{child.range_string}\" ", file=outfile)
+            print(f"      :ref:`\<{child.name}\><{parentRef}{child.name}>`, {type}, \"{required}\" ", file=outfile)
+        print("\n\n", file=outfile)
+
+        for child in element.children:
+            if child.name != stop_element:
+                write_tree(child, stop_element, outfile, first_time = False)
+
+    return
+
+def elementChoiceChooser(documentation,theElement):
+    documentationChoices=documentation.split("ElementChoice:")
+    documentation=documentationChoices[0][16:]
+    elementSymbol=theElement.name[0].upper()
+
+    for choice in documentationChoices[1:]:
+        if elementSymbol==choice[0]:
+            documentation=choice[2:]
+
+    return documentation
+
+
+def isRightChoice(documentation, theElement):
+    if documentation.find("LevelChoice:")!=-1:
+        documentationChoice=documentation.split("LevelChoice:")[1]
+
+        sectionSymbol=theElement.crumb[0][0].upper()
+        if sectionSymbol==documentationChoice[0]:
+            right_choice=documentationChoice[2:]
+        else:
+            return False
+
+    elif documentation.find("ElementChoice:")!=-1:
+        documentationChoice=documentation.split("ElementChoice:")[1]
+
+        #some require you to go up a level
+        if documentationChoice[0]=="^":
+            sectionName=theElement.crumb[-(int(documentationChoice[1])+1)].upper()
+            documentationChoice=documentationChoice[2:]
+        else:
+            sectionName=theElement.name.upper()
+
+        if documentationChoice.find(sectionName)==0:
+            right_choice=documentationChoice[len(sectionName)+1:]
+            #print(sectionName, file=sys.stderr)
+
+        else:
+            return False
+
+    else:
+        right_choice=documentation[:]
+
+    return right_choice
+
+
+def urlInserter(documentation):
+    while documentation.find("urlHere:")!=-1:
+        docAtLeastTwoParts=documentation.split("urlHere:")
+
+        docStartWithURL=docAtLeastTwoParts[1]
+        docEndWithURLText=docAtLeastTwoParts[0]
+
+        docEndWithURLText=docEndWithURLText.rstrip()
+        docStartWithURL=docStartWithURL.lstrip()
+
+
+        docURL=docStartWithURL.split(" ")[0]
+        docPostURL=docStartWithURL.split(" ")[1:]
+        docPostURL=" ".join(docPostURL)
+
+        docText=docEndWithURLText.split(" ")[-1]
+        #print(docEndWithURLText.split(" "), file=sys.stderr)
+
+        docPreText=docEndWithURLText.split(" ")[:-1]
+        docPreText=" ".join(docPreText)
+
+        docText= "`%s <%s>`_" % (docText,docURL)
+
+        documentation=docPreText+" "+docText+" "+docPostURL
+    return documentation
+
+
+#Put []endEQ around equation
+def mathBlock(documentation,theLevel):
+    correctTabs="\t"*theLevel
+    if documentation.find('.. math::')!=-1:
+        documentation=documentation.split('.. math:: ')
+        toReturn=[documentation[0]]
+        for postMathBlock in documentation[1:]:
+            #print(postMathBlock, file=sys.stderr)
+            splitBlock=postMathBlock.split(']endEQ ')
+            equation=splitBlock[0][1:]
+            #print(equation, file=sys.stderr)
+            if len(splitBlock)>1:
+                restOf=correctTabs+''.join(splitBlock[1:])
+            else:
+                restOf=''
+            toReturn+=["\\begin{eqnarray}"+equation+"\\end{eqnarray}\n\n"+restOf]
+        documentation=("\n\n"+correctTabs+".. math::\n\t"+correctTabs+":nowrap:\n\n\t"+correctTabs).join(toReturn)
+    return documentation
+
+
+class Attribute(object):
+    def __init__(self, name=None, local_name=None, required=False, annotation=None, type=None):
+        self.name = name
+        self.local_name = local_name
+        self.required = required
+        self.annotation = []
+        self.example = []
+        self.warning = []
+        self.type = type
+
+        if annotation is not None:
+            for note in annotation:
+                self.add_annotation(note)
+
+    def add_annotation(self, note):
+        self.annotation.append(note)
+
+    def add_example(self, ex):
+        self.example.append(ex)
+
+    def add_warning(self, element):
+        self.warning.append(element)
+
+    def __repr__(self):
+
+        if self.annotation:
+            if len(self.annotation) == 1:
+                string = " attrib:%s required:[%s] annote:[%s]\n" % \
+                        (self.name, self.required, self.annotation[0])
+            else:
+                string = " attrib:%s required:[%s]\n" % \
+                        (self.name, self.required)
+                for anote in self.annotation:
+                    string += "anote:[%s]\n" % (self.name, anote)
+        else:
+            string = " attrib:%s required:[%s]\n" % (self.name, self.required)
+
+        return string
+
+
+class Element(object):
+    def __init__(self, name=None, local_name=None, required=False, attributes=None, crumb=None,
+                 annotation=None, children=None, level=None, type=None, range_string=None):
+        self.name = name
+        self.local_name = local_name
+        self.required = required
+        self.annotation = []
+        self.example = []
+        self.warning = []
+        self.children = []
+        self.attributes = []
+        self.crumb = []
+        self.level = level
+        self.type = type
+        self.range_string = range_string
+        self.parent = None
+        self.min_occurs = 1
+        self.max_occurs = 1
+
+        if annotation is not None:
+            for note in annotation:
+                self.add_annotation(note)
+
+        if children is not None:
+            for child in children:
+                self.add_child(child)
+
+        if crumb is not None:
+            for x in crumb:
+                self.add_crumb(x)
+
+    def add_annotation(self, note):
+        self.annotation.append(note)
+
+    def add_example(self, element):
+        self.example.append(element)
+
+    def add_warning(self, element):
+        self.warning.append(element)
+
+    def add_attribute(self, attribute):
+        self.attributes.append(attribute)
+
+    def add_child(self, element):
+        self.children.append(element)
+        element.parent = self
+
+    def add_crumb(self, x):
+        self.crumb.append(x)
+    def isRequired(self):
+        # MTH: Hack to fix: SampleRate is not required *unless* SampleRateRatio is present:
+        elements_in_groups = ['SampleRate', 'SampleRateRatio', 'FrequencyStart', 'FrequencyEnd',
+                              'FrequencyDBVariation']
+        if self.name in elements_in_groups:
+            return False
+        else:
+            return self.required
+
+
+
+def get_type(x, field_name):
+
+    keep_type = None
+    range_string = None
+
+    if isinstance(x, XsdAtomicBuiltin):
+        keep_type = x.local_name
+    elif isinstance(x, XsdAtomicRestriction):
+        keep_type = x.primitive_type.local_name
+        minval = None
+        maxval = None
+        mininc = False
+        maxinc = False
+
+        for v in x.validators:
+            if isinstance(v, XsdMinInclusiveFacet):
+                mininc = True
+                minval = v.value
+            elif isinstance(v, XsdMinExclusiveFacet):
+                minval = v.value
+            elif isinstance(v, XsdMaxInclusiveFacet):
+                maxinc = True
+                maxval = v.value
+            elif isinstance(v, XsdMaxExclusiveFacet):
+                maxval = v.value
+        min_symb = "lt"
+        if mininc:
+            min_symb = "le"
+        max_symb = "lt"
+        if maxinc:
+            max_symb = "le"
+
+        if minval is not None:
+            if maxval is not None:
+                range_string = "%s \%s %s \%s %s" % (minval, min_symb, field_name, max_symb, maxval)
+            else:
+                # range_string = "%s \%s %s" % (minval, min_symb, field_name)
+                symb = 'g%s' % min_symb[1]
+                range_string = "%s \%s %s" % (field_name, symb, minval)
+
+        # print("range_string:%s" % range_string, file=sys.stderr)
+
+    return keep_type, range_string
+
+
+def walk_tree(xsd_element, level=1, last_elem=None, context=None):
+    """Recursively walk the schema element tree """
+
+    level_elem = None
+    space = (level - 1) * 8 + 6
+    space *= " "
+
+    # Create initial context list
+    if context is None:
+        context = []
+
+    if args.verbose > 1:
+        print (f'Working on xsd_element: {xsd_element}, level: {level}')
+
+    # Store the context for breadcrumbs
+    context.append(xsd_element.local_name)
+
+    keep_type, range_string = get_type(xsd_element.type.content, xsd_element.local_name)
+    this_elem = Element(name=xsd_element.local_name, level=level, type=keep_type, range_string=range_string, crumb=context)
+    this_elem.min_occurs = xsd_element.min_occurs
+    this_elem.max_occurs = xsd_element.max_occurs
+
+    if xsd_element.min_occurs == 1:
+        this_elem.required = True
+
+    if level == 1:
+        level_elem = this_elem
+
+    if last_elem is not None:
+        last_elem.add_child(this_elem)
+        # print("Elem level:%d name:%s --> add_child:%s" % (last_elem.level, last_elem.name, this_elem.name), file=sys.stderr)
+
+    if xsd_element.annotation is not None:
+        for y in xsd_element.annotation.documentation:
+            for ex in y.findall("example"):
+                this_elem.add_example(ex)
+            for ex in y.findall("warning"):
+                this_elem.add_warning(ex)
+            for ld in y.findall("levelDesc"):
+                this_elem.add_annotation(ld)
+            if len(y) == 0 and y.text != None:
+                this_elem.add_annotation(y)
+
+    # May not want these:
+    if xsd_element.type.annotation is not None:
+        for y in xsd_element.type.annotation.documentation:
+            for ex in y.findall("example"):
+                this_elem.add_example(ex)
+            for ex in y.findall("warning"):
+                this_elem.add_warning(ex)
+            for ld in y.findall("levelDesc"):
+                this_elem.add_annotation(ld)
+            if len(y) == 0 and y.text is not None:
+                this_elem.add_annotation(y)
+                #print("%s MTH: Add (type) annotation:[%s]" % (space, text), file=sys.stderr)
+
+    for k in xsd_element.attributes:
+        attrib = xsd_element.attributes[k]
+        if not isinstance(attrib, XsdAnyAttribute):
+            attr = Attribute(name=attrib.name, local_name=attrib.type.local_name,
+                             required=attrib.use, type=attrib.type.local_name)
+            this_elem.add_attribute(attr)
+
+        if attrib.annotation is not None:
+            for y in attrib.annotation.documentation:
+                for ex in y.findall("example"):
+                    attr.add_example(ex)
+                for ex in y.findall("warning"):
+                    attr.add_warning(ex)
+                for ld in y.findall("levelDesc"):
+                    attr.add_annotation(ld)
+                if len(y) == 0 and y.text is not None:
+                    attr.add_annotation(y)
+                    #print("%s MTH: Add attrib annotation:[%s]" % (space, text), file=sys.stderr)
+
+    # xsd_element.type is always some form of XsdComplexType
+    # xsd_element.type.content_type is either XsdGroup, XsdAtomicBuiltin or XsdAtomicRestriction
+    if isinstance(xsd_element.type.content, XsdGroup):
+
+        # Iterate through contained elements
+        for e in xsd_element.type.content.iter_elements():
+
+            if not isinstance(e, XsdAnyElement):
+
+                required = False
+                if e.min_occurs == 1:
+                    required = True
+
+                keep_type, range_string = get_type(e.type, e.local_name)
+
+                if isinstance(e.type, XsdAtomicBuiltin) or isinstance(e.type, XsdAtomicRestriction):
+
+                    # Store subelement, while adding name to context
+                    subElement = Element(name=e.local_name, required=required, type=keep_type, level=level+1,
+                                         range_string=range_string, crumb=context + [e.local_name])
+                    subElement.min_occurs = e.min_occurs
+                    subElement.max_occurs = e.max_occurs
+                    this_elem.add_child(subElement)
+
+                    if e.annotation is not None:
+                        for y in e.annotation.documentation:
+                            for ex in y.findall("example"):
+                                subElement.add_example(ex)
+                            for ex in y.findall("warning"):
+                                subElement.add_warning(ex)
+                            for ld in y.findall("levelDesc"):
+                                subElement.add_annotation(ld)
+                            if len(y) == 0 and y.text != None:
+                                subElement.add_annotation(y)
+                                # print("  has annotation=[%s]" % text, file=sys.stderr)
+                    for k in e.attributes:
+                        attrib = e.attributes[k]
+                        if not isinstance(attrib, XsdAnyAttribute):
+                            attr = Attribute(name=attrib.name, local_name=attrib.type.local_name,
+                                            required=attrib.use, type=attrib.type.local_name)
+                            subElement.add_attribute(attr)
+
+                        if attrib.annotation is not None:
+                            for y in attrib.annotation.documentation:
+                                for ex in y.findall("example"):
+                                    attr.add_example(ex)
+                                for ex in y.findall("warning"):
+                                    attr.add_warning(ex)
+                                for ld in y.findall("levelDesc"):
+                                    subElement.add_annotation(ld)
+                                if len(y) == 0 and y.text != None:
+                                    attr.add_annotation(y)
+
+                else:
+                    walk_tree(e, level=level+1, last_elem=this_elem, context=context)
+                    context.pop()
+
+    else:
+        #print("  NOT XsdGroup x.local_name=%s x.type=%s x.content_type=%s" % (x.local_name, x.type.local_name, x.type.content_type.local_name), file=sys.stderr)
+        return level_elem
+
+    return level_elem
+
+def save_spelling(words):
+    spelling_dir = 'spelling'
+    schema_words = 'schema_words.txt'
+    text_words = 'text_words.txt'
+    if not os.path.isdir(spelling_dir):
+        os.makedirs(spelling_dir)
+    with open(os.path.join(spelling_dir, schema_words), 'w') as words_file:
+        sort_words = list(words)
+        sort_words.sort()
+        for w in sort_words:
+            print(w, file=words_file)
+
+
+def recur_spelling(words, element):
+    words.add(element.name)
+    for a in element.attributes:
+        words.add(a.name)
+    for child in element.children:
+        recur_spelling(words, child)
+
+
+
+
+def main():
+    """Generate RST from XSD documentation tags
+
+    Iterate through specified schema file, accumulate documentation
+    elements, convert to RST and write to output files.
+
+    Output files are opened (overwritting) for each main level of the
+    schema: Preamble, Network, Station, Channel, Response in the pattern:
+    `OUTDIR/level-LEVEL.rst`
+    """
+
+    print (f'Reading schema file {args.schemafile} and writing RST to directory {args.outdir}')
+
+    schema = xmlschema.XMLSchema(args.schemafile)
+
+    # create warning.rst file for deprectaion warnings
+    with open("warnings.rst", "w") as warnfile:
+        print(".. Put any comments here\n", file=warnfile)
+        print("  Warning, this file is regenerated from the annotations in the schema file.\n", file=warnfile)
+        print("  Any changes will be overwritten by convert_xsd_to_rst.py.\n\n\n", file=warnfile)
+        print("\n", file=warnfile)
+        print("The following are potential future changes, as tagged in the schema with <warning> elements in the documentation. They may result in modifications or deletions in future versions of StationXML.\n", file=warnfile)
+        print("\n\n", file=warnfile)
+
+    level_xpaths = ['fsx:FDSNStationXML',
+                    'fsx:FDSNStationXML/fsx:Network',
+                    'fsx:FDSNStationXML/fsx:Network/fsx:Station',
+                    'fsx:FDSNStationXML/fsx:Network/fsx:Station/fsx:Channel',
+                    'fsx:FDSNStationXML/fsx:Network/fsx:Station/fsx:Channel/fsx:Response']
+
+    words = set()
+    for i, xpath in enumerate(level_xpaths):
+        xsd_element = schema.find(xpath)
+
+        stop_element = None
+        this_element = os.path.basename(xpath).split(':')[1]
+        if i < 4:
+            stop_element = os.path.basename(level_xpaths[i+1]).split(':')[1]
+
+        level_elem = walk_tree(xsd_element)
+
+        # Use Preamble instead of root element name
+        if this_element=="FDSNStationXML":
+            this_element="Preamble"
+
+        # Generate output file name for this level
+        rst_file = os.path.join (args.outdir, f'level-{this_element.lower()}.rst')
+
+        if args.verbose:
+            print (f'Writing to {rst_file}')
+
+        with open(rst_file, 'w') as outfile:
+            print(".. Put any comments here\n", file=outfile)
+            print("  Warning, this file is regenerated from the annotations in the schema file.\n", file=outfile)
+            print("  Any changes will be overwritten by convert_xsd_to_rst.py.\n", file=outfile)
+
+            write_tree(level_elem, stop_element, outfile = outfile)
+
+        recur_spelling(words, level_elem)
+    save_spelling(words)
+
+
+if __name__ == "__main__":
+
+    # Parse command line arguments
+    parser = argparse.ArgumentParser(description='Generate RST output from XSD documentation tags')
+    parser.add_argument('schemafile',
+                        help='input XSD schema file')
+    parser.add_argument('outdir', nargs='?', default=os.getcwd(),
+                        help='directory for output RST files, default is current working directory')
+    parser.add_argument('--verbose', '-v', action='count', default=0,
+                        help='increase verbosity')
+
+    args = parser.parse_args()
+
+    main()
diff --git a/docs/decimation_delay.png b/docs/decimation_delay.png
new file mode 100644
index 0000000..671d5d2
Binary files /dev/null and b/docs/decimation_delay.png differ
diff --git a/docs/examples/.gitignore b/docs/examples/.gitignore
new file mode 100644
index 0000000..7458e21
--- /dev/null
+++ b/docs/examples/.gitignore
@@ -0,0 +1,5 @@
+fdsn-station-1.1.xsd
+stationxml-validator-1.7.1.jar
+validator.tar.gz
+xerces-2_12_1-xml-schema-1.1/
+xmlvalidator/
diff --git a/docs/examples/Setra_270-intro.rst b/docs/examples/Setra_270-intro.rst
new file mode 100644
index 0000000..d5e501c
--- /dev/null
+++ b/docs/examples/Setra_270-intro.rst
@@ -0,0 +1,78 @@
+
+
+This example was lifted from [62] Response [Polynomial] Blockette section (p.85)
+of the SEED manual (v.2.4).
+
+The Setra Model 270 Pressure Transducer response is
+given as a polynomial response with 2 coefficients,
+valid for input pressure between 600-1100 mbar.
+
+.. math::
+
+   Pressure(V)=\sum_{n=0}^{1} a_n V^{n}
+
+where :math:`a_0=600` and :math:`a_1=100`,
+e.g., over this voltage range (0-5V), the input (mbar of pressure) is a
+linear function of the output (Volts).
+
+Bound Values for polynomial:
+Lower 600 mbar
+Upper 1100 mbar
+
+.. csv-table::
+   :class: rows
+   :header: "Volts", "mbar"
+   :widths: auto
+
+   0.0, 600
+   1.0, 700
+   2.0, 800
+   3.0, 900
+   4.0, 1000
+   5.0, 1100
+
+
+How the InstrumentPolynomial was calculated
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Assume we use an 8 bit digitizer where 0 counts = 0 volts and 255 counts = 5 volts.
+This translates to a digitizer gain of 51 Counts/volt.
+
+This provides the following conversion from counts to pressure:
+
+
+.. csv-table::
+  :class: rows
+  :header: "Counts", "Volts (V) = gain*counts", "Pressure (mbar) = p(volts)"
+  :widths: auto
+
+  0, 0.0, 600
+  51, 1.0, 700
+  102, 2.0, 800
+  153, 3.0, 900
+  204, 4.0, 1000
+  255, 5.0, 1100
+
+
+Just as in the previous example for the YSI 44031,
+the InstrumentPolynomial stage looks a lot like the Polynomial stage
+except that the overall system gain has been incorporated into the
+polynomial coefficients. In this case, because it is linear, only the
+:math:`a_1` term is affected.
+
+
+.. math::
+
+   a^{\prime}_n=\frac{a_n}{(g_0)^{n}}
+
+where :math:`g_0 = 51` is the overall gain, giving coefficients for the
+InstrumentPolynomial of :math:`a_0=600` and :math:`a_1=1.96`.
+This yields an overall InstrumentPolynomial, where pressure is a function
+of the recorded counts, of:
+
+.. math::
+  Pressure(c) = 600 + 1.96*c
+
+
+A complete StationXML Response element is shown below for the Setra 270 sensor
+attached to a generic 51 count per volt datalogger sampling at 1Hz.
diff --git a/docs/examples/Setra_270.rst b/docs/examples/Setra_270.rst
new file mode 100644
index 0000000..7979766
--- /dev/null
+++ b/docs/examples/Setra_270.rst
@@ -0,0 +1,9 @@
+
+.. include:: examples/Setra_270-intro.rst
+
+.. toggle-header::
+  :header: StationXML **Show/Hide**
+
+  .. literalinclude:: examples/Setra_270.xml
+    :language: XML
+
diff --git a/docs/examples/Setra_270.xml b/docs/examples/Setra_270.xml
new file mode 100644
index 0000000..1ec3a9c
--- /dev/null
+++ b/docs/examples/Setra_270.xml
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+    schemaVersion="1.2">
+  <Source>isti</Source>
+  <Created>2020-06-06T01:19:15.736834Z</Created>
+  <Network code="XX">
+    <Station code="ABCD">
+      <Latitude>0.0</Latitude>
+      <Longitude>0.0</Longitude>
+      <Elevation>10.0</Elevation>
+      <Site>
+        <Name>Nowhere</Name>
+      </Site>
+      <Channel code="BDO" locationCode="10">
+        <Latitude>0.0</Latitude>
+        <Longitude>0.0</Longitude>
+        <Elevation>10.0</Elevation>
+        <Depth>0.0</Depth>
+        <Azimuth>0.0</Azimuth>
+        <Dip>-90.0</Dip>
+        <SampleRate>40.0</SampleRate>
+        <Sensor><Description>Setra 270 pressure transducer</Description></Sensor>
+        <Response>
+           <InstrumentPolynomial name="InstrumentPolynomial">
+             <InputUnits>
+               <Name>mbar</Name>
+               <Description>Pressure in mbar</Description>
+             </InputUnits>
+             <OutputUnits>
+              <Name>count</Name>
+              <Description>Digital Counts</Description>
+             </OutputUnits>
+             <ApproximationType>MACLAURIN</ApproximationType>
+             <FrequencyLowerBound unit="HERTZ">0.0</FrequencyLowerBound>
+             <FrequencyUpperBound unit="HERTZ">0.0</FrequencyUpperBound>
+             <ApproximationLowerBound>600</ApproximationLowerBound>
+             <ApproximationUpperBound>1100</ApproximationUpperBound>
+             <MaximumError>0.0</MaximumError>
+             <Coefficient>600</Coefficient>
+             <Coefficient>1.96</Coefficient>
+           </InstrumentPolynomial>
+           <Stage number="1">
+              <Polynomial name=" SENSOR RESPONSE   ">
+                <InputUnits>
+                  <Name>mbar</Name>
+                  <Description>Pressure in mbar</Description>
+                </InputUnits>
+              <OutputUnits>
+                 <Name>V</Name>
+                 <Description>Volts</Description>
+              </OutputUnits>
+              <ApproximationType>MACLAURIN</ApproximationType>
+              <FrequencyLowerBound unit="HERTZ">0.0</FrequencyLowerBound>
+              <FrequencyUpperBound unit="HERTZ">0.0</FrequencyUpperBound>
+              <ApproximationLowerBound>600</ApproximationLowerBound>
+              <ApproximationUpperBound>1100</ApproximationUpperBound>
+              <MaximumError>0.0</MaximumError>
+              <Coefficient>600</Coefficient>
+              <Coefficient>100</Coefficient>
+              </Polynomial>
+           </Stage>
+           <Stage number="2">
+              <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+              </StageGain>
+           </Stage>
+           <Stage number="3">
+              <Coefficients name=" DIGITIZER">
+              <InputUnits>
+                 <Name>V</Name>
+                 <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                 <Name>count</Name>
+                 <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.0</Numerator>
+              </Coefficients>
+              <Decimation>
+              <InputSampleRate unit="HERTZ">1.0</InputSampleRate>
+              <Factor>1</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+              </Decimation>
+              <StageGain>
+              <Value>51</Value>
+              <Frequency>0.0</Frequency>
+              </StageGain>
+           </Stage>
+        </Response>
+      </Channel>
+    </Station>
+  </Network>
+</FDSNStationXML>
diff --git a/docs/examples/YSI-44031-intro.rst b/docs/examples/YSI-44031-intro.rst
new file mode 100644
index 0000000..e4c79b7
--- /dev/null
+++ b/docs/examples/YSI-44031-intro.rst
@@ -0,0 +1,93 @@
+
+
+The Berkeley Digital Seismic Network (BDSN) seismometers, use a Yellow Springs Instrument Co.
+(YSI) 44031 thermistor to monitor the temperature of the seismometer.
+The thermistor response has been determined by measuring its
+voltage output as a function of input temperature.
+It has been calibrated within a range of temperatures from -5C to 68.59C.
+
+The resistance of the thermistor is a non-linear function of the temperature and its
+response can be described by a polynomial.
+
+In order to model the response within 0.2 degrees C accuracy,
+a MacLaurin polynomial with 11 coefficients:
+
+.. math::
+
+   Temp(V)=\sum_{n=0}^{10} a_n V^{n}
+
+The coefficients are given in Table 1.
+
+.. csv-table::
+      :class: rows
+      :header: :math:`a_n`, "value"
+      :widths: auto
+
+      :math:`a_0`, 0.12505E+02
+      :math:`a_1`, 0.13824E+02
+      :math:`a_2`, 0.41039E+01
+      :math:`a_3`, 0.12932E+01
+      :math:`a_4`, 0.18741E+01
+      :math:`a_5`, 0.17250E+01
+      :math:`a_6`, -0.61021E+00
+      :math:`a_7`, -0.10540E+01
+      :math:`a_8`, 0.13974E+00
+      :math:`a_9`, 0.39061E+00
+      :math:`a_{10}`,0.95345E-01
+
+Because this is a *polynomial* response, the corresponding StationXML looks
+a little different than the usual responses (e.g., for seismometers).
+Instead of a InstrumentSensitivity element, there is an InstrumentPolynomial element.
+In addition the analog stage is represented by a Polynomial stage.
+The Polynomial stage and the InstrumentPolynomial stage both contain all
+of the MacLaurin coefficients, however, in the InstrumentPolynomial stage,
+those coefficients have been scaled by the datalogger sensitivity to give
+units of Counts instead of Volts.
+
+How the InstrumentPolynomial was calculated
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The InstrumentPolynomial stage looks a lot like the Polynomial stage
+except that the overall system gain has been incorporated into the
+polynomial coefficients.
+
+The overall system gain is just the product of the individual stage gains
+for the remaining stages:
+
+.. math::
+
+   g_0=\Pi_{n=1}^{N} gain_n
+
+where :math:`g_0` is the system gain. Note that the Polynomial stage cannot
+have a StageGain element, and so the gain for that stage is unity.
+
+Then the :math:`n^{th}` coefficient of the MacLaurin series is scaled by the inverse
+:math:`n^{th}` power of the system gain:
+
+.. math::
+
+   a^{\prime}_n=\frac{a_n}{(g_0)^{n}}
+
+For the example shown, the system gain is :math:`g_0=838860.80`  so that
+the scaled coefficients are:
+
+.. csv-table::
+      :class: rows
+      :header: "coefficient", "value"
+      :widths: auto
+
+      :math:`a^{\prime}_0`, 0.12505E+02
+      :math:`a^{\prime}_1`, 1.64795e-05
+      :math:`a^{\prime}_2`, 5.83199e-12
+      :math:`a^{\prime}_3`, 2.19077e-18
+      :math:`a^{\prime}_4`, 3.78471e-24
+      :math:`a^{\prime}_5`, 4.15279e-30
+      :math:`a^{\prime}_6`, -1.75122e-36
+      :math:`a^{\prime}_7`, -3.60588e-42
+      :math:`a^{\prime}_8`, 5.69904e-49
+      :math:`a^{\prime}_9`, 1.89904e-54
+      :math:`a^{\prime}_{10}`,5.52585e-61
+
+
+A complete StationXML Response element is shown below for the YSI-44301
+thermistor attached to a Reftek RT130 datalogger sampling at 40Hz.
diff --git a/docs/examples/YSI-44031.png b/docs/examples/YSI-44031.png
new file mode 100644
index 0000000..d88d9dc
Binary files /dev/null and b/docs/examples/YSI-44031.png differ
diff --git a/docs/examples/YSI-44031.rst b/docs/examples/YSI-44031.rst
new file mode 100644
index 0000000..be6c369
--- /dev/null
+++ b/docs/examples/YSI-44031.rst
@@ -0,0 +1,12 @@
+
+.. include:: examples/YSI-44031-intro.rst
+
+.. toggle-header::
+  :header: StationXML **Show/Hide**
+
+  .. literalinclude:: examples/YSI-44031.xml
+    :language: XML
+
+
+.. image:: examples/YSI-44031.png
+
diff --git a/docs/examples/YSI-44031.xml b/docs/examples/YSI-44031.xml
new file mode 100644
index 0000000..1db0cd2
--- /dev/null
+++ b/docs/examples/YSI-44031.xml
@@ -0,0 +1,741 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+    schemaVersion="1.2">
+  <Source>isti</Source>
+  <Created>2020-06-10T13:25:01.910728Z</Created>
+  <Network code="XX">
+    <Station code="ABCD">
+      <Latitude>0.0</Latitude>
+      <Longitude>0.0</Longitude>
+      <Elevation>10.0</Elevation>
+      <Site>
+        <Name>Nowhere</Name>
+      </Site>
+      <Channel code="BKD" locationCode="10">
+        <Latitude>0.0</Latitude>
+        <Longitude>0.0</Longitude>
+        <Elevation>10.0</Elevation>
+        <Depth>0.0</Depth>
+        <Azimuth>0.0</Azimuth>
+        <Dip>-90.0</Dip>
+        <SampleRate>40.0</SampleRate>
+        <Sensor><Description>YSI 44301 temperature</Description></Sensor>
+        <DataLogger><Description>Reftek RT130</Description></DataLogger>
+        <Response>
+          <InstrumentPolynomial name="InstrumentPolynomial">
+            <Description>None</Description>
+            <InputUnits>
+              <Name>degC</Name>
+              <Description>TEMPERATURE in Celsius</Description>
+            </InputUnits>
+            <OutputUnits>
+              <Name>count</Name>
+              <Description>Digital Counts</Description>
+            </OutputUnits>
+            <ApproximationType>MACLAURIN</ApproximationType>
+            <FrequencyLowerBound unit="HERTZ">0.0</FrequencyLowerBound>
+            <FrequencyUpperBound unit="HERTZ">0.01</FrequencyUpperBound>
+            <ApproximationLowerBound>-5.02</ApproximationLowerBound>
+            <ApproximationUpperBound>68.59</ApproximationUpperBound>
+            <MaximumError>0.072</MaximumError>
+            <Coefficient>12.505</Coefficient>
+            <Coefficient>1.64794921875e-05</Coefficient>
+            <Coefficient>5.83199266657175e-12</Coefficient>
+            <Coefficient>2.1907660147785217e-18</Coefficient>
+            <Coefficient>3.784714809535227e-24</Coefficient>
+            <Coefficient>4.1527864425849766e-30</Coefficient>
+            <Coefficient>-1.7512168159552436e-36</Coefficient>
+            <Coefficient>-3.605880325679582e-42</Coefficient>
+            <Coefficient>5.699037789738209e-49</Coefficient>
+            <Coefficient>1.8990406231916714e-54</Coefficient>
+            <Coefficient>5.525847819332687e-61</Coefficient>
+          </InstrumentPolynomial>
+          <Stage number="1">
+            <Polynomial name=" SENSOR RESPONSE   ">
+              <InputUnits>
+                <Name>degC</Name>
+                <Description>TEMPERATURE in Celsius</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </OutputUnits>
+              <ApproximationType>MACLAURIN</ApproximationType>
+              <FrequencyLowerBound unit="HERTZ">0.0</FrequencyLowerBound>
+              <FrequencyUpperBound unit="HERTZ">0.01</FrequencyUpperBound>
+              <ApproximationLowerBound>-5.02</ApproximationLowerBound>
+              <ApproximationUpperBound>68.59</ApproximationUpperBound>
+              <MaximumError>0.072</MaximumError>
+              <Coefficient>12.505</Coefficient>
+              <Coefficient>13.824</Coefficient>
+              <Coefficient>4.1039</Coefficient>
+              <Coefficient>1.2932</Coefficient>
+              <Coefficient>1.8741</Coefficient>
+              <Coefficient>1.725</Coefficient>
+              <Coefficient>-0.61021</Coefficient>
+              <Coefficient>-1.054</Coefficient>
+              <Coefficient>0.13974</Coefficient>
+              <Coefficient>0.39061</Coefficient>
+              <Coefficient>0.095345</Coefficient>
+            </Polynomial>
+          </Stage>
+          <Stage number="2">
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="3">
+            <Coefficients name=" DIGITIZER">
+              <InputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.0</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">102400.0</InputSampleRate>
+              <Factor>1</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>838860.8</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="4">
+            <Coefficients name=" DECIMATION">
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.000976562</Numerator>
+              <Numerator>0.00244141</Numerator>
+              <Numerator>0.00488281</Numerator>
+              <Numerator>0.00854492</Numerator>
+              <Numerator>0.0136719</Numerator>
+              <Numerator>0.0205078</Numerator>
+              <Numerator>0.0292969</Numerator>
+              <Numerator>0.0393066</Numerator>
+              <Numerator>0.0498047</Numerator>
+              <Numerator>0.0600586</Numerator>
+              <Numerator>0.0693359</Numerator>
+              <Numerator>0.0769043</Numerator>
+              <Numerator>0.0820312</Numerator>
+              <Numerator>0.0839844</Numerator>
+              <Numerator>0.0820312</Numerator>
+              <Numerator>0.0769043</Numerator>
+              <Numerator>0.0693359</Numerator>
+              <Numerator>0.0600586</Numerator>
+              <Numerator>0.0498047</Numerator>
+              <Numerator>0.0393066</Numerator>
+              <Numerator>0.0292969</Numerator>
+              <Numerator>0.0205078</Numerator>
+              <Numerator>0.0136719</Numerator>
+              <Numerator>0.00854492</Numerator>
+              <Numerator>0.00488281</Numerator>
+              <Numerator>0.00244141</Numerator>
+              <Numerator>0.000976562</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">102400.0</InputSampleRate>
+              <Factor>8</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="5">
+            <Coefficients name=" DECIMATION">
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">12800.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="6">
+            <Coefficients name=" DECIMATION">
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">6400.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="7">
+            <Coefficients name=" DECIMATION">
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">3200.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="8">
+            <Coefficients name=" DECIMATION">
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">1600.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="9">
+            <Coefficients name=" DECIMATION">
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">800.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="10">
+            <Coefficients name=" DECIMATION">
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-7.15032e-07</Numerator>
+              <Numerator>-5.60109e-06</Numerator>
+              <Numerator>-2.62179e-06</Numerator>
+              <Numerator>-4.31403e-05</Numerator>
+              <Numerator>-4.64771e-06</Numerator>
+              <Numerator>1.43006e-06</Numerator>
+              <Numerator>2.34769e-05</Numerator>
+              <Numerator>1.43006e-06</Numerator>
+              <Numerator>-5.27932e-05</Numerator>
+              <Numerator>-0.000366692</Numerator>
+              <Numerator>0.000376107</Numerator>
+              <Numerator>0.000854226</Numerator>
+              <Numerator>3.05081e-05</Numerator>
+              <Numerator>-0.00127621</Numerator>
+              <Numerator>-0.000910951</Numerator>
+              <Numerator>0.00127669</Numerator>
+              <Numerator>0.00215165</Numerator>
+              <Numerator>-0.000461554</Numerator>
+              <Numerator>-0.00333765</Numerator>
+              <Numerator>-0.00140933</Numerator>
+              <Numerator>0.00377072</Numerator>
+              <Numerator>0.00419414</Numerator>
+              <Numerator>-0.00264288</Numerator>
+              <Numerator>-0.00720121</Numerator>
+              <Numerator>-0.000644006</Numerator>
+              <Numerator>0.009184</Numerator>
+              <Numerator>0.00608445</Numerator>
+              <Numerator>-0.00857824</Numerator>
+              <Numerator>-0.0127401</Numerator>
+              <Numerator>0.00398225</Numerator>
+              <Numerator>0.0186261</Numerator>
+              <Numerator>0.0052052</Numerator>
+              <Numerator>-0.0209407</Numerator>
+              <Numerator>-0.0181629</Numerator>
+              <Numerator>0.0166669</Numerator>
+              <Numerator>0.0322447</Numerator>
+              <Numerator>-0.00346588</Numerator>
+              <Numerator>-0.0429528</Numerator>
+              <Numerator>-0.0193265</Numerator>
+              <Numerator>0.044309</Numerator>
+              <Numerator>0.0497909</Numerator>
+              <Numerator>-0.0294164</Numerator>
+              <Numerator>-0.0826078</Numerator>
+              <Numerator>-0.00934166</Numerator>
+              <Numerator>0.107552</Numerator>
+              <Numerator>0.0816604</Numerator>
+              <Numerator>-0.10311</Numerator>
+              <Numerator>-0.204208</Numerator>
+              <Numerator>-3.12231e-05</Numerator>
+              <Numerator>0.390432</Numerator>
+              <Numerator>0.589958</Numerator>
+              <Numerator>0.390432</Numerator>
+              <Numerator>-3.12231e-05</Numerator>
+              <Numerator>-0.204208</Numerator>
+              <Numerator>-0.10311</Numerator>
+              <Numerator>0.0816604</Numerator>
+              <Numerator>0.107552</Numerator>
+              <Numerator>-0.00934166</Numerator>
+              <Numerator>-0.0826078</Numerator>
+              <Numerator>-0.0294164</Numerator>
+              <Numerator>0.0497909</Numerator>
+              <Numerator>0.044309</Numerator>
+              <Numerator>-0.0193265</Numerator>
+              <Numerator>-0.0429528</Numerator>
+              <Numerator>-0.00346588</Numerator>
+              <Numerator>0.0322447</Numerator>
+              <Numerator>0.0166669</Numerator>
+              <Numerator>-0.0181629</Numerator>
+              <Numerator>-0.0209407</Numerator>
+              <Numerator>0.0052052</Numerator>
+              <Numerator>0.0186261</Numerator>
+              <Numerator>0.00398225</Numerator>
+              <Numerator>-0.0127401</Numerator>
+              <Numerator>-0.00857824</Numerator>
+              <Numerator>0.00608445</Numerator>
+              <Numerator>0.009184</Numerator>
+              <Numerator>-0.000644006</Numerator>
+              <Numerator>-0.00720121</Numerator>
+              <Numerator>-0.00264288</Numerator>
+              <Numerator>0.00419414</Numerator>
+              <Numerator>0.00377072</Numerator>
+              <Numerator>-0.00140933</Numerator>
+              <Numerator>-0.00333765</Numerator>
+              <Numerator>-0.000461554</Numerator>
+              <Numerator>0.00215165</Numerator>
+              <Numerator>0.00127669</Numerator>
+              <Numerator>-0.000910951</Numerator>
+              <Numerator>-0.00127621</Numerator>
+              <Numerator>3.05081e-05</Numerator>
+              <Numerator>0.000854226</Numerator>
+              <Numerator>0.000376107</Numerator>
+              <Numerator>-0.000366692</Numerator>
+              <Numerator>-0.00041031</Numerator>
+              <Numerator>2.52645e-05</Numerator>
+              <Numerator>0.000261821</Numerator>
+              <Numerator>0.000120602</Numerator>
+              <Numerator>-9.99854e-05</Numerator>
+              <Numerator>-0.000162312</Numerator>
+              <Numerator>-9.79595e-05</Numerator>
+              <Numerator>-2.94355e-05</Numerator>
+              <Numerator>-3.09847e-06</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">400.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="11">
+            <Coefficients name=" DECIMATION">
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-1.09889e-05</Numerator>
+              <Numerator>-1.99798e-05</Numerator>
+              <Numerator>-3.29668e-05</Numerator>
+              <Numerator>-4.39561e-05</Numerator>
+              <Numerator>-4.79522e-05</Numerator>
+              <Numerator>-4.09589e-05</Numerator>
+              <Numerator>-1.8981e-05</Numerator>
+              <Numerator>1.8981e-05</Numerator>
+              <Numerator>6.7932e-05</Numerator>
+              <Numerator>0.000118881</Numerator>
+              <Numerator>0.000158842</Numerator>
+              <Numerator>0.000174826</Numerator>
+              <Numerator>0.000157843</Numerator>
+              <Numerator>0.000104895</Numerator>
+              <Numerator>2.49751e-05</Numerator>
+              <Numerator>-6.49352e-05</Numerator>
+              <Numerator>-0.00014086</Numerator>
+              <Numerator>-0.000178822</Numerator>
+              <Numerator>-0.00016084</Numerator>
+              <Numerator>-8.59142e-05</Numerator>
+              <Numerator>3.29668e-05</Numerator>
+              <Numerator>0.000163837</Numerator>
+              <Numerator>0.000268733</Numerator>
+              <Numerator>0.000310691</Numerator>
+              <Numerator>0.000263737</Numerator>
+              <Numerator>0.00013087</Numerator>
+              <Numerator>-6.09391e-05</Numerator>
+              <Numerator>-0.00026074</Numerator>
+              <Numerator>-0.000408593</Numerator>
+              <Numerator>-0.000448554</Numerator>
+              <Numerator>-0.000353648</Numerator>
+              <Numerator>-0.000135864</Numerator>
+              <Numerator>0.000155845</Numerator>
+              <Numerator>0.000438563</Numerator>
+              <Numerator>0.000623379</Numerator>
+              <Numerator>0.000638365</Numerator>
+              <Numerator>0.000456546</Numerator>
+              <Numerator>0.000108891</Numerator>
+              <Numerator>-0.000315686</Numerator>
+              <Numerator>-0.000694309</Numerator>
+              <Numerator>-0.000903101</Numerator>
+              <Numerator>-0.00085415</Numerator>
+              <Numerator>-0.000533469</Numerator>
+              <Numerator>-7.99164e-06</Numerator>
+              <Numerator>0.000581421</Numerator>
+              <Numerator>0.00105695</Numerator>
+              <Numerator>0.00125675</Numerator>
+              <Numerator>0.00108792</Numerator>
+              <Numerator>0.000559443</Numerator>
+              <Numerator>-0.000201799</Numerator>
+              <Numerator>-0.000983021</Numerator>
+              <Numerator>-0.00154047</Numerator>
+              <Numerator>-0.00167733</Numerator>
+              <Numerator>-0.0013037</Numerator>
+              <Numerator>-0.000484518</Numerator>
+              <Numerator>0.000571431</Numerator>
+              <Numerator>0.00155645</Numerator>
+              <Numerator>0.00215685</Numerator>
+              <Numerator>0.00214287</Numerator>
+              <Numerator>0.00145855</Numerator>
+              <Numerator>0.00025075</Numerator>
+              <Numerator>-0.00115385</Numerator>
+              <Numerator>-0.00233568</Numerator>
+              <Numerator>-0.00290311</Numerator>
+              <Numerator>-0.0026174</Numerator>
+              <Numerator>-0.00148752</Numerator>
+              <Numerator>0.000215785</Numerator>
+              <Numerator>0.002014</Numerator>
+              <Numerator>0.00335166</Numerator>
+              <Numerator>0.00376825</Numerator>
+              <Numerator>0.00304597</Numerator>
+              <Numerator>0.0013037</Numerator>
+              <Numerator>-0.001009</Numerator>
+              <Numerator>-0.0032208</Numerator>
+              <Numerator>-0.00463139</Numerator>
+              <Numerator>-0.0047233</Numerator>
+              <Numerator>-0.00334667</Numerator>
+              <Numerator>-0.000793211</Numerator>
+              <Numerator>0.00224477</Numerator>
+              <Numerator>0.00486516</Numerator>
+              <Numerator>0.00620583</Numerator>
+              <Numerator>0.0057273</Numerator>
+              <Numerator>0.00340861</Numerator>
+              <Numerator>-0.000199801</Numerator>
+              <Numerator>-0.00409193</Numerator>
+              <Numerator>-0.00707596</Numerator>
+              <Numerator>-0.00812791</Numerator>
+              <Numerator>-0.00672831</Numerator>
+              <Numerator>-0.00307194</Numerator>
+              <Numerator>0.00192309</Numerator>
+              <Numerator>0.00682721</Numerator>
+              <Numerator>0.010091</Numerator>
+              <Numerator>0.0105175</Numerator>
+              <Numerator>0.00766437</Numerator>
+              <Numerator>0.00206594</Numerator>
+              <Numerator>-0.00483219</Numerator>
+              <Numerator>-0.01101</Numerator>
+              <Numerator>-0.0144376</Numerator>
+              <Numerator>-0.0136934</Numerator>
+              <Numerator>-0.00847457</Numerator>
+              <Numerator>0.000173827</Numerator>
+              <Numerator>0.010004</Numerator>
+              <Numerator>0.018085</Numerator>
+              <Numerator>0.0215935</Numerator>
+              <Numerator>0.0186664</Numerator>
+              <Numerator>0.00910094</Numerator>
+              <Numerator>-0.0053287</Numerator>
+              <Numerator>-0.0210541</Numerator>
+              <Numerator>-0.0333958</Numerator>
+              <Numerator>-0.0376226</Numerator>
+              <Numerator>-0.030137</Numerator>
+              <Numerator>-0.00949755</Numerator>
+              <Numerator>0.0229931</Numerator>
+              <Numerator>0.063304</Numerator>
+              <Numerator>0.10534</Numerator>
+              <Numerator>0.142124</Numerator>
+              <Numerator>0.167226</Numerator>
+              <Numerator>0.176134</Numerator>
+              <Numerator>0.167226</Numerator>
+              <Numerator>0.142124</Numerator>
+              <Numerator>0.10534</Numerator>
+              <Numerator>0.063304</Numerator>
+              <Numerator>0.0229931</Numerator>
+              <Numerator>-0.00949755</Numerator>
+              <Numerator>-0.030137</Numerator>
+              <Numerator>-0.0376226</Numerator>
+              <Numerator>-0.0333958</Numerator>
+              <Numerator>-0.0210541</Numerator>
+              <Numerator>-0.0053287</Numerator>
+              <Numerator>0.00910094</Numerator>
+              <Numerator>0.0186664</Numerator>
+              <Numerator>0.0215935</Numerator>
+              <Numerator>0.018085</Numerator>
+              <Numerator>0.010004</Numerator>
+              <Numerator>0.000173827</Numerator>
+              <Numerator>-0.00847457</Numerator>
+              <Numerator>-0.0136934</Numerator>
+              <Numerator>-0.0144376</Numerator>
+              <Numerator>-0.01101</Numerator>
+              <Numerator>-0.00483219</Numerator>
+              <Numerator>0.00206594</Numerator>
+              <Numerator>0.00766437</Numerator>
+              <Numerator>0.0105175</Numerator>
+              <Numerator>0.010091</Numerator>
+              <Numerator>0.00682721</Numerator>
+              <Numerator>0.00192309</Numerator>
+              <Numerator>-0.00307194</Numerator>
+              <Numerator>-0.00672831</Numerator>
+              <Numerator>-0.00812791</Numerator>
+              <Numerator>-0.00707596</Numerator>
+              <Numerator>-0.00409193</Numerator>
+              <Numerator>-0.000199801</Numerator>
+              <Numerator>0.00340861</Numerator>
+              <Numerator>0.0057273</Numerator>
+              <Numerator>0.00620583</Numerator>
+              <Numerator>0.00486516</Numerator>
+              <Numerator>0.00224477</Numerator>
+              <Numerator>-0.000793211</Numerator>
+              <Numerator>-0.00334667</Numerator>
+              <Numerator>-0.0047233</Numerator>
+              <Numerator>-0.00463139</Numerator>
+              <Numerator>-0.0032208</Numerator>
+              <Numerator>-0.001009</Numerator>
+              <Numerator>0.0013037</Numerator>
+              <Numerator>0.00304597</Numerator>
+              <Numerator>0.00376825</Numerator>
+              <Numerator>0.00335166</Numerator>
+              <Numerator>0.002014</Numerator>
+              <Numerator>0.000215785</Numerator>
+              <Numerator>-0.00148752</Numerator>
+              <Numerator>-0.0026174</Numerator>
+              <Numerator>-0.00290311</Numerator>
+              <Numerator>-0.00233568</Numerator>
+              <Numerator>-0.00115385</Numerator>
+              <Numerator>0.00025075</Numerator>
+              <Numerator>0.00145855</Numerator>
+              <Numerator>0.00214287</Numerator>
+              <Numerator>0.00215685</Numerator>
+              <Numerator>0.00155645</Numerator>
+              <Numerator>0.000571431</Numerator>
+              <Numerator>-0.000484518</Numerator>
+              <Numerator>-0.0013037</Numerator>
+              <Numerator>-0.00167733</Numerator>
+              <Numerator>-0.00154047</Numerator>
+              <Numerator>-0.000983021</Numerator>
+              <Numerator>-0.000201799</Numerator>
+              <Numerator>0.000559443</Numerator>
+              <Numerator>0.00108792</Numerator>
+              <Numerator>0.00125675</Numerator>
+              <Numerator>0.00105695</Numerator>
+              <Numerator>0.000581421</Numerator>
+              <Numerator>-7.99164e-06</Numerator>
+              <Numerator>-0.000533469</Numerator>
+              <Numerator>-0.00085415</Numerator>
+              <Numerator>-0.000903101</Numerator>
+              <Numerator>-0.000694309</Numerator>
+              <Numerator>-0.000315686</Numerator>
+              <Numerator>0.000108891</Numerator>
+              <Numerator>0.000456546</Numerator>
+              <Numerator>0.000638365</Numerator>
+              <Numerator>0.000623379</Numerator>
+              <Numerator>0.000438563</Numerator>
+              <Numerator>0.000155845</Numerator>
+              <Numerator>-0.000135864</Numerator>
+              <Numerator>-0.000353648</Numerator>
+              <Numerator>-0.000448554</Numerator>
+              <Numerator>-0.000408593</Numerator>
+              <Numerator>-0.00026074</Numerator>
+              <Numerator>-6.09391e-05</Numerator>
+              <Numerator>0.00013087</Numerator>
+              <Numerator>0.000263737</Numerator>
+              <Numerator>0.000310691</Numerator>
+              <Numerator>0.000268733</Numerator>
+              <Numerator>0.000163837</Numerator>
+              <Numerator>3.29668e-05</Numerator>
+              <Numerator>-8.59142e-05</Numerator>
+              <Numerator>-0.00016084</Numerator>
+              <Numerator>-0.000178822</Numerator>
+              <Numerator>-0.00014086</Numerator>
+              <Numerator>-6.49352e-05</Numerator>
+              <Numerator>2.49751e-05</Numerator>
+              <Numerator>0.000104895</Numerator>
+              <Numerator>0.000157843</Numerator>
+              <Numerator>0.000174826</Numerator>
+              <Numerator>0.000158842</Numerator>
+              <Numerator>0.000118881</Numerator>
+              <Numerator>6.7932e-05</Numerator>
+              <Numerator>1.8981e-05</Numerator>
+              <Numerator>-1.8981e-05</Numerator>
+              <Numerator>-4.09589e-05</Numerator>
+              <Numerator>-4.79522e-05</Numerator>
+              <Numerator>-4.39561e-05</Numerator>
+              <Numerator>-3.29668e-05</Numerator>
+              <Numerator>-1.99798e-05</Numerator>
+              <Numerator>-1.09889e-05</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">200.0</InputSampleRate>
+              <Factor>5</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.0</Frequency>
+            </StageGain>
+          </Stage>
+        </Response>
+      </Channel>
+    </Station>
+  </Network>
+</FDSNStationXML>
diff --git a/docs/examples/convert_xml_to_rst.py b/docs/examples/convert_xml_to_rst.py
new file mode 100644
index 0000000..2cd5f2f
--- /dev/null
+++ b/docs/examples/convert_xml_to_rst.py
@@ -0,0 +1,52 @@
+
+import sys
+import os
+import subprocess
+
+# IRIS stationxml validator
+# available from
+# https://github.com/iris-edu/StationXML-Validator/releases
+# help at
+# http://iris-edu.github.io/stationxml-validator/
+iris_validator = "stationxml-validator-1.7.1.jar"
+
+do_validate = True
+if not os.path.exists(iris_validator):
+    print()
+    print("If you wish to validate, download IRIS validator from https://github.com/iris-edu/StationXML-Validator/releases")
+    print("...skipping stationxml-validator")
+    print()
+    do_validate = False
+
+all_xml = ['gs-13_Qx80.xml',
+    'kinemetrics_etna_fba-3.xml',
+    'l-22d_rt72a-08.xml',
+    'Setra_270.xml',
+    'sts-1_Qx80.xml',
+    'sts-2_rt130.xml',
+    'YSI-44031.xml']
+
+for xmlfile in all_xml:
+    print(xmlfile)
+    rstfile = xmlfile.replace(".xml", ".rst")
+    introfile = rstfile.replace(".rst", "-intro.rst")
+    pngfile = xmlfile.replace(".xml", ".png")
+
+    with open(rstfile, 'w') as out:
+        if os.path.exists(introfile):
+            out.write(f"\n.. include:: examples/{introfile}\n\n")
+
+        out.write("%s\n" % ".. toggle-header::")
+        out.write("  %s\n\n" % ":header: StationXML **Show/Hide**")
+        out.write(f"  .. literalinclude:: examples/{xmlfile}\n")
+        out.write(f"    :language: XML\n\n")
+
+        if os.path.exists(pngfile):
+            out.write("\n.. image:: examples/%s\n\n" % pngfile)
+
+    if do_validate:
+        validate_cmd = f"java -jar {iris_validator} --input {xmlfile}"
+        print("validation...")
+        res = subprocess.call(validate_cmd, shell = True)
+        if res != 0:
+            raise Exception(f"Validator for {xmlfile} returned non-zero exit code: {res}")
diff --git a/docs/examples/gs-13_Qx80.png b/docs/examples/gs-13_Qx80.png
new file mode 100644
index 0000000..40aa61c
Binary files /dev/null and b/docs/examples/gs-13_Qx80.png differ
diff --git a/docs/examples/gs-13_Qx80.rst b/docs/examples/gs-13_Qx80.rst
new file mode 100644
index 0000000..a802e8c
--- /dev/null
+++ b/docs/examples/gs-13_Qx80.rst
@@ -0,0 +1,9 @@
+.. toggle-header::
+  :header: StationXML **Show/Hide**
+
+  .. literalinclude:: examples/gs-13_Qx80.xml
+    :language: XML
+
+
+.. image:: examples/gs-13_Qx80.png
+
diff --git a/docs/examples/gs-13_Qx80.xml b/docs/examples/gs-13_Qx80.xml
new file mode 100644
index 0000000..e0734f1
--- /dev/null
+++ b/docs/examples/gs-13_Qx80.xml
@@ -0,0 +1,293 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+    schemaVersion="1.2">
+  <Source>isti</Source>
+  <Created>2020-06-05T21:59:22.232797Z</Created>
+  <Network code="XX">
+    <Station code="ABCD">
+      <Latitude>0.0</Latitude>
+      <Longitude>0.0</Longitude>
+      <Elevation>10.0</Elevation>
+      <Site>
+        <Name>Nowhere</Name>
+      </Site>
+      <Channel code="BHZ" locationCode="10">
+        <Latitude>0.0</Latitude>
+        <Longitude>0.0</Longitude>
+        <Elevation>10.0</Elevation>
+        <Depth>0.0</Depth>
+        <Azimuth>0.0</Azimuth>
+        <Dip>-90.0</Dip>
+        <SampleRate>80.0</SampleRate>
+        <Sensor><Description>Geotech GS-13</Description></Sensor>
+        <DataLogger><Description>Quanterra Qx80</Description></DataLogger>
+        <Response>
+          <InstrumentSensitivity>
+            <Value>264268099.805</Value>
+            <Frequency>5.0</Frequency>
+            <InputUnits>
+              <Name>m/s</Name>
+              <Description>Velocity in Meters per Second</Description>
+            </InputUnits>
+            <OutputUnits>
+              <Name>count</Name>
+              <Description>Digital Counts</Description>
+            </OutputUnits>
+          </InstrumentSensitivity>
+          <Stage number="1">
+            <PolesZeros>
+              <InputUnits>
+                <Name>m/s</Name>
+                <Description>Velocity in Meters per Second</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </OutputUnits>
+              <PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType>
+              <NormalizationFactor>1.0</NormalizationFactor>
+              <NormalizationFrequency unit="HERTZ">5.0</NormalizationFrequency>
+              <Zero number="0">
+                <Real>0.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Zero number="1">
+                <Real>0.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Pole number="0">
+                <Real>-4.443</Real>
+                <Imaginary>4.443</Imaginary>
+              </Pole>
+              <Pole number="1">
+                <Real>-4.443</Real>
+                <Imaginary>-4.443</Imaginary>
+              </Pole>
+            </PolesZeros>
+            <StageGain>
+              <Value>629.0</Value>
+              <Frequency>5.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="2">
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="3">
+            <Coefficients>
+              <InputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.0</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">5120.0</InputSampleRate>
+              <Factor>1</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>400000.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="4">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-0.00111328</Numerator>
+              <Numerator>-0.001008</Numerator>
+              <Numerator>-0.00135286</Numerator>
+              <Numerator>-0.00173045</Numerator>
+              <Numerator>-0.00208418</Numerator>
+              <Numerator>-0.00238538</Numerator>
+              <Numerator>-0.00260956</Numerator>
+              <Numerator>-0.00273352</Numerator>
+              <Numerator>-0.00273316</Numerator>
+              <Numerator>-0.00258472</Numerator>
+              <Numerator>-0.00226412</Numerator>
+              <Numerator>-0.00174847</Numerator>
+              <Numerator>-0.00101403</Numerator>
+              <Numerator>-3.51682e-05</Numerator>
+              <Numerator>0.00123782</Numerator>
+              <Numerator>0.00315983</Numerator>
+              <Numerator>0.00699945</Numerator>
+              <Numerator>0.0090996</Numerator>
+              <Numerator>0.0125424</Numerator>
+              <Numerator>0.0163123</Numerator>
+              <Numerator>0.0202632</Numerator>
+              <Numerator>0.0243173</Numerator>
+              <Numerator>0.0284051</Numerator>
+              <Numerator>0.0324604</Numerator>
+              <Numerator>0.0364143</Numerator>
+              <Numerator>0.0401987</Numerator>
+              <Numerator>0.043745</Numerator>
+              <Numerator>0.0469873</Numerator>
+              <Numerator>0.0498573</Numerator>
+              <Numerator>0.0522796</Numerator>
+              <Numerator>0.054114</Numerator>
+              <Numerator>0.0543903</Numerator>
+              <Numerator>0.0543903</Numerator>
+              <Numerator>0.054114</Numerator>
+              <Numerator>0.0522796</Numerator>
+              <Numerator>0.0498573</Numerator>
+              <Numerator>0.0469873</Numerator>
+              <Numerator>0.043745</Numerator>
+              <Numerator>0.0401987</Numerator>
+              <Numerator>0.0364143</Numerator>
+              <Numerator>0.0324604</Numerator>
+              <Numerator>0.0284051</Numerator>
+              <Numerator>0.0243173</Numerator>
+              <Numerator>0.0202632</Numerator>
+              <Numerator>0.0163123</Numerator>
+              <Numerator>0.0125424</Numerator>
+              <Numerator>0.0090996</Numerator>
+              <Numerator>0.00699945</Numerator>
+              <Numerator>0.00315983</Numerator>
+              <Numerator>0.00123782</Numerator>
+              <Numerator>-3.51682e-05</Numerator>
+              <Numerator>-0.00101403</Numerator>
+              <Numerator>-0.00174847</Numerator>
+              <Numerator>-0.00226412</Numerator>
+              <Numerator>-0.00258472</Numerator>
+              <Numerator>-0.00273316</Numerator>
+              <Numerator>-0.00273352</Numerator>
+              <Numerator>-0.00260956</Numerator>
+              <Numerator>-0.00238538</Numerator>
+              <Numerator>-0.00208418</Numerator>
+              <Numerator>-0.00173045</Numerator>
+              <Numerator>-0.00135286</Numerator>
+              <Numerator>-0.001008</Numerator>
+              <Numerator>-0.00111328</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">5120.0</InputSampleRate>
+              <Factor>16</Factor>
+              <Offset>0</Offset>
+              <Delay>0.006152344</Delay>
+              <Correction>0.006</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.014774</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="5">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000150487</Numerator>
+              <Numerator>0.000305924</Numerator>
+              <Numerator>0.000442949</Numerator>
+              <Numerator>0.000387117</Numerator>
+              <Numerator>-4.73787e-05</Numerator>
+              <Numerator>-0.000970772</Numerator>
+              <Numerator>-0.00230317</Numerator>
+              <Numerator>-0.00370638</Numerator>
+              <Numerator>-0.00462505</Numerator>
+              <Numerator>-0.0044648</Numerator>
+              <Numerator>-0.00286984</Numerator>
+              <Numerator>7.00861e-06</Numerator>
+              <Numerator>0.0033852</Numerator>
+              <Numerator>0.00600353</Numerator>
+              <Numerator>0.00655094</Numerator>
+              <Numerator>0.00425995</Numerator>
+              <Numerator>-0.000576024</Numerator>
+              <Numerator>-0.00643416</Numerator>
+              <Numerator>-0.0109214</Numerator>
+              <Numerator>-0.0116364</Numerator>
+              <Numerator>-0.00726515</Numerator>
+              <Numerator>0.00153727</Numerator>
+              <Numerator>0.0119331</Numerator>
+              <Numerator>0.0196157</Numerator>
+              <Numerator>0.0203516</Numerator>
+              <Numerator>0.011868</Numerator>
+              <Numerator>-0.00464369</Numerator>
+              <Numerator>-0.0241125</Numerator>
+              <Numerator>-0.0386383</Numerator>
+              <Numerator>-0.0398499</Numerator>
+              <Numerator>-0.0218684</Numerator>
+              <Numerator>0.0161612</Numerator>
+              <Numerator>0.0689624</Numerator>
+              <Numerator>0.126003</Numerator>
+              <Numerator>0.174229</Numerator>
+              <Numerator>0.201834</Numerator>
+              <Numerator>0.201834</Numerator>
+              <Numerator>0.174229</Numerator>
+              <Numerator>0.126003</Numerator>
+              <Numerator>0.0689624</Numerator>
+              <Numerator>0.0161612</Numerator>
+              <Numerator>-0.0218684</Numerator>
+              <Numerator>-0.0398499</Numerator>
+              <Numerator>-0.0386383</Numerator>
+              <Numerator>-0.0241125</Numerator>
+              <Numerator>-0.00464369</Numerator>
+              <Numerator>0.011868</Numerator>
+              <Numerator>0.0203516</Numerator>
+              <Numerator>0.0196157</Numerator>
+              <Numerator>0.0119331</Numerator>
+              <Numerator>0.00153727</Numerator>
+              <Numerator>-0.00726515</Numerator>
+              <Numerator>-0.0116364</Numerator>
+              <Numerator>-0.0109214</Numerator>
+              <Numerator>-0.00643416</Numerator>
+              <Numerator>-0.000576024</Numerator>
+              <Numerator>0.00425995</Numerator>
+              <Numerator>0.00655094</Numerator>
+              <Numerator>0.00600353</Numerator>
+              <Numerator>0.0033852</Numerator>
+              <Numerator>7.00861e-06</Numerator>
+              <Numerator>-0.00286984</Numerator>
+              <Numerator>-0.0044648</Numerator>
+              <Numerator>-0.00462505</Numerator>
+              <Numerator>-0.00370638</Numerator>
+              <Numerator>-0.00230317</Numerator>
+              <Numerator>-0.000970772</Numerator>
+              <Numerator>-4.73787e-05</Numerator>
+              <Numerator>0.000387117</Numerator>
+              <Numerator>0.000442949</Numerator>
+              <Numerator>0.000305924</Numerator>
+              <Numerator>0.000150487</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">320.0</InputSampleRate>
+              <Factor>4</Factor>
+              <Offset>0</Offset>
+              <Delay>0.1109375</Delay>
+              <Correction>0.083</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>0.9781118</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+        </Response>
+      </Channel>
+    </Station>
+  </Network>
+</FDSNStationXML>
diff --git a/docs/examples/kinemetrics_etna_fba-3.png b/docs/examples/kinemetrics_etna_fba-3.png
new file mode 100644
index 0000000..b7dbc0b
Binary files /dev/null and b/docs/examples/kinemetrics_etna_fba-3.png differ
diff --git a/docs/examples/kinemetrics_etna_fba-3.rst b/docs/examples/kinemetrics_etna_fba-3.rst
new file mode 100644
index 0000000..6247ce4
--- /dev/null
+++ b/docs/examples/kinemetrics_etna_fba-3.rst
@@ -0,0 +1,9 @@
+.. toggle-header::
+  :header: StationXML **Show/Hide**
+
+  .. literalinclude:: examples/kinemetrics_etna_fba-3.xml
+    :language: XML
+
+
+.. image:: examples/kinemetrics_etna_fba-3.png
+
diff --git a/docs/examples/kinemetrics_etna_fba-3.xml b/docs/examples/kinemetrics_etna_fba-3.xml
new file mode 100644
index 0000000..2362a63
--- /dev/null
+++ b/docs/examples/kinemetrics_etna_fba-3.xml
@@ -0,0 +1,347 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+    schemaVersion="1.2">
+  <Source>isti</Source>
+  <Created>2020-06-05T21:54:34.921819Z</Created>
+  <Network code="XX">
+    <Station code="ABCD">
+      <Latitude>0.0</Latitude>
+      <Longitude>0.0</Longitude>
+      <Elevation>10.0</Elevation>
+      <Site>
+        <Name>Nowhere</Name>
+      </Site>
+      <Channel code="BHZ" locationCode="10">
+        <Latitude>0.0</Latitude>
+        <Longitude>0.0</Longitude>
+        <Elevation>10.0</Elevation>
+        <Depth>0.0</Depth>
+        <Azimuth>0.0</Azimuth>
+        <Dip>-90.0</Dip>
+        <SampleRate>200.0</SampleRate>
+        <Sensor><Description>Kinemetrics FBA-3</Description></Sensor>
+        <DataLogger><Description>Kinemetrics Etna</Description></DataLogger>
+        <Response>
+          <InstrumentSensitivity>
+            <Value>213920.152837</Value>
+            <Frequency>0.15</Frequency>
+            <InputUnits>
+              <Name>m/s**2</Name>
+              <Description>Acceleration in Meters Per Second Per Second</Description>
+            </InputUnits>
+            <OutputUnits>
+              <Name>count</Name>
+              <Description>Digital Counts</Description>
+            </OutputUnits>
+          </InstrumentSensitivity>
+          <Stage number="1">
+            <PolesZeros>
+              <InputUnits>
+                <Name>m/s**2</Name>
+                <Description>Acceleration in Meters Per Second Per Second</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </OutputUnits>
+              <PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType>
+              <NormalizationFactor>147985000.0</NormalizationFactor>
+              <NormalizationFrequency unit="HERTZ">0.15</NormalizationFrequency>
+              <Pole number="0">
+                <Real>-222.1</Real>
+                <Imaginary>222.1</Imaginary>
+              </Pole>
+              <Pole number="1">
+                <Real>-222.1</Real>
+                <Imaginary>-222.1</Imaginary>
+              </Pole>
+              <Pole number="2">
+                <Real>-1500.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Pole>
+            </PolesZeros>
+            <StageGain>
+              <Value>0.0637</Value>
+              <Frequency>0.15</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="2">
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>1.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="3">
+            <Coefficients>
+              <InputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.0</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">2000.0</InputSampleRate>
+              <Factor>1</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>3360000.0</Value>
+              <Frequency>1.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="4">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.2e-07</Numerator>
+              <Numerator>-6e-07</Numerator>
+              <Numerator>-7.27e-06</Numerator>
+              <Numerator>-3.278e-05</Numerator>
+              <Numerator>-9.894e-05</Numerator>
+              <Numerator>-0.00023174</Numerator>
+              <Numerator>-0.00044167</Numerator>
+              <Numerator>-0.00069332</Numerator>
+              <Numerator>-0.00087345</Numerator>
+              <Numerator>-0.0007838</Numerator>
+              <Numerator>-0.00018537</Numerator>
+              <Numerator>0.00108707</Numerator>
+              <Numerator>0.00296128</Numerator>
+              <Numerator>0.0049758</Numerator>
+              <Numerator>0.00624192</Numerator>
+              <Numerator>0.00561416</Numerator>
+              <Numerator>0.00210238</Numerator>
+              <Numerator>-0.00455022</Numerator>
+              <Numerator>-0.0133232</Numerator>
+              <Numerator>-0.0216756</Numerator>
+              <Numerator>-0.0258368</Numerator>
+              <Numerator>-0.0217012</Numerator>
+              <Numerator>-0.00615335</Numerator>
+              <Numerator>0.0215797</Numerator>
+              <Numerator>0.0590637</Numerator>
+              <Numerator>0.100701</Numerator>
+              <Numerator>0.13883</Numerator>
+              <Numerator>0.165634</Numerator>
+              <Numerator>0.175286</Numerator>
+              <Numerator>0.165634</Numerator>
+              <Numerator>0.13883</Numerator>
+              <Numerator>0.100701</Numerator>
+              <Numerator>0.0590637</Numerator>
+              <Numerator>0.0215797</Numerator>
+              <Numerator>-0.00615335</Numerator>
+              <Numerator>-0.0217012</Numerator>
+              <Numerator>-0.0258368</Numerator>
+              <Numerator>-0.0216756</Numerator>
+              <Numerator>-0.0133232</Numerator>
+              <Numerator>-0.00455022</Numerator>
+              <Numerator>0.00210238</Numerator>
+              <Numerator>0.00561416</Numerator>
+              <Numerator>0.00624192</Numerator>
+              <Numerator>0.0049758</Numerator>
+              <Numerator>0.00296128</Numerator>
+              <Numerator>0.00108707</Numerator>
+              <Numerator>-0.00018537</Numerator>
+              <Numerator>-0.0007838</Numerator>
+              <Numerator>-0.00087345</Numerator>
+              <Numerator>-0.00069332</Numerator>
+              <Numerator>-0.00044167</Numerator>
+              <Numerator>-0.00023174</Numerator>
+              <Numerator>-9.894e-05</Numerator>
+              <Numerator>-3.278e-05</Numerator>
+              <Numerator>-7.27e-06</Numerator>
+              <Numerator>-6e-07</Numerator>
+              <Numerator>1.2e-07</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">2000.0</InputSampleRate>
+              <Factor>5</Factor>
+              <Offset>0</Offset>
+              <Delay>0.014</Delay>
+              <Correction>0.014</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>1.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="5">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>6e-07</Numerator>
+              <Numerator>1.55e-06</Numerator>
+              <Numerator>-2.26e-06</Numerator>
+              <Numerator>-1.681e-05</Numerator>
+              <Numerator>-3.362e-05</Numerator>
+              <Numerator>-2.73e-05</Numerator>
+              <Numerator>1.156e-05</Numerator>
+              <Numerator>4.172e-05</Numerator>
+              <Numerator>9.78e-06</Numerator>
+              <Numerator>-5.686e-05</Numerator>
+              <Numerator>-5.186e-05</Numerator>
+              <Numerator>5.221e-05</Numerator>
+              <Numerator>0.00010896</Numerator>
+              <Numerator>-1.156e-05</Numerator>
+              <Numerator>-0.00016463</Numerator>
+              <Numerator>-7.641e-05</Numerator>
+              <Numerator>0.00019097</Numerator>
+              <Numerator>0.00021076</Numerator>
+              <Numerator>-0.00015306</Numerator>
+              <Numerator>-0.00036979</Numerator>
+              <Numerator>1.884e-05</Numerator>
+              <Numerator>0.00050938</Numerator>
+              <Numerator>0.00022852</Numerator>
+              <Numerator>-0.00056541</Numerator>
+              <Numerator>-0.00057662</Numerator>
+              <Numerator>0.00046456</Numerator>
+              <Numerator>0.00097203</Numerator>
+              <Numerator>-0.00014412</Numerator>
+              <Numerator>-0.00131798</Numerator>
+              <Numerator>-0.00042439</Numerator>
+              <Numerator>0.00148249</Numerator>
+              <Numerator>0.00121105</Numerator>
+              <Numerator>-0.0013206</Numerator>
+              <Numerator>-0.00210965</Numerator>
+              <Numerator>0.00070846</Numerator>
+              <Numerator>0.00293458</Numerator>
+              <Numerator>0.00041425</Numerator>
+              <Numerator>-0.00343633</Numerator>
+              <Numerator>-0.00200474</Numerator>
+              <Numerator>0.00333858</Numerator>
+              <Numerator>0.00388706</Numerator>
+              <Numerator>-0.00239384</Numerator>
+              <Numerator>-0.00574386</Numerator>
+              <Numerator>0.00045073</Numerator>
+              <Numerator>0.00713658</Numerator>
+              <Numerator>0.00248027</Numerator>
+              <Numerator>-0.00755632</Numerator>
+              <Numerator>-0.00617528</Numerator>
+              <Numerator>0.00650048</Numerator>
+              <Numerator>0.0101701</Numerator>
+              <Numerator>-0.00356448</Numerator>
+              <Numerator>-0.0137692</Numerator>
+              <Numerator>-0.00146592</Numerator>
+              <Numerator>0.0160844</Numerator>
+              <Numerator>0.00854254</Numerator>
+              <Numerator>-0.016091</Numerator>
+              <Numerator>-0.0173173</Numerator>
+              <Numerator>0.0126604</Numerator>
+              <Numerator>0.0271523</Numerator>
+              <Numerator>-0.00448489</Numerator>
+              <Numerator>-0.0371805</Numerator>
+              <Numerator>-0.0103546</Numerator>
+              <Numerator>0.046411</Numerator>
+              <Numerator>0.0361366</Numerator>
+              <Numerator>-0.0538626</Numerator>
+              <Numerator>-0.0885348</Numerator>
+              <Numerator>0.0587055</Numerator>
+              <Numerator>0.312242</Numerator>
+              <Numerator>0.439562</Numerator>
+              <Numerator>0.312242</Numerator>
+              <Numerator>0.0587055</Numerator>
+              <Numerator>-0.0885348</Numerator>
+              <Numerator>-0.0538626</Numerator>
+              <Numerator>0.0361366</Numerator>
+              <Numerator>0.046411</Numerator>
+              <Numerator>-0.0103546</Numerator>
+              <Numerator>-0.0371805</Numerator>
+              <Numerator>-0.00448489</Numerator>
+              <Numerator>0.0271523</Numerator>
+              <Numerator>0.0126604</Numerator>
+              <Numerator>-0.0173173</Numerator>
+              <Numerator>-0.016091</Numerator>
+              <Numerator>0.00854254</Numerator>
+              <Numerator>0.0160844</Numerator>
+              <Numerator>-0.00146592</Numerator>
+              <Numerator>-0.0137692</Numerator>
+              <Numerator>-0.00356448</Numerator>
+              <Numerator>0.0101701</Numerator>
+              <Numerator>0.00650048</Numerator>
+              <Numerator>-0.00617528</Numerator>
+              <Numerator>-0.00755632</Numerator>
+              <Numerator>0.00248027</Numerator>
+              <Numerator>0.00713658</Numerator>
+              <Numerator>0.00045073</Numerator>
+              <Numerator>-0.00574386</Numerator>
+              <Numerator>-0.00239384</Numerator>
+              <Numerator>0.00388706</Numerator>
+              <Numerator>0.00333858</Numerator>
+              <Numerator>-0.00200474</Numerator>
+              <Numerator>-0.00343633</Numerator>
+              <Numerator>0.00041425</Numerator>
+              <Numerator>0.00293458</Numerator>
+              <Numerator>0.00070846</Numerator>
+              <Numerator>-0.00210965</Numerator>
+              <Numerator>-0.0013206</Numerator>
+              <Numerator>0.00121105</Numerator>
+              <Numerator>0.00148249</Numerator>
+              <Numerator>-0.00042439</Numerator>
+              <Numerator>-0.00131798</Numerator>
+              <Numerator>-0.00014412</Numerator>
+              <Numerator>0.00097203</Numerator>
+              <Numerator>0.00046456</Numerator>
+              <Numerator>-0.00057662</Numerator>
+              <Numerator>-0.00056541</Numerator>
+              <Numerator>0.00022852</Numerator>
+              <Numerator>0.00050938</Numerator>
+              <Numerator>1.884e-05</Numerator>
+              <Numerator>-0.00036979</Numerator>
+              <Numerator>-0.00015306</Numerator>
+              <Numerator>0.00021076</Numerator>
+              <Numerator>0.00019097</Numerator>
+              <Numerator>-7.641e-05</Numerator>
+              <Numerator>-0.00016463</Numerator>
+              <Numerator>-1.156e-05</Numerator>
+              <Numerator>0.00010896</Numerator>
+              <Numerator>5.221e-05</Numerator>
+              <Numerator>-5.186e-05</Numerator>
+              <Numerator>-5.686e-05</Numerator>
+              <Numerator>9.78e-06</Numerator>
+              <Numerator>4.172e-05</Numerator>
+              <Numerator>1.156e-05</Numerator>
+              <Numerator>-2.73e-05</Numerator>
+              <Numerator>-3.362e-05</Numerator>
+              <Numerator>-1.681e-05</Numerator>
+              <Numerator>-2.26e-06</Numerator>
+              <Numerator>1.55e-06</Numerator>
+              <Numerator>6e-07</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">400.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.17</Delay>
+              <Correction>0.17</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>1.0</Frequency>
+            </StageGain>
+          </Stage>
+        </Response>
+      </Channel>
+    </Station>
+  </Network>
+</FDSNStationXML>
diff --git a/docs/examples/l-22d_rt72a-08.png b/docs/examples/l-22d_rt72a-08.png
new file mode 100644
index 0000000..81826cc
Binary files /dev/null and b/docs/examples/l-22d_rt72a-08.png differ
diff --git a/docs/examples/l-22d_rt72a-08.rst b/docs/examples/l-22d_rt72a-08.rst
new file mode 100644
index 0000000..ce84922
--- /dev/null
+++ b/docs/examples/l-22d_rt72a-08.rst
@@ -0,0 +1,9 @@
+.. toggle-header::
+  :header: StationXML **Show/Hide**
+
+  .. literalinclude:: examples/l-22d_rt72a-08.xml
+    :language: XML
+
+
+.. image:: examples/l-22d_rt72a-08.png
+
diff --git a/docs/examples/l-22d_rt72a-08.xml b/docs/examples/l-22d_rt72a-08.xml
new file mode 100644
index 0000000..b4da8d2
--- /dev/null
+++ b/docs/examples/l-22d_rt72a-08.xml
@@ -0,0 +1,351 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+    schemaVersion="1.2">
+  <Source>isti</Source>
+  <Created>2020-06-06T01:01:14.188519Z</Created>
+  <Network code="XX">
+    <Station code="ABCD">
+      <Latitude>0.0</Latitude>
+      <Longitude>0.0</Longitude>
+      <Elevation>10.0</Elevation>
+      <Site>
+        <Name>Nowhere</Name>
+      </Site>
+      <Channel code="BHZ" locationCode="10">
+        <Latitude>0.0</Latitude>
+        <Longitude>0.0</Longitude>
+        <Elevation>10.0</Elevation>
+        <Depth>0.0</Depth>
+        <Azimuth>0.0</Azimuth>
+        <Dip>-90.0</Dip>
+        <SampleRate>100.0</SampleRate>
+        <Sensor><Description>L-22d</Description></Sensor>
+        <DataLogger><Description>Reftek RT72A-08</Description></DataLogger>
+        <Response>
+          <InstrumentSensitivity>
+            <Value>1488803226.82</Value>
+            <Frequency>10.0</Frequency>
+            <InputUnits>
+              <Name>m/s</Name>
+              <Description>Velocity in Meters per Second</Description>
+            </InputUnits>
+            <OutputUnits>
+              <Name>count</Name>
+              <Description>Digital Counts</Description>
+            </OutputUnits>
+          </InstrumentSensitivity>
+          <Stage number="1">
+            <PolesZeros>
+              <InputUnits>
+                <Name>m/s</Name>
+                <Description>Velocity in Meters per Second</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </OutputUnits>
+              <PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType>
+              <NormalizationFactor>1.0</NormalizationFactor>
+              <NormalizationFrequency unit="HERTZ">10.0</NormalizationFrequency>
+              <Zero number="0">
+                <Real>0.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Zero number="1">
+                <Real>0.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Pole number="0">
+                <Real>-8.884</Real>
+                <Imaginary>8.887</Imaginary>
+              </Pole>
+              <Pole number="1">
+                <Real>-8.884</Real>
+                <Imaginary>-8.887</Imaginary>
+              </Pole>
+            </PolesZeros>
+            <StageGain>
+              <Value>87.9</Value>
+              <Frequency>10.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="2">
+            <StageGain>
+              <Value>32.2</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="3">
+            <Coefficients>
+              <InputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.0</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">1000.0</InputSampleRate>
+              <Factor>1</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>524384.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="4">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.00095e-05</Numerator>
+              <Numerator>1.60155e-05</Numerator>
+              <Numerator>2.10207e-05</Numerator>
+              <Numerator>1.70167e-05</Numerator>
+              <Numerator>-5.00475e-06</Numerator>
+              <Numerator>-5.60554e-05</Numerator>
+              <Numerator>-0.000139138</Numerator>
+              <Numerator>-0.000252249</Numerator>
+              <Numerator>-0.000379375</Numerator>
+              <Numerator>-0.000490485</Numerator>
+              <Numerator>-0.000544538</Numerator>
+              <Numerator>-0.00049549</Numerator>
+              <Numerator>-0.000305302</Numerator>
+              <Numerator>4.00394e-05</Numerator>
+              <Numerator>0.000519514</Numerator>
+              <Numerator>0.00106605</Numerator>
+              <Numerator>0.00156655</Numerator>
+              <Numerator>0.00187986</Numerator>
+              <Numerator>0.00185884</Numerator>
+              <Numerator>0.00139438</Numerator>
+              <Numerator>0.000452447</Numerator>
+              <Numerator>-0.000891882</Numerator>
+              <Numerator>-0.00244041</Numerator>
+              <Numerator>-0.00388684</Numerator>
+              <Numerator>-0.0048568</Numerator>
+              <Numerator>-0.00498693</Numerator>
+              <Numerator>-0.00401297</Numerator>
+              <Numerator>-0.00186484</Numerator>
+              <Numerator>0.00127226</Numerator>
+              <Numerator>0.00493088</Numerator>
+              <Numerator>0.00840631</Numerator>
+              <Numerator>0.0108557</Numerator>
+              <Numerator>0.0114653</Numerator>
+              <Numerator>0.00963653</Numerator>
+              <Numerator>0.00517011</Numerator>
+              <Numerator>-0.00159358</Numerator>
+              <Numerator>-0.00973062</Numerator>
+              <Numerator>-0.0177896</Numerator>
+              <Numerator>-0.0239687</Numerator>
+              <Numerator>-0.0263971</Numerator>
+              <Numerator>-0.0234562</Numerator>
+              <Numerator>-0.014115</Numerator>
+              <Numerator>0.00180478</Numerator>
+              <Numerator>0.0234952</Numerator>
+              <Numerator>0.0491706</Numerator>
+              <Numerator>0.0762664</Numerator>
+              <Numerator>0.101771</Numerator>
+              <Numerator>0.122659</Numerator>
+              <Numerator>0.136353</Numerator>
+              <Numerator>0.141121</Numerator>
+              <Numerator>0.136353</Numerator>
+              <Numerator>0.122659</Numerator>
+              <Numerator>0.101771</Numerator>
+              <Numerator>0.0762664</Numerator>
+              <Numerator>0.0491706</Numerator>
+              <Numerator>0.0234952</Numerator>
+              <Numerator>0.00180478</Numerator>
+              <Numerator>-0.014115</Numerator>
+              <Numerator>-0.0234562</Numerator>
+              <Numerator>-0.0263971</Numerator>
+              <Numerator>-0.0239687</Numerator>
+              <Numerator>-0.0177896</Numerator>
+              <Numerator>-0.00973062</Numerator>
+              <Numerator>-0.00159358</Numerator>
+              <Numerator>0.00517011</Numerator>
+              <Numerator>0.00963653</Numerator>
+              <Numerator>0.0114653</Numerator>
+              <Numerator>0.0108557</Numerator>
+              <Numerator>0.00840631</Numerator>
+              <Numerator>0.00493088</Numerator>
+              <Numerator>0.00127226</Numerator>
+              <Numerator>-0.00186484</Numerator>
+              <Numerator>-0.00401297</Numerator>
+              <Numerator>-0.00498693</Numerator>
+              <Numerator>-0.0048568</Numerator>
+              <Numerator>-0.00388684</Numerator>
+              <Numerator>-0.00244041</Numerator>
+              <Numerator>-0.000891882</Numerator>
+              <Numerator>0.000452447</Numerator>
+              <Numerator>0.00139438</Numerator>
+              <Numerator>0.00185884</Numerator>
+              <Numerator>0.00187986</Numerator>
+              <Numerator>0.00156655</Numerator>
+              <Numerator>0.00106605</Numerator>
+              <Numerator>0.000519514</Numerator>
+              <Numerator>4.00394e-05</Numerator>
+              <Numerator>-0.000305302</Numerator>
+              <Numerator>-0.00049549</Numerator>
+              <Numerator>-0.000544538</Numerator>
+              <Numerator>-0.000490485</Numerator>
+              <Numerator>-0.000379375</Numerator>
+              <Numerator>-0.000252249</Numerator>
+              <Numerator>-0.000139138</Numerator>
+              <Numerator>-5.60554e-05</Numerator>
+              <Numerator>-5.00475e-06</Numerator>
+              <Numerator>1.70167e-05</Numerator>
+              <Numerator>2.10207e-05</Numerator>
+              <Numerator>1.60155e-05</Numerator>
+              <Numerator>1.00095e-05</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">1000.0</InputSampleRate>
+              <Factor>5</Factor>
+              <Offset>0</Offset>
+              <Delay>0.049</Delay>
+              <Correction>0.049</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="5">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-4.7042e-05</Numerator>
+              <Numerator>-0.000186167</Numerator>
+              <Numerator>-0.000292263</Numerator>
+              <Numerator>-0.000145131</Numerator>
+              <Numerator>0.000212191</Numerator>
+              <Numerator>0.000310279</Numerator>
+              <Numerator>-0.000124111</Numerator>
+              <Numerator>-0.000523471</Numerator>
+              <Numerator>-0.000114103</Numerator>
+              <Numerator>0.000692624</Numerator>
+              <Numerator>0.000534481</Numerator>
+              <Numerator>-0.000695627</Numerator>
+              <Numerator>-0.00109999</Numerator>
+              <Numerator>0.000406366</Numerator>
+              <Numerator>0.00169853</Numerator>
+              <Numerator>0.000273246</Numerator>
+              <Numerator>-0.00213993</Numerator>
+              <Numerator>-0.00136523</Numerator>
+              <Numerator>0.00218096</Numerator>
+              <Numerator>0.0027785</Numerator>
+              <Numerator>-0.00156841</Numerator>
+              <Numerator>-0.00427885</Numerator>
+              <Numerator>0.000108097</Numerator>
+              <Numerator>0.00549495</Numerator>
+              <Numerator>0.00226304</Numerator>
+              <Numerator>-0.00595036</Numerator>
+              <Numerator>-0.00541087</Numerator>
+              <Numerator>0.00513563</Numerator>
+              <Numerator>0.00895507</Numerator>
+              <Numerator>-0.00260134</Numerator>
+              <Numerator>-0.0122651</Numerator>
+              <Numerator>-0.00193975</Numerator>
+              <Numerator>0.014478</Numerator>
+              <Numerator>0.00851968</Numerator>
+              <Numerator>-0.0145601</Numerator>
+              <Numerator>-0.0168652</Numerator>
+              <Numerator>0.0113402</Numerator>
+              <Numerator>0.0263838</Numerator>
+              <Numerator>-0.0034461</Numerator>
+              <Numerator>-0.0362236</Numerator>
+              <Numerator>-0.011103</Numerator>
+              <Numerator>0.0453779</Numerator>
+              <Numerator>0.03664</Numerator>
+              <Numerator>-0.0528236</Numerator>
+              <Numerator>-0.0888721</Numerator>
+              <Numerator>0.057688</Numerator>
+              <Numerator>0.312634</Numerator>
+              <Numerator>0.441072</Numerator>
+              <Numerator>0.312634</Numerator>
+              <Numerator>0.057688</Numerator>
+              <Numerator>-0.0888721</Numerator>
+              <Numerator>-0.0528236</Numerator>
+              <Numerator>0.03664</Numerator>
+              <Numerator>0.0453779</Numerator>
+              <Numerator>-0.011103</Numerator>
+              <Numerator>-0.0362236</Numerator>
+              <Numerator>-0.0034461</Numerator>
+              <Numerator>0.0263838</Numerator>
+              <Numerator>0.0113402</Numerator>
+              <Numerator>-0.0168652</Numerator>
+              <Numerator>-0.0145601</Numerator>
+              <Numerator>0.00851968</Numerator>
+              <Numerator>0.014478</Numerator>
+              <Numerator>-0.00193975</Numerator>
+              <Numerator>-0.0122651</Numerator>
+              <Numerator>-0.00260134</Numerator>
+              <Numerator>0.00895507</Numerator>
+              <Numerator>0.00513563</Numerator>
+              <Numerator>-0.00541087</Numerator>
+              <Numerator>-0.00595036</Numerator>
+              <Numerator>0.00226304</Numerator>
+              <Numerator>0.00549495</Numerator>
+              <Numerator>0.000108097</Numerator>
+              <Numerator>-0.00427885</Numerator>
+              <Numerator>-0.00156841</Numerator>
+              <Numerator>0.0027785</Numerator>
+              <Numerator>0.00218096</Numerator>
+              <Numerator>-0.00136523</Numerator>
+              <Numerator>-0.00213993</Numerator>
+              <Numerator>0.000273246</Numerator>
+              <Numerator>0.00169853</Numerator>
+              <Numerator>0.000406366</Numerator>
+              <Numerator>-0.00109999</Numerator>
+              <Numerator>-0.000695627</Numerator>
+              <Numerator>0.000534481</Numerator>
+              <Numerator>0.000692624</Numerator>
+              <Numerator>-0.000114103</Numerator>
+              <Numerator>-0.000523471</Numerator>
+              <Numerator>-0.000124111</Numerator>
+              <Numerator>0.000310279</Numerator>
+              <Numerator>0.000212191</Numerator>
+              <Numerator>-0.000145131</Numerator>
+              <Numerator>-0.000292263</Numerator>
+              <Numerator>-0.000186167</Numerator>
+              <Numerator>-4.7042e-05</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">200.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.235</Delay>
+              <Correction>0.235</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+        </Response>
+      </Channel>
+    </Station>
+  </Network>
+</FDSNStationXML>
diff --git a/docs/examples/obspy/Test.xml b/docs/examples/obspy/Test.xml
new file mode 100644
index 0000000..56ed44b
--- /dev/null
+++ b/docs/examples/obspy/Test.xml
@@ -0,0 +1,778 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1" schemaVersion="1.1">
+  <Source>demo</Source>
+  <Module>ObsPy 1.2.2</Module>
+  <ModuleURI>https://www.obspy.org</ModuleURI>
+  <Created>2022-02-25T15:04:30.276150Z</Created>
+  <Network code="XX">
+    <Station code="ABCD">
+      <Latitude unit="DEGREES">0.0</Latitude>
+      <Longitude unit="DEGREES">0.0</Longitude>
+      <Elevation unit="METERS">0.0</Elevation>
+      <Site>
+        <Name>Fake Site</Name>
+      </Site>
+      <CreationDate>1970-01-01T00:00:00.000000Z</CreationDate>
+      <Channel code="BHZ" locationCode="10">
+        <Latitude unit="DEGREES">0.0</Latitude>
+        <Longitude unit="DEGREES">0.0</Longitude>
+        <Elevation unit="METERS">0.0</Elevation>
+        <Depth unit="METERS">0.0</Depth>
+        <Response>
+          <InstrumentSensitivity>
+            <Value>941864732.693</Value>
+            <Frequency>1.0</Frequency>
+            <InputUnits>
+              <Name>M/S</Name>
+              <Description>Velocity in Meters per Second</Description>
+            </InputUnits>
+            <OutputUnits>
+              <Name>COUNTS</Name>
+              <Description>Digital Counts</Description>
+            </OutputUnits>
+          </InstrumentSensitivity>
+          <Stage number="1">
+            <PolesZeros>
+              <InputUnits>
+                <Name>M/S</Name>
+                <Description>Velocity in Meters per Second</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </OutputUnits>
+              <PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType>
+              <NormalizationFactor>3.4684e+17</NormalizationFactor>
+              <NormalizationFrequency unit="HERTZ">1.0</NormalizationFrequency>
+              <Zero number="0">
+                <Real minusError="0.0" plusError="0.0">0.0</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Zero>
+              <Zero number="1">
+                <Real minusError="0.0" plusError="0.0">0.0</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Zero>
+              <Zero number="2">
+                <Real minusError="-15.15" plusError="-15.15">-15.15</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Zero>
+              <Zero number="3">
+                <Real minusError="-176.6" plusError="-176.6">-176.6</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Zero>
+              <Zero number="4">
+                <Real minusError="-463.1" plusError="-463.1">-463.1</Real>
+                <Imaginary minusError="-430.5" plusError="-430.5">-430.5</Imaginary>
+              </Zero>
+              <Zero number="5">
+                <Real minusError="-463.1" plusError="-463.1">-463.1</Real>
+                <Imaginary minusError="430.5" plusError="430.5">430.5</Imaginary>
+              </Zero>
+              <Pole number="0">
+                <Real minusError="-0.037" plusError="-0.037">-0.037</Real>
+                <Imaginary minusError="-0.037" plusError="-0.037">-0.037</Imaginary>
+              </Pole>
+              <Pole number="1">
+                <Real minusError="-0.037" plusError="-0.037">-0.037</Real>
+                <Imaginary minusError="0.037" plusError="0.037">0.037</Imaginary>
+              </Pole>
+              <Pole number="2">
+                <Real minusError="-15.64" plusError="-15.64">-15.64</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Pole>
+              <Pole number="3">
+                <Real minusError="-97.34" plusError="-97.34">-97.34</Real>
+                <Imaginary minusError="-400.7" plusError="-400.7">-400.7</Imaginary>
+              </Pole>
+              <Pole number="4">
+                <Real minusError="-97.34" plusError="-97.34">-97.34</Real>
+                <Imaginary minusError="400.7" plusError="400.7">400.7</Imaginary>
+              </Pole>
+              <Pole number="5">
+                <Real minusError="-374.8" plusError="-374.8">-374.8</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Pole>
+              <Pole number="6">
+                <Real minusError="-520.3" plusError="-520.3">-520.3</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Pole>
+              <Pole number="7">
+                <Real minusError="-10530.0" plusError="-10530.0">-10530.0</Real>
+                <Imaginary minusError="-10050.0" plusError="-10050.0">-10050.0</Imaginary>
+              </Pole>
+              <Pole number="8">
+                <Real minusError="-10530.0" plusError="-10530.0">-10530.0</Real>
+                <Imaginary minusError="10050.0" plusError="10050.0">10050.0</Imaginary>
+              </Pole>
+              <Pole number="9">
+                <Real minusError="-13300.0" plusError="-13300.0">-13300.0</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Pole>
+              <Pole number="10">
+                <Real minusError="-255.097" plusError="-255.097">-255.097</Real>
+                <Imaginary minusError="0.0" plusError="0.0">0.0</Imaginary>
+              </Pole>
+            </PolesZeros>
+            <StageGain>
+              <Value>1500.0</Value>
+              <Frequency>1.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="2">
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="3">
+            <Coefficients>
+              <InputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.0</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">102400.0</InputSampleRate>
+              <Factor>1</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>629129.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="4">
+            <Coefficients>
+              <InputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.000976562</Numerator>
+              <Numerator>0.00244141</Numerator>
+              <Numerator>0.00488281</Numerator>
+              <Numerator>0.00854492</Numerator>
+              <Numerator>0.0136719</Numerator>
+              <Numerator>0.0205078</Numerator>
+              <Numerator>0.0292969</Numerator>
+              <Numerator>0.0393066</Numerator>
+              <Numerator>0.0498047</Numerator>
+              <Numerator>0.0600586</Numerator>
+              <Numerator>0.0693359</Numerator>
+              <Numerator>0.0769043</Numerator>
+              <Numerator>0.0820312</Numerator>
+              <Numerator>0.0839844</Numerator>
+              <Numerator>0.0820312</Numerator>
+              <Numerator>0.0769043</Numerator>
+              <Numerator>0.0693359</Numerator>
+              <Numerator>0.0600586</Numerator>
+              <Numerator>0.0498047</Numerator>
+              <Numerator>0.0393066</Numerator>
+              <Numerator>0.0292969</Numerator>
+              <Numerator>0.0205078</Numerator>
+              <Numerator>0.0136719</Numerator>
+              <Numerator>0.00854492</Numerator>
+              <Numerator>0.00488281</Numerator>
+              <Numerator>0.00244141</Numerator>
+              <Numerator>0.000976562</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">102400.0</InputSampleRate>
+              <Factor>8</Factor>
+              <Offset>0</Offset>
+              <Delay>0.00013672</Delay>
+              <Correction>0.00013672</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="5">
+            <Coefficients>
+              <InputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">12800.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.00046875</Delay>
+              <Correction>0.00046875</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="6">
+            <Coefficients>
+              <InputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">6400.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0009375</Delay>
+              <Correction>0.0009375</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="7">
+            <Coefficients>
+              <InputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">3200.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.001875</Delay>
+              <Correction>0.001875</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="8">
+            <Coefficients>
+              <InputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">1600.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.00375</Delay>
+              <Correction>0.00375</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="9">
+            <Coefficients>
+              <InputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">800.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0075</Delay>
+              <Correction>0.0075</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="10">
+            <Coefficients>
+              <InputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-7.15032e-07</Numerator>
+              <Numerator>-5.60109e-06</Numerator>
+              <Numerator>-2.62179e-06</Numerator>
+              <Numerator>-4.31403e-05</Numerator>
+              <Numerator>-4.64771e-06</Numerator>
+              <Numerator>1.43006e-06</Numerator>
+              <Numerator>2.34769e-05</Numerator>
+              <Numerator>1.43006e-06</Numerator>
+              <Numerator>-5.27932e-05</Numerator>
+              <Numerator>-0.000366692</Numerator>
+              <Numerator>0.000376107</Numerator>
+              <Numerator>0.000854226</Numerator>
+              <Numerator>3.05081e-05</Numerator>
+              <Numerator>-0.00127621</Numerator>
+              <Numerator>-0.000910951</Numerator>
+              <Numerator>0.00127669</Numerator>
+              <Numerator>0.00215165</Numerator>
+              <Numerator>-0.000461554</Numerator>
+              <Numerator>-0.00333765</Numerator>
+              <Numerator>-0.00140933</Numerator>
+              <Numerator>0.00377072</Numerator>
+              <Numerator>0.00419414</Numerator>
+              <Numerator>-0.00264288</Numerator>
+              <Numerator>-0.00720121</Numerator>
+              <Numerator>-0.000644006</Numerator>
+              <Numerator>0.009184</Numerator>
+              <Numerator>0.00608445</Numerator>
+              <Numerator>-0.00857824</Numerator>
+              <Numerator>-0.0127401</Numerator>
+              <Numerator>0.00398225</Numerator>
+              <Numerator>0.0186261</Numerator>
+              <Numerator>0.0052052</Numerator>
+              <Numerator>-0.0209407</Numerator>
+              <Numerator>-0.0181629</Numerator>
+              <Numerator>0.0166669</Numerator>
+              <Numerator>0.0322447</Numerator>
+              <Numerator>-0.00346588</Numerator>
+              <Numerator>-0.0429528</Numerator>
+              <Numerator>-0.0193265</Numerator>
+              <Numerator>0.044309</Numerator>
+              <Numerator>0.0497909</Numerator>
+              <Numerator>-0.0294164</Numerator>
+              <Numerator>-0.0826078</Numerator>
+              <Numerator>-0.00934166</Numerator>
+              <Numerator>0.107552</Numerator>
+              <Numerator>0.0816604</Numerator>
+              <Numerator>-0.10311</Numerator>
+              <Numerator>-0.204208</Numerator>
+              <Numerator>-3.12231e-05</Numerator>
+              <Numerator>0.390432</Numerator>
+              <Numerator>0.589958</Numerator>
+              <Numerator>0.390432</Numerator>
+              <Numerator>-3.12231e-05</Numerator>
+              <Numerator>-0.204208</Numerator>
+              <Numerator>-0.10311</Numerator>
+              <Numerator>0.0816604</Numerator>
+              <Numerator>0.107552</Numerator>
+              <Numerator>-0.00934166</Numerator>
+              <Numerator>-0.0826078</Numerator>
+              <Numerator>-0.0294164</Numerator>
+              <Numerator>0.0497909</Numerator>
+              <Numerator>0.044309</Numerator>
+              <Numerator>-0.0193265</Numerator>
+              <Numerator>-0.0429528</Numerator>
+              <Numerator>-0.00346588</Numerator>
+              <Numerator>0.0322447</Numerator>
+              <Numerator>0.0166669</Numerator>
+              <Numerator>-0.0181629</Numerator>
+              <Numerator>-0.0209407</Numerator>
+              <Numerator>0.0052052</Numerator>
+              <Numerator>0.0186261</Numerator>
+              <Numerator>0.00398225</Numerator>
+              <Numerator>-0.0127401</Numerator>
+              <Numerator>-0.00857824</Numerator>
+              <Numerator>0.00608445</Numerator>
+              <Numerator>0.009184</Numerator>
+              <Numerator>-0.000644006</Numerator>
+              <Numerator>-0.00720121</Numerator>
+              <Numerator>-0.00264288</Numerator>
+              <Numerator>0.00419414</Numerator>
+              <Numerator>0.00377072</Numerator>
+              <Numerator>-0.00140933</Numerator>
+              <Numerator>-0.00333765</Numerator>
+              <Numerator>-0.000461554</Numerator>
+              <Numerator>0.00215165</Numerator>
+              <Numerator>0.00127669</Numerator>
+              <Numerator>-0.000910951</Numerator>
+              <Numerator>-0.00127621</Numerator>
+              <Numerator>3.05081e-05</Numerator>
+              <Numerator>0.000854226</Numerator>
+              <Numerator>0.000376107</Numerator>
+              <Numerator>-0.000366692</Numerator>
+              <Numerator>-0.00041031</Numerator>
+              <Numerator>2.52645e-05</Numerator>
+              <Numerator>0.000261821</Numerator>
+              <Numerator>0.000120602</Numerator>
+              <Numerator>-9.99854e-05</Numerator>
+              <Numerator>-0.000162312</Numerator>
+              <Numerator>-9.79595e-05</Numerator>
+              <Numerator>-2.94355e-05</Numerator>
+              <Numerator>-3.09847e-06</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">400.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.125</Delay>
+              <Correction>0.125</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="11">
+            <Coefficients>
+              <InputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>COUNTS</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-1.09889e-05</Numerator>
+              <Numerator>-1.99798e-05</Numerator>
+              <Numerator>-3.29668e-05</Numerator>
+              <Numerator>-4.39561e-05</Numerator>
+              <Numerator>-4.79522e-05</Numerator>
+              <Numerator>-4.09589e-05</Numerator>
+              <Numerator>-1.8981e-05</Numerator>
+              <Numerator>1.8981e-05</Numerator>
+              <Numerator>6.7932e-05</Numerator>
+              <Numerator>0.000118881</Numerator>
+              <Numerator>0.000158842</Numerator>
+              <Numerator>0.000174826</Numerator>
+              <Numerator>0.000157843</Numerator>
+              <Numerator>0.000104895</Numerator>
+              <Numerator>2.49751e-05</Numerator>
+              <Numerator>-6.49352e-05</Numerator>
+              <Numerator>-0.00014086</Numerator>
+              <Numerator>-0.000178822</Numerator>
+              <Numerator>-0.00016084</Numerator>
+              <Numerator>-8.59142e-05</Numerator>
+              <Numerator>3.29668e-05</Numerator>
+              <Numerator>0.000163837</Numerator>
+              <Numerator>0.000268733</Numerator>
+              <Numerator>0.000310691</Numerator>
+              <Numerator>0.000263737</Numerator>
+              <Numerator>0.00013087</Numerator>
+              <Numerator>-6.09391e-05</Numerator>
+              <Numerator>-0.00026074</Numerator>
+              <Numerator>-0.000408593</Numerator>
+              <Numerator>-0.000448554</Numerator>
+              <Numerator>-0.000353648</Numerator>
+              <Numerator>-0.000135864</Numerator>
+              <Numerator>0.000155845</Numerator>
+              <Numerator>0.000438563</Numerator>
+              <Numerator>0.000623379</Numerator>
+              <Numerator>0.000638365</Numerator>
+              <Numerator>0.000456546</Numerator>
+              <Numerator>0.000108891</Numerator>
+              <Numerator>-0.000315686</Numerator>
+              <Numerator>-0.000694309</Numerator>
+              <Numerator>-0.000903101</Numerator>
+              <Numerator>-0.00085415</Numerator>
+              <Numerator>-0.000533469</Numerator>
+              <Numerator>-7.99164e-06</Numerator>
+              <Numerator>0.000581421</Numerator>
+              <Numerator>0.00105695</Numerator>
+              <Numerator>0.00125675</Numerator>
+              <Numerator>0.00108792</Numerator>
+              <Numerator>0.000559443</Numerator>
+              <Numerator>-0.000201799</Numerator>
+              <Numerator>-0.000983021</Numerator>
+              <Numerator>-0.00154047</Numerator>
+              <Numerator>-0.00167733</Numerator>
+              <Numerator>-0.0013037</Numerator>
+              <Numerator>-0.000484518</Numerator>
+              <Numerator>0.000571431</Numerator>
+              <Numerator>0.00155645</Numerator>
+              <Numerator>0.00215685</Numerator>
+              <Numerator>0.00214287</Numerator>
+              <Numerator>0.00145855</Numerator>
+              <Numerator>0.00025075</Numerator>
+              <Numerator>-0.00115385</Numerator>
+              <Numerator>-0.00233568</Numerator>
+              <Numerator>-0.00290311</Numerator>
+              <Numerator>-0.0026174</Numerator>
+              <Numerator>-0.00148752</Numerator>
+              <Numerator>0.000215785</Numerator>
+              <Numerator>0.002014</Numerator>
+              <Numerator>0.00335166</Numerator>
+              <Numerator>0.00376825</Numerator>
+              <Numerator>0.00304597</Numerator>
+              <Numerator>0.0013037</Numerator>
+              <Numerator>-0.001009</Numerator>
+              <Numerator>-0.0032208</Numerator>
+              <Numerator>-0.00463139</Numerator>
+              <Numerator>-0.0047233</Numerator>
+              <Numerator>-0.00334667</Numerator>
+              <Numerator>-0.000793211</Numerator>
+              <Numerator>0.00224477</Numerator>
+              <Numerator>0.00486516</Numerator>
+              <Numerator>0.00620583</Numerator>
+              <Numerator>0.0057273</Numerator>
+              <Numerator>0.00340861</Numerator>
+              <Numerator>-0.000199801</Numerator>
+              <Numerator>-0.00409193</Numerator>
+              <Numerator>-0.00707596</Numerator>
+              <Numerator>-0.00812791</Numerator>
+              <Numerator>-0.00672831</Numerator>
+              <Numerator>-0.00307194</Numerator>
+              <Numerator>0.00192309</Numerator>
+              <Numerator>0.00682721</Numerator>
+              <Numerator>0.010091</Numerator>
+              <Numerator>0.0105175</Numerator>
+              <Numerator>0.00766437</Numerator>
+              <Numerator>0.00206594</Numerator>
+              <Numerator>-0.00483219</Numerator>
+              <Numerator>-0.01101</Numerator>
+              <Numerator>-0.0144376</Numerator>
+              <Numerator>-0.0136934</Numerator>
+              <Numerator>-0.00847457</Numerator>
+              <Numerator>0.000173827</Numerator>
+              <Numerator>0.010004</Numerator>
+              <Numerator>0.018085</Numerator>
+              <Numerator>0.0215935</Numerator>
+              <Numerator>0.0186664</Numerator>
+              <Numerator>0.00910094</Numerator>
+              <Numerator>-0.0053287</Numerator>
+              <Numerator>-0.0210541</Numerator>
+              <Numerator>-0.0333958</Numerator>
+              <Numerator>-0.0376226</Numerator>
+              <Numerator>-0.030137</Numerator>
+              <Numerator>-0.00949755</Numerator>
+              <Numerator>0.0229931</Numerator>
+              <Numerator>0.063304</Numerator>
+              <Numerator>0.10534</Numerator>
+              <Numerator>0.142124</Numerator>
+              <Numerator>0.167226</Numerator>
+              <Numerator>0.176134</Numerator>
+              <Numerator>0.167226</Numerator>
+              <Numerator>0.142124</Numerator>
+              <Numerator>0.10534</Numerator>
+              <Numerator>0.063304</Numerator>
+              <Numerator>0.0229931</Numerator>
+              <Numerator>-0.00949755</Numerator>
+              <Numerator>-0.030137</Numerator>
+              <Numerator>-0.0376226</Numerator>
+              <Numerator>-0.0333958</Numerator>
+              <Numerator>-0.0210541</Numerator>
+              <Numerator>-0.0053287</Numerator>
+              <Numerator>0.00910094</Numerator>
+              <Numerator>0.0186664</Numerator>
+              <Numerator>0.0215935</Numerator>
+              <Numerator>0.018085</Numerator>
+              <Numerator>0.010004</Numerator>
+              <Numerator>0.000173827</Numerator>
+              <Numerator>-0.00847457</Numerator>
+              <Numerator>-0.0136934</Numerator>
+              <Numerator>-0.0144376</Numerator>
+              <Numerator>-0.01101</Numerator>
+              <Numerator>-0.00483219</Numerator>
+              <Numerator>0.00206594</Numerator>
+              <Numerator>0.00766437</Numerator>
+              <Numerator>0.0105175</Numerator>
+              <Numerator>0.010091</Numerator>
+              <Numerator>0.00682721</Numerator>
+              <Numerator>0.00192309</Numerator>
+              <Numerator>-0.00307194</Numerator>
+              <Numerator>-0.00672831</Numerator>
+              <Numerator>-0.00812791</Numerator>
+              <Numerator>-0.00707596</Numerator>
+              <Numerator>-0.00409193</Numerator>
+              <Numerator>-0.000199801</Numerator>
+              <Numerator>0.00340861</Numerator>
+              <Numerator>0.0057273</Numerator>
+              <Numerator>0.00620583</Numerator>
+              <Numerator>0.00486516</Numerator>
+              <Numerator>0.00224477</Numerator>
+              <Numerator>-0.000793211</Numerator>
+              <Numerator>-0.00334667</Numerator>
+              <Numerator>-0.0047233</Numerator>
+              <Numerator>-0.00463139</Numerator>
+              <Numerator>-0.0032208</Numerator>
+              <Numerator>-0.001009</Numerator>
+              <Numerator>0.0013037</Numerator>
+              <Numerator>0.00304597</Numerator>
+              <Numerator>0.00376825</Numerator>
+              <Numerator>0.00335166</Numerator>
+              <Numerator>0.002014</Numerator>
+              <Numerator>0.000215785</Numerator>
+              <Numerator>-0.00148752</Numerator>
+              <Numerator>-0.0026174</Numerator>
+              <Numerator>-0.00290311</Numerator>
+              <Numerator>-0.00233568</Numerator>
+              <Numerator>-0.00115385</Numerator>
+              <Numerator>0.00025075</Numerator>
+              <Numerator>0.00145855</Numerator>
+              <Numerator>0.00214287</Numerator>
+              <Numerator>0.00215685</Numerator>
+              <Numerator>0.00155645</Numerator>
+              <Numerator>0.000571431</Numerator>
+              <Numerator>-0.000484518</Numerator>
+              <Numerator>-0.0013037</Numerator>
+              <Numerator>-0.00167733</Numerator>
+              <Numerator>-0.00154047</Numerator>
+              <Numerator>-0.000983021</Numerator>
+              <Numerator>-0.000201799</Numerator>
+              <Numerator>0.000559443</Numerator>
+              <Numerator>0.00108792</Numerator>
+              <Numerator>0.00125675</Numerator>
+              <Numerator>0.00105695</Numerator>
+              <Numerator>0.000581421</Numerator>
+              <Numerator>-7.99164e-06</Numerator>
+              <Numerator>-0.000533469</Numerator>
+              <Numerator>-0.00085415</Numerator>
+              <Numerator>-0.000903101</Numerator>
+              <Numerator>-0.000694309</Numerator>
+              <Numerator>-0.000315686</Numerator>
+              <Numerator>0.000108891</Numerator>
+              <Numerator>0.000456546</Numerator>
+              <Numerator>0.000638365</Numerator>
+              <Numerator>0.000623379</Numerator>
+              <Numerator>0.000438563</Numerator>
+              <Numerator>0.000155845</Numerator>
+              <Numerator>-0.000135864</Numerator>
+              <Numerator>-0.000353648</Numerator>
+              <Numerator>-0.000448554</Numerator>
+              <Numerator>-0.000408593</Numerator>
+              <Numerator>-0.00026074</Numerator>
+              <Numerator>-6.09391e-05</Numerator>
+              <Numerator>0.00013087</Numerator>
+              <Numerator>0.000263737</Numerator>
+              <Numerator>0.000310691</Numerator>
+              <Numerator>0.000268733</Numerator>
+              <Numerator>0.000163837</Numerator>
+              <Numerator>3.29668e-05</Numerator>
+              <Numerator>-8.59142e-05</Numerator>
+              <Numerator>-0.00016084</Numerator>
+              <Numerator>-0.000178822</Numerator>
+              <Numerator>-0.00014086</Numerator>
+              <Numerator>-6.49352e-05</Numerator>
+              <Numerator>2.49751e-05</Numerator>
+              <Numerator>0.000104895</Numerator>
+              <Numerator>0.000157843</Numerator>
+              <Numerator>0.000174826</Numerator>
+              <Numerator>0.000158842</Numerator>
+              <Numerator>0.000118881</Numerator>
+              <Numerator>6.7932e-05</Numerator>
+              <Numerator>1.8981e-05</Numerator>
+              <Numerator>-1.8981e-05</Numerator>
+              <Numerator>-4.09589e-05</Numerator>
+              <Numerator>-4.79522e-05</Numerator>
+              <Numerator>-4.39561e-05</Numerator>
+              <Numerator>-3.29668e-05</Numerator>
+              <Numerator>-1.99798e-05</Numerator>
+              <Numerator>-1.09889e-05</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">200.0</InputSampleRate>
+              <Factor>5</Factor>
+              <Offset>0</Offset>
+              <Delay>0.585</Delay>
+              <Correction>0.585</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+        </Response>
+      </Channel>
+    </Station>
+  </Network>
+</FDSNStationXML>
diff --git a/docs/examples/obspy/create_staxml.py b/docs/examples/obspy/create_staxml.py
new file mode 100644
index 0000000..2484b04
--- /dev/null
+++ b/docs/examples/obspy/create_staxml.py
@@ -0,0 +1,38 @@
+from obspy.clients.nrl import NRL
+from obspy.core.inventory import Inventory, Network, Station, Channel, Site
+from obspy.core import UTCDateTime
+
+def do_xml():
+    nrl = NRL('http://ds.iris.edu/NRL/')
+    datalogger_keys = ['REF TEK', 'RT 130 & 130-SMA', '1', '40']
+    sensor_keys = ['Streckeisen', 'STS-2', '1500', '3 - installed 04/97 to present']
+
+    response = nrl.get_response(sensor_keys=sensor_keys, datalogger_keys=datalogger_keys)
+
+    channel = Channel(code='BHZ',
+                      location_code='10',      # required
+                      latitude=0,      # required
+                      longitude=0,   # required
+                      elevation=0.0,        # required
+                      depth=0.,                # required
+                      )
+
+    channel.response = response
+    station = Station(code='ABCD',
+                      latitude=0,
+                      longitude=0,
+                      elevation=0.0,
+                      creation_date=UTCDateTime(1970, 1, 1),          # required
+                      site=Site(name='Fake Site'),  # required
+                      channels=[channel],
+                      )
+
+    network = Network(code='XX',
+                     stations=[station])
+    inventory = Inventory(networks=[network], source="demo")
+
+    inventory.write("Test.xml", format="stationxml", validate=True)
+
+
+if __name__ == '__main__':
+    do_xml()
diff --git a/docs/examples/obspy/plot_output.txt b/docs/examples/obspy/plot_output.txt
new file mode 100644
index 0000000..a10fe7c
--- /dev/null
+++ b/docs/examples/obspy/plot_output.txt
@@ -0,0 +1,109 @@
+Response type: PolesZerosResponseStage, Stage Sequence Number: 1
+	From M/S (Velocity in Meters per Second) to V (Volts)
+	Stage gain: 1500.0, defined at 1.00 Hz
+	Transfer function type: LAPLACE (RADIANS/SECOND)
+	Normalization factor: 3.4684e+17, Normalization frequency: 1.00 Hz
+	Poles: (-0.037-0.037j), (-0.037+0.037j), (-15.64+0j), (-97.34-400.7j), (-97.34+400.7j), (-374.8+0j), (-520.3+0j), (-10530-10050j), (-10530+10050j), (-13300+0j), (-255.097+0j)
+	Zeros: 0j, 0j, (-15.15+0j), (-176.6+0j), (-463.1-430.5j), (-463.1+430.5j)
+Response type: ResponseStage, Stage Sequence Number: 2
+	From V to V
+	Stage gain: 1.0, defined at 0.05 Hz
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 3
+	From V (Volts) to COUNTS (Digital Counts)
+	Stage gain: 629129.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 102400.00 Hz
+		Decimation Factor: 1
+		Decimation Offset: 0
+		Decimation Delay: 0.00
+		Decimation Correction: 0.00
+	Transfer function type: DIGITAL
+	Contains 1 numerators and 0 denominators
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 4
+	From COUNTS (Digital Counts) to COUNTS (Digital Counts)
+	Stage gain: 1.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 102400.00 Hz
+		Decimation Factor: 8
+		Decimation Offset: 0
+		Decimation Delay: 0.00
+		Decimation Correction: 0.00
+	Transfer function type: DIGITAL
+	Contains 29 numerators and 0 denominators
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 5
+	From COUNTS (Digital Counts) to COUNTS (Digital Counts)
+	Stage gain: 1.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 12800.00 Hz
+		Decimation Factor: 2
+		Decimation Offset: 0
+		Decimation Delay: 0.00
+		Decimation Correction: 0.00
+	Transfer function type: DIGITAL
+	Contains 13 numerators and 0 denominators
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 6
+	From COUNTS (Digital Counts) to COUNTS (Digital Counts)
+	Stage gain: 1.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 6400.00 Hz
+		Decimation Factor: 2
+		Decimation Offset: 0
+		Decimation Delay: 0.00
+		Decimation Correction: 0.00
+	Transfer function type: DIGITAL
+	Contains 13 numerators and 0 denominators
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 7
+	From COUNTS (Digital Counts) to COUNTS (Digital Counts)
+	Stage gain: 1.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 3200.00 Hz
+		Decimation Factor: 2
+		Decimation Offset: 0
+		Decimation Delay: 0.00
+		Decimation Correction: 0.00
+	Transfer function type: DIGITAL
+	Contains 13 numerators and 0 denominators
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 8
+	From COUNTS (Digital Counts) to COUNTS (Digital Counts)
+	Stage gain: 1.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 1600.00 Hz
+		Decimation Factor: 2
+		Decimation Offset: 0
+		Decimation Delay: 0.00
+		Decimation Correction: 0.00
+	Transfer function type: DIGITAL
+	Contains 13 numerators and 0 denominators
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 9
+	From COUNTS (Digital Counts) to COUNTS (Digital Counts)
+	Stage gain: 1.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 800.00 Hz
+		Decimation Factor: 2
+		Decimation Offset: 0
+		Decimation Delay: 0.01
+		Decimation Correction: 0.01
+	Transfer function type: DIGITAL
+	Contains 13 numerators and 0 denominators
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 10
+	From COUNTS (Digital Counts) to COUNTS (Digital Counts)
+	Stage gain: 1.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 400.00 Hz
+		Decimation Factor: 2
+		Decimation Offset: 0
+		Decimation Delay: 0.12
+		Decimation Correction: 0.12
+	Transfer function type: DIGITAL
+	Contains 101 numerators and 0 denominators
+Response type: CoefficientsTypeResponseStage, Stage Sequence Number: 11
+	From COUNTS (Digital Counts) to COUNTS (Digital Counts)
+	Stage gain: 1.0, defined at 0.05 Hz
+	Decimation:
+		Input Sample Rate: 200.00 Hz
+		Decimation Factor: 5
+		Decimation Offset: 0
+		Decimation Delay: 0.58
+		Decimation Correction: 0.58
+	Transfer function type: DIGITAL
+	Contains 235 numerators and 0 denominators
diff --git a/docs/examples/obspy/plot_response.py b/docs/examples/obspy/plot_response.py
new file mode 100644
index 0000000..4f7187f
--- /dev/null
+++ b/docs/examples/obspy/plot_response.py
@@ -0,0 +1,21 @@
+from obspy.clients.nrl import NRL
+from obspy.core.inventory import Inventory, Network, Station, Channel, Site
+from obspy.core import UTCDateTime
+
+#from lib.valid import stationxml_validator
+
+def do_plot():
+
+   nrl = NRL('http://ds.iris.edu/NRL/')
+   datalogger_keys = ['REF TEK', 'RT 130 & 130-SMA', '1', '40']
+   sensor_keys = ['Streckeisen', 'STS-2', '1500', '3 - installed 04/97 to present']
+
+   response = nrl.get_response(sensor_keys=sensor_keys, datalogger_keys=datalogger_keys)
+
+   response.plot(min_freq=.001, outfile="sts2-rt130.png")
+
+   for stage in response.response_stages:
+      print(stage)
+
+if __name__ == '__main__':
+    do_plot()
diff --git a/docs/examples/obspy/sts2-rt130.png b/docs/examples/obspy/sts2-rt130.png
new file mode 100644
index 0000000..3014cff
Binary files /dev/null and b/docs/examples/obspy/sts2-rt130.png differ
diff --git a/docs/examples/overview_example.xml b/docs/examples/overview_example.xml
new file mode 100644
index 0000000..a29c2c8
--- /dev/null
+++ b/docs/examples/overview_example.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+    schemaVersion="1.2">
+  <Source></Source>
+  <Sender>FAKE-DC</Sender>
+  <Module>Some WEB SERVICE</Module>
+  <Created>2022-02-21T20:27:54.6270Z</Created>
+  <Network code="IU" startDate="1988-01-01T00:00:00Z">
+   <Description>Global Seismograph Network - IRIS/USGS (GSN)</Description>
+   <Identifier type="DOI">10.7914/SN/IU
+   </Identifier>
+   <Station code="ANMO" startDate="2002-11-19T21:07:00Z">
+    <Description>(GSN) IRIS/USGS (IU) and ANSS</Description>
+    <Latitude>34.94591</Latitude>
+    <Longitude>-106.4572</Longitude>
+    <Elevation>1820.0</Elevation>
+    <Site>
+     <Name>Albuquerque, New Mexico, USA</Name>
+    </Site>
+    <Channel code="BHZ" locationCode="00" startDate="2018-07-09T20:45:00Z" >
+     <Latitude>34.94591</Latitude>
+     <Longitude>-106.4572</Longitude>
+     <Elevation>1632.7</Elevation>
+     <Depth>188</Depth>
+     <Azimuth>0</Azimuth>
+     <Dip>-90</Dip>
+     <SampleRate>40</SampleRate>
+     <Sensor>
+      <Description>Streckeisen STS-6A VBB Seismometer</Description>
+     </Sensor>
+     <Response>
+     <InstrumentSensitivity>
+       <Value>1.98475E9</Value>
+       <Frequency>0.02</Frequency>
+       <InputUnits>
+         <Name>m/s</Name>
+       </InputUnits>
+       <OutputUnits>
+         <Name>count</Name>
+       </OutputUnits>
+     </InstrumentSensitivity>
+     </Response>
+    </Channel>
+   </Station>
+  </Network>
+ </FDSNStationXML>
diff --git a/docs/examples/sts-1_Qx80.png b/docs/examples/sts-1_Qx80.png
new file mode 100644
index 0000000..bf8a2ad
Binary files /dev/null and b/docs/examples/sts-1_Qx80.png differ
diff --git a/docs/examples/sts-1_Qx80.rst b/docs/examples/sts-1_Qx80.rst
new file mode 100644
index 0000000..3f52d9f
--- /dev/null
+++ b/docs/examples/sts-1_Qx80.rst
@@ -0,0 +1,9 @@
+.. toggle-header::
+  :header: StationXML **Show/Hide**
+
+  .. literalinclude:: examples/sts-1_Qx80.xml
+    :language: XML
+
+
+.. image:: examples/sts-1_Qx80.png
+
diff --git a/docs/examples/sts-1_Qx80.xml b/docs/examples/sts-1_Qx80.xml
new file mode 100644
index 0000000..45b9176
--- /dev/null
+++ b/docs/examples/sts-1_Qx80.xml
@@ -0,0 +1,301 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+    schemaVersion="1.2">
+  <Source>isti</Source>
+  <Created>2020-06-06T01:19:15.736834Z</Created>
+  <Network code="XX">
+    <Station code="ABCD">
+      <Latitude>0.0</Latitude>
+      <Longitude>0.0</Longitude>
+      <Elevation>10.0</Elevation>
+      <Site>
+        <Name>Nowhere</Name>
+      </Site>
+      <Channel code="BHZ" locationCode="10">
+        <Latitude>0.0</Latitude>
+        <Longitude>0.0</Longitude>
+        <Elevation>10.0</Elevation>
+        <Depth>0.0</Depth>
+        <Azimuth>0.0</Azimuth>
+        <Dip>-90.0</Dip>
+        <SampleRate>80.0</SampleRate>
+        <Sensor><Description>Streckeisen STS-1</Description></Sensor>
+        <DataLogger><Description>Quanterra Qx80</Description></DataLogger>
+        <Response>
+          <InstrumentSensitivity>
+            <Value>966938797.852</Value>
+            <Frequency>0.02</Frequency>
+            <InputUnits>
+              <Name>m/s</Name>
+              <Description>Velocity in Meters per Second</Description>
+            </InputUnits>
+            <OutputUnits>
+              <Name>count</Name>
+              <Description>Digital Counts</Description>
+            </OutputUnits>
+          </InstrumentSensitivity>
+          <Stage number="1">
+            <PolesZeros>
+              <InputUnits>
+                <Name>m/s</Name>
+                <Description>Velocity in Meters per Second</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </OutputUnits>
+              <PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType>
+              <NormalizationFactor>3948.58</NormalizationFactor>
+              <NormalizationFrequency unit="HERTZ">0.02</NormalizationFrequency>
+              <Zero number="0">
+                <Real>0.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Zero number="1">
+                <Real>0.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Pole number="0">
+                <Real>-0.01234</Real>
+                <Imaginary>0.01234</Imaginary>
+              </Pole>
+              <Pole number="1">
+                <Real>-0.01234</Real>
+                <Imaginary>-0.01234</Imaginary>
+              </Pole>
+              <Pole number="2">
+                <Real>-39.18</Real>
+                <Imaginary>49.12</Imaginary>
+              </Pole>
+              <Pole number="3">
+                <Real>-39.18</Real>
+                <Imaginary>-49.12</Imaginary>
+              </Pole>
+            </PolesZeros>
+            <StageGain>
+              <Value>2400.0</Value>
+              <Frequency>0.02</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="2">
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="3">
+            <Coefficients>
+              <InputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.0</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">5120.0</InputSampleRate>
+              <Factor>1</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>400000.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="4">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-0.00111328</Numerator>
+              <Numerator>-0.001008</Numerator>
+              <Numerator>-0.00135286</Numerator>
+              <Numerator>-0.00173045</Numerator>
+              <Numerator>-0.00208418</Numerator>
+              <Numerator>-0.00238538</Numerator>
+              <Numerator>-0.00260956</Numerator>
+              <Numerator>-0.00273352</Numerator>
+              <Numerator>-0.00273316</Numerator>
+              <Numerator>-0.00258472</Numerator>
+              <Numerator>-0.00226412</Numerator>
+              <Numerator>-0.00174847</Numerator>
+              <Numerator>-0.00101403</Numerator>
+              <Numerator>-3.51682e-05</Numerator>
+              <Numerator>0.00123782</Numerator>
+              <Numerator>0.00315983</Numerator>
+              <Numerator>0.00699945</Numerator>
+              <Numerator>0.0090996</Numerator>
+              <Numerator>0.0125424</Numerator>
+              <Numerator>0.0163123</Numerator>
+              <Numerator>0.0202632</Numerator>
+              <Numerator>0.0243173</Numerator>
+              <Numerator>0.0284051</Numerator>
+              <Numerator>0.0324604</Numerator>
+              <Numerator>0.0364143</Numerator>
+              <Numerator>0.0401987</Numerator>
+              <Numerator>0.043745</Numerator>
+              <Numerator>0.0469873</Numerator>
+              <Numerator>0.0498573</Numerator>
+              <Numerator>0.0522796</Numerator>
+              <Numerator>0.054114</Numerator>
+              <Numerator>0.0543903</Numerator>
+              <Numerator>0.0543903</Numerator>
+              <Numerator>0.054114</Numerator>
+              <Numerator>0.0522796</Numerator>
+              <Numerator>0.0498573</Numerator>
+              <Numerator>0.0469873</Numerator>
+              <Numerator>0.043745</Numerator>
+              <Numerator>0.0401987</Numerator>
+              <Numerator>0.0364143</Numerator>
+              <Numerator>0.0324604</Numerator>
+              <Numerator>0.0284051</Numerator>
+              <Numerator>0.0243173</Numerator>
+              <Numerator>0.0202632</Numerator>
+              <Numerator>0.0163123</Numerator>
+              <Numerator>0.0125424</Numerator>
+              <Numerator>0.0090996</Numerator>
+              <Numerator>0.00699945</Numerator>
+              <Numerator>0.00315983</Numerator>
+              <Numerator>0.00123782</Numerator>
+              <Numerator>-3.51682e-05</Numerator>
+              <Numerator>-0.00101403</Numerator>
+              <Numerator>-0.00174847</Numerator>
+              <Numerator>-0.00226412</Numerator>
+              <Numerator>-0.00258472</Numerator>
+              <Numerator>-0.00273316</Numerator>
+              <Numerator>-0.00273352</Numerator>
+              <Numerator>-0.00260956</Numerator>
+              <Numerator>-0.00238538</Numerator>
+              <Numerator>-0.00208418</Numerator>
+              <Numerator>-0.00173045</Numerator>
+              <Numerator>-0.00135286</Numerator>
+              <Numerator>-0.001008</Numerator>
+              <Numerator>-0.00111328</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">5120.0</InputSampleRate>
+              <Factor>16</Factor>
+              <Offset>0</Offset>
+              <Delay>0.006152344</Delay>
+              <Correction>0.006</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.014774</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="5">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000150487</Numerator>
+              <Numerator>0.000305924</Numerator>
+              <Numerator>0.000442949</Numerator>
+              <Numerator>0.000387117</Numerator>
+              <Numerator>-4.73787e-05</Numerator>
+              <Numerator>-0.000970772</Numerator>
+              <Numerator>-0.00230317</Numerator>
+              <Numerator>-0.00370638</Numerator>
+              <Numerator>-0.00462505</Numerator>
+              <Numerator>-0.0044648</Numerator>
+              <Numerator>-0.00286984</Numerator>
+              <Numerator>7.00861e-06</Numerator>
+              <Numerator>0.0033852</Numerator>
+              <Numerator>0.00600353</Numerator>
+              <Numerator>0.00655094</Numerator>
+              <Numerator>0.00425995</Numerator>
+              <Numerator>-0.000576024</Numerator>
+              <Numerator>-0.00643416</Numerator>
+              <Numerator>-0.0109214</Numerator>
+              <Numerator>-0.0116364</Numerator>
+              <Numerator>-0.00726515</Numerator>
+              <Numerator>0.00153727</Numerator>
+              <Numerator>0.0119331</Numerator>
+              <Numerator>0.0196157</Numerator>
+              <Numerator>0.0203516</Numerator>
+              <Numerator>0.011868</Numerator>
+              <Numerator>-0.00464369</Numerator>
+              <Numerator>-0.0241125</Numerator>
+              <Numerator>-0.0386383</Numerator>
+              <Numerator>-0.0398499</Numerator>
+              <Numerator>-0.0218684</Numerator>
+              <Numerator>0.0161612</Numerator>
+              <Numerator>0.0689624</Numerator>
+              <Numerator>0.126003</Numerator>
+              <Numerator>0.174229</Numerator>
+              <Numerator>0.201834</Numerator>
+              <Numerator>0.201834</Numerator>
+              <Numerator>0.174229</Numerator>
+              <Numerator>0.126003</Numerator>
+              <Numerator>0.0689624</Numerator>
+              <Numerator>0.0161612</Numerator>
+              <Numerator>-0.0218684</Numerator>
+              <Numerator>-0.0398499</Numerator>
+              <Numerator>-0.0386383</Numerator>
+              <Numerator>-0.0241125</Numerator>
+              <Numerator>-0.00464369</Numerator>
+              <Numerator>0.011868</Numerator>
+              <Numerator>0.0203516</Numerator>
+              <Numerator>0.0196157</Numerator>
+              <Numerator>0.0119331</Numerator>
+              <Numerator>0.00153727</Numerator>
+              <Numerator>-0.00726515</Numerator>
+              <Numerator>-0.0116364</Numerator>
+              <Numerator>-0.0109214</Numerator>
+              <Numerator>-0.00643416</Numerator>
+              <Numerator>-0.000576024</Numerator>
+              <Numerator>0.00425995</Numerator>
+              <Numerator>0.00655094</Numerator>
+              <Numerator>0.00600353</Numerator>
+              <Numerator>0.0033852</Numerator>
+              <Numerator>7.00861e-06</Numerator>
+              <Numerator>-0.00286984</Numerator>
+              <Numerator>-0.0044648</Numerator>
+              <Numerator>-0.00462505</Numerator>
+              <Numerator>-0.00370638</Numerator>
+              <Numerator>-0.00230317</Numerator>
+              <Numerator>-0.000970772</Numerator>
+              <Numerator>-4.73787e-05</Numerator>
+              <Numerator>0.000387117</Numerator>
+              <Numerator>0.000442949</Numerator>
+              <Numerator>0.000305924</Numerator>
+              <Numerator>0.000150487</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">320.0</InputSampleRate>
+              <Factor>4</Factor>
+              <Offset>0</Offset>
+              <Delay>0.1109375</Delay>
+              <Correction>0.083</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>0.9781118</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+        </Response>
+      </Channel>
+    </Station>
+  </Network>
+</FDSNStationXML>
diff --git a/docs/examples/sts-2_rt130.png b/docs/examples/sts-2_rt130.png
new file mode 100644
index 0000000..a366b2c
Binary files /dev/null and b/docs/examples/sts-2_rt130.png differ
diff --git a/docs/examples/sts-2_rt130.rst b/docs/examples/sts-2_rt130.rst
new file mode 100644
index 0000000..a7c4629
--- /dev/null
+++ b/docs/examples/sts-2_rt130.rst
@@ -0,0 +1,9 @@
+.. toggle-header::
+  :header: StationXML **Show/Hide**
+
+  .. literalinclude:: examples/sts-2_rt130.xml
+    :language: XML
+
+
+.. image:: examples/sts-2_rt130.png
+
diff --git a/docs/examples/sts-2_rt130.xml b/docs/examples/sts-2_rt130.xml
new file mode 100644
index 0000000..d2f2b05
--- /dev/null
+++ b/docs/examples/sts-2_rt130.xml
@@ -0,0 +1,783 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+    schemaVersion="1.2">
+  <Source>isti</Source>
+  <Created>2020-06-05T21:58:37.500208Z</Created>
+  <Network code="XX">
+    <Station code="ABCD">
+      <Latitude>0.0</Latitude>
+      <Longitude>0.0</Longitude>
+      <Elevation>10.0</Elevation>
+      <Site>
+        <Name>Nowhere</Name>
+      </Site>
+      <Channel code="BHZ" locationCode="10">
+        <Latitude>0.0</Latitude>
+        <Longitude>0.0</Longitude>
+        <Elevation>10.0</Elevation>
+        <Depth>0.0</Depth>
+        <Azimuth>0.0</Azimuth>
+        <Dip>-90.0</Dip>
+        <SampleRate>40.0</SampleRate>
+        <Sensor><Description>STS-2</Description></Sensor>
+        <DataLogger><Description>Reftek RT130</Description></DataLogger>
+        <Response>
+          <InstrumentSensitivity>
+            <Value>941864732.693</Value>
+            <Frequency>1.0</Frequency>
+            <InputUnits>
+              <Name>m/s</Name>
+              <Description>Velocity in Meters per Second</Description>
+            </InputUnits>
+            <OutputUnits>
+              <Name>count</Name>
+              <Description>Digital Counts</Description>
+            </OutputUnits>
+          </InstrumentSensitivity>
+          <Stage number="1">
+            <PolesZeros>
+              <InputUnits>
+                <Name>m/s</Name>
+                <Description>Velocity in Meters per Second</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </OutputUnits>
+              <PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType>
+              <NormalizationFactor>3.4684e+17</NormalizationFactor>
+              <NormalizationFrequency unit="HERTZ">1.0</NormalizationFrequency>
+              <Zero number="0">
+                <Real>0.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Zero number="1">
+                <Real>0.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Zero number="2">
+                <Real>-15.15</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Zero number="3">
+                <Real>-176.6</Real>
+                <Imaginary>0.0</Imaginary>
+              </Zero>
+              <Zero number="4">
+                <Real>-463.1</Real>
+                <Imaginary>-430.5</Imaginary>
+              </Zero>
+              <Zero number="5">
+                <Real>-463.1</Real>
+                <Imaginary>430.5</Imaginary>
+              </Zero>
+              <Pole number="0">
+                <Real>-0.037</Real>
+                <Imaginary>-0.037</Imaginary>
+              </Pole>
+              <Pole number="1">
+                <Real>-0.037</Real>
+                <Imaginary>0.037</Imaginary>
+              </Pole>
+              <Pole number="2">
+                <Real>-15.64</Real>
+                <Imaginary>0.0</Imaginary>
+              </Pole>
+              <Pole number="3">
+                <Real>-97.34</Real>
+                <Imaginary>-400.7</Imaginary>
+              </Pole>
+              <Pole number="4">
+                <Real>-97.34</Real>
+                <Imaginary>400.7</Imaginary>
+              </Pole>
+              <Pole number="5">
+                <Real>-374.8</Real>
+                <Imaginary>0.0</Imaginary>
+              </Pole>
+              <Pole number="6">
+                <Real>-520.3</Real>
+                <Imaginary>0.0</Imaginary>
+              </Pole>
+              <Pole number="7">
+                <Real>-10530.0</Real>
+                <Imaginary>-10050.0</Imaginary>
+              </Pole>
+              <Pole number="8">
+                <Real>-10530.0</Real>
+                <Imaginary>10050.0</Imaginary>
+              </Pole>
+              <Pole number="9">
+                <Real>-13300.0</Real>
+                <Imaginary>0.0</Imaginary>
+              </Pole>
+              <Pole number="10">
+                <Real>-255.097</Real>
+                <Imaginary>0.0</Imaginary>
+              </Pole>
+            </PolesZeros>
+            <StageGain>
+              <Value>1500.0</Value>
+              <Frequency>1.0</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="2">
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="3">
+            <Coefficients>
+              <InputUnits>
+                <Name>V</Name>
+                <Description>Volts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>1.0</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">102400.0</InputSampleRate>
+              <Factor>1</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0</Delay>
+              <Correction>0.0</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>629129.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="4">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.000976562</Numerator>
+              <Numerator>0.00244141</Numerator>
+              <Numerator>0.00488281</Numerator>
+              <Numerator>0.00854492</Numerator>
+              <Numerator>0.0136719</Numerator>
+              <Numerator>0.0205078</Numerator>
+              <Numerator>0.0292969</Numerator>
+              <Numerator>0.0393066</Numerator>
+              <Numerator>0.0498047</Numerator>
+              <Numerator>0.0600586</Numerator>
+              <Numerator>0.0693359</Numerator>
+              <Numerator>0.0769043</Numerator>
+              <Numerator>0.0820312</Numerator>
+              <Numerator>0.0839844</Numerator>
+              <Numerator>0.0820312</Numerator>
+              <Numerator>0.0769043</Numerator>
+              <Numerator>0.0693359</Numerator>
+              <Numerator>0.0600586</Numerator>
+              <Numerator>0.0498047</Numerator>
+              <Numerator>0.0393066</Numerator>
+              <Numerator>0.0292969</Numerator>
+              <Numerator>0.0205078</Numerator>
+              <Numerator>0.0136719</Numerator>
+              <Numerator>0.00854492</Numerator>
+              <Numerator>0.00488281</Numerator>
+              <Numerator>0.00244141</Numerator>
+              <Numerator>0.000976562</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">102400.0</InputSampleRate>
+              <Factor>8</Factor>
+              <Offset>0</Offset>
+              <Delay>0.00013672</Delay>
+              <Correction>0.00013672</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="5">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">12800.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.00046875</Delay>
+              <Correction>0.00046875</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="6">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">6400.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0009375</Delay>
+              <Correction>0.0009375</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="7">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">3200.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.001875</Delay>
+              <Correction>0.001875</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="8">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">1600.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.00375</Delay>
+              <Correction>0.00375</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="9">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>0.000244141</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.225586</Numerator>
+              <Numerator>0.193359</Numerator>
+              <Numerator>0.12085</Numerator>
+              <Numerator>0.0537109</Numerator>
+              <Numerator>0.0161133</Numerator>
+              <Numerator>0.00292969</Numerator>
+              <Numerator>0.000244141</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">800.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.0075</Delay>
+              <Correction>0.0075</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="10">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-7.15032e-07</Numerator>
+              <Numerator>-5.60109e-06</Numerator>
+              <Numerator>-2.62179e-06</Numerator>
+              <Numerator>-4.31403e-05</Numerator>
+              <Numerator>-4.64771e-06</Numerator>
+              <Numerator>1.43006e-06</Numerator>
+              <Numerator>2.34769e-05</Numerator>
+              <Numerator>1.43006e-06</Numerator>
+              <Numerator>-5.27932e-05</Numerator>
+              <Numerator>-0.000366692</Numerator>
+              <Numerator>0.000376107</Numerator>
+              <Numerator>0.000854226</Numerator>
+              <Numerator>3.05081e-05</Numerator>
+              <Numerator>-0.00127621</Numerator>
+              <Numerator>-0.000910951</Numerator>
+              <Numerator>0.00127669</Numerator>
+              <Numerator>0.00215165</Numerator>
+              <Numerator>-0.000461554</Numerator>
+              <Numerator>-0.00333765</Numerator>
+              <Numerator>-0.00140933</Numerator>
+              <Numerator>0.00377072</Numerator>
+              <Numerator>0.00419414</Numerator>
+              <Numerator>-0.00264288</Numerator>
+              <Numerator>-0.00720121</Numerator>
+              <Numerator>-0.000644006</Numerator>
+              <Numerator>0.009184</Numerator>
+              <Numerator>0.00608445</Numerator>
+              <Numerator>-0.00857824</Numerator>
+              <Numerator>-0.0127401</Numerator>
+              <Numerator>0.00398225</Numerator>
+              <Numerator>0.0186261</Numerator>
+              <Numerator>0.0052052</Numerator>
+              <Numerator>-0.0209407</Numerator>
+              <Numerator>-0.0181629</Numerator>
+              <Numerator>0.0166669</Numerator>
+              <Numerator>0.0322447</Numerator>
+              <Numerator>-0.00346588</Numerator>
+              <Numerator>-0.0429528</Numerator>
+              <Numerator>-0.0193265</Numerator>
+              <Numerator>0.044309</Numerator>
+              <Numerator>0.0497909</Numerator>
+              <Numerator>-0.0294164</Numerator>
+              <Numerator>-0.0826078</Numerator>
+              <Numerator>-0.00934166</Numerator>
+              <Numerator>0.107552</Numerator>
+              <Numerator>0.0816604</Numerator>
+              <Numerator>-0.10311</Numerator>
+              <Numerator>-0.204208</Numerator>
+              <Numerator>-3.12231e-05</Numerator>
+              <Numerator>0.390432</Numerator>
+              <Numerator>0.589958</Numerator>
+              <Numerator>0.390432</Numerator>
+              <Numerator>-3.12231e-05</Numerator>
+              <Numerator>-0.204208</Numerator>
+              <Numerator>-0.10311</Numerator>
+              <Numerator>0.0816604</Numerator>
+              <Numerator>0.107552</Numerator>
+              <Numerator>-0.00934166</Numerator>
+              <Numerator>-0.0826078</Numerator>
+              <Numerator>-0.0294164</Numerator>
+              <Numerator>0.0497909</Numerator>
+              <Numerator>0.044309</Numerator>
+              <Numerator>-0.0193265</Numerator>
+              <Numerator>-0.0429528</Numerator>
+              <Numerator>-0.00346588</Numerator>
+              <Numerator>0.0322447</Numerator>
+              <Numerator>0.0166669</Numerator>
+              <Numerator>-0.0181629</Numerator>
+              <Numerator>-0.0209407</Numerator>
+              <Numerator>0.0052052</Numerator>
+              <Numerator>0.0186261</Numerator>
+              <Numerator>0.00398225</Numerator>
+              <Numerator>-0.0127401</Numerator>
+              <Numerator>-0.00857824</Numerator>
+              <Numerator>0.00608445</Numerator>
+              <Numerator>0.009184</Numerator>
+              <Numerator>-0.000644006</Numerator>
+              <Numerator>-0.00720121</Numerator>
+              <Numerator>-0.00264288</Numerator>
+              <Numerator>0.00419414</Numerator>
+              <Numerator>0.00377072</Numerator>
+              <Numerator>-0.00140933</Numerator>
+              <Numerator>-0.00333765</Numerator>
+              <Numerator>-0.000461554</Numerator>
+              <Numerator>0.00215165</Numerator>
+              <Numerator>0.00127669</Numerator>
+              <Numerator>-0.000910951</Numerator>
+              <Numerator>-0.00127621</Numerator>
+              <Numerator>3.05081e-05</Numerator>
+              <Numerator>0.000854226</Numerator>
+              <Numerator>0.000376107</Numerator>
+              <Numerator>-0.000366692</Numerator>
+              <Numerator>-0.00041031</Numerator>
+              <Numerator>2.52645e-05</Numerator>
+              <Numerator>0.000261821</Numerator>
+              <Numerator>0.000120602</Numerator>
+              <Numerator>-9.99854e-05</Numerator>
+              <Numerator>-0.000162312</Numerator>
+              <Numerator>-9.79595e-05</Numerator>
+              <Numerator>-2.94355e-05</Numerator>
+              <Numerator>-3.09847e-06</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">400.0</InputSampleRate>
+              <Factor>2</Factor>
+              <Offset>0</Offset>
+              <Delay>0.125</Delay>
+              <Correction>0.125</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+          <Stage number="11">
+            <Coefficients>
+              <InputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </InputUnits>
+              <OutputUnits>
+                <Name>count</Name>
+                <Description>Digital Counts</Description>
+              </OutputUnits>
+              <CfTransferFunctionType>DIGITAL</CfTransferFunctionType>
+              <Numerator>-1.09889e-05</Numerator>
+              <Numerator>-1.99798e-05</Numerator>
+              <Numerator>-3.29668e-05</Numerator>
+              <Numerator>-4.39561e-05</Numerator>
+              <Numerator>-4.79522e-05</Numerator>
+              <Numerator>-4.09589e-05</Numerator>
+              <Numerator>-1.8981e-05</Numerator>
+              <Numerator>1.8981e-05</Numerator>
+              <Numerator>6.7932e-05</Numerator>
+              <Numerator>0.000118881</Numerator>
+              <Numerator>0.000158842</Numerator>
+              <Numerator>0.000174826</Numerator>
+              <Numerator>0.000157843</Numerator>
+              <Numerator>0.000104895</Numerator>
+              <Numerator>2.49751e-05</Numerator>
+              <Numerator>-6.49352e-05</Numerator>
+              <Numerator>-0.00014086</Numerator>
+              <Numerator>-0.000178822</Numerator>
+              <Numerator>-0.00016084</Numerator>
+              <Numerator>-8.59142e-05</Numerator>
+              <Numerator>3.29668e-05</Numerator>
+              <Numerator>0.000163837</Numerator>
+              <Numerator>0.000268733</Numerator>
+              <Numerator>0.000310691</Numerator>
+              <Numerator>0.000263737</Numerator>
+              <Numerator>0.00013087</Numerator>
+              <Numerator>-6.09391e-05</Numerator>
+              <Numerator>-0.00026074</Numerator>
+              <Numerator>-0.000408593</Numerator>
+              <Numerator>-0.000448554</Numerator>
+              <Numerator>-0.000353648</Numerator>
+              <Numerator>-0.000135864</Numerator>
+              <Numerator>0.000155845</Numerator>
+              <Numerator>0.000438563</Numerator>
+              <Numerator>0.000623379</Numerator>
+              <Numerator>0.000638365</Numerator>
+              <Numerator>0.000456546</Numerator>
+              <Numerator>0.000108891</Numerator>
+              <Numerator>-0.000315686</Numerator>
+              <Numerator>-0.000694309</Numerator>
+              <Numerator>-0.000903101</Numerator>
+              <Numerator>-0.00085415</Numerator>
+              <Numerator>-0.000533469</Numerator>
+              <Numerator>-7.99164e-06</Numerator>
+              <Numerator>0.000581421</Numerator>
+              <Numerator>0.00105695</Numerator>
+              <Numerator>0.00125675</Numerator>
+              <Numerator>0.00108792</Numerator>
+              <Numerator>0.000559443</Numerator>
+              <Numerator>-0.000201799</Numerator>
+              <Numerator>-0.000983021</Numerator>
+              <Numerator>-0.00154047</Numerator>
+              <Numerator>-0.00167733</Numerator>
+              <Numerator>-0.0013037</Numerator>
+              <Numerator>-0.000484518</Numerator>
+              <Numerator>0.000571431</Numerator>
+              <Numerator>0.00155645</Numerator>
+              <Numerator>0.00215685</Numerator>
+              <Numerator>0.00214287</Numerator>
+              <Numerator>0.00145855</Numerator>
+              <Numerator>0.00025075</Numerator>
+              <Numerator>-0.00115385</Numerator>
+              <Numerator>-0.00233568</Numerator>
+              <Numerator>-0.00290311</Numerator>
+              <Numerator>-0.0026174</Numerator>
+              <Numerator>-0.00148752</Numerator>
+              <Numerator>0.000215785</Numerator>
+              <Numerator>0.002014</Numerator>
+              <Numerator>0.00335166</Numerator>
+              <Numerator>0.00376825</Numerator>
+              <Numerator>0.00304597</Numerator>
+              <Numerator>0.0013037</Numerator>
+              <Numerator>-0.001009</Numerator>
+              <Numerator>-0.0032208</Numerator>
+              <Numerator>-0.00463139</Numerator>
+              <Numerator>-0.0047233</Numerator>
+              <Numerator>-0.00334667</Numerator>
+              <Numerator>-0.000793211</Numerator>
+              <Numerator>0.00224477</Numerator>
+              <Numerator>0.00486516</Numerator>
+              <Numerator>0.00620583</Numerator>
+              <Numerator>0.0057273</Numerator>
+              <Numerator>0.00340861</Numerator>
+              <Numerator>-0.000199801</Numerator>
+              <Numerator>-0.00409193</Numerator>
+              <Numerator>-0.00707596</Numerator>
+              <Numerator>-0.00812791</Numerator>
+              <Numerator>-0.00672831</Numerator>
+              <Numerator>-0.00307194</Numerator>
+              <Numerator>0.00192309</Numerator>
+              <Numerator>0.00682721</Numerator>
+              <Numerator>0.010091</Numerator>
+              <Numerator>0.0105175</Numerator>
+              <Numerator>0.00766437</Numerator>
+              <Numerator>0.00206594</Numerator>
+              <Numerator>-0.00483219</Numerator>
+              <Numerator>-0.01101</Numerator>
+              <Numerator>-0.0144376</Numerator>
+              <Numerator>-0.0136934</Numerator>
+              <Numerator>-0.00847457</Numerator>
+              <Numerator>0.000173827</Numerator>
+              <Numerator>0.010004</Numerator>
+              <Numerator>0.018085</Numerator>
+              <Numerator>0.0215935</Numerator>
+              <Numerator>0.0186664</Numerator>
+              <Numerator>0.00910094</Numerator>
+              <Numerator>-0.0053287</Numerator>
+              <Numerator>-0.0210541</Numerator>
+              <Numerator>-0.0333958</Numerator>
+              <Numerator>-0.0376226</Numerator>
+              <Numerator>-0.030137</Numerator>
+              <Numerator>-0.00949755</Numerator>
+              <Numerator>0.0229931</Numerator>
+              <Numerator>0.063304</Numerator>
+              <Numerator>0.10534</Numerator>
+              <Numerator>0.142124</Numerator>
+              <Numerator>0.167226</Numerator>
+              <Numerator>0.176134</Numerator>
+              <Numerator>0.167226</Numerator>
+              <Numerator>0.142124</Numerator>
+              <Numerator>0.10534</Numerator>
+              <Numerator>0.063304</Numerator>
+              <Numerator>0.0229931</Numerator>
+              <Numerator>-0.00949755</Numerator>
+              <Numerator>-0.030137</Numerator>
+              <Numerator>-0.0376226</Numerator>
+              <Numerator>-0.0333958</Numerator>
+              <Numerator>-0.0210541</Numerator>
+              <Numerator>-0.0053287</Numerator>
+              <Numerator>0.00910094</Numerator>
+              <Numerator>0.0186664</Numerator>
+              <Numerator>0.0215935</Numerator>
+              <Numerator>0.018085</Numerator>
+              <Numerator>0.010004</Numerator>
+              <Numerator>0.000173827</Numerator>
+              <Numerator>-0.00847457</Numerator>
+              <Numerator>-0.0136934</Numerator>
+              <Numerator>-0.0144376</Numerator>
+              <Numerator>-0.01101</Numerator>
+              <Numerator>-0.00483219</Numerator>
+              <Numerator>0.00206594</Numerator>
+              <Numerator>0.00766437</Numerator>
+              <Numerator>0.0105175</Numerator>
+              <Numerator>0.010091</Numerator>
+              <Numerator>0.00682721</Numerator>
+              <Numerator>0.00192309</Numerator>
+              <Numerator>-0.00307194</Numerator>
+              <Numerator>-0.00672831</Numerator>
+              <Numerator>-0.00812791</Numerator>
+              <Numerator>-0.00707596</Numerator>
+              <Numerator>-0.00409193</Numerator>
+              <Numerator>-0.000199801</Numerator>
+              <Numerator>0.00340861</Numerator>
+              <Numerator>0.0057273</Numerator>
+              <Numerator>0.00620583</Numerator>
+              <Numerator>0.00486516</Numerator>
+              <Numerator>0.00224477</Numerator>
+              <Numerator>-0.000793211</Numerator>
+              <Numerator>-0.00334667</Numerator>
+              <Numerator>-0.0047233</Numerator>
+              <Numerator>-0.00463139</Numerator>
+              <Numerator>-0.0032208</Numerator>
+              <Numerator>-0.001009</Numerator>
+              <Numerator>0.0013037</Numerator>
+              <Numerator>0.00304597</Numerator>
+              <Numerator>0.00376825</Numerator>
+              <Numerator>0.00335166</Numerator>
+              <Numerator>0.002014</Numerator>
+              <Numerator>0.000215785</Numerator>
+              <Numerator>-0.00148752</Numerator>
+              <Numerator>-0.0026174</Numerator>
+              <Numerator>-0.00290311</Numerator>
+              <Numerator>-0.00233568</Numerator>
+              <Numerator>-0.00115385</Numerator>
+              <Numerator>0.00025075</Numerator>
+              <Numerator>0.00145855</Numerator>
+              <Numerator>0.00214287</Numerator>
+              <Numerator>0.00215685</Numerator>
+              <Numerator>0.00155645</Numerator>
+              <Numerator>0.000571431</Numerator>
+              <Numerator>-0.000484518</Numerator>
+              <Numerator>-0.0013037</Numerator>
+              <Numerator>-0.00167733</Numerator>
+              <Numerator>-0.00154047</Numerator>
+              <Numerator>-0.000983021</Numerator>
+              <Numerator>-0.000201799</Numerator>
+              <Numerator>0.000559443</Numerator>
+              <Numerator>0.00108792</Numerator>
+              <Numerator>0.00125675</Numerator>
+              <Numerator>0.00105695</Numerator>
+              <Numerator>0.000581421</Numerator>
+              <Numerator>-7.99164e-06</Numerator>
+              <Numerator>-0.000533469</Numerator>
+              <Numerator>-0.00085415</Numerator>
+              <Numerator>-0.000903101</Numerator>
+              <Numerator>-0.000694309</Numerator>
+              <Numerator>-0.000315686</Numerator>
+              <Numerator>0.000108891</Numerator>
+              <Numerator>0.000456546</Numerator>
+              <Numerator>0.000638365</Numerator>
+              <Numerator>0.000623379</Numerator>
+              <Numerator>0.000438563</Numerator>
+              <Numerator>0.000155845</Numerator>
+              <Numerator>-0.000135864</Numerator>
+              <Numerator>-0.000353648</Numerator>
+              <Numerator>-0.000448554</Numerator>
+              <Numerator>-0.000408593</Numerator>
+              <Numerator>-0.00026074</Numerator>
+              <Numerator>-6.09391e-05</Numerator>
+              <Numerator>0.00013087</Numerator>
+              <Numerator>0.000263737</Numerator>
+              <Numerator>0.000310691</Numerator>
+              <Numerator>0.000268733</Numerator>
+              <Numerator>0.000163837</Numerator>
+              <Numerator>3.29668e-05</Numerator>
+              <Numerator>-8.59142e-05</Numerator>
+              <Numerator>-0.00016084</Numerator>
+              <Numerator>-0.000178822</Numerator>
+              <Numerator>-0.00014086</Numerator>
+              <Numerator>-6.49352e-05</Numerator>
+              <Numerator>2.49751e-05</Numerator>
+              <Numerator>0.000104895</Numerator>
+              <Numerator>0.000157843</Numerator>
+              <Numerator>0.000174826</Numerator>
+              <Numerator>0.000158842</Numerator>
+              <Numerator>0.000118881</Numerator>
+              <Numerator>6.7932e-05</Numerator>
+              <Numerator>1.8981e-05</Numerator>
+              <Numerator>-1.8981e-05</Numerator>
+              <Numerator>-4.09589e-05</Numerator>
+              <Numerator>-4.79522e-05</Numerator>
+              <Numerator>-4.39561e-05</Numerator>
+              <Numerator>-3.29668e-05</Numerator>
+              <Numerator>-1.99798e-05</Numerator>
+              <Numerator>-1.09889e-05</Numerator>
+            </Coefficients>
+            <Decimation>
+              <InputSampleRate unit="HERTZ">200.0</InputSampleRate>
+              <Factor>5</Factor>
+              <Offset>0</Offset>
+              <Delay>0.585</Delay>
+              <Correction>0.585</Correction>
+            </Decimation>
+            <StageGain>
+              <Value>1.0</Value>
+              <Frequency>0.05</Frequency>
+            </StageGain>
+          </Stage>
+        </Response>
+      </Channel>
+    </Station>
+  </Network>
+</FDSNStationXML>
diff --git a/docs/examples/validate.sh b/docs/examples/validate.sh
new file mode 100755
index 0000000..7738b2d
--- /dev/null
+++ b/docs/examples/validate.sh
@@ -0,0 +1,63 @@
+#!/bin/bash
+
+SCHEMAURL='http://www.fdsn.org/xml/station/fdsn-station-1.1.xsd'
+SCHEMA='fdsn-station-1.1.xsd'
+IRIS_VALIDATOR='stationxml-validator-1.7.1.jar'
+
+if [[ ! -r 'xmlvalidator/ValidateStationXml.class' ]]
+then
+    echo
+    echo "xmlvalidator not in current directory, please get with:"
+    echo
+    echo "wget http://wiki.anss-sis.scsn.org/SIStrac/raw-attachment/wiki/SIS/Code/validator.tar.gz"
+    echo "tar ztf validator.tar.gz"
+    echo
+elif [[ ! -r 'xerces-2_12_1-xml-schema-1.1/xercesImpl.jar' ]]
+then
+    echo
+    echo "Xerces not in current directory, please get with:"
+    echo
+    echo "http://xerces.apache.org"
+    echo "or a mirror like:"
+    echo
+    echo "wget http://ftp.wayne.edu/apache/xerces/j/binaries/Xerces-J-bin.2.12.1-xml-schema-1.1.tar.gz"
+    echo "tar zxf Xerces-J-bin.2.12.1-xml-schema-1.1.tar.gz"
+    echo
+    echo "Note it must be the xml-schema-1.1 version."
+    echo
+elif [[ ! -r $SCHEMA ]]
+then
+    echo
+    echo "$SCHEMA not in current directory, please get with:"
+    echo
+    echo "wget -O $SCHEMA $SCHEMAURL"
+    echo
+    echo "Note you may choose the a different version, like 2.1 instead, but will need to change this script."
+    echo
+else
+    if [[ ! -n $1 ]]
+    then
+        echo "Warn: no stationxml file on command line"
+    elif [[ ! -r $1 ]]
+    then
+        echo "Warn: cannot read stationxml file"
+    else
+        ERRFILE=`java -cp xerces-2_12_1-xml-schema-1.1/xercesImpl.jar:xerces-2_12_1-xml-schema-1.1/xml-apis.jar:xerces-2_12_1-xml-schema-1.1/serializer.jar:xerces-2_12_1-xml-schema-1.1/org.eclipse.wst.xml.xpath2.processor_1.2.0.jar:xmlvalidator ValidateStationXml -s $SCHEMA -i $*`
+
+        if [ $ERRFILE = "0" ]
+        then
+           echo "Valid"
+        else
+           less $ERRFILE
+           echo $ERRFILE
+        fi
+    fi
+fi
+
+# run iris content validator
+if [[ -e $IRIS_VALIDATOR ]]
+then
+  java -jar $IRIS_VALIDATOR --input $1
+else
+  echo "IRIS stationxml-validator not found"
+fi
diff --git a/docs/examples/validate_all.sh b/docs/examples/validate_all.sh
new file mode 100755
index 0000000..c3df8da
--- /dev/null
+++ b/docs/examples/validate_all.sh
@@ -0,0 +1,9 @@
+#!/bin/bash
+
+FILES=*.xml
+#echo ${FILES}
+for f in $FILES
+do
+  echo $f
+  ./validate.sh $f
+done
diff --git a/docs/filters.rst b/docs/filters.rst
new file mode 100644
index 0000000..7140f65
--- /dev/null
+++ b/docs/filters.rst
@@ -0,0 +1,75 @@
+FIR anti-alias filter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The recommended practice for storing FIR filters is to
+normalize the filter response at a specified frequency:
+
+.. math::
+   :nowrap:
+
+   \begin{eqnarray}
+      G(f)&=&S_d H_c(z)\Big|_{z=e^{j2\pi \Delta t f_s}} \\
+          &=&S_d\sum_{k=0}^{M}b_k z^{-k} \Big|_{z=e^{j2\pi \Delta t f_s}} \\
+          &=&S_d\sum_{n=0}^{M}b_k e^{-j 2\pi f_s k \Delta t}
+   \end{eqnarray}
+
+where :math:`b_k` are the FIR coefficients, :math:`M` is the filter order,
+:math:`\Delta t` is the sample rate [seconds], and
+:math:`f_s` is the frequency at which the filter is normalized
+to have a gain of :math:`S_d`.
+
+
+The Quanterra QDP380/QDP680 family of dataloggers
+employ the 64-element FIR filter described
+in Table X as a digital anti-alias filter
+in the stage 4 decimation from 40Hz down to
+20 Hz.
+
+The FIR coefficients, :math:`b_k` are plotted in Fig. X
+
+.. figure:: Qx80_FIR_64.png
+
+   Fig. X Plot of filter coefficients for Qx80 FIR filter
+
+The FIR filter has 64 coefficients (order M = 64-1 = 63)
+and is symmetric about the midpoint (which lies in between
+samples 32 and 33).
+Hence it is a FIR Type II symmetric filter.
+
+
+Decimation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In the normal process by which the datalogger holds and samples information,
+followed by decimation, a time delay is often introduced into the recorded
+trace (see Fig. X). This delay, if known, can be stored in the <Delay> element.
+For example, a delay of 1.0 seconds would be stored as:
+
+.. code-block:: XML
+
+      <Response>
+         <Stage>
+            <Decimation>
+               <Delay>1.0</Delay>
+            </Decimation>
+         </Stage>
+      </Response>
+
+while any applied time correction, e.g., to cancel out the delay, can be stored in:
+
+.. code-block:: XML
+
+      <Response>
+         <Stage>
+            <Decimation>
+               <Correction>1.0</Correction>
+            </Decimation>
+         </Stage>
+      </Response>
+
+An anti-alias FIR filter normally introduces a positive delay into the recorded trace
+as indicated in the figure. If this delay is removed from the data,
+e.g., by introducing a negative offset -x prior to recording, then the
+positive value +x is stored in the <Correction> element.
+
+.. image:: ./decimation_delay.png
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644
index 0000000..3c53639
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,38 @@
+.. StationXML documentation master file
+   :titlesonly:
+   :maxdepth: 5
+
+.. role::  raw-html(raw)
+	:format: html
+
+.. role:: latex(raw)
+   :format: latex
+
+Welcome to the StationXML documentation!
+========================================
+
+Version: |doc_version|
+
+..  :numbered=3:
+
+.. toctree::
+   :glob:
+   :numbered: 3
+
+   Contents <self>
+   overview
+   reference
+   response
+   tools
+   appendices
+   Specification home <https://www.fdsn.org/xml/station/>
+   FDSN home <https://www.fdsn.org/>
+
+Indices and tables
+==================
+
+* :doc:`overview`
+* :doc:`reference`
+* :doc:`response-theory`
+* :doc:`tools`
+* :doc:`appendices`
diff --git a/docs/level-channel.rst b/docs/level-channel.rst
new file mode 100644
index 0000000..22e0f8d
--- /dev/null
+++ b/docs/level-channel.rst
@@ -0,0 +1,2892 @@
+.. Put any comments here
+
+  Warning, this file is regenerated from the annotations in the schema file.
+
+  Any changes will be overwritten by convert_xsd_to_rst.py.
+
+.. Auto-generated rst file from scan of fdsn xsd
+
+.. role:: blue
+.. role:: red
+.. role::  raw-html(raw)
+	:format: html
+.. role::  raw-latex(raw)
+	:format: latex
+
+.. _channel:
+
+<Channel>
+============================================================
+.. container:: hatnote hatnote-gray
+
+   .. admonition:: Warning, Future Change
+
+      endDate: This attribute should not be used if it is in the future.
+
+   .. admonition:: Warning, Future Change
+
+      endDate: This attribute is likely to require timezone of Z.
+
+   .. admonition:: Warning, Future Change
+
+      startDate: This attribute is likely to require timezone of Z.
+
+   .. container:: description
+
+      The Channel container.
+      A Description element may be included with other information.
+      An Identifier element may be included to designate a persistent identifier (e.g. DOI) to use for citation or reference.
+      A Comment element may be included for arbitrary comments.
+
+      An active Channel should not use the endDate attribute.
+      Unlike SEED, do not use an endDate in the distant future to mean active.
+
+
+
+
+
+
+   **Attributes of <Channel>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **alternateCode**, :ref:`string<type-glossary>`, no, "A code used for display or association", "alternateCode=\"Z\"" 
+      **code**, :ref:`string<type-glossary>`, :red:`yes`, "Name of Channel", "code=\"BHZ\"" 
+      **endDate**, :ref:`dateTime<type-glossary>`, no, "End date of channel epoch. Do not use if still active, endDate should not be in the future.", "endDate=\"2018-01-27T00:00:00Z\"" 
+      **historicalCode**, :ref:`string<type-glossary>`, no, "A previously used code if different from the current code", "historicalCode=\"bhz\"" 
+      **locationCode**, :ref:`string<type-glossary>`, :red:`yes`, "The locationCode is typically used to group channels from a common sensor. For example, the channels of the primary sensor at global IDA-IRIS stations have locationCode = \"00\": 00_BHZ, 00_BHE, 00_BHN, 00_LHZ, ..., etc. Even though it is required, locationCode may be, and often is, an empty string, however, it is recommended that the locationCode not be empty.", "locationCode=\"30\"" 
+      **restrictedStatus**, :ref:`RestrictedStatusType<type-glossary>`, no, "One of: \"open\", \"closed\", \"partial\"", "restrictedStatus=\"open\"" 
+      **sourceID**, :ref:`anyURI<type-glossary>`, no, "A data source identifier in URI form. It is recommended that this follow the FDSN Source Identifiers specification, http://docs.fdsn.org/projects/source-identifiers", "sourceID=\"FDSN:XX_ABCD_00_B_H_Z\"" 
+      **startDate**, :ref:`dateTime<type-glossary>`, no, "Start date of channel epoch", "startDate=\"2016-07-01T00:00:00Z\"" 
+
+
+
+
+   **Sub Elements of <Channel>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Channel-Description>`, string, "optional" 
+      :ref:`\<Identifier\><Channel-Identifier>`, string, "optional, many" 
+      :ref:`\<Comment\><Channel-Comment>`, , "optional, many" 
+      :ref:`\<DataAvailability\><Channel-DataAvailability>`, , "optional" 
+      :ref:`\<ExternalReference\><Channel-ExternalReference>`, , "optional, many" 
+      :ref:`\<Latitude\><Channel-Latitude>`, double, ":red:`required`" 
+      :ref:`\<Longitude\><Channel-Longitude>`, double, ":red:`required`" 
+      :ref:`\<Elevation\><Channel-Elevation>`, double, ":red:`required`" 
+      :ref:`\<Depth\><Channel-Depth>`, double, ":red:`required`" 
+      :ref:`\<Azimuth\><Channel-Azimuth>`, double, "optional" 
+      :ref:`\<Dip\><Channel-Dip>`, double, "optional" 
+      :ref:`\<WaterLevel\><Channel-WaterLevel>`, double, "optional" 
+      :ref:`\<Type\><Channel-Type>`, string, "optional, many" 
+      :ref:`\<SampleRate\><Channel-SampleRate>`, double, "optional" 
+      :ref:`\<SampleRateRatio\><Channel-SampleRateRatio>`, , "optional" 
+      :ref:`\<ClockDrift\><Channel-ClockDrift>`, double, "optional" 
+      :ref:`\<CalibrationUnits\><Channel-CalibrationUnits>`, , "optional" 
+      :ref:`\<Sensor\><Channel-Sensor>`, , "optional" 
+      :ref:`\<PreAmplifier\><Channel-PreAmplifier>`, , "optional" 
+      :ref:`\<DataLogger\><Channel-DataLogger>`, , "optional" 
+      :ref:`\<Equipment\><Channel-Equipment>`, , "optional, many" 
+      :ref:`\<Response\><Response>`, , "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-description:
+
+<Description>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of the Channel
+
+
+
+   .. container:: example
+
+      **Example**: <Description>This is a description</Description>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-identifier:
+
+<Identifier>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Identifier
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      A type to document persistent identifiers.
+      Identifier values should be specified without a URI scheme (prefix),
+      instead the identifier type is documented as an attribute.
+
+
+
+   .. container:: example
+
+      **Example**: <identifier type="DOI">10.1000/140</identifier>
+
+   .. container:: example
+
+     **Example**: <identifier type="DOI">10.5555/12345678</identifier>BHZ.
+
+
+
+
+   **Attributes of <Identifier>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **type**, :ref:`string<type-glossary>`, no, "Identifier type", "type=\"DOI\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment:
+
+<Comment>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment
+
+   .. container:: description
+
+      Container for a comment or log entry.
+
+
+
+
+
+
+   **Attributes of <Comment>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **id**, :ref:`CounterType<type-glossary>`, no, "An ID for this comment", "id=\"12345\"" 
+      **subject**, :ref:`string<type-glossary>`, no, "A subject for this comment. Multiple comments with the same subject should be considered related.", "subject=\"Scheduled maintenance\"" 
+
+
+
+
+   **Sub Elements of <Comment>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Value\><Channel-Comment-Value>`, string, ":red:`required`" 
+      :ref:`\<BeginEffectiveTime\><Channel-Comment-BeginEffectiveTime>`, dateTime, "optional" 
+      :ref:`\<EndEffectiveTime\><Channel-Comment-EndEffectiveTime>`, dateTime, "optional" 
+      :ref:`\<Author\><Channel-Comment-Author>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-value:
+
+<Value>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Value
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Comment text.
+
+
+
+   .. container:: example
+
+      **Example**: <Value>Large number of spikes</Value>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-begineffectivetime:
+
+<BeginEffectiveTime>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` BeginEffectiveTime
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Start time for when comment applies.
+
+
+
+   .. container:: example
+
+      **Example**: <BeginEffectiveTime>2008-09-15T00:00:00Z</BeginEffectiveTime>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-endeffectivetime:
+
+<EndEffectiveTime>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` EndEffectiveTime
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      End time for when comment applies.
+
+
+
+   .. container:: example
+
+      **Example**: <EndEffectiveTime>2008-09-16T12:00:00Z</EndEffectiveTime>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-author:
+
+<Author>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author
+
+   .. container:: description
+
+      Author of Comment.
+
+      Person's contact information. A person can belong
+      to multiple agencies and have multiple email addresses and phone numbers.
+
+
+
+
+
+
+   **Sub Elements of <Author>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Channel-Comment-Author-Name>`, string, "optional, many" 
+      :ref:`\<Agency\><Channel-Comment-Author-Agency>`, string, "optional, many" 
+      :ref:`\<Email\><Channel-Comment-Author-Email>`, string, "optional, many" 
+      :ref:`\<Phone\><Channel-Comment-Author-Phone>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-author-name:
+
+<Name>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Name of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Name>Dr. Jane Doe</Name>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-author-agency:
+
+<Agency>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Agency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Agency of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Agency>USGS</Agency>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-author-email:
+
+<Email>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Email
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Email of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Email>jane_doe@example.com</Email>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-author-phone:
+
+<Phone>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone
+
+   .. container:: description
+
+      Phone of contact or author
+
+
+
+
+
+
+   **Attributes of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **description**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+
+
+   **Sub Elements of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<CountryCode\><Channel-Comment-Author-Phone-CountryCode>`, integer, "optional" 
+      :ref:`\<AreaCode\><Channel-Comment-Author-Phone-AreaCode>`, integer, ":red:`required`" 
+      :ref:`\<PhoneNumber\><Channel-Comment-Author-Phone-PhoneNumber>`, string, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-author-phone-countrycode:
+
+<CountryCode>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CountryCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone country code
+
+
+
+   .. container:: example
+
+      **Example**: <CountryCode>64</CountryCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-author-phone-areacode:
+
+<AreaCode>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` AreaCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone area code
+
+
+
+   .. container:: example
+
+      **Example**: <AreaCode>408</AreaCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-comment-author-phone-phonenumber:
+
+<PhoneNumber>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PhoneNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Telephone number
+
+
+
+   .. container:: example
+
+      **Example**: <PhoneNumber>5551212</PhoneNumber>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-dataavailability:
+
+<DataAvailability>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability
+
+   .. container:: description
+
+      A description of time series data availability. This
+      information should be considered transient and is primarily useful as a
+      guide for generating time series data requests. The information for a
+      DataAvailability:Span may be specific to the time range used in a request
+      that resulted in the document or limited to the availability of data within
+      the request range. These details may or may not be retained when
+      synchronizing metadata between data centers.
+
+      A type for describing data availability.
+
+
+
+
+
+
+   **Sub Elements of <DataAvailability>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Extent\><Channel-DataAvailability-Extent>`, , "optional" 
+      :ref:`\<Span\><Channel-DataAvailability-Span>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-dataavailability-extent:
+
+<Extent>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Extent
+
+   .. container:: description
+
+      Data availability extents, the earliest and
+      latest data available. No information about the continuity of the data
+      is included or implied.
+
+
+
+
+
+
+   **Attributes of <Extent>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **end**, :ref:`dateTime<type-glossary>`, :red:`yes`, "end date of extent", "end=\"1988-12-31T00:00:00Z\"" 
+      **start**, :ref:`dateTime<type-glossary>`, :red:`yes`, "start date of extent", "start=\"1988-01-01T00:00:00Z\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-dataavailability-span:
+
+<Span>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Span
+
+   .. container:: description
+
+      A type for describing data availability spans, with variable
+      continuity. The time range described may be based on the request parameters that
+      generated the document and not necessarily relate to continuity outside of the
+      range. It may also be a smaller time window than the request depending on the data
+      characteristics.
+
+
+
+
+
+
+   **Attributes of <Span>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **end**, :ref:`dateTime<type-glossary>`, :red:`yes`, "end date of span", "end=\"1988-12-31T00:00:00Z\"" 
+      **maximumTimeTear**, :ref:`decimal<type-glossary>`, no, "The maximum time tear (gap or overlap) in seconds between time series segments in the specified range.", "maximumTimeTear=\"0.01\"" 
+      **numberSegments**, :ref:`integer<type-glossary>`, :red:`yes`, "The number of continuous time series segments contained in the specified time range. A value of 1 indicates that the time series is continuous from start to end.", "numberSegments=\"2\"" 
+      **start**, :ref:`dateTime<type-glossary>`, :red:`yes`, "start date of span", "start=\"1988-01-01T00:00:00Z\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-externalreference:
+
+<ExternalReference>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ExternalReference
+
+   .. container:: description
+
+      URI of any type of external report, such as data quality reports.
+
+      This type contains a Uniform Resource Identifier (URI) and description
+      for external information that users may want to reference.
+
+
+
+
+
+
+   **Sub Elements of <ExternalReference>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<URI\><Channel-ExternalReference-URI>`, anyURI, ":red:`required`" 
+      :ref:`\<Description\><Channel-ExternalReference-Description>`, string, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-externalreference-uri:
+
+<URI>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ExternalReference :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` URI
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`anyURI<type-glossary>`
+
+			.. only:: html
+
+					content type: `anyURI <appendices.html#glossary-anyuri>`_
+
+   .. container:: description
+
+      URI of the external reference.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-externalreference-description:
+
+<Description>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ExternalReference :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of the external reference.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-latitude:
+
+<Latitude>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Latitude
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+					range: -90.0 :math:`\le` Latitude :math:`\lt` 90.0
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+					range: -90.0 :math:`\le` Latitude :math:`\lt` 90.0
+
+   .. container:: description
+
+      Latitude of this channel's sensor, in degrees.
+      Often the same as the station latitude, but
+      when different the channel latitude is the true location of the sensor.
+
+      Latitude type extending the base type to add datum as an attribute with default.
+
+
+
+   .. container:: example
+
+      **Example**: <Latitude>34.9459</Latitude>
+
+
+
+
+   **Attributes of <Latitude>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be DEGREES, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+      **datum**, :ref:`NMTOKEN<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-longitude:
+
+<Longitude>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Longitude
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+					range: -180.0 :math:`\le` Longitude :math:`\le` 180.0
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+					range: -180.0 :math:`\le` Longitude :math:`\le` 180.0
+
+   .. container:: description
+
+      Longitude of this channel's sensor, in degrees.
+      Often the same as the station longitude, but
+      when different the channel longitude is the true location of the sensor.
+
+      Longitude type extending the base type to add datum as an attribute with default.
+
+
+
+   .. container:: example
+
+      **Example**: <Longitude>-106.4572</Longitude>
+
+
+
+
+   **Attributes of <Longitude>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be DEGREES, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+      **datum**, :ref:`NMTOKEN<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-elevation:
+
+<Elevation>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Elevation
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Elevation of the sensor, in meters.  To find the local ground surface level,
+      add the Depth value to this elevation.
+
+
+
+
+
+
+   **Attributes of <Elevation>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be METERS, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-depth:
+
+<Depth>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Depth
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The depth of the sensor relative to the local ground surface level, in meters.
+
+
+
+
+
+
+   **Attributes of <Depth>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be METERS, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-azimuth:
+
+<Azimuth>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Azimuth
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+					range: 0.0 :math:`\le` Azimuth :math:`\lt` 360.0
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+					range: 0.0 :math:`\le` Azimuth :math:`\lt` 360.0
+
+   .. container:: description
+
+      Azimuth of the component in degrees clockwise from geographic (true) north.
+
+
+
+
+
+
+   **Attributes of <Azimuth>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be DEGREES, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-dip:
+
+<Dip>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Dip
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+					range: -90.0 :math:`\le` Dip :math:`\le` 90.0
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+					range: -90.0 :math:`\le` Dip :math:`\le` 90.0
+
+   .. container:: description
+
+      Dip of the component in degrees, positive is down from horizontal.
+      For horizontal dip=0, for vertical upwards
+      dip=-90 and for vertical downwards dip=+90.
+
+
+
+
+
+
+   **Attributes of <Dip>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be DEGREES, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-waterlevel:
+
+<WaterLevel>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` WaterLevel
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Elevation of the water surface in meters for underwater sites, where 0 is mean sea level.
+      If you put an OBS on a lake bottom, where the lake surface is at elevation=1200 meters,
+      then you should set WaterLevel=1200. An OBS in the ocean would
+      have WaterLevel=0.
+
+
+
+
+
+
+   **Attributes of <WaterLevel>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The unit of measurement. Use *SI* unit names and symbols whenever possible (e.g., 'm' instead of 'METERS').", "unit=\"m\"" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-type:
+
+<Type>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Type
+
+   .. admonition:: Warning, Future Change
+
+      <Type>: This element is likely to be removed.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Data type for this channel. One or more <Type> tags
+      can be used to specify the nature of the data this channel collects.
+      The value between the <Type> tags must be one of:
+      TRIGGERED, CONTINUOUS, HEALTH, GEOPHYSICAL, WEATHER, FLAG or SYNTHESIZED.
+
+      This element existed primarily to hold the corresponding
+      value from SEED, but should not be used for new StationXML.
+
+
+
+   .. container:: example
+
+      **Example**: <Type>CONTINUOUS</Type>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-samplerate:
+
+<SampleRate>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SampleRate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Sample rate in samples per second.
+      SampleRate is optional unless SampleRateRatio is present, in which case
+      SampleRate is required.
+
+
+
+   .. container:: example
+
+      **Example**: <SampleRate>40.0</SampleRate>
+
+
+
+
+   **Attributes of <SampleRate>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be SAMPLES/S, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-samplerateratio:
+
+<SampleRateRatio>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SampleRateRatio
+
+   .. container:: description
+
+      Sample rate expressed as number of samples in a number of seconds.
+      If present, then <SampleRate> must also be present.
+      It can be useful for very slow data (e.g., less than a few samples per day),
+      since it allows for greater precision in the stored value.
+
+
+
+   .. container:: example
+
+      **Example**::
+
+        <SampleRate>0.000023148</SampleRate>
+                      <SampleRateRatio>
+                        <NumberSamples>2</NumberSamples>
+                        <NumberSeconds>86400</NumberSeconds>
+                      </SampleRateRatio>
+
+
+
+   **Sub Elements of <SampleRateRatio>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<NumberSamples\><Channel-SampleRateRatio-NumberSamples>`, integer, ":red:`required`" 
+      :ref:`\<NumberSeconds\><Channel-SampleRateRatio-NumberSeconds>`, integer, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-samplerateratio-numbersamples:
+
+<NumberSamples>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SampleRateRatio :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` NumberSamples
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Integer number of samples that span a number of seconds.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-samplerateratio-numberseconds:
+
+<NumberSeconds>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SampleRateRatio :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` NumberSeconds
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Integer number of seconds that span a number of samples.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-clockdrift:
+
+<ClockDrift>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ClockDrift
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+					range: ClockDrift :math:`\ge` 0.0
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+					range: ClockDrift :math:`\ge` 0.0
+
+   .. container:: description
+
+      Tolerance value, measured in seconds per sample,
+      used as a threshold for time error detection in data from the channel.
+
+
+
+
+
+
+   **Attributes of <ClockDrift>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The unit of drift value. This value is fixed to be SECONDS/SAMPLE, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-calibrationunits:
+
+<CalibrationUnits>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CalibrationUnits
+
+   .. container:: description
+
+      Units of calibration (e.g., V (for Volts) or A (for amps))
+
+      Use *SI* units when possible
+
+      A type to document units; use SI whenever possible.
+
+
+
+   .. container:: example
+
+      **Example**::
+
+        <CalibrationUnits>
+          <Name>V</Name>
+          <Description>Volts</Description>
+        </CalibrationUnits>
+
+
+
+   **Sub Elements of <CalibrationUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Channel-CalibrationUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Channel-CalibrationUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-calibrationunits-name:
+
+<Name>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CalibrationUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-calibrationunits-description:
+
+<Description>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CalibrationUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor:
+
+<Sensor>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor
+
+   .. container:: description
+
+      Details of the (typically analog) sensor attached to this channel.
+      If this was entered at the Station level, it is not necessary to do it for each Channel,
+      unless you have differences in equipment.
+
+      A type for equipment related to data acquisition or processing.
+
+
+
+
+
+
+   **Attributes of <Sensor>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **resourceId**, :ref:`string<type-glossary>`, no, "An identifier that serves to uniquely identify this resource. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that equipment with the same ID should indicate the same information or be derived from the same base instruments.", "" 
+
+
+
+
+   **Sub Elements of <Sensor>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Type\><Channel-Sensor-Type>`, string, "optional" 
+      :ref:`\<Description\><Channel-Sensor-Description>`, string, "optional" 
+      :ref:`\<Manufacturer\><Channel-Sensor-Manufacturer>`, string, "optional" 
+      :ref:`\<Vendor\><Channel-Sensor-Vendor>`, string, "optional" 
+      :ref:`\<Model\><Channel-Sensor-Model>`, string, "optional" 
+      :ref:`\<SerialNumber\><Channel-Sensor-SerialNumber>`, string, "optional" 
+      :ref:`\<InstallationDate\><Channel-Sensor-InstallationDate>`, dateTime, "optional" 
+      :ref:`\<RemovalDate\><Channel-Sensor-RemovalDate>`, dateTime, "optional" 
+      :ref:`\<CalibrationDate\><Channel-Sensor-CalibrationDate>`, dateTime, "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-type:
+
+<Type>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Type
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Type of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-description:
+
+<Description>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-manufacturer:
+
+<Manufacturer>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Manufacturer
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Manufacturer of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-vendor:
+
+<Vendor>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Vendor
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Vendor of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-model:
+
+<Model>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Model
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Model of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-serialnumber:
+
+<SerialNumber>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SerialNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Serial number of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-installationdate:
+
+<InstallationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstallationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was installed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-removaldate:
+
+<RemovalDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` RemovalDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was removed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-sensor-calibrationdate:
+
+<CalibrationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sensor :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CalibrationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was calibrated
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier:
+
+<PreAmplifier>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier
+
+   .. container:: description
+
+      Preamplifier (if any) used by this channel. If this was entered at the Station level,
+      it is not necessary to do it for each Channel, unless you have differences in equipment.
+
+      A type for equipment related to data acquisition or processing.
+
+
+
+
+
+
+   **Attributes of <PreAmplifier>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **resourceId**, :ref:`string<type-glossary>`, no, "An identifier that serves to uniquely identify this resource. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that equipment with the same ID should indicate the same information or be derived from the same base instruments.", "" 
+
+
+
+
+   **Sub Elements of <PreAmplifier>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Type\><Channel-PreAmplifier-Type>`, string, "optional" 
+      :ref:`\<Description\><Channel-PreAmplifier-Description>`, string, "optional" 
+      :ref:`\<Manufacturer\><Channel-PreAmplifier-Manufacturer>`, string, "optional" 
+      :ref:`\<Vendor\><Channel-PreAmplifier-Vendor>`, string, "optional" 
+      :ref:`\<Model\><Channel-PreAmplifier-Model>`, string, "optional" 
+      :ref:`\<SerialNumber\><Channel-PreAmplifier-SerialNumber>`, string, "optional" 
+      :ref:`\<InstallationDate\><Channel-PreAmplifier-InstallationDate>`, dateTime, "optional" 
+      :ref:`\<RemovalDate\><Channel-PreAmplifier-RemovalDate>`, dateTime, "optional" 
+      :ref:`\<CalibrationDate\><Channel-PreAmplifier-CalibrationDate>`, dateTime, "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-type:
+
+<Type>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Type
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Type of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-description:
+
+<Description>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-manufacturer:
+
+<Manufacturer>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Manufacturer
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Manufacturer of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-vendor:
+
+<Vendor>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Vendor
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Vendor of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-model:
+
+<Model>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Model
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Model of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-serialnumber:
+
+<SerialNumber>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SerialNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Serial number of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-installationdate:
+
+<InstallationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstallationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was installed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-removaldate:
+
+<RemovalDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` RemovalDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was removed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-preamplifier-calibrationdate:
+
+<CalibrationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PreAmplifier :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CalibrationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was calibrated
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger:
+
+<DataLogger>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger
+
+   .. container:: description
+
+      Datalogger that recorded this channel. If this was entered at the Station level,
+      it is not necessary to do it for each Channel, unless you have differences in equipment.
+
+      A type for equipment related to data acquisition or processing.
+
+
+
+
+
+
+   **Attributes of <DataLogger>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **resourceId**, :ref:`string<type-glossary>`, no, "An identifier that serves to uniquely identify this resource. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that equipment with the same ID should indicate the same information or be derived from the same base instruments.", "" 
+
+
+
+
+   **Sub Elements of <DataLogger>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Type\><Channel-DataLogger-Type>`, string, "optional" 
+      :ref:`\<Description\><Channel-DataLogger-Description>`, string, "optional" 
+      :ref:`\<Manufacturer\><Channel-DataLogger-Manufacturer>`, string, "optional" 
+      :ref:`\<Vendor\><Channel-DataLogger-Vendor>`, string, "optional" 
+      :ref:`\<Model\><Channel-DataLogger-Model>`, string, "optional" 
+      :ref:`\<SerialNumber\><Channel-DataLogger-SerialNumber>`, string, "optional" 
+      :ref:`\<InstallationDate\><Channel-DataLogger-InstallationDate>`, dateTime, "optional" 
+      :ref:`\<RemovalDate\><Channel-DataLogger-RemovalDate>`, dateTime, "optional" 
+      :ref:`\<CalibrationDate\><Channel-DataLogger-CalibrationDate>`, dateTime, "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-type:
+
+<Type>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Type
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Type of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-description:
+
+<Description>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-manufacturer:
+
+<Manufacturer>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Manufacturer
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Manufacturer of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-vendor:
+
+<Vendor>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Vendor
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Vendor of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-model:
+
+<Model>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Model
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Model of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-serialnumber:
+
+<SerialNumber>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SerialNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Serial number of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-installationdate:
+
+<InstallationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstallationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was installed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-removaldate:
+
+<RemovalDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` RemovalDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was removed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-datalogger-calibrationdate:
+
+<CalibrationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataLogger :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CalibrationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was calibrated
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment:
+
+<Equipment>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment
+
+   .. container:: description
+
+      Any equipment that does not have type-specific fields.
+      Equipment such as sensor, data logger and preamplifier that has type-specific fields should be documented in those structures.
+      If the same Equipment is entered at the Station level, it is not necessary to include it for each Channel.
+      If using a preamplifier, sensor, or datalogger, use their appropriate fields instead.
+
+      A type for equipment related to data acquisition or processing.
+
+
+
+
+
+
+   **Attributes of <Equipment>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **resourceId**, :ref:`string<type-glossary>`, no, "An identifier that serves to uniquely identify this resource. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that equipment with the same ID should indicate the same information or be derived from the same base instruments.", "" 
+
+
+
+
+   **Sub Elements of <Equipment>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Type\><Channel-Equipment-Type>`, string, "optional" 
+      :ref:`\<Description\><Channel-Equipment-Description>`, string, "optional" 
+      :ref:`\<Manufacturer\><Channel-Equipment-Manufacturer>`, string, "optional" 
+      :ref:`\<Vendor\><Channel-Equipment-Vendor>`, string, "optional" 
+      :ref:`\<Model\><Channel-Equipment-Model>`, string, "optional" 
+      :ref:`\<SerialNumber\><Channel-Equipment-SerialNumber>`, string, "optional" 
+      :ref:`\<InstallationDate\><Channel-Equipment-InstallationDate>`, dateTime, "optional" 
+      :ref:`\<RemovalDate\><Channel-Equipment-RemovalDate>`, dateTime, "optional" 
+      :ref:`\<CalibrationDate\><Channel-Equipment-CalibrationDate>`, dateTime, "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-type:
+
+<Type>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Type
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Type of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-description:
+
+<Description>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-manufacturer:
+
+<Manufacturer>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Manufacturer
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Manufacturer of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-vendor:
+
+<Vendor>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Vendor
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Vendor of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-model:
+
+<Model>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Model
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Model of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-serialnumber:
+
+<SerialNumber>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SerialNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Serial number of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-installationdate:
+
+<InstallationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstallationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was installed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-removaldate:
+
+<RemovalDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` RemovalDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was removed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _channel-equipment-calibrationdate:
+
+<CalibrationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Channel :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CalibrationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was calibrated
+
+
+
diff --git a/docs/level-network.rst b/docs/level-network.rst
new file mode 100644
index 0000000..eac0333
--- /dev/null
+++ b/docs/level-network.rst
@@ -0,0 +1,1235 @@
+.. Put any comments here
+
+  Warning, this file is regenerated from the annotations in the schema file.
+
+  Any changes will be overwritten by convert_xsd_to_rst.py.
+
+.. Auto-generated rst file from scan of fdsn xsd
+
+.. role:: blue
+.. role:: red
+.. role::  raw-html(raw)
+	:format: html
+.. role::  raw-latex(raw)
+	:format: latex
+
+.. _network:
+
+<Network>     :red:`required`
+============================================================
+.. container:: hatnote hatnote-gray
+
+   .. admonition:: Warning, Future Change
+
+      endDate: This attribute should not be used if it is in the future.
+
+   .. admonition:: Warning, Future Change
+
+      endDate: This attribute is likely to require timezone of Z.
+
+   .. admonition:: Warning, Future Change
+
+      startDate: This attribute is likely to require timezone of Z.
+
+   .. container:: description
+
+      The Network container. All station metadata for this network is contained within this element.
+      A Description element may be included with the official network name and other descriptive information.
+      An Identifier element may be included to designate a persistent identifier (e.g. DOI) to use for citation.
+      A Comment element may be included for additional comments.
+
+      An active Network should not use the endDate attribute.
+      Unlike SEED, do not use an endDate in the distant future to mean active.
+
+
+
+   .. container:: example
+
+      **Example**: <Network code="XX" startDate="2016-01-27T13:00:00Z" />
+
+
+
+
+   **Attributes of <Network>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **alternateCode**, :ref:`string<type-glossary>`, no, "A code used for display or association", "alternateCode=\"GSN\"" 
+      **code**, :ref:`string<type-glossary>`, :red:`yes`, "Name of Network", "code=\"XX\"" 
+      **endDate**, :ref:`dateTime<type-glossary>`, no, "End date of network. Do not use if still active, endDate should not be in the future.", "endDate=\"2018-01-27T00:00:00Z\"" 
+      **historicalCode**, :ref:`string<type-glossary>`, no, "A previously used code if different from the current code", "historicalCode=\"XX\"" 
+      **restrictedStatus**, :ref:`RestrictedStatusType<type-glossary>`, no, "One of: \"open\", \"closed\", \"partial\"", "restrictedStatus=\"open\"" 
+      **sourceID**, :ref:`anyURI<type-glossary>`, no, "A data source identifier in URI form. It is recommended that this follow the FDSN Source Identifiers specification, http://docs.fdsn.org/projects/source-identifiers", "sourceID=\"FDSN:XX\"" 
+      **startDate**, :ref:`dateTime<type-glossary>`, no, "Start date of network", "startDate=\"2016-07-01T00:00:00Z\"" 
+
+
+
+
+   **Sub Elements of <Network>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Network-Description>`, string, "optional" 
+      :ref:`\<Identifier\><Network-Identifier>`, string, "optional, many" 
+      :ref:`\<Comment\><Network-Comment>`, , "optional, many" 
+      :ref:`\<DataAvailability\><Network-DataAvailability>`, , "optional" 
+      :ref:`\<Operator\><Network-Operator>`, , "optional, many" 
+      :ref:`\<TotalNumberStations\><Network-TotalNumberStations>`, decimal, "optional" 
+      :ref:`\<SelectedNumberStations\><Network-SelectedNumberStations>`, decimal, "optional" 
+      :ref:`\<Station\><Station>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-description:
+
+<Description>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of the Network
+
+
+
+   .. container:: example
+
+      **Example**: <Description>This is a description</Description>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-identifier:
+
+<Identifier>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Identifier
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      A type to document persistent identifiers.
+      Identifier values should be specified without a URI scheme (prefix),
+      instead the identifier type is documented as an attribute.
+
+
+
+   .. container:: example
+
+      **Example**: <identifier type="DOI">10.1000/140</identifier>
+
+   .. container:: example
+
+      **Example**: <identifier type="DOI">10.7914/SN/XX</identifier>
+
+
+
+
+   **Attributes of <Identifier>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **type**, :ref:`string<type-glossary>`, no, "Identifier type", "type=\"DOI\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment:
+
+<Comment>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment
+
+   .. container:: description
+
+      Container for a comment or log entry.
+
+
+
+
+
+
+   **Attributes of <Comment>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **id**, :ref:`CounterType<type-glossary>`, no, "An ID for this comment", "id=\"12345\"" 
+      **subject**, :ref:`string<type-glossary>`, no, "A subject for this comment. Multiple comments with the same subject should be considered related.", "subject=\"Scheduled maintenance\"" 
+
+
+
+
+   **Sub Elements of <Comment>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Value\><Network-Comment-Value>`, string, ":red:`required`" 
+      :ref:`\<BeginEffectiveTime\><Network-Comment-BeginEffectiveTime>`, dateTime, "optional" 
+      :ref:`\<EndEffectiveTime\><Network-Comment-EndEffectiveTime>`, dateTime, "optional" 
+      :ref:`\<Author\><Network-Comment-Author>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-value:
+
+<Value>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Value
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Comment text.
+
+
+
+   .. container:: example
+
+      **Example**: <Value>Temporary network deployment</Value>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-begineffectivetime:
+
+<BeginEffectiveTime>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` BeginEffectiveTime
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Start time for when comment applies.
+
+
+
+   .. container:: example
+
+      **Example**: <BeginEffectiveTime>2008-09-15T00:00:00Z</BeginEffectiveTime>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-endeffectivetime:
+
+<EndEffectiveTime>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` EndEffectiveTime
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      End time for when comment applies.
+
+
+
+   .. container:: example
+
+      **Example**: <EndEffectiveTime>2008-09-16T12:00:00Z</EndEffectiveTime>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-author:
+
+<Author>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author
+
+   .. container:: description
+
+      Author of Comment.
+
+      Person's contact information. A person can belong
+      to multiple agencies and have multiple email addresses and phone numbers.
+
+
+
+
+
+
+   **Sub Elements of <Author>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Network-Comment-Author-Name>`, string, "optional, many" 
+      :ref:`\<Agency\><Network-Comment-Author-Agency>`, string, "optional, many" 
+      :ref:`\<Email\><Network-Comment-Author-Email>`, string, "optional, many" 
+      :ref:`\<Phone\><Network-Comment-Author-Phone>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-author-name:
+
+<Name>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Name of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Name>Dr. Jane Doe</Name>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-author-agency:
+
+<Agency>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Agency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Agency of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Agency>USGS</Agency>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-author-email:
+
+<Email>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Email
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Email of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Email>jane_doe@example.com</Email>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-author-phone:
+
+<Phone>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone
+
+   .. container:: description
+
+      Phone of contact or author
+
+
+
+
+
+
+   **Attributes of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **description**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+
+
+   **Sub Elements of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<CountryCode\><Network-Comment-Author-Phone-CountryCode>`, integer, "optional" 
+      :ref:`\<AreaCode\><Network-Comment-Author-Phone-AreaCode>`, integer, ":red:`required`" 
+      :ref:`\<PhoneNumber\><Network-Comment-Author-Phone-PhoneNumber>`, string, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-author-phone-countrycode:
+
+<CountryCode>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CountryCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone country code
+
+
+
+   .. container:: example
+
+      **Example**: <CountryCode>64</CountryCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-author-phone-areacode:
+
+<AreaCode>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` AreaCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone area code
+
+
+
+   .. container:: example
+
+      **Example**: <AreaCode>408</AreaCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-comment-author-phone-phonenumber:
+
+<PhoneNumber>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PhoneNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Telephone number
+
+
+
+   .. container:: example
+
+      **Example**: <PhoneNumber>5551212</PhoneNumber>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-dataavailability:
+
+<DataAvailability>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability
+
+   .. container:: description
+
+      A description of time series data availability. This
+      information should be considered transient and is primarily useful as a
+      guide for generating time series data requests. The information for a
+      DataAvailability:Span may be specific to the time range used in a request
+      that resulted in the document or limited to the availability of data within
+      the request range. These details may or may not be retained when
+      synchronizing metadata between data centers.
+
+      A type for describing data availability.
+
+
+
+
+
+
+   **Sub Elements of <DataAvailability>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Extent\><Network-DataAvailability-Extent>`, , "optional" 
+      :ref:`\<Span\><Network-DataAvailability-Span>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-dataavailability-extent:
+
+<Extent>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Extent
+
+   .. container:: description
+
+      Data availability extents, the earliest and
+      latest data available. No information about the continuity of the data
+      is included or implied.
+
+
+
+
+
+
+   **Attributes of <Extent>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **end**, :ref:`dateTime<type-glossary>`, :red:`yes`, "end date of extent", "end=\"1988-12-31T00:00:00Z\"" 
+      **start**, :ref:`dateTime<type-glossary>`, :red:`yes`, "start date of extent", "start=\"1988-01-01T00:00:00Z\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-dataavailability-span:
+
+<Span>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Span
+
+   .. container:: description
+
+      A type for describing data availability spans, with variable
+      continuity. The time range described may be based on the request parameters that
+      generated the document and not necessarily relate to continuity outside of the
+      range. It may also be a smaller time window than the request depending on the data
+      characteristics.
+
+
+
+
+
+
+   **Attributes of <Span>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **end**, :ref:`dateTime<type-glossary>`, :red:`yes`, "end date of span", "end=\"1988-12-31T00:00:00Z\"" 
+      **maximumTimeTear**, :ref:`decimal<type-glossary>`, no, "The maximum time tear (gap or overlap) in seconds between time series segments in the specified range.", "maximumTimeTear=\"0.01\"" 
+      **numberSegments**, :ref:`integer<type-glossary>`, :red:`yes`, "The number of continuous time series segments contained in the specified time range. A value of 1 indicates that the time series is continuous from start to end.", "numberSegments=\"2\"" 
+      **start**, :ref:`dateTime<type-glossary>`, :red:`yes`, "start date of span", "start=\"1988-01-01T00:00:00Z\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator:
+
+<Operator>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator
+
+   .. container:: description
+
+      Agency and contact persons who manage this network.
+
+      Since the Contact element is a generic type that represents any contact
+      person, it also has its own optional Agency element.
+      It is expected that typically the contact's optional Agency tag will match the Operator Agency.
+      Only contacts appropriate for the enclosing element should be included in the Operator tag.
+
+
+
+
+
+
+   **Sub Elements of <Operator>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Agency\><Network-Operator-Agency>`, string, ":red:`required`" 
+      :ref:`\<Contact\><Network-Operator-Contact>`, , "optional, many" 
+      :ref:`\<WebSite\><Network-Operator-WebSite>`, anyURI, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-agency:
+
+<Agency>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Agency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The operating agency.
+
+
+
+   .. container:: example
+
+      **Example**: <Agency>USGS</Agency>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-contact:
+
+<Contact>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact
+
+   .. container:: description
+
+      Person's contact information. A person can belong
+      to multiple agencies and have multiple email addresses and phone numbers.
+
+
+
+
+
+
+   **Sub Elements of <Contact>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Network-Operator-Contact-Name>`, string, "optional, many" 
+      :ref:`\<Agency\><Network-Operator-Contact-Agency>`, string, "optional, many" 
+      :ref:`\<Email\><Network-Operator-Contact-Email>`, string, "optional, many" 
+      :ref:`\<Phone\><Network-Operator-Contact-Phone>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-contact-name:
+
+<Name>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Name of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Name>Dr. Jane Doe</Name>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-contact-agency:
+
+<Agency>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Agency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Agency of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Agency>USGS</Agency>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-contact-email:
+
+<Email>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Email
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Email of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Email>jane_doe@example.com</Email>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-contact-phone:
+
+<Phone>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone
+
+   .. container:: description
+
+      Phone of contact or author
+
+
+
+
+
+
+   **Attributes of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **description**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+
+
+   **Sub Elements of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<CountryCode\><Network-Operator-Contact-Phone-CountryCode>`, integer, "optional" 
+      :ref:`\<AreaCode\><Network-Operator-Contact-Phone-AreaCode>`, integer, ":red:`required`" 
+      :ref:`\<PhoneNumber\><Network-Operator-Contact-Phone-PhoneNumber>`, string, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-contact-phone-countrycode:
+
+<CountryCode>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CountryCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone country code
+
+
+
+   .. container:: example
+
+      **Example**: <CountryCode>64</CountryCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-contact-phone-areacode:
+
+<AreaCode>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` AreaCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone area code
+
+
+
+   .. container:: example
+
+      **Example**: <AreaCode>408</AreaCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-contact-phone-phonenumber:
+
+<PhoneNumber>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PhoneNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Telephone number
+
+
+
+   .. container:: example
+
+      **Example**: <PhoneNumber>5551212</PhoneNumber>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-operator-website:
+
+<WebSite>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` WebSite
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`anyURI<type-glossary>`
+
+			.. only:: html
+
+					content type: `anyURI <appendices.html#glossary-anyuri>`_
+
+   .. container:: description
+
+      Website of operating agency
+
+
+
+   .. container:: example
+
+      **Example**: <WebSite>http://usgs.gov</WebSite>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-totalnumberstations:
+
+<TotalNumberStations>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` TotalNumberStations
+
+   .. admonition:: Warning, Future Change
+
+      <TotalNumberStations>: This element is likely to be removed.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`decimal<type-glossary>`
+
+					range: TotalNumberStations :math:`\ge` 0
+
+			.. only:: html
+
+					content type: `decimal <appendices.html#glossary-decimal>`_
+
+					range: TotalNumberStations :math:`\ge` 0
+
+   .. container:: description
+
+      The total number of stations in this
+      network, including inactive or terminated stations.
+
+
+
+   .. container:: example
+
+      **Example**: <TotalNumberStations>24</TotalNumberStations>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _network-selectednumberstations:
+
+<SelectedNumberStations>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Network :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SelectedNumberStations
+
+   .. admonition:: Warning, Future Change
+
+      <SelectedNumberStations>: This element is likely to be removed.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`decimal<type-glossary>`
+
+					range: SelectedNumberStations :math:`\ge` 0
+
+			.. only:: html
+
+					content type: `decimal <appendices.html#glossary-decimal>`_
+
+					range: SelectedNumberStations :math:`\ge` 0
+
+   .. container:: description
+
+      The number of stations selected in the request that resulted
+      in this document.
+
+
+
+   .. container:: example
+
+      **Example**: <SelectedNumberStations>12</SelectedNumberStations>
+
diff --git a/docs/level-preamble.rst b/docs/level-preamble.rst
new file mode 100644
index 0000000..7f87f06
--- /dev/null
+++ b/docs/level-preamble.rst
@@ -0,0 +1,236 @@
+.. Put any comments here
+
+  Warning, this file is regenerated from the annotations in the schema file.
+
+  Any changes will be overwritten by convert_xsd_to_rst.py.
+
+.. Auto-generated rst file from scan of fdsn xsd
+
+.. role:: blue
+.. role:: red
+.. role::  raw-html(raw)
+	:format: html
+.. role::  raw-latex(raw)
+	:format: latex
+
+.. _fdsnstationxml:
+
+<FDSNStationXML>     :red:`required`
+============================================================
+.. container:: hatnote hatnote-gray
+
+   .. admonition:: Warning, Future Change
+
+      schemaVersion: This attribute may change to be a string to allow micro versions, and potential dash, '-', separators starting in version 2. Users should not assume 'xs:decimal'.
+
+   .. container:: description
+
+      Root-level for StationXML documents.
+
+
+
+
+
+
+   **Attributes of <FDSNStationXML>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **schemaVersion**, :ref:`decimal<type-glossary>`, :red:`yes`, "The StationXML schema version of this document.", "schemaVersion=\"1.2\"" 
+
+
+
+
+   **Sub Elements of <FDSNStationXML>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Source\><FDSNStationXML-Source>`, string, ":red:`required`" 
+      :ref:`\<Sender\><FDSNStationXML-Sender>`, string, "optional" 
+      :ref:`\<Module\><FDSNStationXML-Module>`, string, "optional" 
+      :ref:`\<ModuleURI\><FDSNStationXML-ModuleURI>`, anyURI, "optional" 
+      :ref:`\<Created\><FDSNStationXML-Created>`, dateTime, ":red:`required`" 
+      :ref:`\<Network\><Network>`, , ":red:`required, many`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _fdsnstationxml-source:
+
+<Source>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      FDSNStationXML :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Source
+
+   .. admonition:: Warning, Future Change
+
+      <Source>: This element is likely to be a choice with Sender.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Originator of the information contained in the document.
+      It is recommended that archives or services providing StationXML that are not
+      the original creator of the metadata set this to be
+      the empty element, especially because a StationXML document may
+      contain information from many unrelated networks.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _fdsnstationxml-sender:
+
+<Sender>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      FDSNStationXML :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Sender
+
+   .. admonition:: Warning, Future Change
+
+      <Sender>: This element is likely to be a choice with Source.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Name of the institution sending this document,
+      for example the institution hosting an FDSN Station web service.
+      It is recommended that authoritative StationXML
+      created by the originator of the metadata not use Sender and
+      use Source instead. For example metadata created by a network
+      operator for submission to other data archives would only use Source,
+      The data archive in response to a request would use Sender.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _fdsnstationxml-module:
+
+<Module>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      FDSNStationXML :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Module
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Name of the software module that generated this document.
+
+
+
+   .. container:: example
+
+      **Example**: <Module>SeisComp3</Module>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _fdsnstationxml-moduleuri:
+
+<ModuleURI>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      FDSNStationXML :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ModuleURI
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`anyURI<type-glossary>`
+
+			.. only:: html
+
+					content type: `anyURI <appendices.html#glossary-anyuri>`_
+
+   .. container:: description
+
+      Resource identifier of the query that generated the document,
+      or, if applicable, the resource identifier of the software that generated this document.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _fdsnstationxml-created:
+
+<Created>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      FDSNStationXML :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Created
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date that this document was generated.
+
+
+
diff --git a/docs/level-response.rst b/docs/level-response.rst
new file mode 100644
index 0000000..d414a12
--- /dev/null
+++ b/docs/level-response.rst
@@ -0,0 +1,4042 @@
+.. Put any comments here
+
+  Warning, this file is regenerated from the annotations in the schema file.
+
+  Any changes will be overwritten by convert_xsd_to_rst.py.
+
+.. Auto-generated rst file from scan of fdsn xsd
+
+.. role:: blue
+.. role:: red
+.. role::  raw-html(raw)
+	:format: html
+.. role::  raw-latex(raw)
+	:format: latex
+
+.. _response:
+
+<Response>
+============================================================
+.. container:: hatnote hatnote-gray
+
+   .. container:: description
+
+      The complete instrument response for this channel that expresses the effect of the
+      geophysical instrumentation used to record the input ground motion.
+      The information can be used to convert raw data to Earth unit measurement at a specified
+      frequency or within a range of frequencies.
+      It is strongly suggested that either InstrumentSensitivity or InstrumentPolynomial should be present.
+
+      In cases where the response is unknown, for example really old channels,
+      or where a response is not applicable, like textual log channels,
+      it is preferred that an empty
+      response element be used, <response></response>,
+      to positively indicate that no response exists.
+
+
+
+
+
+
+   **Attributes of <Response>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **resourceId**, :ref:`string<type-glossary>`, no, "An identifier that serves to uniquely identify this resource. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that elements with the same ID should indicate the same information.", "" 
+
+
+
+
+   **Sub Elements of <Response>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<InstrumentSensitivity\><Response-InstrumentSensitivity>`, , "optional" 
+      :ref:`\<InstrumentPolynomial\><Response-InstrumentPolynomial>`, , "optional" 
+      :ref:`\<Stage\><Response-Stage>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity:
+
+<InstrumentSensitivity>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity
+
+   .. container:: description
+
+      The total sensitivity for a channel, representing the
+      complete acquisition system expressed as a scalar.
+      All instrument responses except polynomial response should have
+      an InstrumentSensitivity.
+
+      Type for sensitivity, input/output units and relevant frequency range.
+
+
+
+
+
+
+   **Sub Elements of <InstrumentSensitivity>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Value\><Response-InstrumentSensitivity-Value>`, double, ":red:`required`" 
+      :ref:`\<Frequency\><Response-InstrumentSensitivity-Frequency>`, double, ":red:`required`" 
+      :ref:`\<InputUnits\><Response-InstrumentSensitivity-InputUnits>`, , ":red:`required`" 
+      :ref:`\<OutputUnits\><Response-InstrumentSensitivity-OutputUnits>`, , ":red:`required`" 
+      :ref:`\<FrequencyStart\><Response-InstrumentSensitivity-FrequencyStart>`, double, "optional" 
+      :ref:`\<FrequencyEnd\><Response-InstrumentSensitivity-FrequencyEnd>`, double, "optional" 
+      :ref:`\<FrequencyDBVariation\><Response-InstrumentSensitivity-FrequencyDBVariation>`, double, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-value:
+
+<Value>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Value
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      A scalar value representing the amount of amplification or diminution, if any,
+      the current stage applies to the input signal.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-frequency:
+
+<Frequency>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Frequency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The frequency (in Hertz) at which the Value is valid.
+      
+      While any frequency in the passband is acceptable, it is preferred that:
+      
+      #. For low pass FIR filters, use gain at zero frequency (sum of coefficients)
+      #. If given, use manufacturer frequency/gain without recomputing
+      #. For anything else, frequency should be in the "good" part of the passband
+      #. All stage frequencies should be below the final Nyquist, as long as 2,3 are satisfied
+      #. All stages, except lowpass FIR filters, should use the same frequencies, as long as 2,3 are satisfied
+      #. Overall gain should also use the same frequency as 5, as long as it is below the final Nyquist and in the good part of the final passband
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-inputunits:
+
+<InputUnits>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits
+
+   .. container:: description
+
+      The units of the data as input to the sensor. For example
+      if stage 1 represented a seismometer, InputUnits would be 'm/s'
+      and OutputUnits would be 'V'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <InputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-InstrumentSensitivity-InputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-InstrumentSensitivity-InputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-inputunits-name:
+
+<Name>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-inputunits-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-outputunits:
+
+<OutputUnits>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits
+
+   .. container:: description
+
+      The units of the data as output from data
+      acquisition system. For most channels recorded by
+      systems that use an AtoD, the OutputUnits will be 'count'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <OutputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-InstrumentSensitivity-OutputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-InstrumentSensitivity-OutputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-outputunits-name:
+
+<Name>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-outputunits-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-frequencystart:
+
+<FrequencyStart>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FrequencyStart
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The lowest frequency for which the InstrumentSensitivity is valid.
+      <FrequencyStart>, <FrequencyEnd> and <FrequencyDBVariation> are not
+      required, however, if one of these is present, then all must be present.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-frequencyend:
+
+<FrequencyEnd>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FrequencyEnd
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The highest frequency for which the InstrumentSensitivity is valid.
+      <FrequencyStart>, <FrequencyEnd> and <FrequencyDBVariation> are not
+      required, however, if one of these is present, then all must be present.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentsensitivity-frequencydbvariation:
+
+<FrequencyDBVariation>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentSensitivity :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FrequencyDBVariation
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Variation in decibels within the specified frequency range.
+      <FrequencyStart>, <FrequencyEnd> and <FrequencyDBVariation> are not
+      required, however, if one of these is present, then all must be present.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial:
+
+<InstrumentPolynomial>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial
+
+   .. container:: description
+
+      For non-linear sensors (e.g., :math:`N\ge 2`), such as some thermistors,
+      pressure transducers, extensometers, etc.), it is required to
+      express the sensor input (e.g., Temp) as a Maclaurin series expansion of powers of the
+      *output* units (e.g., Volts):
+      
+      .. math::
+      
+        Temp(V)=\sum_{k=0}^{N} a_k V^{k}
+      
+      For such responses, two StationXML components are required to specify the response:
+      1. A Polynomial stage, which contains the values of the Maclaurin coefficients,
+      :math:`a_k`, and 2. An InstrumentPolynomial element that contains the
+      same coefficients, but scaled by powers of the overall gain representing the
+      combined effect of all the stages in the complete acquisition system.
+
+      Response type for a response represented as a polynomial expansion,
+      which allows non-linear sensors to be described. Used at either a stage of
+      acquisition response or a complete system.
+
+
+
+
+
+
+   **Attributes of <InstrumentPolynomial>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **name**, :ref:`string<type-glossary>`, no, "A name given to this filter.", "" 
+      **resourceId**, :ref:`string<type-glossary>`, no, "A resource identifier that serves to unique identify this filter or response. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that elements with the same resourceId should indicate the same information.", "" 
+
+
+
+
+   **Sub Elements of <InstrumentPolynomial>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Response-InstrumentPolynomial-Description>`, string, "optional" 
+      :ref:`\<InputUnits\><Response-InstrumentPolynomial-InputUnits>`, , ":red:`required`" 
+      :ref:`\<OutputUnits\><Response-InstrumentPolynomial-OutputUnits>`, , ":red:`required`" 
+      :ref:`\<ApproximationType\><Response-InstrumentPolynomial-ApproximationType>`, string, ":red:`required`" 
+      :ref:`\<FrequencyLowerBound\><Response-InstrumentPolynomial-FrequencyLowerBound>`, double, ":red:`required`" 
+      :ref:`\<FrequencyUpperBound\><Response-InstrumentPolynomial-FrequencyUpperBound>`, double, ":red:`required`" 
+      :ref:`\<ApproximationLowerBound\><Response-InstrumentPolynomial-ApproximationLowerBound>`, double, ":red:`required`" 
+      :ref:`\<ApproximationUpperBound\><Response-InstrumentPolynomial-ApproximationUpperBound>`, double, ":red:`required`" 
+      :ref:`\<MaximumError\><Response-InstrumentPolynomial-MaximumError>`, double, ":red:`required`" 
+      :ref:`\<Coefficient\><Response-InstrumentPolynomial-Coefficient>`, double, ":red:`required, many`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-description:
+
+<Description>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The description of the filter/stage/response
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-inputunits:
+
+<InputUnits>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits
+
+   .. container:: description
+
+      The units of the data as input from the previous stage. For example
+      if stage 1 represented a seismometer, InputUnits would be 'm/s'
+      and OutputUnits would be 'V'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <InputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-InstrumentPolynomial-InputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-InstrumentPolynomial-InputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-inputunits-name:
+
+<Name>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-inputunits-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-outputunits:
+
+<OutputUnits>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits
+
+   .. container:: description
+
+      The units of the data as output to the following stage. For example
+      if stage 2 represented the AtoD stage of a data logger,
+      InputUnits would be 'V'
+      and OutputUnits would be 'count'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <OutputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-InstrumentPolynomial-OutputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-InstrumentPolynomial-OutputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-outputunits-name:
+
+<Name>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-outputunits-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-approximationtype:
+
+<ApproximationType>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ApproximationType
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The series type for the polynomial approximation
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-frequencylowerbound:
+
+<FrequencyLowerBound>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FrequencyLowerBound
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The lower bound of the frequency range.
+
+
+
+
+
+
+   **Attributes of <FrequencyLowerBound>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be HERTZ, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-frequencyupperbound:
+
+<FrequencyUpperBound>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FrequencyUpperBound
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The upper bound of the frequency range.
+
+
+
+
+
+
+   **Attributes of <FrequencyUpperBound>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be HERTZ, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-approximationlowerbound:
+
+<ApproximationLowerBound>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ApproximationLowerBound
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The lower bound of the approximation range.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-approximationupperbound:
+
+<ApproximationUpperBound>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ApproximationUpperBound
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The upper bound of the approximation range.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-maximumerror:
+
+<MaximumError>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` MaximumError
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The maximum error of the approximation.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-instrumentpolynomial-coefficient:
+
+<Coefficient>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstrumentPolynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficient
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+
+
+
+   **Attributes of <Coefficient>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+      **number**, :ref:`CounterType<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage:
+
+<Stage>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage
+
+   .. admonition:: Warning, Future Change
+
+      <Stage>: A filter, (PolesZeros, Coefficients, FIR, etc) may be required.
+
+   .. container:: description
+
+      Type for channel response entry or stage.  A full response is
+      represented as an ordered sequence of these stages.
+
+      A filter, (PolesZeros, Coefficients, FIR, etc) is not required, but is
+      recommended to provide a place to store the input and output units
+      even in the case of "gain-only" stages.
+      
+      For an analog gain-only stage, use a PolesZeros filter with no poles
+      or zeros, PzTransferFunctionType=LAPLACE (RADIANS/SECOND)",
+      NormalizationFactor=1 and NormalizationFrequency=0.
+      
+      For a digital gain-only stage, use a FIR filter with one
+      numerator with value 1.0, and symmetry=NONE. While a digital Coefficients
+      filter can serve the same purpose and is common, the FIR filter is more concise.
+
+
+
+
+
+
+   **Attributes of <Stage>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **number**, :ref:`CounterType<type-glossary>`, :red:`yes`, "Stage sequence number. This is used in all the response blockettes. Start from name='1' and iterate sequentially.", "" 
+      **resourceId**, :ref:`string<type-glossary>`, no, "A resource identifier that serves to uniquely identify this response stage. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that equipment with the same ID should indicate the same information.", "" 
+
+
+
+
+   **Sub Elements of <Stage>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<PolesZeros\><Response-Stage-PolesZeros>`, , "optional" 
+      :ref:`\<Coefficients\><Response-Stage-Coefficients>`, , "optional" 
+      :ref:`\<ResponseList\><Response-Stage-ResponseList>`, , "optional" 
+      :ref:`\<FIR\><Response-Stage-FIR>`, , "optional" 
+      :ref:`\<Decimation\><Response-Stage-Decimation>`, , "optional" 
+      :ref:`\<StageGain\><Response-Stage-StageGain>`, , ":red:`required`" 
+      :ref:`\<Polynomial\><Response-Stage-Polynomial>`, , ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros:
+
+<PolesZeros>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros
+
+   .. container:: description
+
+      Response stage described by the complex poles and zeros of the Laplace Transform (or z-transform)
+      of the transfer function for this stage.
+
+
+
+
+
+
+   **Attributes of <PolesZeros>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **name**, :ref:`string<type-glossary>`, no, "A name given to this filter.", "" 
+      **resourceId**, :ref:`string<type-glossary>`, no, "A resource identifier that serves to unique identify this filter or response. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that elements with the same resourceId should indicate the same information.", "" 
+
+
+
+
+   **Sub Elements of <PolesZeros>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Response-Stage-PolesZeros-Description>`, string, "optional" 
+      :ref:`\<InputUnits\><Response-Stage-PolesZeros-InputUnits>`, , ":red:`required`" 
+      :ref:`\<OutputUnits\><Response-Stage-PolesZeros-OutputUnits>`, , ":red:`required`" 
+      :ref:`\<PzTransferFunctionType\><Response-Stage-PolesZeros-PzTransferFunctionType>`, string, ":red:`required`" 
+      :ref:`\<NormalizationFactor\><Response-Stage-PolesZeros-NormalizationFactor>`, double, ":red:`required`" 
+      :ref:`\<NormalizationFrequency\><Response-Stage-PolesZeros-NormalizationFrequency>`, double, ":red:`required`" 
+      :ref:`\<Zero\><Response-Stage-PolesZeros-Zero>`, , "optional, many" 
+      :ref:`\<Pole\><Response-Stage-PolesZeros-Pole>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The description of the filter/stage/response
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-inputunits:
+
+<InputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits
+
+   .. container:: description
+
+      The units of the data as input from the previous stage. For example
+      if stage 1 represented a seismometer, InputUnits would be 'm/s'
+      and OutputUnits would be 'V'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <InputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-PolesZeros-InputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-PolesZeros-InputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-inputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-inputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-outputunits:
+
+<OutputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits
+
+   .. container:: description
+
+      The units of the data as output to the following stage. For example
+      if stage 2 represented the AtoD stage of a data logger,
+      InputUnits would be 'V'
+      and OutputUnits would be 'count'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <OutputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-PolesZeros-OutputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-PolesZeros-OutputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-outputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-outputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-pztransferfunctiontype:
+
+<PzTransferFunctionType>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PzTransferFunctionType
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Allowable values are:"LAPLACE (RADIANS/SECOND)", "LAPLACE (HERTZ)", "DIGITAL (Z-TRANSFORM)".
+      For an analog stage this should be the units of the poles and zeros of
+      the Laplace Transform, either:
+      "LAPLACE (RADIANS/SECOND)" or "LAPLACE (HERTZ)".
+      For a digital z-transform (e.g., for an IIR filter), this should be
+      "DIGITAL (Z-TRANSFORM)"
+
+
+
+   .. container:: example
+
+      **Example**: <PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-normalizationfactor:
+
+<NormalizationFactor>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` NormalizationFactor
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Normalization scale factor
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-normalizationfrequency:
+
+<NormalizationFrequency>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` NormalizationFrequency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Frequency at which the NormalizationFactor is valid.
+      This should be the same for all stages and within the passband, if any.
+
+
+
+
+
+
+   **Attributes of <NormalizationFrequency>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be HERTZ, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-zero:
+
+<Zero>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Zero
+
+   .. container:: description
+
+      Complex zero of the polezero stage.
+
+
+
+
+
+
+   **Attributes of <Zero>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **number**, :ref:`integer<type-glossary>`, no, "The position index of the pole (or zero) in the array of poles[] (or zeros[])", "number=\"None\"" 
+
+
+
+
+   **Sub Elements of <Zero>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Real\><Response-Stage-PolesZeros-Zero-Real>`, double, ":red:`required`" 
+      :ref:`\<Imaginary\><Response-Stage-PolesZeros-Zero-Imaginary>`, double, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-zero-real:
+
+<Real>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Zero :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Real
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Real part of the complex number.
+
+      Representation of floating-point numbers without unit.
+
+
+
+
+
+
+   **Attributes of <Real>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-zero-imaginary:
+
+<Imaginary>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Zero :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Imaginary
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Imaginary part of the complex number.
+
+      Representation of floating-point numbers without unit.
+
+
+
+
+
+
+   **Attributes of <Imaginary>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-pole:
+
+<Pole>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Pole
+
+   .. container:: description
+
+      Complex pole of the polezero stage.
+
+
+
+
+
+
+   **Attributes of <Pole>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **number**, :ref:`integer<type-glossary>`, no, "The position index of the pole (or zero) in the array of poles[] (or zeros[])", "number=\"None\"" 
+
+
+
+
+   **Sub Elements of <Pole>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Real\><Response-Stage-PolesZeros-Pole-Real>`, double, ":red:`required`" 
+      :ref:`\<Imaginary\><Response-Stage-PolesZeros-Pole-Imaginary>`, double, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-pole-real:
+
+<Real>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Pole :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Real
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Real part of the complex number.
+
+      Representation of floating-point numbers without unit.
+
+
+
+
+
+
+   **Attributes of <Real>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-poleszeros-pole-imaginary:
+
+<Imaginary>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PolesZeros :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Pole :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Imaginary
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Imaginary part of the complex number.
+
+      Representation of floating-point numbers without unit.
+
+
+
+
+
+
+   **Attributes of <Imaginary>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients:
+
+<Coefficients>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients
+
+   .. admonition:: Warning, Future Change
+
+      <Coefficients>: The Numerator element is likely to be changed to require at least one numerator.
+
+   .. container:: description
+
+      Response type for filter giving coefficients. Laplace transforms or analog
+      filters can both be expressed using this type as well but the PolesZeros should be used
+      instead. Digital filters with no denominator should use FIR instead.
+
+
+
+
+
+
+   **Attributes of <Coefficients>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **name**, :ref:`string<type-glossary>`, no, "A name given to this filter.", "" 
+      **resourceId**, :ref:`string<type-glossary>`, no, "A resource identifier that serves to unique identify this filter or response. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that elements with the same resourceId should indicate the same information.", "" 
+
+
+
+
+   **Sub Elements of <Coefficients>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Response-Stage-Coefficients-Description>`, string, "optional" 
+      :ref:`\<InputUnits\><Response-Stage-Coefficients-InputUnits>`, , ":red:`required`" 
+      :ref:`\<OutputUnits\><Response-Stage-Coefficients-OutputUnits>`, , ":red:`required`" 
+      :ref:`\<CfTransferFunctionType\><Response-Stage-Coefficients-CfTransferFunctionType>`, string, ":red:`required`" 
+      :ref:`\<Numerator\><Response-Stage-Coefficients-Numerator>`, double, "optional, many" 
+      :ref:`\<Denominator\><Response-Stage-Coefficients-Denominator>`, double, "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The description of the filter/stage/response
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-inputunits:
+
+<InputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits
+
+   .. container:: description
+
+      The units of the data as input from the previous stage. For example
+      if stage 1 represented a seismometer, InputUnits would be 'm/s'
+      and OutputUnits would be 'V'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <InputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-Coefficients-InputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-Coefficients-InputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-inputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-inputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-outputunits:
+
+<OutputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits
+
+   .. container:: description
+
+      The units of the data as output to the following stage. For example
+      if stage 2 represented the AtoD stage of a data logger,
+      InputUnits would be 'V'
+      and OutputUnits would be 'count'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <OutputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-Coefficients-OutputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-Coefficients-OutputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-outputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-outputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-cftransferfunctiontype:
+
+<CfTransferFunctionType>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CfTransferFunctionType
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Almost always a digital response, but can be an
+      analog response in rad/sec or Hertz.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-numerator:
+
+<Numerator>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Numerator
+
+   .. admonition:: Warning, Future Change
+
+      <Numerator>: At least one Numerator may be required.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Numerator for the coefficient. Should include at least one.
+
+
+
+
+
+
+   **Attributes of <Numerator>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+      **number**, :ref:`CounterType<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-coefficients-denominator:
+
+<Denominator>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficients :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Denominator
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Denominator for the coefficient
+
+
+
+
+
+
+   **Attributes of <Denominator>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+      **number**, :ref:`CounterType<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist:
+
+<ResponseList>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList
+
+   .. container:: description
+
+      Response type for a list of frequency, amplitude, and phase values.
+      Because it is less flexible, the other filter types, PolesZeros,
+      Coefficients, FIR, etc, are preferred.
+
+
+
+
+
+
+   **Attributes of <ResponseList>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **name**, :ref:`string<type-glossary>`, no, "A name given to this filter.", "" 
+      **resourceId**, :ref:`string<type-glossary>`, no, "A resource identifier that serves to unique identify this filter or response. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that elements with the same resourceId should indicate the same information.", "" 
+
+
+
+
+   **Sub Elements of <ResponseList>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Response-Stage-ResponseList-Description>`, string, "optional" 
+      :ref:`\<InputUnits\><Response-Stage-ResponseList-InputUnits>`, , ":red:`required`" 
+      :ref:`\<OutputUnits\><Response-Stage-ResponseList-OutputUnits>`, , ":red:`required`" 
+      :ref:`\<ResponseListElement\><Response-Stage-ResponseList-ResponseListElement>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The description of the filter/stage/response
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-inputunits:
+
+<InputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits
+
+   .. container:: description
+
+      The units of the data as input from the previous stage. For example
+      if stage 1 represented a seismometer, InputUnits would be 'm/s'
+      and OutputUnits would be 'V'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <InputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-ResponseList-InputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-ResponseList-InputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-inputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-inputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-outputunits:
+
+<OutputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits
+
+   .. container:: description
+
+      The units of the data as output to the following stage. For example
+      if stage 2 represented the AtoD stage of a data logger,
+      InputUnits would be 'V'
+      and OutputUnits would be 'count'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <OutputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-ResponseList-OutputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-ResponseList-OutputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-outputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-outputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-responselistelement:
+
+<ResponseListElement>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseListElement
+
+
+
+
+   **Sub Elements of <ResponseListElement>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Frequency\><Response-Stage-ResponseList-ResponseListElement-Frequency>`, double, ":red:`required`" 
+      :ref:`\<Amplitude\><Response-Stage-ResponseList-ResponseListElement-Amplitude>`, double, ":red:`required`" 
+      :ref:`\<Phase\><Response-Stage-ResponseList-ResponseListElement-Phase>`, double, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-responselistelement-frequency:
+
+<Frequency>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseListElement :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Frequency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+
+
+
+   **Attributes of <Frequency>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be HERTZ, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-responselistelement-amplitude:
+
+<Amplitude>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseListElement :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Amplitude
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+
+
+
+   **Attributes of <Amplitude>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The unit of measurement. Use *SI* unit names and symbols whenever possible (e.g., 'm' instead of 'METERS').", "unit=\"m\"" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-responselist-responselistelement-phase:
+
+<Phase>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseList :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ResponseListElement :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phase
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+					range: -360.0 :math:`\le` Phase :math:`\le` 360.0
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+					range: -360.0 :math:`\le` Phase :math:`\le` 360.0
+
+
+
+
+   **Attributes of <Phase>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be DEGREES, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir:
+
+<FIR>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR
+
+   .. admonition:: Warning, Future Change
+
+      <FIR>: The NumeratorCoefficient field is likely to be changed to require at least one numerator in future versions of StationXML.
+
+   .. admonition:: Warning, Future Change
+
+      <FIR>: The NumeratorCoefficient field is likely to be renamed to Numerator in future versions of StationXML.
+
+   .. container:: description
+
+      Response type for FIR filter.  FIR filters
+      are also commonly documented using a digital Coefficients element with no
+      denominators, but it is preferred to use this type
+      allowing representation of symmetric FIR coefficients without repeating them.
+
+
+
+
+
+
+   **Attributes of <FIR>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **name**, :ref:`string<type-glossary>`, no, "A name given to this filter.", "" 
+      **resourceId**, :ref:`string<type-glossary>`, no, "A resource identifier that serves to unique identify this filter or response. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that elements with the same resourceId should indicate the same information.", "" 
+
+
+
+
+   **Sub Elements of <FIR>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Response-Stage-FIR-Description>`, string, "optional" 
+      :ref:`\<InputUnits\><Response-Stage-FIR-InputUnits>`, , ":red:`required`" 
+      :ref:`\<OutputUnits\><Response-Stage-FIR-OutputUnits>`, , ":red:`required`" 
+      :ref:`\<Symmetry\><Response-Stage-FIR-Symmetry>`, string, ":red:`required`" 
+      :ref:`\<NumeratorCoefficient\><Response-Stage-FIR-NumeratorCoefficient>`, double, "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The description of the filter/stage/response
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-inputunits:
+
+<InputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits
+
+   .. container:: description
+
+      The units of the data as input from the previous stage. For example
+      if stage 1 represented a seismometer, InputUnits would be 'm/s'
+      and OutputUnits would be 'V'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <InputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-FIR-InputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-FIR-InputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-inputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-inputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-outputunits:
+
+<OutputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits
+
+   .. container:: description
+
+      The units of the data as output to the following stage. For example
+      if stage 2 represented the AtoD stage of a data logger,
+      InputUnits would be 'V'
+      and OutputUnits would be 'count'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <OutputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-FIR-OutputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-FIR-OutputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-outputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-outputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-symmetry:
+
+<Symmetry>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Symmetry
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The symmetry code. Designates how the factors will be specified.
+      
+      * NONE: No Symmetry - all Coefficients are specified, corresponds to A in SEED.
+      * ODD: Odd number Coefficients with symmetry, B in SEED.
+      * EVEN: Even number Coefficients with symmetry, C in SEED.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-fir-numeratorcoefficient:
+
+<NumeratorCoefficient>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FIR :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` NumeratorCoefficient
+
+   .. admonition:: Warning, Future Change
+
+      <NumeratorCoefficient>: At least one Numerator may be required.
+
+   .. admonition:: Warning, Future Change
+
+      <NumeratorCoefficient>: May be renamed to Numerator.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The coefficients of the FIR filter. Should include at least one.
+
+
+
+
+
+
+   **Attributes of <NumeratorCoefficient>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **i**, :ref:`integer<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-decimation:
+
+<Decimation>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Decimation
+
+   .. container:: description
+
+      Representation of decimation stage
+
+
+
+
+
+
+   **Sub Elements of <Decimation>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<InputSampleRate\><Response-Stage-Decimation-InputSampleRate>`, double, ":red:`required`" 
+      :ref:`\<Factor\><Response-Stage-Decimation-Factor>`, integer, ":red:`required`" 
+      :ref:`\<Offset\><Response-Stage-Decimation-Offset>`, integer, ":red:`required`" 
+      :ref:`\<Delay\><Response-Stage-Decimation-Delay>`, double, ":red:`required`" 
+      :ref:`\<Correction\><Response-Stage-Decimation-Correction>`, double, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-decimation-inputsamplerate:
+
+<InputSampleRate>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Decimation :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputSampleRate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+
+
+
+   **Attributes of <InputSampleRate>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be HERTZ, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-decimation-factor:
+
+<Factor>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Decimation :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Factor
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      The factor of the input sample rate by which the rate is reduced.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-decimation-offset:
+
+<Offset>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Decimation :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Offset
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Sample offset chosen for use. The value should be greater than or equal to zero,
+      but less than the decimation factor. If the first sample is used, set this field to zero.
+      If the second sample, set it to 1, and so forth.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-decimation-delay:
+
+<Delay>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Decimation :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Delay
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The estimated pure delay for the stage. This value will almost always be positive
+      to indicate a delayed signal. Due to the difficulty in estimating the pure delay
+      of a stage and because dispersion is neglected, this value should be
+      considered nominal.  Normally the delay would be corrected by the
+      recording system and the correction applied would be specified in <Correction> below.
+      See the Decimation Section in the StationXML documentation for a schematic description of delay sign convention.
+
+
+
+
+
+
+   **Attributes of <Delay>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The unit of measurement. Use *SI* unit names and symbols whenever possible (e.g., 'm' instead of 'METERS').", "unit=\"s\"" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-decimation-correction:
+
+<Correction>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Decimation :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Correction
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The time shift, if any, applied to correct for the delay at this stage.
+      The sign convention used is opposite the <Delay> value; a positive sign here
+      indicates that the trace was corrected to an earlier time to cancel the
+      delay caused by the stage and indicated in the <Delay> element.
+      Commonly, the estimated delay and the applied correction are both positive to cancel
+      each other.  A value of zero indicates no correction was applied.
+      See the Decimation Section in the StationXML documentation for a schematic description of delay sign convention.
+
+
+
+
+
+
+   **Attributes of <Correction>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The unit of measurement. Use *SI* unit names and symbols whenever possible (e.g., 'm' instead of 'METERS').", "unit=\"s\"" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-stagegain:
+
+<StageGain>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` StageGain
+
+   .. container:: description
+
+      The gain at the stage of the encapsulating
+      response element at a specific frequency.
+      Total channel sensitivity should be specified in the InstrumentSensitivity
+      element.
+
+      Type used for representing sensitivity at a given frequency. This complex type
+      can be used to represent both total sensitivities and individual stage gains.
+
+
+
+
+
+
+   **Sub Elements of <StageGain>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Value\><Response-Stage-StageGain-Value>`, double, ":red:`required`" 
+      :ref:`\<Frequency\><Response-Stage-StageGain-Frequency>`, double, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-stagegain-value:
+
+<Value>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` StageGain :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Value
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      A scalar value representing the amount of amplification or diminution, if any,
+      the current stage applies to the input signal.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-stagegain-frequency:
+
+<Frequency>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` StageGain :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Frequency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The frequency (in Hertz) at which the Value is valid.
+      
+      While any frequency in the passband is acceptable, it is preferred that:
+      
+      #. For low pass FIR filters, use gain at zero frequency (sum of coefficients)
+      #. If given, use manufacturer frequency/gain without recomputing
+      #. For anything else, frequency should be in the "good" part of the passband
+      #. All stage frequencies should be below the final Nyquist, as long as 2,3 are satisfied
+      #. All stages, except lowpass FIR filters, should use the same frequencies, as long as 2,3 are satisfied
+      #. Overall gain should also use the same frequency as 5, as long as it is below the final Nyquist and in the good part of the final passband
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial:
+
+<Polynomial>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial
+
+   .. container:: description
+
+      When a response is given in terms of a polynomial expansion of
+      powers of the sensor output signal (e.g., Volts), a Polynomial stage is
+      required to specify the Maclaurin coefficients of the expansion.
+      
+      In addition, an InstrumentPolynomial element must be present at Response level
+      to represent the whole acquisition process, which contains the same Maclaurin
+      coefficients, but scaled by powers of the overall gain for all stages.
+
+      Response type for a response represented as a polynomial expansion,
+      which allows non-linear sensors to be described. Used at either a stage of
+      acquisition response or a complete system.
+
+
+
+
+
+
+   **Attributes of <Polynomial>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **name**, :ref:`string<type-glossary>`, no, "A name given to this filter.", "" 
+      **resourceId**, :ref:`string<type-glossary>`, no, "A resource identifier that serves to unique identify this filter or response. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that elements with the same resourceId should indicate the same information.", "" 
+
+
+
+
+   **Sub Elements of <Polynomial>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Response-Stage-Polynomial-Description>`, string, "optional" 
+      :ref:`\<InputUnits\><Response-Stage-Polynomial-InputUnits>`, , ":red:`required`" 
+      :ref:`\<OutputUnits\><Response-Stage-Polynomial-OutputUnits>`, , ":red:`required`" 
+      :ref:`\<ApproximationType\><Response-Stage-Polynomial-ApproximationType>`, string, ":red:`required`" 
+      :ref:`\<FrequencyLowerBound\><Response-Stage-Polynomial-FrequencyLowerBound>`, double, ":red:`required`" 
+      :ref:`\<FrequencyUpperBound\><Response-Stage-Polynomial-FrequencyUpperBound>`, double, ":red:`required`" 
+      :ref:`\<ApproximationLowerBound\><Response-Stage-Polynomial-ApproximationLowerBound>`, double, ":red:`required`" 
+      :ref:`\<ApproximationUpperBound\><Response-Stage-Polynomial-ApproximationUpperBound>`, double, ":red:`required`" 
+      :ref:`\<MaximumError\><Response-Stage-Polynomial-MaximumError>`, double, ":red:`required`" 
+      :ref:`\<Coefficient\><Response-Stage-Polynomial-Coefficient>`, double, ":red:`required, many`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-description:
+
+<Description>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The description of the filter/stage/response
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-inputunits:
+
+<InputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits
+
+   .. container:: description
+
+      The units of the data as input from the previous stage. For example
+      if stage 1 represented a seismometer, InputUnits would be 'm/s'
+      and OutputUnits would be 'V'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <InputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-Polynomial-InputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-Polynomial-InputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-inputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-inputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-outputunits:
+
+<OutputUnits>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits
+
+   .. container:: description
+
+      The units of the data as output to the following stage. For example
+      if stage 2 represented the AtoD stage of a data logger,
+      InputUnits would be 'V'
+      and OutputUnits would be 'count'.
+
+      A type to document units; use SI whenever possible.
+
+
+
+
+
+
+   **Sub Elements of <OutputUnits>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Response-Stage-Polynomial-OutputUnits-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Response-Stage-Polynomial-OutputUnits-Description>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-outputunits-name:
+
+<Name>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+      Use SI whenever possible, along with singular lowercase
+      "count" for digital counts.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-outputunits-description:
+
+<Description>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` OutputUnits :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of units, e.g. "Velocity in meters per second",
+      "Volts", "Pascals", "Degrees Celsius".
+      Description is only needed when the unit name is not a well know
+      SI unit or there is need for clarification. Prefer not to use a
+      Description for common units like `m/s`, `m/s**2`, `count`, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-approximationtype:
+
+<ApproximationType>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ApproximationType
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The series type for the polynomial approximation
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-frequencylowerbound:
+
+<FrequencyLowerBound>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FrequencyLowerBound
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The lower bound of the frequency range.
+
+
+
+
+
+
+   **Attributes of <FrequencyLowerBound>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be HERTZ, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-frequencyupperbound:
+
+<FrequencyUpperBound>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` FrequencyUpperBound
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The upper bound of the frequency range.
+
+
+
+
+
+
+   **Attributes of <FrequencyUpperBound>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be HERTZ, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-approximationlowerbound:
+
+<ApproximationLowerBound>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ApproximationLowerBound
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The lower bound of the approximation range.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-approximationupperbound:
+
+<ApproximationUpperBound>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ApproximationUpperBound
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The upper bound of the approximation range.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-maximumerror:
+
+<MaximumError>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` MaximumError
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      The maximum error of the approximation.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _response-stage-polynomial-coefficient:
+
+<Coefficient>     :red:`required`
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Response :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Stage :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Polynomial :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Coefficient
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+
+
+
+   **Attributes of <Coefficient>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+      **number**, :ref:`CounterType<type-glossary>`, no, "", "" 
+
diff --git a/docs/level-station.rst b/docs/level-station.rst
new file mode 100644
index 0000000..8f72e71
--- /dev/null
+++ b/docs/level-station.rst
@@ -0,0 +1,2242 @@
+.. Put any comments here
+
+  Warning, this file is regenerated from the annotations in the schema file.
+
+  Any changes will be overwritten by convert_xsd_to_rst.py.
+
+.. Auto-generated rst file from scan of fdsn xsd
+
+.. role:: blue
+.. role:: red
+.. role::  raw-html(raw)
+	:format: html
+.. role::  raw-latex(raw)
+	:format: latex
+
+.. _station:
+
+<Station>
+============================================================
+.. container:: hatnote hatnote-gray
+
+   .. admonition:: Warning, Future Change
+
+      endDate: This attribute should not be used if it is in the future.
+
+   .. admonition:: Warning, Future Change
+
+      endDate: This attribute is likely to require timezone of Z.
+
+   .. admonition:: Warning, Future Change
+
+      startDate: This attribute is likely to require timezone of Z.
+
+   .. container:: description
+
+      The Station container. All channel metadata for this station is contained within this element.
+      A Description element may be included with the official station name and other descriptive information.
+      An Identifier element may be included to designate a persistent identifier (e.g. DOI) to use for citation or reference.
+      A Comment element may be included for additional comments.
+
+      An active Station should not use the endDate attribute.
+      Unlike SEED, do not use an endDate in the distant future to mean active.
+
+
+
+
+
+
+   **Attributes of <Station>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **alternateCode**, :ref:`string<type-glossary>`, no, "A code used for display or association", "alternateCode=\"ALQ\"" 
+      **code**, :ref:`string<type-glossary>`, :red:`yes`, "Name of Station", "code=\"ABCD\"" 
+      **endDate**, :ref:`dateTime<type-glossary>`, no, "End date of station epoch. Do not use if still active, endDate should not be in the future.", "endDate=\"2018-01-27T00:00:00Z\"" 
+      **historicalCode**, :ref:`string<type-glossary>`, no, "A previously used code if different from the current code", "historicalCode=\"albq\"" 
+      **restrictedStatus**, :ref:`RestrictedStatusType<type-glossary>`, no, "One of: \"open\", \"closed\", \"partial\"", "restrictedStatus=\"open\"" 
+      **sourceID**, :ref:`anyURI<type-glossary>`, no, "A data source identifier in URI form. It is recommended that this follow the FDSN Source Identifiers specification, http://docs.fdsn.org/projects/source-identifiers", "sourceID=\"FDSN:XX_ABCD\"" 
+      **startDate**, :ref:`dateTime<type-glossary>`, no, "Start date of station epoch", "startDate=\"2016-07-01T00:00:00Z\"" 
+
+
+
+
+   **Sub Elements of <Station>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Description\><Station-Description>`, string, "optional" 
+      :ref:`\<Identifier\><Station-Identifier>`, string, "optional, many" 
+      :ref:`\<Comment\><Station-Comment>`, , "optional, many" 
+      :ref:`\<DataAvailability\><Station-DataAvailability>`, , "optional" 
+      :ref:`\<Latitude\><Station-Latitude>`, double, ":red:`required`" 
+      :ref:`\<Longitude\><Station-Longitude>`, double, ":red:`required`" 
+      :ref:`\<Elevation\><Station-Elevation>`, double, ":red:`required`" 
+      :ref:`\<Site\><Station-Site>`, , ":red:`required`" 
+      :ref:`\<WaterLevel\><Station-WaterLevel>`, double, "optional" 
+      :ref:`\<Vault\><Station-Vault>`, string, "optional" 
+      :ref:`\<Geology\><Station-Geology>`, string, "optional" 
+      :ref:`\<Equipment\><Station-Equipment>`, , "optional, many" 
+      :ref:`\<Operator\><Station-Operator>`, , "optional, many" 
+      :ref:`\<CreationDate\><Station-CreationDate>`, dateTime, "optional" 
+      :ref:`\<TerminationDate\><Station-TerminationDate>`, dateTime, "optional" 
+      :ref:`\<TotalNumberChannels\><Station-TotalNumberChannels>`, decimal, "optional" 
+      :ref:`\<SelectedNumberChannels\><Station-SelectedNumberChannels>`, decimal, "optional" 
+      :ref:`\<ExternalReference\><Station-ExternalReference>`, , "optional, many" 
+      :ref:`\<Channel\><Channel>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-description:
+
+<Description>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of the Station
+
+
+
+   .. container:: example
+
+      **Example**: <Description>This is a description</Description>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-identifier:
+
+<Identifier>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Identifier
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      A type to document persistent identifiers.
+      Identifier values should be specified without a URI scheme (prefix),
+      instead the identifier type is documented as an attribute.
+
+
+
+   .. container:: example
+
+      **Example**: <identifier type="DOI">10.1000/140</identifier>
+
+   .. container:: example
+
+     **Example**: <identifier type="DOI">10.5555/12345678</identifier>ABCD.
+
+
+
+
+   **Attributes of <Identifier>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **type**, :ref:`string<type-glossary>`, no, "Identifier type", "type=\"DOI\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment:
+
+<Comment>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment
+
+   .. container:: description
+
+      Container for a comment or log entry.
+
+
+
+
+
+
+   **Attributes of <Comment>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **id**, :ref:`CounterType<type-glossary>`, no, "An ID for this comment", "id=\"12345\"" 
+      **subject**, :ref:`string<type-glossary>`, no, "A subject for this comment. Multiple comments with the same subject should be considered related.", "subject=\"Scheduled maintenance\"" 
+
+
+
+
+   **Sub Elements of <Comment>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Value\><Station-Comment-Value>`, string, ":red:`required`" 
+      :ref:`\<BeginEffectiveTime\><Station-Comment-BeginEffectiveTime>`, dateTime, "optional" 
+      :ref:`\<EndEffectiveTime\><Station-Comment-EndEffectiveTime>`, dateTime, "optional" 
+      :ref:`\<Author\><Station-Comment-Author>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-value:
+
+<Value>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Value
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Comment text.
+
+
+
+   .. container:: example
+
+      **Example**: <Value>GPS Clock is unlocked</Value>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-begineffectivetime:
+
+<BeginEffectiveTime>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` BeginEffectiveTime
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Start time for when comment applies.
+
+
+
+   .. container:: example
+
+      **Example**: <BeginEffectiveTime>2008-09-15T00:00:00Z</BeginEffectiveTime>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-endeffectivetime:
+
+<EndEffectiveTime>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` EndEffectiveTime
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      End time for when comment applies.
+
+
+
+   .. container:: example
+
+      **Example**: <EndEffectiveTime>2008-09-16T12:00:00Z</EndEffectiveTime>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-author:
+
+<Author>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author
+
+   .. container:: description
+
+      Author of Comment.
+
+      Person's contact information. A person can belong
+      to multiple agencies and have multiple email addresses and phone numbers.
+
+
+
+
+
+
+   **Sub Elements of <Author>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Station-Comment-Author-Name>`, string, "optional, many" 
+      :ref:`\<Agency\><Station-Comment-Author-Agency>`, string, "optional, many" 
+      :ref:`\<Email\><Station-Comment-Author-Email>`, string, "optional, many" 
+      :ref:`\<Phone\><Station-Comment-Author-Phone>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-author-name:
+
+<Name>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Name of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Name>Dr. Jane Doe</Name>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-author-agency:
+
+<Agency>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Agency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Agency of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Agency>USGS</Agency>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-author-email:
+
+<Email>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Email
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Email of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Email>jane_doe@example.com</Email>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-author-phone:
+
+<Phone>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone
+
+   .. container:: description
+
+      Phone of contact or author
+
+
+
+
+
+
+   **Attributes of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **description**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+
+
+   **Sub Elements of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<CountryCode\><Station-Comment-Author-Phone-CountryCode>`, integer, "optional" 
+      :ref:`\<AreaCode\><Station-Comment-Author-Phone-AreaCode>`, integer, ":red:`required`" 
+      :ref:`\<PhoneNumber\><Station-Comment-Author-Phone-PhoneNumber>`, string, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-author-phone-countrycode:
+
+<CountryCode>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CountryCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone country code
+
+
+
+   .. container:: example
+
+      **Example**: <CountryCode>64</CountryCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-author-phone-areacode:
+
+<AreaCode>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` AreaCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone area code
+
+
+
+   .. container:: example
+
+      **Example**: <AreaCode>408</AreaCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-comment-author-phone-phonenumber:
+
+<PhoneNumber>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Comment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Author :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PhoneNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Telephone number
+
+
+
+   .. container:: example
+
+      **Example**: <PhoneNumber>5551212</PhoneNumber>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-dataavailability:
+
+<DataAvailability>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability
+
+   .. container:: description
+
+      A description of time series data availability. This
+      information should be considered transient and is primarily useful as a
+      guide for generating time series data requests. The information for a
+      DataAvailability:Span may be specific to the time range used in a request
+      that resulted in the document or limited to the availability of data within
+      the request range. These details may or may not be retained when
+      synchronizing metadata between data centers.
+
+      A type for describing data availability.
+
+
+
+
+
+
+   **Sub Elements of <DataAvailability>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Extent\><Station-DataAvailability-Extent>`, , "optional" 
+      :ref:`\<Span\><Station-DataAvailability-Span>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-dataavailability-extent:
+
+<Extent>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Extent
+
+   .. container:: description
+
+      Data availability extents, the earliest and
+      latest data available. No information about the continuity of the data
+      is included or implied.
+
+
+
+
+
+
+   **Attributes of <Extent>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **end**, :ref:`dateTime<type-glossary>`, :red:`yes`, "end date of extent", "end=\"1988-12-31T00:00:00Z\"" 
+      **start**, :ref:`dateTime<type-glossary>`, :red:`yes`, "start date of extent", "start=\"1988-01-01T00:00:00Z\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-dataavailability-span:
+
+<Span>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` DataAvailability :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Span
+
+   .. container:: description
+
+      A type for describing data availability spans, with variable
+      continuity. The time range described may be based on the request parameters that
+      generated the document and not necessarily relate to continuity outside of the
+      range. It may also be a smaller time window than the request depending on the data
+      characteristics.
+
+
+
+
+
+
+   **Attributes of <Span>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **end**, :ref:`dateTime<type-glossary>`, :red:`yes`, "end date of span", "end=\"1988-12-31T00:00:00Z\"" 
+      **maximumTimeTear**, :ref:`decimal<type-glossary>`, no, "The maximum time tear (gap or overlap) in seconds between time series segments in the specified range.", "maximumTimeTear=\"0.01\"" 
+      **numberSegments**, :ref:`integer<type-glossary>`, :red:`yes`, "The number of continuous time series segments contained in the specified time range. A value of 1 indicates that the time series is continuous from start to end.", "numberSegments=\"2\"" 
+      **start**, :ref:`dateTime<type-glossary>`, :red:`yes`, "start date of span", "start=\"1988-01-01T00:00:00Z\"" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-latitude:
+
+<Latitude>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Latitude
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+					range: -90.0 :math:`\le` Latitude :math:`\lt` 90.0
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+					range: -90.0 :math:`\le` Latitude :math:`\lt` 90.0
+
+   .. container:: description
+
+      Station latitude, in degrees. Where the bulk of the equipment is located (or another appropriate site location).
+      The unit is fixed to be degrees, and datum defaults to WGS84.
+
+      Latitude type extending the base type to add datum as an attribute with default.
+
+
+
+   .. container:: example
+
+      **Example**: <Latitude>34.9459</Latitude>
+
+
+
+
+   **Attributes of <Latitude>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be DEGREES, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+      **datum**, :ref:`NMTOKEN<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-longitude:
+
+<Longitude>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Longitude
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+					range: -180.0 :math:`\le` Longitude :math:`\le` 180.0
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+					range: -180.0 :math:`\le` Longitude :math:`\le` 180.0
+
+   .. container:: description
+
+      Station longitude, in degrees. Where the bulk of the equipment is located (or another appropriate site location).
+      The unit is fixed to be degrees, and datum defaults to WGS84.
+
+      Longitude type extending the base type to add datum as an attribute with default.
+
+
+
+   .. container:: example
+
+      **Example**: <Longitude>-106.4572</Longitude>
+
+
+
+
+   **Attributes of <Longitude>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be DEGREES, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+      **datum**, :ref:`NMTOKEN<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-elevation:
+
+<Elevation>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Elevation
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Elevation of local ground surface level at station, in meters.
+
+
+
+   .. container:: example
+
+      **Example**: <Elevation>1850.0</Elevation>
+
+
+
+
+   **Attributes of <Elevation>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The type of unit being used. This value is fixed to be METERS, setting it is redundant.", "" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-site:
+
+<Site>     :red:`required`
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Site
+
+   .. container:: description
+
+      Description of a location using name and optional geopolitical boundaries (country, city, etc.).
+
+
+
+
+
+
+   **Sub Elements of <Site>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Station-Site-Name>`, string, ":red:`required`" 
+      :ref:`\<Description\><Station-Site-Description>`, string, "optional" 
+      :ref:`\<Town\><Station-Site-Town>`, string, "optional" 
+      :ref:`\<County\><Station-Site-County>`, string, "optional" 
+      :ref:`\<Region\><Station-Site-Region>`, string, "optional" 
+      :ref:`\<Country\><Station-Site-Country>`, string, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-site-name:
+
+<Name>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Site :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Name of the site
+
+
+
+   .. container:: example
+
+      **Example**: <Name>Albuquerque, New Mexico</Name>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-site-description:
+
+<Description>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Site :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      A longer description of the location of this station
+
+
+
+   .. container:: example
+
+      **Example**: <Description>NW corner of Yellowstone National Park</Description>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-site-town:
+
+<Town>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Site :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Town
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The town or city closest to the station.
+
+
+
+   .. container:: example
+
+      **Example**: <Town>Albuquerque</Town>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-site-county:
+
+<County>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Site :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` County
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The county where the station is located
+
+
+
+   .. container:: example
+
+      **Example**: <County>Bernalillo</County>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-site-region:
+
+<Region>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Site :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Region
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The state, province, or region of this site.
+
+
+
+   .. container:: example
+
+      **Example**: <Region>Southwest U.S.</Region>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-site-country:
+
+<Country>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Site :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Country
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The country of this site.
+
+
+
+   .. container:: example
+
+      **Example**: <Country>U.S.A.</Country>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-waterlevel:
+
+<WaterLevel>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` WaterLevel
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`double<type-glossary>`
+
+			.. only:: html
+
+					content type: `double <appendices.html#glossary-double>`_
+
+   .. container:: description
+
+      Elevation of the water surface in meters for underwater sites, where 0 is mean sea level.
+      If you put an OBS on a lake bottom, where the lake surface is at elevation=1200 meters,
+      then you should set WaterLevel=1200. An OBS in the ocean would
+      have WaterLevel=0.
+
+
+
+   .. container:: example
+
+      **Example**: <WaterLevel>1200</WaterLevel>
+
+
+
+
+   **Attributes of <WaterLevel>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **unit**, :ref:`string<type-glossary>`, no, "The unit of measurement. Use *SI* unit names and symbols whenever possible (e.g., 'm' instead of 'METERS').", "unit=\"m\"" 
+      **plusError**, :ref:`double<type-glossary>`, no, "plus uncertainty or error in measured value.", "plusError=\"0.1\"" 
+      **minusError**, :ref:`double<type-glossary>`, no, "minus uncertainty or error in measured value.", "minusError=\"0.1\"" 
+      **measurementMethod**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-vault:
+
+<Vault>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Vault
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Type of vault, e.g. World-Wide Standardized Seismograph Network (WWSSN), tunnel,
+      USArray Transportable Array Generation 2, etc.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-geology:
+
+<Geology>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Geology
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Type of rock and/or geologic formation at the station.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment:
+
+<Equipment>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment
+
+   .. container:: description
+
+      Equipment used by all channels at a station,
+      Equipment that contributes to or affects the response of a channel should be documented on the channel.
+
+      A type for equipment related to data acquisition or processing.
+
+
+
+
+
+
+   **Attributes of <Equipment>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **resourceId**, :ref:`string<type-glossary>`, no, "An identifier that serves to uniquely identify this resource. This identifier can be interpreted differently depending on the datacenter/software that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID. It should be expected that equipment with the same ID should indicate the same information or be derived from the same base instruments.", "" 
+
+
+
+
+   **Sub Elements of <Equipment>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Type\><Station-Equipment-Type>`, string, "optional" 
+      :ref:`\<Description\><Station-Equipment-Description>`, string, "optional" 
+      :ref:`\<Manufacturer\><Station-Equipment-Manufacturer>`, string, "optional" 
+      :ref:`\<Vendor\><Station-Equipment-Vendor>`, string, "optional" 
+      :ref:`\<Model\><Station-Equipment-Model>`, string, "optional" 
+      :ref:`\<SerialNumber\><Station-Equipment-SerialNumber>`, string, "optional" 
+      :ref:`\<InstallationDate\><Station-Equipment-InstallationDate>`, dateTime, "optional" 
+      :ref:`\<RemovalDate\><Station-Equipment-RemovalDate>`, dateTime, "optional" 
+      :ref:`\<CalibrationDate\><Station-Equipment-CalibrationDate>`, dateTime, "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-type:
+
+<Type>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Type
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Type of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-description:
+
+<Description>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-manufacturer:
+
+<Manufacturer>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Manufacturer
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Manufacturer of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-vendor:
+
+<Vendor>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Vendor
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Vendor of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-model:
+
+<Model>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Model
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Model of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-serialnumber:
+
+<SerialNumber>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SerialNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Serial number of equipment
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-installationdate:
+
+<InstallationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` InstallationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was installed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-removaldate:
+
+<RemovalDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` RemovalDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was removed
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-equipment-calibrationdate:
+
+<CalibrationDate>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Equipment :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CalibrationDate
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date this equipment was calibrated
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator:
+
+<Operator>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator
+
+   .. container:: description
+
+      Agency who manage this station.
+      Only use if this differs from the Operator of the Network.
+
+      Since the Contact element is a generic type that represents any contact
+      person, it also has its own optional Agency element.
+      It is expected that typically the contact's optional Agency tag will match the Operator Agency.
+      Only contacts appropriate for the enclosing element should be included in the Operator tag.
+
+
+
+
+
+
+   **Sub Elements of <Operator>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Agency\><Station-Operator-Agency>`, string, ":red:`required`" 
+      :ref:`\<Contact\><Station-Operator-Contact>`, , "optional, many" 
+      :ref:`\<WebSite\><Station-Operator-WebSite>`, anyURI, "optional" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-agency:
+
+<Agency>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Agency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      The operating agency.
+
+
+
+   .. container:: example
+
+      **Example**: <Agency>USGS</Agency>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-contact:
+
+<Contact>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact
+
+   .. container:: description
+
+      Person's contact information. A person can belong
+      to multiple agencies and have multiple email addresses and phone numbers.
+
+
+
+
+
+
+   **Sub Elements of <Contact>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<Name\><Station-Operator-Contact-Name>`, string, "optional, many" 
+      :ref:`\<Agency\><Station-Operator-Contact-Agency>`, string, "optional, many" 
+      :ref:`\<Email\><Station-Operator-Contact-Email>`, string, "optional, many" 
+      :ref:`\<Phone\><Station-Operator-Contact-Phone>`, , "optional, many" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-contact-name:
+
+<Name>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Name
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Name of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Name>Dr. Jane Doe</Name>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-contact-agency:
+
+<Agency>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Agency
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Agency of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Agency>USGS</Agency>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-contact-email:
+
+<Email>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Email
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Email of contact or author
+
+
+
+   .. container:: example
+
+      **Example**: <Email>jane_doe@example.com</Email>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-contact-phone:
+
+<Phone>
+''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone
+
+   .. container:: description
+
+      Phone of contact or author
+
+
+
+
+
+
+   **Attributes of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|1|1| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "attribute", "type", "required", "description", "example"
+      :widths: auto
+
+      **description**, :ref:`string<type-glossary>`, no, "", "" 
+
+
+
+
+   **Sub Elements of <Phone>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<CountryCode\><Station-Operator-Contact-Phone-CountryCode>`, integer, "optional" 
+      :ref:`\<AreaCode\><Station-Operator-Contact-Phone-AreaCode>`, integer, ":red:`required`" 
+      :ref:`\<PhoneNumber\><Station-Operator-Contact-Phone-PhoneNumber>`, string, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-contact-phone-countrycode:
+
+<CountryCode>
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CountryCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone country code
+
+
+
+   .. container:: example
+
+      **Example**: <CountryCode>64</CountryCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-contact-phone-areacode:
+
+<AreaCode>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` AreaCode
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`integer<type-glossary>`
+
+			.. only:: html
+
+					content type: `integer <appendices.html#glossary-integer>`_
+
+   .. container:: description
+
+      Telephone area code
+
+
+
+   .. container:: example
+
+      **Example**: <AreaCode>408</AreaCode>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-contact-phone-phonenumber:
+
+<PhoneNumber>     :red:`required`
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Contact :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Phone :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` PhoneNumber
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Telephone number
+
+
+
+   .. container:: example
+
+      **Example**: <PhoneNumber>5551212</PhoneNumber>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-operator-website:
+
+<WebSite>
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Operator :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` WebSite
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`anyURI<type-glossary>`
+
+			.. only:: html
+
+					content type: `anyURI <appendices.html#glossary-anyuri>`_
+
+   .. container:: description
+
+      Website of operating agency
+
+
+
+   .. container:: example
+
+      **Example**: <WebSite>http://usgs.gov</WebSite>
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-creationdate:
+
+<CreationDate>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` CreationDate
+
+   .. admonition:: Warning, Future Change
+
+      <CreationDate>: This element is likely to be removed.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date and time (UTC) when the station was first installed.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-terminationdate:
+
+<TerminationDate>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` TerminationDate
+
+   .. admonition:: Warning, Future Change
+
+      <TerminationDate>: This element is likely to be removed.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`dateTime<type-glossary>`
+
+			.. only:: html
+
+					content type: `dateTime <appendices.html#glossary-datetime>`_
+
+   .. container:: description
+
+      Date and time (UTC) when the station was terminated or
+      will be terminated. Do not include this element if a termination date is not available or is not relevant.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-totalnumberchannels:
+
+<TotalNumberChannels>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` TotalNumberChannels
+
+   .. admonition:: Warning, Future Change
+
+      <TotalNumberChannels>: This element is likely to be removed.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`decimal<type-glossary>`
+
+					range: TotalNumberChannels :math:`\ge` 0
+
+			.. only:: html
+
+					content type: `decimal <appendices.html#glossary-decimal>`_
+
+					range: TotalNumberChannels :math:`\ge` 0
+
+   .. container:: description
+
+      Total number of channels recorded at this station.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-selectednumberchannels:
+
+<SelectedNumberChannels>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` SelectedNumberChannels
+
+   .. admonition:: Warning, Future Change
+
+      <SelectedNumberChannels>: This element is likely to be removed.
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`decimal<type-glossary>`
+
+					range: SelectedNumberChannels :math:`\ge` 0
+
+			.. only:: html
+
+					content type: `decimal <appendices.html#glossary-decimal>`_
+
+					range: SelectedNumberChannels :math:`\ge` 0
+
+   .. container:: description
+
+      The number of channels selected in the request that resulted in this document.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-externalreference:
+
+<ExternalReference>
+------------------------------------------------------------
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ExternalReference
+
+   .. container:: description
+
+      URI of any type of external report
+
+      This type contains a Uniform Resource Identifier (URI) and description
+      for external information that users may want to reference.
+
+
+
+
+
+
+   **Sub Elements of <ExternalReference>**: 
+
+   .. tabularcolumns::|l|l|l|l| 
+
+   .. csv-table::
+      :class: rows
+      :escape: \ 
+      :header: "element", "type", "number"
+      :widths: auto
+
+      :ref:`\<URI\><Station-ExternalReference-URI>`, anyURI, ":red:`required`" 
+      :ref:`\<Description\><Station-ExternalReference-Description>`, string, ":red:`required`" 
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-externalreference-uri:
+
+<URI>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ExternalReference :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` URI
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`anyURI<type-glossary>`
+
+			.. only:: html
+
+					content type: `anyURI <appendices.html#glossary-anyuri>`_
+
+   .. container:: description
+
+      URI of the external reference.
+
+
+
+
+:raw-latex:`\noindent\rule{\textwidth}{1pt}`
+
+.. _station-externalreference-description:
+
+<Description>     :red:`required`
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+.. container:: hatnote hatnote-gray
+
+   .. container:: crumb
+
+      Station :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` ExternalReference :raw-html:`&rarr;`:raw-latex:`$\rightarrow$` Description
+
+   .. container:: type
+
+			.. only:: latex
+
+					content type: :ref:`string<type-glossary>`
+
+			.. only:: html
+
+					content type: `string <appendices.html#glossary-string>`_
+
+   .. container:: description
+
+      Description of the external reference.
+
+
+
diff --git a/docs/mystyle.tex.txt b/docs/mystyle.tex.txt
new file mode 100644
index 0000000..73e0bd2
--- /dev/null
+++ b/docs/mystyle.tex.txt
@@ -0,0 +1,5 @@
+\newcommand{\lt}{<}
+\newcommand{\gt}{>}
+
+\def\changemargin#1#2{\list{}{\rightmargin#2\leftmargin#1}\item[]}
+\let\endchangemargin=\endlist 
\ No newline at end of file
diff --git a/docs/overview.rst b/docs/overview.rst
new file mode 100644
index 0000000..a0a7a1d
--- /dev/null
+++ b/docs/overview.rst
@@ -0,0 +1,146 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+****************
+Overview
+****************
+
+.. include..:: metadata.rst
+
+Introducing StationXML
+=======================
+
+StationXML is an `XML <https://en.wikipedia.org/wiki/XML>`_ representation of
+`metadata <https://en.wikipedia.org/wiki/Metadata>`_ that describes the data collected by
+geophysical instrumentation.
+
+StationXML is defined by a schema that specifies the allowable format of StationXML documents.
+
+StationXML Example
+-----------------------
+
+.. toggle-header::
+  :header: StationXML **Show/Hide**
+
+  .. literalinclude:: examples/overview_example.xml
+    :language: XML
+
+
+Note that each XML element must have a start tag (e.g., <Station>) and an end tag (</Station>)
+and the element hierarchy must be maintained (e.g., a <Channel> may not exist outside
+of a <Station> and a <Station> may not exist outside of a <Network>, etc.).
+
+
+The FDSN and StationXML schema
+----------------------------------
+StationXML was developed through the International Federation of Digital Seismograph Networks
+(`FDSN <https://www.fdsn.org/>`_) to provide a standardized format for geophysical metadata.
+
+Notice that the example StationXML excerpt above contains the following lines
+
+.. code-block:: XML
+
+  <?xml version="1.0" encoding="UTF-8"?>
+  <FDSNStationXML xmlns="http://www.fdsn.org/xml/station/1"
+     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+     xsi:schemaLocation="http://www.fdsn.org/xml/station/1 http://www.fdsn.org/xml/station/fdsn-station-1.2.xsd"
+     schemaVersion="1.2">
+
+
+The first line, the xml prologue, specifies the xml version and the character encoding.
+
+The second line begins the StationXML document and
+specifies the location and version of the schema
+to which the StationXML example must conform.
+
+
+The FDSN maintains all versions of the StationXML schema at:
+
+   `<https://www.fdsn.org/xml/station/>`_
+
+For instance, at the time of this writing, the latest schema version is v1.2 and is
+located at:
+
+   `<https://www.fdsn.org/xml/station/fdsn-station-1.2.xsd>`_
+
+
+Character Encoding
+----------------------------------
+UTF-8 is the default encoding for XML, specified in the prologue,
+allowing non-ascii characters to be used within StationXML. This
+is common within names of people and places and in comments and descriptions.
+However, authors should use ASCII when possible for maximum portability.
+
+In particular, text that will likely be used by software, as opposed to simply
+displayed, such as ids and units, should only use ASCII.
+
+Documentation Organization
+=========================================
+
+This documentation has 5 parts:
+
+#. This introduction
+#. StationXML Reference - Over time, once users have absorbed the other parts of the
+   documentation, it is expected that this reference section will be the most frequently
+   used. The reference section is auto-generated directly from the FDSN schema so that it
+   should always be in sync with the schema.
+   The reference itself is broken out by the 5 levels of response detail:
+
+   * FDSNStationXML
+   * Network
+   * Station
+   * Channel
+   * Response
+
+#. Specifying and using response information - In this section you will find theory and examples
+   to help you create instrument responses for your own stations.
+#. StationXML tools - contains examples of 3rd party tools available to help users create and edit
+   StationXML files.  This is expected to be a fluid page that changes as new tools become
+   available and older tools are deprecated.
+#. Appendices - In here you will find more technical details on specific parts of StationXML and metadata.
+   For instance, the first section, Mapping SEED to StationXML, is meant to be used as a reference to help
+   users migrate their SEED format metadata to StationXML
+
+Some History - SEED
+=======================
+
+For three decades, the Standard for the Exchange of Earthquake Data
+(`SEED <https://www.fdsn.org/publications/>`_) was the standard
+format for archiving and distributing metadata within the seismological community.
+Once representing file volumes binding metadata to data, a provision was later developed
+that allowed SEED metadata to stand on its own and was given the designation 'dataless SEED'.
+
+StationXML was developed through the FDSN (International Federation of Digital Seismograph Networks)
+as a replacement and extension of the SEED standard.
+
+The purpose of the FDSN StationXML schema (`fdsn-station.xsd <https://www.fdsn.org/xml/station/>`_)
+is to define an XML representation of the most important and
+commonly used structures of SEED 2.4 metadata with enhancements.
+
+The goal of this document is to allow mapping between SEED 2.4 dataless SEED volumes and the StationXML schema with as little
+transformation or loss of information as possible, while at the same time simplifying station
+metadata representation when possible. Also, content and clarification has been added where
+lacking in the SEED standard.
+
+StationXML Schema Changes
+=================================
+
+.. include:: changelog.rst
+
+Documentation Changes
+=================================
+
+Changes to this documentation.
+
+Version 2022-02-25:
+
+- Resolved issues with documentation by FDSN WG evaluation team.
+
+Version 2020-09-02:
+
+- Initial StationXML documentation.
+
+The initial version of StationXML documentation was prepared by
+`ISTI <https://isti.com>`_ and sponsored by
+`IRIS Data Services <https://ds.iris.edu>`_ and
+`ORFEUS <https://www.orfeus-eu.org/>`_.
diff --git a/docs/pz_table_l-22d.rst b/docs/pz_table_l-22d.rst
new file mode 100644
index 0000000..1d65737
--- /dev/null
+++ b/docs/pz_table_l-22d.rst
@@ -0,0 +1,38 @@
+.. # NRL file:
+   sercel/RESP.XX.NS159..SHZ.L22D.5470.20000.2.87_9
+
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 0
+   :widths: 1 1 1 1
+
+   * - Sensor: Sercel L-22D
+
+   * - **Gain:**
+     - 87.9 [V/m/s]
+     - **Freq of gain:**
+     - 10.0 [Hz]
+
+   * - **A0 normalization:**
+     - 1.0
+     - **Freq of normalization:**
+     - 10.0 [Hz]
+
+   * - :cspan:`1` **Poles:**
+     - :cspan:`1` **Zeros:**
+
+   * - **real** (rad/s)
+     - **imag** (rad/s)
+     - **real** (rad/s)
+     - **imag** (rad/s)
+
+   * - -8.884
+     - +8.887
+     - 0.0
+     - 0.0
+
+   * - -8.884
+     - -8.887
+     - 0.0
+     - 0.0
+
diff --git a/docs/pz_table_sts-1.rst b/docs/pz_table_sts-1.rst
new file mode 100644
index 0000000..114a944
--- /dev/null
+++ b/docs/pz_table_sts-1.rst
@@ -0,0 +1,45 @@
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 0
+   :widths: 1 1 1 1
+
+   * - Sensor: Streckeisen STS-1
+
+   * - **Gain:**
+     - 2400 [V/m/s]
+     - **Freq of gain:**
+     - 0.02 [Hz]
+
+   * - **A0 normalization:**
+     - 3.94858E+03
+     - **Freq of normalization:**
+     - 0.02 [Hz]
+
+   * - :cspan:`1` **Poles:**
+     - :cspan:`1` **Zeros:**
+
+   * - **real** (rad/s)
+     - **imag** (rad/s)
+     - **real** (rad/s)
+     - **imag** (rad/s)
+
+   * - -0.01234
+     - +0.01234
+     - 0.0
+     - 0.0
+
+   * - -0.01234
+     - -0.01234
+     - 0.0
+     - 0.0
+
+   * - -39.18
+     - +49.12
+     - ..
+     - ..
+
+   * - -39.18
+     - -49.12
+     - ..
+     - ..
+
diff --git a/docs/pz_table_sts-1_Hz.rst b/docs/pz_table_sts-1_Hz.rst
new file mode 100644
index 0000000..ebc40d7
--- /dev/null
+++ b/docs/pz_table_sts-1_Hz.rst
@@ -0,0 +1,44 @@
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 0
+   :widths: 1 1 1 1
+
+   * - Sensor: Streckeisen STS-1 poles and zeros given in Hz
+
+   * - **Gain:**
+     - 2400 [V/m/s]
+     - **Freq of gain:**
+     - 0.02 [Hz]
+
+   * - **A0 normalization:**
+     - 1.0001869E+02
+     - **Freq of normalization:**
+     - 0.02 [Hz]
+
+   * - :cspan:`1` **Poles:**
+     - :cspan:`1` **Zeros:**
+
+   * - **real** (Hz)
+     - **imag** (Hz)
+     - **real** (Hz)
+     - **imag** (Hz)
+
+   * - -0.0019639
+     - +0.0019639
+     - 0.0
+     - 0.0
+
+   * - -0.0019639
+     - -0.0019639
+     - 0.0
+     - 0.0
+
+   * - -6.2357
+     - +7.8177
+     - ..
+     - ..
+
+   * - -6.2357
+     - -7.8177
+     - ..
+     - ..
diff --git a/docs/pz_table_sts-2.rst b/docs/pz_table_sts-2.rst
new file mode 100644
index 0000000..2dde0eb
--- /dev/null
+++ b/docs/pz_table_sts-2.rst
@@ -0,0 +1,82 @@
+.. flat-table::
+   :header-rows: 1
+   :stub-columns: 0
+   :widths: 1 1 1 1
+
+   * - Sensor: Streckeisen STS-2 (3rd Generation)
+
+   * - **Gain:**
+     - 1500 [V/m/s]
+     - **Freq of gain:**
+     - 1.0 [Hz]
+
+   * - **A0 normalization:**
+     - 3.4684E+17
+     - **Freq of normalization:**
+     - 1.0 [Hz]
+
+   * - :cspan:`1` **Poles:**
+     - :cspan:`1` **Zeros:**
+
+   * - **real** (rad/s)
+     - **imag** (rad/s)
+     - **real** (rad/s)
+     - **imag** (rad/s)
+
+   * - -0.037
+     - -0.037
+     - 0.0
+     - 0.0
+
+   * - -0.037
+     - +0.037
+     - 0.0
+     - 0.0
+
+   * - -15.54
+     - 0.0
+     - 15.15
+     - 0.0
+
+   * - -97.34
+     - -400.7
+     - -176.6
+     - 0.0
+
+   * - -374.8
+     - 0.0
+     - -463.1
+     - -430.5
+
+   * - -97.34
+     - +400.7
+     - -463.1
+     - +430.5
+
+   * - -520.3
+     - 0.0
+     - ..
+     - ..
+
+   * - -10530.0
+     - -10050.0
+     - ..
+     - ..
+
+   * - -10530.0
+     - +10050.0
+     - ..
+     - ..
+
+   * - -13300.0
+     - 0.0
+     - ..
+     - ..
+
+   * - -255.097
+     - 0.0
+     - ..
+     - ..
+
+
+
diff --git a/docs/reference.rst b/docs/reference.rst
new file mode 100644
index 0000000..53f71f3
--- /dev/null
+++ b/docs/reference.rst
@@ -0,0 +1,19 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+
+.. role:: blue
+
+.. role:: red
+
+.. _reference:
+
+************************
+StationXML Reference
+************************
+
+.. include:: level-preamble.rst
+.. include:: level-network.rst
+.. include:: level-station.rst
+.. include:: level-channel.rst
+.. include:: level-response.rst
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 0000000..5c77f50
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,13 @@
+wget==3.2
+xmlschema==1.9.2
+docutils==0.17.1
+Sphinx==4.4.0
+sphinx-rtd-theme==1.0.0
+sphinxcontrib-applehelp==1.0.2
+sphinxcontrib-contentui==0.2.5
+sphinxcontrib-devhelp==1.0.2
+sphinxcontrib-htmlhelp==2.0.0
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==1.0.3
+sphinxcontrib-serializinghtml==1.1.5
+linuxdoc==20211220
diff --git a/docs/response-examples.rst b/docs/response-examples.rst
new file mode 100644
index 0000000..102cd90
--- /dev/null
+++ b/docs/response-examples.rst
@@ -0,0 +1,49 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+Broadband sensor
+--------------------------
+
+   3rd generation Streckeisen STS-2 sensor + Reftek RT130 datalogger
+
+   .. include:: examples/sts-2_rt130.rst
+
+Broadband sensor
+--------------------------
+
+   Streckeisen STS-1 sensor (360 s) + Quanterra Qx80 datalogger (80)
+
+   .. include:: examples/sts-1_Qx80.rst
+
+Short-period sensor
+--------------------------
+
+   Geotech GS-13 short-period sensor + Quanterra Quanterra Qx80 datalogger
+
+   .. include:: examples/gs-13_Qx80.rst
+
+Short-period sensor
+--------------------------
+
+   Sercel L-22D short-period sensor (Rc=5470 Ohms, Rs=20000 Ohms) + Reftek RT72A-08 24-bit datalogger, 1 stream, 100 Hz, gain 32
+
+   .. include:: examples/l-22d_rt72a-08.rst
+
+Accelerometer
+--------------------------
+
+Kinemetrics FBA-3 + Kinemetrics Etna
+
+.. include:: examples/kinemetrics_etna_fba-3.rst
+
+YSI 44031 thermistor
+--------------------------
+
+.. include:: examples/YSI-44031.rst
+
+Setra 270
+--------------------------
+
+Setra 270 Pressure Transducer
+
+.. include:: examples/Setra_270.rst
diff --git a/docs/response-practical.rst b/docs/response-practical.rst
new file mode 100644
index 0000000..0098fea
--- /dev/null
+++ b/docs/response-practical.rst
@@ -0,0 +1,354 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+
+Introduction
+-----------------------------------------------
+
+Geophysical data are recorded by an instrument that imparts its
+own signature onto the data.
+When the data are later analyzed, one of the first steps is to remove the effect
+of the instrumentation used to record it, the so-called instrument response.
+This is typically done in the frequency domain, by dividing the complex
+Fourier Transform of the data by the complex Fourier Transform of the
+instrument response.
+
+.. math::
+
+   Z(f)=\frac{X(f)}{I(f)}
+
+where :math:`X(f)` is the Fourier Transform of the recorded time series,
+:math:`I(f)` is the Fourier Transform of the instrument response,
+and :math:`Z(f)` is the Fourier Transform of the data with the instrument response removed.
+
+
+So how does one obtain the Fourier Transform of the instrument response?
+Very often, this is calculated by combining the information describing
+each stage of the instrument response in specific formats.
+
+
+Sensor Response as a Linear Sequence of Stages
+-----------------------------------------------
+
+.. image:: stage_sequence.png
+
+A recording system (sensor + datalogger) represents a linear, time-invariant system.
+As such, the total response of the system (= the instrument response) can be
+calculated by linearly combining the response of each individual stage in the system.
+In the time domain, the operator that represents linear combination in this way is convolution,
+however, it's difficult to visualize the result of convolving several stages together.
+Fortunately, in the frequency domain, the operator that links the individual stage responses
+together is multiplication, and it's trivial to combine stage responses together.
+
+The schematic shown in the figure above represents a generic ideal of the
+instrument response as a sequence of stages.  Where each stage is implemented
+in the hardware, e.g., whether it physically resides in the sensor or the datalogger (or
+whether these are integrated into a single unit) is not specified.
+
+A more specific description of instrument response particular to most seismic instrumentation
+is this:
+The ground motion (typically velocity or acceleration) is "input" to the
+seismic sensor which outputs continuous voltage (an analog signal) proportional to
+the input in some way. This continuous voltage could then be amplified,
+either by an external preamplifier (+ filter possibly) or, more commonly,
+by circuitry within the datalogger itself.
+Next, the continuous signal is sampled by the ADC (analog-to-digital conversion) circuit
+of the datalogger, resulting in discrete data samples.
+
+Typically, the sampling is done over a sequence of stages where the
+first stage highly oversamples the input data.
+Each subsequent stage is a combination of low-pass filter, typically implemented
+using a FIR filter, followed by decimation of the data stream by some decimation
+factor. This anti-alias FIR filter is necessary at each decimation step to avoid aliasing
+of energy above the Nyquist frequency, which would contaminate the signal of interest.
+This cascade of filter/decimate stages begins at the high sample rate
+(e.g., 102400 samples per second for the Reftek RT130) and continues, with typical
+integer decimation factors (2,4,5,8,10,16 etc) at each step, until the final desired output
+sample rate is reached.
+Thus, the input units of the first sensor stage is the ground motion (e.g., m/s),
+while the input units of the first datalogger stage is Volts.
+After the ADC, the input/output units for each subsequent stage is Counts.
+
+
+Stage 1: The Analog Sensor
+-----------------------------
+The first stage of the response often represents the effect of an analog sensor (e.g., seismometer, microphone, etc),
+which takes as input a physical quantity (e.g., ground motion in :math:`\mu ms^{-1}`, air pressure in :math:`Pa`, temperature
+in :math:`^{\circ}C`, etc.)
+and outputs Volts.
+
+We need some way to represent how this sensor stage works and what distortion, if any,
+it applies to the underlying time series (the input physical quantity).
+
+Commonly, the analog sensor stage is stored as a sequence of poles and zeros of the Laplace Transform
+(see Laplace Transform description above) along with associated scale factors.
+
+Recall that the Laplace transform variable is given by :math:`s=\sigma+j\omega`.
+Along the imaginary axis, :math:`\sigma=0` and hence :math:`s=j\omega`.
+Thus, we may express the complex frequency response of the analog stage
+by calculating its polezero expansion
+
+.. math::
+
+   H(f)=A_0\frac{\Pi_{k=1}^{M} (s-z_{k})} {\Pi_{k=1}^{N} (s-p_{k})}
+
+where :math:`s=j2\pi f` [rad/s] or :math:`s=jf` [Hz] , :math:`z_k` are the
+:math:`M` zeros and :math:`p_k` are the :math:`N` poles. :math:`A_0` is the normalization
+factor, typically chosen so that :math:`|H(f_n)|=1.0` where :math:`f_n` is the normalization
+frequency.
+
+Thus, given the poles and zeros of an analog stage,
+in order to properly calculate the stage frequency response,
+we must know the units of :math:`s` (Hz or rad/s) used to calculate the poles and zeros
+using the expansion above.
+
+With the normalization factor :math:`A_0`, the polezero expansion results in a
+complex frequency response with magnitude = 1.0 at the normalization frequency.
+For seismometers whose response is flat to ground velocity,
+the normalization frequency is typically chosen somewhere within the
+flat part of the response spectrum.
+For broadband sensors, it is also considered good practice to
+select a normalization frequency lower than
+two times the lowest sampling frequency.
+For example, if you are sampling VHZ data at 0.1 sps, then you want to
+describe :math:`A_0` at a frequency :math:`\lt 0.05` Hz.
+
+
+Thus, the poles and zeros give the shape of the sensor response,
+but not the gain (see Fig. X below).
+
+..
+   The actual gain of the sensor (e.g., the conversion factor from ground motion to Volts)
+   is specified within a <StageGain> element (see example below).
+
+
+Analog polezero examples
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Below are the poles and zeros for two broadband seismometers (STS-1 and STS-2)
+and a short-period sensor (L-22D). All have a response that is flat to velocity
+within some frequency band, which is controlled by the location of the poles
+and zeros in the :math:`s`-plane.
+
+.. include:: pz_table_sts-2.rst
+
+.. include:: pz_table_sts-1.rst
+
+.. include:: pz_table_l-22d.rst
+
+Notice from the table above that the poles always appear in
+complex conjugate pairs (in the degenerate case this is represented
+by a single real pole).
+This will always be the case, since
+the poles and zeros ultimately relate to a polynomial expression
+with real coefficients that describes the seismometer response.
+In addition, notice that all of the poles have a negative real part.
+This is required for stability reasons as discussed in the theory
+section above.
+
+The poles and zeros have units in the
+complex s-plane. For the examples given (and for most analog stages),
+<PzTransferFunctionType> is "LAPLACE (RADIANS/SECOND)", hence the
+poles and zeros have units of rad/s.
+
+When viewing the total instrument response as a plot of amplitude and phase versus frequency,
+most of the shape is controlled by the polezero expansion of the analog sensor stage.
+
+
+.. figure:: analog_stage_comparison.png
+
+   Fig. X Plot of polezero expansion of analog sensor for Streckeisen STS-2 (green)
+   and Sercel L-22D (red) [see table for polezero values used].
+
+
+In the figure above we plot the analog stage polezero expansion for a broadband
+seismometer (STS-2) and a short-period seismometer (L-22D).
+In both cases, the A0 normalization frequency, :math:`f_n` is located within the
+flat part of the spectrum, and each response has a corner frequency, :math:`f_c`
+below which the magnitude response rolls off.  The corner frequency is the
+frequency at which the response magnitude is -3dB below the flat part of the spectrum.
+
+
+Given the poles and zeros, one can determine the low-frequency corner frequency, :math:`f_c`,
+from the magnitude of the lowest frequency pole in the s-plane.
+
+For instance, for the STS-2 example shown, the lowest frequency pole is at
+:math:`-.037 \pm .037j` in the complex s-plane, and the corresponding
+corner frequency is:
+
+.. math::
+
+   \omega = \sqrt{.037^2 + .037^2} = \sqrt{2} \times .037 = .052326 rad/s
+
+   f_c =  \frac{\omega}{2\pi} = 0.0083279 s^{-1} \rightarrow T_c = 1/f_c = 120 sec
+
+As expected, the STS-2 sensor has a corner *period* of 120 s.
+
+By similar reasoning, the corner frequency of the short-period L-22D sensor is
+
+.. math::
+
+   \omega = \sqrt{8.884^2 + 8.887^2} = 12.566 rad/s
+
+   f_c =  \frac{\omega}{2\pi} = 2.0 Hz
+
+For many applications the exact instrument response is not needed and it is
+sufficient to calculate a single scale factor to convert from recorded COUNTS
+to ground motion (e.g, M/S).  For instance, if the signal of interest only
+contains energy within the flat part of the spectrum (e.g., band-limited signal),
+then we might be able to ignore the polezero shape altogether and compute
+and overall scale factor (to go from COUNTS to M/S) for the sensor + datalogger.
+
+For instance, if the STS-2 sensor discussed above were connected to a generic
+Reftek RT-130 datalogger, we can calculate an approximate forward scale factor:
+
+.. math::
+
+   1500 [V/m/s] \times 6.291290\times 10^{5} [Counts/V] = 9.4369\times 10^{8} [Counts/m/s]
+
+
+While this is often done to do a quick conversion to ground velocity, several
+caveats must be mentioned.
+
+   #. Very few signals are truly bandlimited this way and we're essentially applying the
+      wrong correction factor to the signals outside the bandwidth
+
+   #. Often, the frequency at which the sensor response is normalized, is not the same
+      as the frequency at which the datalogger response is normalized.
+      For instance, the Reftek RT-130 is normalized at 0.05 Hz, while the STS-2 is
+      normalized at 1.0 Hz.
+      This matters because the amplitude response of the datalogger filters are not perfectly flat,
+      hence to compute the overall instrument response (sensor + datalogger), the
+      datalogger gain often has to be recalculated at the frequency of the sensor normalization.
+
+   #. It ignores the phase response, which can be very important for modeling waveforms, etc.
+
+Alternatively, when simple scaling is insufficient, it is necessary to use all of the
+response stages to compute the exact instrument response.
+When the datalogger normalization frequency is different from the sensor normalization
+frequency, the datalogger response is *recalculated* at the sensor normalization frequency
+and the new *sensitivity*, equal to the product of each stage amplitude response at
+this normalization frequency, is stored in the StationXML <InstrumentSensitivity> element.
+
+
+Converting s = rad/s to/from Hz
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Recall the polezero expansion of the Laplace Transform of the transfer function,
+
+.. math::
+
+   H(s)=A_{0}\frac{\Pi_{k=1}^{M}(s-z_{k})}{\Pi_{k=1}^{N}(s-p_{k})}
+
+Consider a system with 1 zero and 2 poles (forming a complex conjugate pair)
+in the complex :math:`s`-plane (rad/s).
+Say :math:`z_{1}=z_{r}+jz_{i}`, :math:`p_{1}=p_{r}+jp_{i}` and :math:`p_2=\bar{p_1}`,
+where each term :math:`z_r, z_i, p_r, p_i` has units of rad/s.
+
+Then
+
+.. math::
+   :nowrap:
+
+   \begin{eqnarray}
+      H(s=j\omega)&=&A_{0}\frac{j\omega-(z_{r}+jz_{i})}{(j\omega-p_{1})(j\omega-\bar{p_{1}})} \\
+      &=&A_{0}\frac{2\pi[jf-(z_{r}^{'}+jz_{i}^{'})]}{(2\pi)^{2}[(jf-p_{1}^{'})(jf-\bar{p_{1}^{'}})]} \\
+   \end{eqnarray}
+
+where the primed quantities equal the unprimed quantities divide by :math:`2\pi`,
+e.g., :math:`z_r^{'}=\frac{z_r}{2\pi}`
+
+We can write this as
+
+.. math::
+
+   H(s=jf)=A_{0}^{'}\frac{[jf-(z_{r}^{'}+jz_{i}^{'})]}{[(jf-p_{1}^{'})(jf-\bar{p_{1}^{'}})]}
+
+where :math:`A_{0}^{'}=\frac{2\pi}{(2\pi)^{2}}A_0`.
+
+In general, we can write
+
+.. math::
+
+   H(s=jf)=A_{0}^{'}\frac{\Pi_{k=1}^{M}(jf-z_{k}^{'})}{\Pi_{k=1}^{N}(jf-p_{k}^{'})}
+
+where :math:`A_{0}^{'}=A_{0}\cdot(2\pi)^{M-N}` and where :math:`M` is the number of
+zeros and :math:`N` is the number of poles.
+
+Thus, if we are given a polezero stage with units of rad/s (:math:`\omega`),
+we can convert this stage to units of Hz and maintain the proper normalization
+by first dividing each pole and zero by :math:`2\pi`,
+and then scaling the normalization factor
+:math:`A_{0}` by :math:`(2\pi)^{M-N}`.
+
+Conversely, if we are given a polezero stage with units of Hz (:math:`f`),
+we can convert it to units of rad/s by first multiplying the each pole
+and zero by :math:`2\pi`,
+and then scaling the given normalization factor
+:math:`A_{0}^{'}` by :math:`(2\pi)^{N-M}`.
+
+For example, the poles and zeros of the Streckeisen STS-I sensor are shown
+in the table below for units = Hz (<PzTransferFunctionType>LAPLACE (HERTZ)</PzTransferFunctionType>)
+
+.. include:: pz_table_sts-1_Hz.rst
+
+Stage 2: The Preamplifier
+-----------------------------
+Not all response sequences have a preamplifier. When present, it may be implemented using
+an analog circuit (V->V) or it may be a digital circuit integrated within the analog-to-digital
+(datalogger) recorder itself.
+
+For example, an analog preamplifier stage with a gain of 8 would be represented as:
+
+.. code-block:: XML
+
+   <Stage number="2">
+      <StageGain>
+         <Value>8</Value>
+         <Frequency>1</Frequency>
+      </StageGain>
+   </Stage>
+
+
+where the <Frequency> is normally chosen to be the same as the normalization frequency, :math:`f_n` in stage 1.
+
+An external preamplifier stage could have an associated filter, either implemented using a polezero or
+coefficient representation.
+
+Often, the preamplifier is integrated with the datalogger and merely adds a uniform scale factor to
+the instrument response.
+
+.. admonition:: Warning
+
+   Using *place-holder* preamplifiers at stage 2 may not be good practice.
+
+Some entities (e.g., the Nominal Response Library or NRL)
+always include a preamplifier at stage 2 in order to
+standardize the numbering of response stages
+(e.g., so that the datalogger response always begins at stage 3).
+If no preamplifier was actually present, then a *place-holder* stage
+with gain=1 is used.
+
+However, there is disagreement about whether *all* responses should have
+such a place-holder stage or whether it is better practice
+to have the response stages more faithfully correspond to the equipment
+that is actually used.
+
+
+Stage 2+: The Datalogger
+-----------------------------
+
+The datalogger, or analog-to-digital converter (ADC)
+has two main functions: 1. To digitize the analog signal (Volts)
+coming from the sensor and 2. To output the digitized
+signal (digital counts) at the desired sample rate(s).
+
+These functions are typically achieved by first highly oversampling the
+analog signal, and then passing it through a sequence of filter/decimate
+steps to achieve the desired output sample rate(s).
+
+Each filter/decimate step is represented by a stage in the StationXML response,
+representing the effects of low-pass filtering (typically implemented
+with an anti-alias FIR filter) and decimation to a lower sample rate.
+
+.. include:: filters.rst
diff --git a/docs/response-theory.rst b/docs/response-theory.rst
new file mode 100644
index 0000000..8df3e1a
--- /dev/null
+++ b/docs/response-theory.rst
@@ -0,0 +1,46 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+   .. spelling::
+
+     Englewood
+
+
+In geophysics, we often work with instrument responses in the frequency domain
+as they are simpler to combine and manipulate
+For instrument responses specified in the time domain, we must first
+transform the response of the frequency domain using one or more transforms.
+Depending on the application, one or more of the following transforms may be used:
+The Fourier Transform, the Laplace Transform and the z-Transform.
+
+The Fourier Transform
+---------------------------
+
+.. include:: transform-fourier.rst
+
+
+The Laplace Transform
+---------------------------
+
+.. include:: transform-laplace.rst
+
+
+The z-Transform
+---------------------------
+
+.. include:: transform-z.rst
+
+FIR-IIR Filters
+---------------------------
+
+.. include:: transform-FIR-IIR.rst
+
+Convolution
+---------------------------
+
+.. include:: transform-convolution.rst
+
+References
+---------------------------
+
+.. include:: theory-references.rst
diff --git a/docs/response.rst b/docs/response.rst
new file mode 100644
index 0000000..e962246
--- /dev/null
+++ b/docs/response.rst
@@ -0,0 +1,24 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+
+********************************************************************
+Specifying and Using Response Information
+********************************************************************
+
+--By Mike Hagerty & Adam Ringler
+
+Theory of Instrument Response
+=========================================
+
+.. include:: response-theory.rst
+
+Practical Instrument Response
+=========================================
+
+.. include:: response-practical.rst
+
+StationXML Response Examples
+===========================================
+
+.. include:: response-examples.rst
diff --git a/docs/schema-keywords.rst b/docs/schema-keywords.rst
new file mode 100644
index 0000000..0adbdfb
--- /dev/null
+++ b/docs/schema-keywords.rst
@@ -0,0 +1,114 @@
+
+The :ref:`reference` of this documentation is auto-generated from
+documentation tags in the StationXML schema document.  In this way a
+single source of documentation is maintained for the purposes of this
+generated documentation and those reading the XSD schema specification
+directly.
+
+To allow additional granularity and clarity in the generated
+documentation, special embedded elements and attributes are parsed from the content
+of standard documentation tags of `XML Schema <https://en.wikipedia.org/wiki/XML_Schema_(W3C)>`_.
+
+The following elements and attributes are recognized in the standard `<documentation>` tags:
+
+#. <example>
+#. <warning>
+#. <levelDesc>
+#. LevelChoice
+#. ElementChoice
+
+These serve the following roles:
+
+* <example> - An XML element that contains an example of the relevant element in the StationXML documentation.
+
+   For instance, NetworkType element contains 2 `documentation` tags:
+
+   .. code-block:: XML
+
+      <xs:complexType name="NetworkType">
+         <xs:annotation>
+         <xs:documentation>The Network container. All station metadata for this network is contained within this element.
+     		A Description element may be included with the official network name and other descriptive information.
+     		An Identifier element may be included to designate a persistent identifier (e.g. DOI) to use for citation.
+     		A Comment element may be included for additional comments.
+        </xs:documentation>
+        <xs:documentation><example><Network code="IU" startDate="2016-01-27T13:00:00" /></example></xs:documentation>
+         </xs:annotation>
+      </xs:complexType>
+
+   The first documentation text appears directly beneath the Network
+   element in the StationXML documentation (it is the Network
+   description), while the second is used to create the example
+   beneath the description::
+
+      Example: <Network code=”IU” startDate=”2016-01-27T13:00:00” />
+
+   Note that for an example attribute, the <example> element should contain just
+   the textual value, not the key or quotes. So within the `code` attribute on
+   Network, the example would be just:
+
+   .. code-block:: XML
+
+    <xs:documentation><example>IU</example></xs:documentation>
+
+   which would produce::
+
+      code=”IU”
+
+* <warning> - This is used to wrap the text that follows it in an ReStructuredText admonition wrapper.
+
+   It is used, for example, to present a caution that a particular element may be deprecated
+   in future versions of the StationXML documentation.
+
+* <levelDesc> - An XML element that contains a description of the relevant element in the StationXML documentation at a given level.
+
+  This exists as a container to hold the description as text, along with a LevelChoice
+  attribute to specify the level.
+
+* LevelChoice="X" - where X is in {N, S, C}.
+
+   When a particular XML element is used more than once in the documentation, this allows
+   us to specify different documentation for different BaseNodeElements.
+   For example, Network, Station and Channel types all inherit code from the BaseNodeElement.
+   By using the LevelChoice attribute on a <levelDesc> or an <example> element, we can specify a unique Description and Example for the
+   Network.code, Station.code and Channel.code.
+
+   For example,
+
+   .. code-block:: XML
+
+      <xs:attribute name="code" type="xs:string" use="required">
+        <xs:annotation>
+          <xs:documentation><levelDesc LevelChoice="N">Name of Network</levelDesc></xs:documentation>
+          <xs:documentation><levelDesc LevelChoice="S">Name of Station</levelDesc></xs:documentation>
+          <xs:documentation><levelDesc LevelChoice="C">Name of Channel</levelDesc></xs:documentation>
+          <xs:documentation><example LevelChoice="N">IU</example></xs:documentation>
+          <xs:documentation><example LevelChoice="S">ANMO</example></xs:documentation>
+          <xs:documentation><example LevelChoice="C">BHZ</example></xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+
+   If LevelChoice is not used (or if no choice is present that matches
+   the Network, Station or Channel element, then the default value is
+   used.
+
+* ElementChoice="X" - Serves a similar function to LevelChoice except
+  that it helps disambiguate StationXML elements that share a common
+  parent type.  For example, the unit attribute within FloatType:
+
+  .. code-block:: XML
+
+      <xs:attribute name="unit" type="xs:string" use="optional">
+        <xs:annotation>
+          <xs:documentation>The unit of measurement. Use *SI* unit names and symbols whenever possible
+            (e.g., 'm' instead of 'METERS').</xs:documentation>
+          <xs:documentation><example>SECONDS</example></xs:documentation>
+          <xs:documentation><example ElementChoice="WaterLevel">m</example></xs:documentation>
+          <xs:documentation><example ElementChoice="Amplitude">m</example></xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+
+   Because several elements are of FloatType but may have different
+   units (METERS, SECONDS, etc), we use this to give more specific
+   examples based on the element itself (Waterlevel, Amplitude).  Note
+   the default Example has unit=‘SECONDS’.
diff --git a/docs/spelling/schema_words.txt b/docs/spelling/schema_words.txt
new file mode 100644
index 0000000..04655e0
--- /dev/null
+++ b/docs/spelling/schema_words.txt
@@ -0,0 +1,139 @@
+Agency
+Amplitude
+ApproximationLowerBound
+ApproximationType
+ApproximationUpperBound
+AreaCode
+Author
+Azimuth
+BeginEffectiveTime
+CalibrationDate
+CalibrationUnits
+CfTransferFunctionType
+Channel
+ClockDrift
+Coefficient
+Coefficients
+Comment
+Contact
+Correction
+Country
+CountryCode
+County
+Created
+CreationDate
+DataAvailability
+DataLogger
+Decimation
+Delay
+Denominator
+Depth
+Description
+Dip
+Elevation
+Email
+EndEffectiveTime
+Equipment
+Extent
+ExternalReference
+FDSNStationXML
+FIR
+Factor
+Frequency
+FrequencyDBVariation
+FrequencyEnd
+FrequencyLowerBound
+FrequencyStart
+FrequencyUpperBound
+Geology
+Identifier
+Imaginary
+InputSampleRate
+InputUnits
+InstallationDate
+InstrumentPolynomial
+InstrumentSensitivity
+Latitude
+Longitude
+Manufacturer
+MaximumError
+Model
+Module
+ModuleURI
+Name
+Network
+NormalizationFactor
+NormalizationFrequency
+NumberSamples
+NumberSeconds
+Numerator
+NumeratorCoefficient
+Offset
+Operator
+OutputUnits
+Phase
+Phone
+PhoneNumber
+Pole
+PolesZeros
+Polynomial
+PreAmplifier
+PzTransferFunctionType
+Real
+Region
+RemovalDate
+Response
+ResponseList
+ResponseListElement
+SampleRate
+SampleRateRatio
+SelectedNumberChannels
+SelectedNumberStations
+Sender
+Sensor
+SerialNumber
+Site
+Source
+Span
+Stage
+StageGain
+Station
+Symmetry
+TerminationDate
+TotalNumberChannels
+TotalNumberStations
+Town
+Type
+URI
+Value
+Vault
+Vendor
+WaterLevel
+WebSite
+Zero
+alternateCode
+code
+datum
+description
+end
+endDate
+historicalCode
+i
+id
+locationCode
+maximumTimeTear
+measurementMethod
+minusError
+name
+number
+numberSegments
+plusError
+resourceId
+restrictedStatus
+schemaVersion
+sourceID
+start
+startDate
+subject
+type
+unit
diff --git a/docs/spelling/text_words.txt b/docs/spelling/text_words.txt
new file mode 100644
index 0000000..04b5e51
--- /dev/null
+++ b/docs/spelling/text_words.txt
@@ -0,0 +1,107 @@
+ABCD
+ALQ
+AtoD
+BHZ
+Butterworth
+DDThh
+DOI
+Elsevier
+GSN
+Geotech
+Hagerty
+Kinemetrics
+Kluwer
+Lett
+Maclaurin
+NaN
+Quanterra
+Qx
+Rc
+Reftek
+Ringler
+SSSZ
+Seis
+SeisComp
+Sercel
+Setra
+StorageFormat
+Streckeisen
+USGS
+UTF
+Wordpad
+YYYY
+acausal
+accelerometer
+albq
+anyURI
+ascii
+bandlimited
+bandpass
+bhz
+blockette
+blockettes
+convolved
+convolving
+datacenter
+dataless
+datalogger
+dataloggers
+dateTime
+digitizer
+downsampling
+evalresp
+extensometers
+fdsn
+fdsn-station
+http
+jane
+levelDesc
+lowpass
+mbar
+Nyquist
+obspy
+oversample
+oversampled
+oversamples
+passband
+piecewise
+polezero
+preamplifier
+preamplifiers
+seismometer
+seismometers
+sinusoid
+sinusoids
+sps
+ssZ
+subchannel
+subsecond
+subtype
+subtypes
+thermistor
+thermistors
+uncertaintyDouble
+unprimed
+usgs
+validator
+waveforms
+xml
+xmlns
+xs
+xsd
+ss
+YYYY
+DDThh
+ssZ
+SSSZ
+Bernalillo
+nd
+Oppenheim
+Schafer
+Haykin
+Ringler
+Bastien
+Scherbaum
+Steim
+Veen
+Englewood
diff --git a/docs/stage_sequence.png b/docs/stage_sequence.png
new file mode 100644
index 0000000..2d9f729
Binary files /dev/null and b/docs/stage_sequence.png differ
diff --git a/docs/stationxml_tools.rst b/docs/stationxml_tools.rst
new file mode 100644
index 0000000..fd42c18
--- /dev/null
+++ b/docs/stationxml_tools.rst
@@ -0,0 +1,82 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+As StationXML files are ordinary text files, they may be edited with
+any text editor (e.g., vi/VIM, TextWrangler, Notepad/Wordpad, etc)
+
+However, StationXML files can become very large and unwieldy as more
+stations and channels are added.  For instance a regional seismic network
+can generate a StationXML file of size > 30Mb on disk (>400,000 lines).
+
+Fortunately, several tools exist that allow creation and editing of
+StationXML files.
+
+ObsPy + NRL
+==============
+
+ObsPy contains a number of very useful modules for working with StationXML.
+In particular, ObsPy contain a module able to connect
+to the IRIS Nominal Resource Library (NRL) and
+download full responses (sensor + datalogger) for various combinations
+of sensor + datalogger contained within the NRL.
+
+The excerpts below provide examples of how to work with ObsPy and the NRL.
+
+
+.. literalinclude:: examples/obspy/plot_response.py
+  :language: python
+
+
+The resulting response plot looks like
+
+.. image:: examples/obspy/sts2-rt130.png
+
+
+.. toggle-header::
+    :header: Output for the response stages **Show/Hide Stages**
+
+    .. literalinclude:: examples/obspy/plot_output.txt
+
+
+
+Up until now we have been examining the response in ObsPy format, that is, as an instance
+of type obspy.core.inventory.response.Response.
+
+We can also examine this as part of a StationXML file, however, StationXML
+does not allow children to exist without parents.  Thus, a response must
+be contained within a <Channel> element, which itself must be contained
+within a <Station> element, which must be contained within a <Network>
+element, etc.
+
+The excerpt below creates a generic structure to contain our Response object,
+exports this to StationXML, and validates it against the StationXML schema.
+Note at the time of this writing, ObsPy outputs StationXML 1.1 and does not
+follow all of the recommendations in StationXML 1.2.
+
+.. literalinclude:: examples/obspy/create_staxml.py
+  :language: python
+
+.. toggle-header::
+    :header: The output StationXML file looks like:
+
+    .. literalinclude:: examples/obspy/Test.xml
+      :language: xml
+
+
+IRIS SEED-StationXML Converter
+====================================
+
+IRIS maintains a Java-based tool that can convert between dataless SEED and StationXML formats at:
+
+`<https://github.com/iris-edu/stationxml-seed-converter>`_
+
+
+IRIS StationXML Validator
+====================================
+
+IRIS maintains a Java-based validator for StationXML documents.
+
+Note: this tool validates documents against the official schema in addition
+to a set of rules that are not possible to represent in the XML Schema language.
+
+`<https://github.com/iris-edu/stationxml-validator>`_
diff --git a/docs/sts2-rt130.png b/docs/sts2-rt130.png
new file mode 100644
index 0000000..a366b2c
Binary files /dev/null and b/docs/sts2-rt130.png differ
diff --git a/docs/theory-references.rst b/docs/theory-references.rst
new file mode 100644
index 0000000..102c019
--- /dev/null
+++ b/docs/theory-references.rst
@@ -0,0 +1,10 @@
+
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+* Haykin, S. and B. Van Veen.  Signals And Systems. Wiley, Somerset, New Jersey, 2002.
+* Oppenheim, A.V. and R.W. Schafer. Discrete-Time Signal Processing. Prentice Hall, Englewood Cliffs, New Jersey, 1989.
+* Ringler, A. T. and P. Bastien (2020). A brief introduction to seismic instrumentation: Where does my data come from?, Seis. Res. Lett., 91 (2A), 1074-1083
+* Ringler, A. T. and J. R. Evans (2015). A quick SEED tutorial, Seis. Res. Lett., 86 (6), 1717-1725.
+* Scherbaum, F. Of Poles and Zeros: Fundamentals of Digital Seismology. Kluwer Academic. 2nd Edition. 2001.
+* Steim, J.M. Theory and Observations - Instrumentation for Global and Regional Seismology. In: Gerald Schubert (editor-in-chief) Treatise on Geophysics, 2nd edition, Vol 1. Oxford: Elsevier; 2015. p. 29-78.
diff --git a/docs/tools.rst b/docs/tools.rst
new file mode 100644
index 0000000..20ae65e
--- /dev/null
+++ b/docs/tools.rst
@@ -0,0 +1,10 @@
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+
+*************************
+StationXML Tools 
+*************************
+
+.. include:: stationxml_tools.rst
+
diff --git a/docs/transform-FIR-IIR.rst b/docs/transform-FIR-IIR.rst
new file mode 100644
index 0000000..7fd62a9
--- /dev/null
+++ b/docs/transform-FIR-IIR.rst
@@ -0,0 +1,421 @@
+
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+Introduction
+^^^^^^^^^^^^^^^^^^^^^
+
+As we'll see in the next section,
+each of the multiple stages that comprise an instrument response
+can be thought of as a filter that modifies the
+amplitude and phase of the original signal (e.g., ground motion)
+in some way.
+
+In fact, to truly understand instrument response and data processing in general,
+it is necessary to have some familiarity with digital signal processing.
+
+There are two categories of discrete-time filters that we routinely encounter in seismology:
+
+#. FIR filters (Finite Impulse Response)
+#. IIR filters (Infinite Impulse Response)
+
+Both filters can be constructed using difference equations, hence, they are
+often represented in terms of their z-transforms.
+
+FIR filters can be written as:
+
+.. math::
+
+   y[n]=\sum_{k=0}^{M}b_k x[n-k]
+
+while IIR filters can be written as:
+
+.. math::
+
+   y[n]=\sum_{k=0}^{M}b_k x[n-k] + \sum_{k=1}^{N}a_k y[n-k]
+
+FIR filters can be thought of as a sum of weighted values of past inputs, :math:`x[n-k]`
+(the so called *moving average* filter).
+IIR filters have this same moving average component, but also offer the
+possibility of feedback, since the current output :math:`y[n]` can also depend on a weighted
+combination of past outputs, :math:`y[n-k]`.
+
+For a finite input impulse, the subsequent impulse response of a FIR filter is finite.
+However, because of the dependence on past outputs, the
+impulse response of the IIR filter is, at least in theory, infinite; it continues
+long after the input signal has finished.
+
+In the FIR case, the system function, found by taking the z-transform of the difference
+equation, can be written
+
+.. math::
+
+   H(z)=\sum_{k=0}^{M}b_k z^{-k}
+
+while for the IIR case, the system function is
+
+.. math::
+
+   H(z)=\frac{\sum_{k=0}^{M}b_k z^{-k}} {\sum_{k=0}^{N}a_k z^{-k}}
+
+
+where :math:`a_0=1`.
+
+The system functions can be factored in terms of their poles and zeros as
+
+.. math::
+   :nowrap:
+
+   \begin{eqnarray}
+      H_{FIR}(z) &=& b_0{\Pi_{k=1}^{M}(1-c_k z^{-1})} \\
+      H_{IIR}(z) &=& \frac{b_0{\Pi_{k=1}^{M}(1-c_k z^{-1})}} {\Pi_{k=1}^{N}(1-d_k z^{-1})}
+   \end{eqnarray}
+
+Thus, the FIR filter has arbitrary zeros, but only has poles at the origin (:math:`z=0`).
+However, poles (or zeros for that matter) at the origin don't affect the frequency response since
+they are located a fixed distance (:math:`|z|=1`) from the unit circle.
+
+In contrast, the IIR filter may have both zeros and poles at arbitrary locations, making them
+especially flexible.
+
+The corresponding impulse responses are found by taking the inverse z-transform
+of the system functions,
+
+.. math::
+   :nowrap:
+
+   \begin{eqnarray}
+      h_{FIR}[n] &=& \begin{cases}
+                        b_n & 0\le n\le M \\
+                        0 & else
+                     \end{cases}
+   \end{eqnarray}
+
+Thus the FIR impulse response is given by the difference equation coefficients, :math:`b_k`, themselves,
+and the impulse response dies after :math:`M` terms.
+
+The impulse response of the causal parts of the IIR filter can be written as
+
+.. math::
+   :nowrap:
+
+   \begin{eqnarray}
+      h_{IIR}[n] &=& \sum_{k=1}^{N}A_k(d_k)^{n}u[n]
+   \end{eqnarray}
+
+where :math:`u[n]` is the unit step function (:math:`u[n]=1,n\ge 0`).
+
+Because of the geometric series :math:`d_k^{n}`, the IIR impulse response decays but
+never actually reaches zero.
+
+FIR vs IIR
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The primary distinguishing factor between FIR and IIR filters is this:
+
+FIR filters are guaranteed to have a linear phase response, which is much easier
+to deal with, while IIR filters have non-linear phase response.
+
+Some pros and cons of each filter type is summarized below.
+
+FIR Filters:
+
+   - Pros
+      - Can be designed using optimization techniques to match a desired magnitude/phase response
+      - Allow for arbitrary magnitude/phase response
+      - Allow for linear or zero phase response (no distortion)
+      - Are always stable
+   - Cons
+      - Can require a large number of coefficients (e.g., :math:`M\approx 100`) to
+        achieve desired accuracy, particularly for steep filters.
+
+IIR Filters:
+
+   - Pros
+      - Can be implemented very efficiently
+        - fewer coefficients than FIR for comparable frequency selective filter accuracy (e.g., :math:`M\approx N\approx 8`)
+      - Filtering is fast
+   - Cons
+      - Generally can't use optimization techniques to design
+      - Better approach is to start from a well-known analog filter design
+        and transform it to discrete-time filter.
+      - Limited to frequency selective filters (e.g., bandpass, high-pass, etc)
+      - Phase is nonlinear (will always cause phase distortion within the passband)
+      - Zero phase filters are impossible to implement exactly
+        (you can get this by filtering forward + backward, but this can't be implemented in real-time!)
+
+In spite of the cons listed above, there are some instances where IIR filters are preferred.
+For instance, for implementing maximally flat selective filters (e.g., Butterworth bandpass filters)
+or for modeling the behavior of systems with feedback.
+
+Nevertheless, the vast majority of filters encountered in seismic metadata
+are *anti-alias* filters used at each decimation stage of the digitizer,
+and the digital anti-alias filters most commonly used are linear phase
+FIR filters that produce a constant time shift.
+
+..
+   If the time shift is zero or is corrected for, the filter is
+   called a *zero phase* filter.
+
+Hence, in what follows we will concentrate on FIR filters.
+
+Classification of FIR Filters
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+FIR filter frequency response can be written
+
+.. math::
+
+   H(e^{j\omega})=\sum_{k=0}^{M}b_{k}z^{-k}=\sum_{k=0}^{M}b_{k}e^{-j\omega k}=\sum_{k=0}^{M}h[k]e^{-j\omega k}
+
+where in the last expression, we identify the filter coefficients :math:`b_{k}` as the
+impulse response values: :math:`h[k]=b_k` to show that the output of the FIR
+filter is the convolution of the input signal :math:`x[n]` with the filter
+impulse response.
+
+It can be shown that the FIR filter response has generalized linear phase of the form,
+
+.. math::
+
+   H(e^{j\omega})=A(e^{j\omega})e^{-j(\omega\alpha+\beta)}
+
+where :math:`A(e^{j\omega})` describes the real amplitude,
+:math:`\beta` is a constant phase factor, and :math:`\alpha` is the constant group delay.
+
+A consequence of this constant group delay (also called *phase* delay) is that
+the shape of the input waveform is not changed; all frequencies are delayed
+the right amount so that they add together in the same way to form the output signal.
+The resulting output signal has the same shape as the input signal
+but is delayed in time.
+
+Some general observations about FIR filters are:
+   - FIR filters contain as many poles as they have zeros.
+   - The number of zeros (poles), :math:`M`, is called the *order* of the FIR filter
+   - All the poles are located at the origin (inside the unit circle), hence FIR filters are said to be *stable*.
+   - These poles don't affect the magnitude of the frequency response, only the phase.
+
+Note that a filter of order M has length M+1.
+
+FIR filters with generalized linear phase are often
+divided into 4 types depending on whether the order M is even or odd,
+so that the number of points is either odd or even,
+and whether the impulse response (=FIR coefficients) exhibits
+even or odd symmetry about the middle point.
+
+FIR filters with symmetrical impulse response are often called
+*two-sided* or *acausal*.
+As a consequence of the symmetry of the filter impulse response,
+the onsets of very impulsive signals (with energy at frequencies near
+the Nyquist cut-off for the FIR filter), may be contaminated
+by precursory (=acausal) oscillations.
+
+..
+   For each type, the positions of zeros in the complex plane are:
+   - Type 1: Either an even number or no zeros at z=1 and z=-1
+   - Type 2: Either an even number or no zeros at z=1 and an odd number of zeros at z=-1
+   - Type 3: An odd number of zeros at z=1 and z=-1
+   - Type 4: An odd number of zeros at z=1 and an even number or no zeros at z=-1
+
+Type I: M even
+'''''''''''''''''''''''''''''''''''''''''''''''''
+   M even + even symmetry about the midpoint M/2
+
+   Note that in this case, there will be M+1 (odd) points in the filter and
+   M/2 will fall on an index right in the middle:
+
+   .. math::
+
+      h[k]=h[M-k],0\le k\le M
+
+   We can write out the frequency response and use symmetry to simplify,
+
+   .. need to change both latex and html!
+
+   .. only:: latex
+
+       .. math::
+          :nowrap:
+
+          \begin{changemargin}{-4cm}{-2cm}
+            \begin{eqnarray}
+               H(e^{j\omega})&=&\sum_{k=0}^{M}h[k]e^{-j\omega k} \\
+               &=&h[0]+h[1]e^{-j\omega\cdot1}+h[2]e^{-j\omega\cdot2}+...+h[M-1]e^{-j\omega\cdot(M-1)}+h[M]e^{-j\omega\cdot M} \\
+               &=&e^{-j\omega\frac{M}{2}}\Big[h[0]e^{+j\omega\frac{M}{2}}+h[1]e^{-j\omega\cdot1}e^{+j\omega\frac{M}{2}}+...+h[M-1]e^{-j\omega\cdot(\frac{M}{2}-1)}+h[M]e^{-j\omega\frac{M}{2}}\Big] \\
+               &=&e^{-j\omega\frac{M}{2}}\Big[h[0]e^{+j\omega\frac{M}{2}}+h[M]e^{-j\omega\frac{M}{2}}+h[1]e^{-j\omega\cdot1}e^{+j\omega\frac{M}{2}}+...+h[M/2+1]e^{-j\omega\cdot1}+h[M/2]\Big] \\
+               &=&e^{-j\omega\frac{M}{2}}\Big[h[0](e^{+j\omega\frac{M}{2}}+e^{-j\omega\frac{M}{2}})+h[1](e^{+j\omega(\frac{M}{2}-1)}+e^{-j\omega(\frac{M}{2}-1)})+...+h[M/2-1](e^{+j\omega}+e^{-j\omega})+h[M/2]\Big] \\
+               &=&e^{-j\omega\frac{M}{2}}\Big[h[0]2cos(\frac{M}{2}\omega)+h[1]2cos((\frac{M}{2}-1)\omega)+...+h[M/2-1]2cos(\omega)+h[M/2]\Big] \\
+               H(e^{j\omega})&=&e^{-j\omega\frac{M}{2}}\sum_{k=0}^{M/2}a[k]cos(\omega k)
+            \end{eqnarray}
+          \end{changemargin}
+
+   .. only:: html
+
+       .. math::
+          :nowrap:
+
+          \begin{eqnarray}
+             H(e^{j\omega})&=&\sum_{k=0}^{M}h[k]e^{-j\omega k} \\
+             &=&h[0]+h[1]e^{-j\omega\cdot1}+h[2]e^{-j\omega\cdot2}+...+h[M-1]e^{-j\omega\cdot(M-1)}+h[M]e^{-j\omega\cdot M} \\
+             &=&e^{-j\omega\frac{M}{2}}\Big[h[0]e^{+j\omega\frac{M}{2}}+h[1]e^{-j\omega\cdot1}e^{+j\omega\frac{M}{2}}+...+h[M-1]e^{-j\omega\cdot(\frac{M}{2}-1)}+h[M]e^{-j\omega\frac{M}{2}}\Big] \\
+             &=&e^{-j\omega\frac{M}{2}}\Big[h[0]e^{+j\omega\frac{M}{2}}+h[M]e^{-j\omega\frac{M}{2}}+h[1]e^{-j\omega\cdot1}e^{+j\omega\frac{M}{2}}+...+h[M/2+1]e^{-j\omega\cdot1}+h[M/2]\Big] \\
+             &=&e^{-j\omega\frac{M}{2}}\Big[h[0](e^{+j\omega\frac{M}{2}}+e^{-j\omega\frac{M}{2}})+h[1](e^{+j\omega(\frac{M}{2}-1)}+e^{-j\omega(\frac{M}{2}-1)})+...+h[M/2-1](e^{+j\omega}+e^{-j\omega})+h[M/2]\Big] \\
+             &=&e^{-j\omega\frac{M}{2}}\Big[h[0]2cos(\frac{M}{2}\omega)+h[1]2cos((\frac{M}{2}-1)\omega)+...+h[M/2-1]2cos(\omega)+h[M/2]\Big] \\
+             H(e^{j\omega})&=&e^{-j\omega\frac{M}{2}}\sum_{k=0}^{M/2}a[k]cos(\omega k)
+          \end{eqnarray}
+
+
+   where :math:`a[0]=h[M/2],a[1]=2h[M/2-1],...,a[M/2]=2h[0]`.
+
+
+   In general, :math:`a[0]=h[\frac{M}{2}]`, and :math:`a[k]=2h[\frac{M}{2}-k],k=1,...,\frac{M}{2}`.
+
+   The :math:`a[k]` coefficients are real, hence the sum is real, and the response
+   satisfies the generalized linear phase property:
+
+   .. math::
+
+      H(e^{j\omega})=A(e^{j\omega})e^{-j(\omega\alpha+\beta)}
+
+   Hence for Type I, the amp is: :math:`A(e^{j\omega})=\sum_{k=0}^{M/2}a[k]cos(\omega k)`,
+   while the phase term is: :math:`e^{-j\omega\frac{M}{2}}`
+   and the corresponding group delay is: :math:`\alpha=\frac{M}{2}`.
+
+Type II: M odd
+''''''''''''''''''''''''''''''''''''''''''''''''''
+   M odd + even symmetry about the midpoint M/2
+
+   Note that in this case, there will be M+1 (even) points in the filter,
+   hence the symmetry mid-point falls between two sample points.
+
+   .. math::
+
+      h[k]=h[M-k],0\le k\le M
+
+   By similar algebra as above, we can write the frequency response as
+
+   .. math::
+
+      H(e^{j\omega})=e^{-j\omega\frac{M}{2}}\sum_{k=1}^{\frac{(M+1)}{2}}b[k]cos(\omega(k-\frac{1}{2}))
+
+   where :math:`b[k]=2h[(\frac{(M+1)}{2}-k],k=1,...,\frac{(M+1)}{2}`.
+
+   Thus, this system also has group delay :math:`\alpha=\frac{M}{2}`.
+
+Type III/IV anti-symmetric
+'''''''''''''''''''''''''''''''''''''''''''''''''
+
+Type III (M even) and Type IV (M odd) FIR filters exhibit anti-symmetry about the midpoint:
+:math:`h[k]=-h[M-k]`.
+
+As a result, their expansions reduce to summation of sine functions and can't be used
+to implement low-pass filters, hence they are not used for anti-alias filtering.
+
+
+Practical Concerns
+'''''''''''''''''''''''''''''''''''''''''''''''''
+
+Thus, we normally use FIR filters of type I or II for anti-alias filtering.
+Because of their symmetry, only half the coefficients need to be stored
+in the metadata.
+
+In StationXML, a FIR filter can be represented using a FIR response stage, with
+sub-element indicating the symmetry (ODD/EVEN/NONE). Note that here, both ODD
+and EVEN symmetry refer to a symmetric FIR filter (there is no flag to indicate
+an asymmetric filter), with the ODD symmetry indicating the total number of FIR
+coefficients, M, is odd (so that the point of symmetry corresponds to index
+(M-1)/2 in the coefficient array. This is also referred to as a "Type I" FIR
+filter in digital signal processing literature
+and is often used in seismic datalogger downsampling
+sequences. In contrast, a symmetric FIR filter with EVEN symmetry has a total
+number of FIR coefficients, M, that is even. As a result, there is no actual
+index at the point of symmetry. This is also referred to as a "Type II" FIR
+filter.
+
+The purpose of the Symmetry element is to obviate the need to enter the entire M
+FIR coefficients when the filter is symmetric (ODD or EVEN). In the case of EVEN
+symmetry, only the unique M/2 coefficients need to be supplied, while in the
+case of ODD symmetry, the number of unique coefficients is M/2 + 1. In the case
+of EVEN symmetry (an even total number of coefficients), there will be an even
+number of unique coefficients.
+However, importantly, in the case of ODD symmetry (an odd total number of
+coefficients), the number of unique coefficients specified in the StationXML may
+be either odd or even.
+
+This simple example illustrate when to use ODD or EVEN :
+
+  .. code-block:: XML
+
+    <FIR>
+        <Symmetry>ODD</Symmetry>
+        <NumeratorCoefficient i="1">0.1</NumeratorCoefficient>
+        <NumeratorCoefficient i="2">0.4</NumeratorCoefficient>
+        <NumeratorCoefficient i="3">0.5</NumeratorCoefficient>
+    </FIR>
+
+
+
+which expands to be equivalent to:
+
+  .. code-block:: XML
+
+    <FIR>
+        <Symmetry>NONE</Symmetry>
+        <NumeratorCoefficient i="1">0.1</NumeratorCoefficient>
+        <NumeratorCoefficient i="2">0.4</NumeratorCoefficient>
+        <NumeratorCoefficient i="3">0.5</NumeratorCoefficient>
+        <NumeratorCoefficient i="4">0.4</NumeratorCoefficient>
+        <NumeratorCoefficient i="5">0.1</NumeratorCoefficient>
+    </FIR>
+
+and also
+
+  .. code-block:: XML
+
+    <FIR>
+        <Symmetry>EVEN</Symmetry>
+        <NumeratorCoefficient i="1">0.1</NumeratorCoefficient>
+        <NumeratorCoefficient i="2">0.4</NumeratorCoefficient>
+        <NumeratorCoefficient i="3">0.5</NumeratorCoefficient>
+    </FIR>
+
+which expands to be equivalent to:
+
+  .. code-block:: XML
+
+    <FIR>
+        <Symmetry>NONE</Symmetry>
+        <NumeratorCoefficient i="1">0.1</NumeratorCoefficient>
+        <NumeratorCoefficient i="2">0.4</NumeratorCoefficient>
+        <NumeratorCoefficient i="3">0.5</NumeratorCoefficient>
+        <NumeratorCoefficient i="4">0.5</NumeratorCoefficient>
+        <NumeratorCoefficient i="5">0.4</NumeratorCoefficient>
+        <NumeratorCoefficient i="6">0.1</NumeratorCoefficient>
+    </FIR>
+
+
+Note that one cannot tell the "symmetry" (ODD/EVEN/NONE) just by looking at
+the (possibly reduced) number of coefficients in the StationXML FIR element.
+
+When in doubt, simply enter all of the FIR coefficients with Symmetry = None, so
+that no assumptions will be made when calculating the frequency response of the
+filter.
+
+In practice, even symmetric FIR filter coefficients are often
+stored in a `Coefficients <reference.html#response-stage-coefficients>`_ response stage.
+
+This is how the FIR response is calculated in ObsPy, which uses the
+venerable evalresp C code underneath the hood.
+
+Note that in evalresp, this type of filter is
+termed *FIR_ASYM*, meaning it can handle both symmetric (about the mid-point)
+and non-symmetric FIR coefficients.
+All of the coefficients are used in the expansion to calculate the filter response.
+
+In contrast, IIR filter coefficients can't be stored in a FIR response stage,
+since it only allows for numerator coefficients. IIR filter coefficients
+can be stored in a `Coefficients <reference.html#response-stage-coefficients>`_ response stage.
+However, IIR responses are very sensitive to round-off errors in
+the values of the stored coefficients and can become unstable.
+Therefore, many IIR filters are instead stored as a `PolesZeros <reference.html#response-stage-poleszeros>`_ response stage
+of type 'D' (digital) and are expanded in terms of the poles and zeros of
+the z-transform as discussed above.
diff --git a/docs/transform-convolution.rst b/docs/transform-convolution.rst
new file mode 100644
index 0000000..d0a348d
--- /dev/null
+++ b/docs/transform-convolution.rst
@@ -0,0 +1,91 @@
+
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+Introduction
+^^^^^^^^^^^^^^^^^^^^^
+
+As we'll see in the next sections, a geophysical sensor (e.g., seismometer)
+connected to a datalogger that digitizes and records the
+input signal (e.g., ground motion), represents a linear time-invariant (LTI)
+system.  We can thus model the overall effect of the instrumentation on
+the input signal as a linear combination of stages representing each
+component of the instrumentation.  The stages are connected sequentially
+so that the output of stage 1, representing the sensor,
+forms the input of stage 2, which might represent either a preamplifier
+or a digitizer.
+As the input signal passes through each stage, we say that it is "convolved"
+with the impulse response of that stage, to form the output signal that
+then becomes the input signal for the subsequent stage.
+
+Convolution is a mathematical operation between two functions.
+For instance, if function :math:`f(t)` represents the input signal to a
+stage, and function :math:`g(t)` represents the impulse response of the
+stage, then the output of the stage is the convolution between :math:`f(t)`
+and :math:`g(t)`.
+
+Given two functions :math:`f(t)` and :math:`g(t)` defined for all :math:`t\ge 0`,
+their convolution at time :math:`t` is defined by:
+
+.. math::
+
+   (f*g)(t)=\int_{0}^{t}f(t-\tau)g(\tau)d\tau
+
+where :math:`*` represents the convolution operator.
+
+Suppose that f and g are piecewise continuous and of exponential order. Then
+
+.. math::
+
+   L[f*g]=L[f]L[g]
+
+Where :math:`L` is the Laplace Transform operator.
+
+Proof
+^^^^^
+
+If we extend the functions :math:`f` and :math:`g` to be 0 for :math:`t<0`,
+then the integral above is the same as
+
+.. math::
+
+   (f*g)(t)=\int_{0}^{\infty}f(t-\tau)g(\tau)d\tau
+
+i.e., for :math:`\tau>t`, :math:`(t-\tau)<0` and :math:`f(t-\tau)=0`.
+
+So we can write the Laplace Transform as
+
+.. math::
+
+   L[f*g](s)=\int_{0}^{\infty}\int_{0}^{\infty}f(t-\tau)g(\tau)d\tau e^{-st}dt
+
+Interchanging the order of integration gives
+
+.. math::
+
+   L[f*g]=\int_{0}^{\infty}\int_{0}^{\infty}f(t-\tau)e^{-st}dtg(\tau)d\tau
+
+Substitute :math:`u=t-\tau,du=dt`,
+
+.. math::
+
+   L[f*g]=\int_{0}^{\infty}\int_{0}^{\infty}f(u)e^{-s(u+\tau)}du\cdot g(\tau)d\tau
+
+or
+
+.. math::
+   :nowrap:
+
+   \begin{eqnarray}
+      L[f*g](s) &=& \int_{0}^{\infty}f(u)e^{-su}du\cdot \int_{0}^{\infty}g(\tau)e^{-s\tau}d\tau \\
+      &=& L[f]L[g]
+   \end{eqnarray}
+
+
+In other words, the Laplace Transform of the convolution of :math:`f` and :math:`g`,
+is equal to the product of the Laplace Transform of :math:`f` times the Laplace Transform
+of :math:`g`.  This holds true for all of the "frequency" transforms (Fourier, Laplace, z).
+
+It is for this reason that most instrument response calculations are
+performed in the frequency domain, by multiplying the frequency response of
+subsequent stages (or filters) together.
diff --git a/docs/transform-fourier.rst b/docs/transform-fourier.rst
new file mode 100644
index 0000000..34a80ec
--- /dev/null
+++ b/docs/transform-fourier.rst
@@ -0,0 +1,62 @@
+
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+Introduction
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The Fourier Transform (:math:`t \rightarrow \omega`) is defined by
+
+.. math::
+
+   X(\omega)=\frac{1}{2\pi}\int_{-\infty}^{\infty}x(t)e^{-j\omega t}dt
+
+while the Inverse Fourier Transform (:math:`\omega \rightarrow t`)  is given by
+
+.. math::
+
+   x(t)=\int_{-\infty}^{\infty}X(\omega)e^{+j\omega t}d\omega
+
+There are different conventions in use for the Fourier Transform.
+The conventions differ in which transform (forward vs. reverse) has
+the positive sign in the exponent, and which transform is scaled
+by :math:`\frac{1}{2\pi}`.
+Some authors prefer to scale each transform by :math:`\frac{1}{\sqrt{2\pi}}`
+instead.
+What is important is that forward and reverse transforms must
+have exponents that are opposite in sign,
+and the product of the scale factors must equal :math:`\frac{1}{2\pi}`.
+
+
+Discrete Time Fourier Transform (DTFT)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In the Fourier transform pair above, both time (:math:`t`) and frequency (:math:`\omega`)
+are continuous parameters.
+In contrast, for signals sampled discretely in time, we may define the related Discrete Time Fourier Transform (DTFT) as
+
+.. math::
+
+   X(\omega)=\frac{1}{2\pi}\sum_{n=-\infty}^{\infty}x[n]e^{-j\omega n}
+
+.. math::
+
+   x[n]=\int_{0}^{2\pi}X(\omega)e^{+j\omega n}d\omega
+
+where :math:`n` is the discrete sample number, and :math:`\omega`  is still continuous.
+
+Discrete Fourier Transform (DFT)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+
+And finally, when both time and frequency are discrete, we define the Discrete Fourier Transform (DFT) pair by
+
+.. math::
+
+   X[k]=\frac{1}{N}\sum_{n=0}^{N-1}x[n]e^{-j2\pi kn/N}
+
+.. math::
+
+   x[n]=\sum_{k=0}^{N-1}X[k]e^{+j2\pi kn/N}
+
+Note that the popular Fast Fourier Transform (FFT) is a particular implementation of the DFT.
diff --git a/docs/transform-laplace.rst b/docs/transform-laplace.rst
new file mode 100644
index 0000000..ded53db
--- /dev/null
+++ b/docs/transform-laplace.rst
@@ -0,0 +1,160 @@
+
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+Introduction
+^^^^^^^^^^^^^^^^^^^^^
+
+The Laplace Transform is defined by
+
+.. math::
+
+   X(\sigma,\omega)=\int_{-\infty}^{\infty}x(t)e^{-\sigma t}e^{-j\omega t}dt
+
+If we make the substitution, :math:`s=\sigma + j\omega`, this becomes
+
+.. math::
+
+   X(s)=\int_{-\infty}^{\infty}x(t)e^{-s t}dt
+
+Each point in the complex s-plane is associated with a frequency, :math:`\omega`  and
+an exponent :math:`\sigma`.
+Thus, each point in the s-plane describes a sinusoid of frequency :math:`\omega`  that is either
+exponentially growing (:math:`\sigma>0`) or exponentially decaying (:math:`\sigma<0`) with time.
+
+Note that the Laplace transform evaluated along the imaginary axis (where the attenuation parameter,
+:math:`\sigma=0`), reduces to the complex Fourier transform, :math:`X(\omega)`.
+
+The Laplace transform at point :math:`s`  is a measure of the
+similarity between the input signal, :math:`x(t)`, and the corresponding
+exponentially growing/decaying sinusoid.
+A large value of :math:`X(s)`  corresponds to a strong similarity between the
+input signal and the sinusoid :math:`e^{-(\sigma + j\omega)t}`, indicating a
+strong presence of the sinusoid in the input signal.
+
+In practice, we are often only interested in causal signals that begin at :math:`t=0`.
+Using the unit step function,
+
+.. math::
+   :nowrap:
+
+   \begin{equation*}
+       u(t)=\begin{cases}
+         1 & t\ge0\\
+         0 & t<0
+         \end{cases}
+   \end{equation*}
+
+we may ensure causality by writing :math:`x(t)=u(t)x(t)` , so that the Laplace Transform becomes
+
+.. math::
+
+   X(s)=\int_{0}^{\infty}x(t)e^{-s t}dt
+
+
+Poles and Zeros
+^^^^^^^^^^^^^^^^^^^^^
+
+
+Suppose we have a data processing system (e.g., analog sensor + datalogger) that can be characterized
+by the linear differential equation,
+
+.. math::
+
+   a_{2}\ddot{y}(t)+a_{1}\dot{y}(t)+a_{0}y(t)=b_{2}\ddot{x}(t)+b_{1}\dot{x}(t)+b_{0}x(t)
+
+where :math:`x(t)` is the input signal (e.g., the ground motion), :math:`y(t)` is the output signal (the signal recorded)
+and :math:`a_{k}` and :math:`b_{k}`  are constant (time-invariant) coefficients.
+If we assume the system is causal, so that the signals + derivatives are all 0 for :math:`t<0` ,
+then the Laplace Transform of the equation gives
+
+.. math::
+
+   a_{2}s^{2}Y(s)+a_{1}sY(s)+a_{0}Y(s)=b_{2}s^{2}X(s)+b_{1}sX(s)+b_{0}X(s)
+
+or
+
+.. math::
+
+   (a_{2}s^{2}+a_{1}s+a_{0})Y(s)=(b_{2}s^{2}+b_{1}s+b_{0})X(s)
+
+From this we can write the system transfer function relating the output to the input as
+
+.. math::
+
+   H(s) = \frac{Y(s)}{X(s)}=\frac{b_{2}s^{2}+b_{1}s+b_{0}}{a_{2}s^{2}+a_{1}s+a_{0}}
+
+or more generally,
+
+.. math::
+
+   H(s) =\frac{\sum_{k=0}^{M}b_k s^n}{\sum_{k=0}^{N}a_n s^n}
+
+This is the coefficient representation of the transfer function.
+It represents the transfer function as the ratio of two polynomials.
+The roots of the numerator polynomial are called 'zeros', while the
+roots of the denominator polynomial are called 'poles'.
+
+Often, for analog stages, it is more convenient to factor the
+transfer function in terms of these poles and zeros:
+
+.. math::
+
+   H(s)=\frac{\Pi_{k=1}^{M} (s-z_{k})} {\Pi_{k=1}^{N} (s-p_{k})}
+
+where :math:`z_{k}` are the M zeros of the system, and :math:`p_{k}` are the N poles.
+
+Because the coefficients of the numerator and denominator polynomials are real,
+the corresponding roots (poles and zeros) must occur in complex conjugate pairs.
+
+Thus, the poles and zeros are either real or form pairs that are symmetric with
+respect to the real axis in the complex :math:`s`-plane.
+In addition, it can be shown that for systems that are stable and causal,
+the poles all have real parts :math:`\le 0`.
+
+Recall that the Laplace transform variable is given by :math:`s=\sigma+j\omega`.
+Along the imaginary axis, :math:`\sigma=0` and hence :math:`s=j\omega`.
+Thus, we may express the complex frequency response of the analog stage
+by calculating its polezero expansion
+
+.. math::
+
+   H(f)=A_0\frac{\Pi_{k=1}^{M} (s-z_{k})} {\Pi_{k=1}^{N} (s-p_{k})}
+
+where :math:`s=j2\pi f` [rad/s] or :math:`s=jf` [Hz].
+
+Thus, given the poles and zeros of an analog stage,
+in order to properly calculate the stage frequency response,
+we must know the units of :math:`s` used to calculate the poles and zeros.
+
+In StationXML, these units are specified by the PzTransferFunctionType element
+within the PolesZerosType response stage:
+
+   ::
+
+      <Stage number="1">
+      <PolesZeros>
+         ...
+         </OutputUnits>
+            <PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType>
+            <NormalizationFactor>1.0</NormalizationFactor>
+            <NormalizationFrequency unit="HERTZ">1.0</NormalizationFrequency>
+
+
+where the possible values for PzTransferfunctionType are:
+
+  #. "LAPLACE (RADIANS/SECOND)"
+  #. "LAPLACE (HERTZ)"
+  #. "DIGITAL (Z-TRANSFORM)"  (Discussed in next section)
+
+Note also the <NormalizationFrequency> with unit "HERTZ".
+These units are distinct from those used to identify :math:`s` above.
+The <NormalizationFrequency> specifies
+the frequency (in Hz) at which the polezero transfer function is normalized.
+The recommended practice is to choose a value of normalization factor,
+:math:`A_0`, that normalizes the polezero expansion to unity at the specified
+normalization frequency, :math:`f_n`:
+
+.. math::
+
+   |H(f_n)| = 1.0
diff --git a/docs/transform-z.rst b/docs/transform-z.rst
new file mode 100644
index 0000000..660c4bd
--- /dev/null
+++ b/docs/transform-z.rst
@@ -0,0 +1,197 @@
+
+.. Put any comments here
+   Be sure to indent at this level to keep it in comment.
+
+Introduction
+^^^^^^^^^^^^^^^^^^^^^
+
+The z-Transform is defined by
+
+.. math::
+
+   X(z)=\sum_{n=0}^{\infty}x[n]z^{-n}
+
+where
+
+.. math::
+
+   z=re^{j\omega}
+
+   z^{-n}=r^{-n}e^{-j\omega n}
+
+Notice that on the unit circle, where :math:`|z|\equiv |r|=1` and :math:`z=e^{j\omega}` , the z-transform reduces to the discrete Fourier transform (DTFT):
+
+.. math::
+
+   X(e^{j\omega})=\sum_{n=0}^{\infty}x[n]e^{-j\omega n}
+
+The z-transform measures the similarity between the input signal :math:`x[n]`
+and the signal :math:`z^{-n}`.
+
+:math:`z^{-n}` represents exponentially increasing (for r < 1) or decreasing (r > 1)
+sinusoids. e.g., :math:`e^{-j\omega n}` is a sinusoid with angular frequency
+:math:`\omega` [radians/sample] that expands with sample number n.
+
+Thus, the location (value) of :math:`z` in the complex plane controls what :math:`z^{-n}` looks like.
+
+The fractional or angular frequency, :math:`\omega` [radians/sample] is related to the linear frequency
+of the sinusoid through
+
+.. math::
+
+   2\pi[radians/cycle]=\omega[radians/sample]\cdot N[samples/cycle]
+
+so the number of samples/cycle is given by
+
+.. math::
+
+   N=\frac{2\pi}{\omega}samples/cycle
+
+and this corresponds to a period of :math:`T=N\Delta t` [seconds],
+
+where :math:`\Delta t` is the sampling interval (secs) and is related to
+the sampling rate by: :math:`f_{s}=\frac{1}{\Delta t}`.
+Then the frequency of oscillation is given by :math:`f=\frac{1}{T}=\frac{1}{N\Delta t}=\frac{f_{s}}{N}` [Hz]
+
+In other words, as the angle in the complex z-plane goes from :math:`\omega=0` to
+:math:`\omega=\pi`, the linear frequency goes from :math:`f=0` to :math:`f=f_{Nyq}` [Hz],
+where the *Nyquist* frequency, :math:`f_{Nyq}=\frac{f_s}{2}` [Hz].
+
+Thus, in implementing the frequency response of the z-transform
+(e.g., when calculating the response of a FIR filter), it is common
+to write it in a way that removes the dependency on the actual sample rate, or
+
+.. math::
+
+   X(e^{j\omega})=\sum_{n=0}^{\infty}x[n]e^{-j 2\pi n \frac{f}{f_s}} = \sum_{n=0}^{\infty}x[n]e^{-j 2\pi n f \Delta t}
+
+
+Difference Equations
+^^^^^^^^^^^^^^^^^^^^^^
+
+z-transforms of linear time-invariant (LTI) systems described by difference equations play
+an important role in signal processing.
+
+The general form of a difference equation is:.
+
+.. math::
+
+   \sum_{k=0}^{N}a_{k}y[n-k]=\sum_{k=0}^{M}b_{k}x[n-k],
+
+where :math:`a_{0}\ne0` (the coefficient of y[n] can't be zero)
+
+
+Taking the z-transform of both sides,
+
+.. math::
+
+   \sum_{k=0}^{N}a_{k}z^{-k}Y(z)=\sum_{k=0}^{M}b_{k}z^{-k}X(z)
+
+or
+
+.. math::
+
+   Y(z)=\frac{\sum_{k=0}^{M}b_{k}z^{-k}}{\sum_{k=0}^{N}a_{k}z^{-k}}X(z)
+
+
+From this we can write the system transfer function
+
+.. math::
+
+   H(z)=\frac{Y(z)}{X(z)}=\frac{\sum_{k=0}^{M}b_{k}z^{-k}}{\sum_{k=0}^{N}a_{k}z^{-k}}
+
+The transfer function is the z-transform of the system impulse response, :math:`h[n]`, or
+
+.. math::
+
+   H(z)=\sum_{n=0}^{\infty}h[n]z^{-n}
+
+The transfer function can also be factored in terms of poles and zeros (for :math:`b_{0}\ne0`)
+
+.. math::
+
+   H(z)=\frac{b_{0}}{a_{0}}\frac{\Pi_{k=1}^{M}(1-c_{k}z^{-1})}{\Pi_{k=1}^{N}(1-d_{k}z^{-1})}
+
+where :math:`c_{k}` are the M zeros of the system, and :math:`d_{k}` are the N poles.
+
+For a system to be both stable and causal, its poles must lie inside the unit circle, or
+:math:`|d_{k}|<1` for :math:`k=1,N`.
+
+z-Transform Frequency Response
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+How does the location of the poles and zeros of the z-transform influence the
+complex frequency response, :math:`H(f)` ?
+
+We start by only considering the magnitude response, :math:`|H(f)|`.
+
+The z-transform only exists within a region of the complex z-plane where
+the infinite sum converges. We call this region the
+Radius of Convergence (ROC) of the system.
+
+If our system, described by difference equations, is stable, then the ROC
+must include the unit circle,
+:math:`|z|=1` where
+
+.. math::
+
+   H(z)=\frac{Y(z)}{X(z)}=\frac{b_{0}}{a_{0}}\frac{\Pi_{k=1}^{M}(1-c_{k}z^{-1})}{\Pi_{k=1}^{N}(1-d_{k}z^{-1})}
+
+   H(e^{-j\omega})=\frac{b_{0}}{a_{0}}\frac{\Pi_{k=1}^{M}(1-c_{k}e^{-j\omega})}{\Pi_{k=1}^{N}(1-d_{k}e^{-j\omega})}
+
+
+The magnitude of the product is equal to the product of the magnitude, thus
+
+
+.. math::
+   :nowrap:
+
+   \begin{eqnarray}
+      |H(e^{-j\omega})| &=& \frac{|b_{0}|}{|a_{0}|}\frac{\Pi_{k=1}^{M}|(1-c_{k}e^{-j\omega})|}{\Pi_{k=1}^{N}|(1-d_{k}e^{-j\omega})|} \\
+                        &=& \frac{|b_{0}|}{|a_{0}|}\frac{\Pi_{k=1}^{M}|e^{-j\omega}(e^{j\omega}-c_{k})|}{\Pi_{k=1}^{N}|e^{-j\omega}(e^{j\omega}-d_{k})|} \\
+      |H(e^{-j\omega})| &=& \frac{|b_{0}|}{|a_{0}|}\frac{\Pi_{k=1}^{M}|(e^{j\omega}-c_{k})|}{\Pi_{k=1}^{N}|(e^{j\omega}-d_{k})|}
+   \end{eqnarray}
+
+
+In other words, as we traverse the unit circle through circular 'frequency', :math:`\omega`,
+from :math:`0-2\pi`, the magnitude of the response depends on the distance between the point
+on the unit circle, :math:`e^{j\omega}`, and the zeros, :math:`|e^{j\omega}-c_k|`, as well as
+the distance between the point and the poles, :math:`|e^{j\omega}-d_k|`, or
+
+
+.. math::
+
+   |H(e^{-j\omega})| = \frac{|b_{0}|}{|a_{0}|}\frac{\Pi_{k=1}^{M}|distance-to-zeros|}{\Pi_{k=1}^{N}|distance-to-poles|}
+
+
+Thus, :math:`|H(e^{j\omega})|` is small when :math:`e^{j\omega}` is near the zeros and
+it is large when :math:`e^{j\omega}` is near the poles.
+
+Examples
+'''''''''''''''''
+
+Example 1
+""""""""""""
+Consider a system with zeros at :math:`z=1,-1` and poles at :math:`z=0.95e^{\pm j\pi/4}`,
+with response function
+
+.. math::
+
+   |H(e^{-j\omega})| = \frac{|(e^{j\omega}-1)||(e^{j\omega}+1)|} {|(e^{j\omega}-0.95e^{j\pi/4})||(e^{j\omega}-0.95e^{-j\pi/4})|}
+
+.. figure:: z-transform_fig1a.png
+
+.. figure:: z-transform_fig1b.png
+
+Poles near the unit circle push the magnitude response up at those frequencies,
+while zeros near the unit circle pull it down; if the zero is actually *on* the unit
+circle, then it forces the magnitude response to be exactly 0 at that frequency.
+
+Example 2
+""""""""""""
+Here's an example pass-band filter comprised of 8 poles and 8 zeros.
+We can predict from the position of the poles and zeros that the
+frequency response will be 0 at :math:`\omega=0` and will
+be maximum near :math:`\omega=\frac{\pi}{2}`.
+
+.. figure:: z-transform_fig2.png
diff --git a/docs/type-glossary.rst b/docs/type-glossary.rst
new file mode 100644
index 0000000..c2332e9
--- /dev/null
+++ b/docs/type-glossary.rst
@@ -0,0 +1,105 @@
+.. |br| raw:: html
+
+   <br />
+
+
+.. flat-table::
+   :header-rows: 1
+   :widths: 10 50 20
+
+   * - .. container::
+             :name: glossary-type
+
+             Type
+     - Type Details
+     - Examples
+
+   * .. _type-glossary-anyuri:
+
+     - .. container::
+             :name: glossary-anyuri
+
+             anyURI
+     - Represents a Uniform Resource Identifier Reference, which often describes URLs and file paths.
+     -  * http://some/path |br|\
+        * http://usgs.gov
+
+   * .. _type-glossary-countertype:
+
+     - .. container::
+             :name: glossary-countertype
+
+             CounterType
+     - Integers greater than or equal to 0.
+     - * 0 |br|\
+       * 12345
+
+   * .. _type-glossary-datetime:
+
+     - .. container::
+             :name: glossary-datetime
+
+             dateTime
+     - `W3C/ISO 8601 <https://www.w3.org/TR/xmlschema-2/#truncatedformats>`_ representation of a date or time. A "Z" should always be appended to a time represent the timezone as UTC.
+     - * 2021-07-26Z
+       * 2021-07-26T12:49:55Z
+       * 2021-07-26T12:49:55.123Z
+
+   * .. _type-glossary-decimal:
+
+     - .. container::
+             :name: glossary-decimal
+
+             decimal
+     - The subset of real numbers
+     - * -123.45 |br|\
+       * 53.7
+
+   * .. _type-glossary-double:
+
+     - .. container::
+             :name: glossary-double
+
+             double
+     - A number between 2.23 × 10^-308 and 8.98 × 10^307 (rounded), along with positive and negative infinity and NaN.
+     - * 12.78e-2 |br|\
+       * -32
+
+   * .. _type-glossary-integer:
+
+     - .. container::
+             :name: glossary-integer
+
+             integer
+     - A decimal number without the period and numbers following it.
+     - ...-2,-1,0,1, 2, ...
+
+   * .. _type-glossary-restrictedstatustype:
+
+     - .. container::
+             :name: glossary-restrictedstatustype
+
+             RestrictedStatusType
+     - an NMTOKEN that is either "open", "closed," or "partial.""
+     - * open |br|\
+       * closed
+
+   * .. _type-glossary-string:
+
+     - .. container::
+             :name: glossary-string
+
+             string
+     - A finite sequence of characters.
+     - foo bar
+
+
+   * .. _type-glossary-nmtoken:
+
+     - .. container::
+             :name: glossary-nmtoken
+
+             NMTOKEN
+     - a combination of name characters, which include letters, digits, periods, hyphens, underscores, colons.
+     - * ANMO |br|\
+       * a1.-_:
diff --git a/docs/warnings.rst b/docs/warnings.rst
new file mode 100644
index 0000000..1dcd1a2
--- /dev/null
+++ b/docs/warnings.rst
@@ -0,0 +1,249 @@
+.. Put any comments here
+
+  Warning, this file is regenerated from the annotations in the schema file.
+
+  Any changes will be overwritten by convert_xsd_to_rst.py.
+
+
+
+
+
+The following are potential future changes, as tagged in the schema with <warning> elements in the documentation. They may result in modifications or deletions in future versions of StationXML.
+
+
+
+
+
+
+
+  -     <FDSNStationXML> schemaVersion : 
+
+     .. admonition:: Warning, Future Change
+
+       schemaVersion: This attribute may change to be a string to allow micro versions, and potential dash, '-', separators starting in version 2. Users should not assume 'xs:decimal'.
+
+
+
+
+  -     <FDSNStationXML> <Source> : 
+
+     .. admonition:: Warning, Future Change
+
+       <Source>: This element is likely to be a choice with Sender.
+
+
+
+
+  -     <FDSNStationXML> <Sender> : 
+
+     .. admonition:: Warning, Future Change
+
+       <Sender>: This element is likely to be a choice with Source.
+
+
+
+
+  -     <Network> endDate : 
+
+     .. admonition:: Warning, Future Change
+
+       endDate: This attribute should not be used if it is in the future.
+
+
+
+
+  -     <Network> endDate : 
+
+     .. admonition:: Warning, Future Change
+
+       endDate: This attribute is likely to require timezone of Z.
+
+
+
+
+  -     <Network> startDate : 
+
+     .. admonition:: Warning, Future Change
+
+       startDate: This attribute is likely to require timezone of Z.
+
+
+
+
+  -     <Network> <TotalNumberStations> : 
+
+     .. admonition:: Warning, Future Change
+
+       <TotalNumberStations>: This element is likely to be removed.
+
+
+
+
+  -     <Network> <SelectedNumberStations> : 
+
+     .. admonition:: Warning, Future Change
+
+       <SelectedNumberStations>: This element is likely to be removed.
+
+
+
+
+  -     <Station> endDate : 
+
+     .. admonition:: Warning, Future Change
+
+       endDate: This attribute should not be used if it is in the future.
+
+
+
+
+  -     <Station> endDate : 
+
+     .. admonition:: Warning, Future Change
+
+       endDate: This attribute is likely to require timezone of Z.
+
+
+
+
+  -     <Station> startDate : 
+
+     .. admonition:: Warning, Future Change
+
+       startDate: This attribute is likely to require timezone of Z.
+
+
+
+
+  -     <Station> <CreationDate> : 
+
+     .. admonition:: Warning, Future Change
+
+       <CreationDate>: This element is likely to be removed.
+
+
+
+
+  -     <Station> <TerminationDate> : 
+
+     .. admonition:: Warning, Future Change
+
+       <TerminationDate>: This element is likely to be removed.
+
+
+
+
+  -     <Station> <TotalNumberChannels> : 
+
+     .. admonition:: Warning, Future Change
+
+       <TotalNumberChannels>: This element is likely to be removed.
+
+
+
+
+  -     <Station> <SelectedNumberChannels> : 
+
+     .. admonition:: Warning, Future Change
+
+       <SelectedNumberChannels>: This element is likely to be removed.
+
+
+
+
+  -     <Channel> endDate : 
+
+     .. admonition:: Warning, Future Change
+
+       endDate: This attribute should not be used if it is in the future.
+
+
+
+
+  -     <Channel> endDate : 
+
+     .. admonition:: Warning, Future Change
+
+       endDate: This attribute is likely to require timezone of Z.
+
+
+
+
+  -     <Channel> startDate : 
+
+     .. admonition:: Warning, Future Change
+
+       startDate: This attribute is likely to require timezone of Z.
+
+
+
+
+  -     <Channel> <Type> : 
+
+     .. admonition:: Warning, Future Change
+
+       <Type>: This element is likely to be removed.
+
+
+
+
+  -     <Response> <Stage> : 
+
+     .. admonition:: Warning, Future Change
+
+       <Stage>: A filter, (PolesZeros, Coefficients, FIR, etc) may be required.
+
+
+
+
+  -     <Response> <Stage> <Coefficients> : 
+
+     .. admonition:: Warning, Future Change
+
+       <Coefficients>: The Numerator element is likely to be changed to require at least one numerator.
+
+
+
+
+  -     <Response> <Stage> <Coefficients> <Numerator> : 
+
+     .. admonition:: Warning, Future Change
+
+       <Numerator>: At least one Numerator may be required.
+
+
+
+
+  -     <Response> <Stage> <FIR> : 
+
+     .. admonition:: Warning, Future Change
+
+       <FIR>: The NumeratorCoefficient field is likely to be changed to require at least one numerator in future versions of StationXML.
+
+
+
+
+  -     <Response> <Stage> <FIR> : 
+
+     .. admonition:: Warning, Future Change
+
+       <FIR>: The NumeratorCoefficient field is likely to be renamed to Numerator in future versions of StationXML.
+
+
+
+
+  -     <Response> <Stage> <FIR> <NumeratorCoefficient> : 
+
+     .. admonition:: Warning, Future Change
+
+       <NumeratorCoefficient>: At least one Numerator may be required.
+
+
+
+
+  -     <Response> <Stage> <FIR> <NumeratorCoefficient> : 
+
+     .. admonition:: Warning, Future Change
+
+       <NumeratorCoefficient>: May be renamed to Numerator.
+
diff --git a/docs/z-transform_fig1.png b/docs/z-transform_fig1.png
new file mode 100644
index 0000000..383bd5b
Binary files /dev/null and b/docs/z-transform_fig1.png differ
diff --git a/docs/z-transform_fig1a.png b/docs/z-transform_fig1a.png
new file mode 100644
index 0000000..96dbc99
Binary files /dev/null and b/docs/z-transform_fig1a.png differ
diff --git a/docs/z-transform_fig1b.png b/docs/z-transform_fig1b.png
new file mode 100644
index 0000000..dcc9d59
Binary files /dev/null and b/docs/z-transform_fig1b.png differ
diff --git a/docs/z-transform_fig2.png b/docs/z-transform_fig2.png
new file mode 100644
index 0000000..5898ccf
Binary files /dev/null and b/docs/z-transform_fig2.png differ
diff --git a/docs/z-transform_fig3.png b/docs/z-transform_fig3.png
new file mode 100644
index 0000000..d4b62ec
Binary files /dev/null and b/docs/z-transform_fig3.png differ
diff --git a/docs/zfig/fig1.py b/docs/zfig/fig1.py
new file mode 100644
index 0000000..da8ae2f
--- /dev/null
+++ b/docs/zfig/fig1.py
@@ -0,0 +1,38 @@
+import numpy as np
+import matplotlib.pyplot as plt
+from matplotlib.pyplot import figure
+
+outfile = '../z-transform_fig1a.png'
+
+fig = figure(num=None, figsize=(6, 6), dpi=300, facecolor='w', edgecolor='k')
+
+#fig = plt.figure()
+#fig.subplots_adjust(top=0.8)
+#ax1 = fig.add_subplot(111)
+ax1 = fig.add_subplot()
+
+ax1.set_ylabel('Imaginary Part')
+ax1.set_xlabel('Real Part')
+#ax1.set_title('a sine wave')
+ax1.set_xlim(xmin=-1.2, xmax=1.2)
+ax1.set_ylim(ymin=-1.2, ymax=1.2)
+
+circle1 = plt.Circle((0, 0), 1., color='k', fill=False)
+ax1.add_artist(circle1)
+ax1.axhline(y=0, xmin=-1.2, xmax=1.2, color='k', linewidth=0.1)
+ax1.axvline(x=0, ymin=-1.2, ymax=1.2, color='k', linewidth=0.1)
+
+plt.plot(1,0,'o', color='k', fillstyle='none')
+plt.plot(-1,0,'o', color='k', fillstyle='none')
+
+z = 0.95 * np.exp(1j*np.pi/4)
+plt.plot(z.real,z.imag,'x', color='k')
+z = 0.95 * np.exp(-1j*np.pi/4)
+plt.plot(z.real,z.imag,'x', color='k')
+
+z = 1. * np.exp(1j*np.pi/4)
+plt.plot(z.real,z.imag,'o', color='r')
+
+#plt.show()
+plt.tight_layout()
+plt.savefig(outfile)
diff --git a/docs/zfig/fig2.py b/docs/zfig/fig2.py
new file mode 100644
index 0000000..ad1979a
--- /dev/null
+++ b/docs/zfig/fig2.py
@@ -0,0 +1,48 @@
+import numpy as np
+import matplotlib.pyplot as plt
+from matplotlib.pyplot import figure
+
+outfile = '../z-transform_fig1b.png'
+
+omega = np.arange(0, np.pi, np.pi/100.)
+
+zeros = []
+zeros.append(1 + 0j)
+zeros.append(-1 + 0j)
+poles = []
+poles.append(0.95 * np.exp(1j*np.pi/4))
+poles.append(0.95 * np.exp(-1j*np.pi/4))
+
+H = []
+for w in omega:
+    numerator = 1
+    denominator = 1
+
+    for zero in zeros:
+        numerator *= np.abs(np.exp(1j*w) - zero)
+
+    for pole in poles:
+        denominator *= np.abs(np.exp(1j*w) - pole)
+
+    abs_H = numerator/denominator
+    H.append(abs_H)
+
+fig = figure(num=None, figsize=(6, 6), dpi=300, facecolor='w', edgecolor='k')
+
+ax1 = fig.add_subplot()
+ax1.set_ylabel(r'$|H(e^{j\omega})|$')
+ax1.set_xlabel(r'$\omega (rad/s)$')
+ax1.set_xlim(xmin=0, xmax=3.14)
+ax1.set_ylim(ymin=0, ymax=22.)
+
+ax1.axvline(x=np.pi/4, ymin=-2, ymax=22, color='k', linestyle='dotted', lw=0.3)
+
+ax1.plot(omega, H, color='k', linewidth=0.4)
+ax1.plot(np.pi/4.,20.5,'o', color='r')
+
+plt.text(np.pi/4., -1.2, r'$\pi/4$', horizontalalignment='center')
+
+plt.tight_layout()
+#plt.show()
+plt.savefig(outfile)
+
diff --git a/fdsn-station.xsd b/fdsn-station.xsd
index 689d0da..38778f8 100644
--- a/fdsn-station.xsd
+++ b/fdsn-station.xsd
@@ -2,21 +2,12 @@
 <!--
 	FDSN StationXML (www.fdsn.org/xml/station)
 
-	The purpose of this schema is to define an XML representation of the most important
-	and commonly used structures of SEED 2.4 metadata.
+	The purpose of this schema is to define a metadata standard for seismological and related data.
 
-	The goal is to allow mapping between SEED 2.4 dataless SEED volumes and this schema with as
-	little transformation or loss of information as possible while at the same time simplifying
-	station metadata representation when possible.  Also, content and clarification has been added
-	where lacking in the SEED standard.
+ 	As a successor to the metadata headers of the SEED 2.4 standard (http://www.fdsn.org/publications.htm)
+	this format contains similar constructs and a superset of information.
 
-	When definitions and usage are underdefined the SEED manual should be referred to for
-	clarification.  SEED specifiation: http://www.fdsn.org/publications.htm
-
-	Another goal is to create a base schema that can be extended to represent similar data types.
-
-
-	Versioning for FDSN StationXML:
+ 	Versioning for FDSN StationXML:
 
 	The 'version' attribute of the schema definition identifies the version of the schema.  This
 	version is not enforced when validating documents.
@@ -27,7 +18,7 @@
 
 	The targetNamespace of the document identifies the major version of the schema and document,
 	version 1.x of the schema uses a target namespace of "http://www.fdsn.org/xml/station/1".
-	All minor versions of a will be backwards compatible with previous minor releases.  For
+	All minor versions of the schema will be backwards compatible with previous minor releases.  For
 	example, all 1.x schemas are backwards compatible with and will validate documents for 1.0.
 	Major changes to the schema that would break backwards compabibility will increment the major
 	version number, e.g. 2.0, and the namespace, e.g. "http://www.fdsn.org/xml/station/2".
@@ -36,69 +27,123 @@
 	versioned and allows the schema to be updated with backward compatible changes (e.g. 1.2)
 	and still validate documents created for previous major versions of the schema (e.g. 1.0).
 
+
+        Regarding embedded documentation keywords:
+        StationXML reference documentation details are auto-generated from <documentation> tags
+        in this this schema document.
+
+        To allow additional granularity and clarity in the generated documentation, special embedded
+        elements and attributes are parsed from the content of the <documentation> tags.  These embedded
+        items are as follows:
+
+        1. <example> - An XML element that contains an example of the relevent element
+           in the StationXML documentation. May have a LevelChoice attribute.
+
+        2. <warning> - Text appears included in an admonition wrapper.
+           It is typically used to indicate features that may be removed in the future.
+
+        3. <levelDesc> - An XML element that contains a description of the relevant element
+            in the StationXML documentation at a given level. Must have a  LevelChoice attribute.
+
+        4. LevelChoice="X" - Where X is one of "N" (network), "S" (station) or "C" (channel).
+           This attribute is used so that documentation can be specific to level X for shared XML elements.
+
+        5. ElementChoice="TAG_NAME" - Similar to LevelChoice, but allows elements built off a
+           common basetype to have specific documentation.
+           For example: <xs:documentation><example ElementChoice="WaterLevel">m</example></xs:documentation>
+           The text in the example will only be used for the WaterLevel element.
 -->
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:fsx="http://www.fdsn.org/xml/station/1"
 	targetNamespace="http://www.fdsn.org/xml/station/1" elementFormDefault="qualified"
-	attributeFormDefault="unqualified" version="1.1">
+	attributeFormDefault="unqualified" version="1.2">
 	<xs:annotation>
-		<xs:documentation> FDSN StationXML schema. Designed as an XML representation of SEED
-			metadata, the schema maps to the most important and commonly used structures of SEED
-			2.4. When definitions and usage are underdefined the SEED manual should be referred to
-			for clarification.</xs:documentation>
+		<xs:documentation>FDSN StationXML schema. A metadata
+		standard for seismological and related data.
+		</xs:documentation>
 	</xs:annotation>
 	<!-- Root element -->
 	<xs:element name="FDSNStationXML" type="fsx:RootType"/>
 	<!-- Type definitions -->
 	<xs:complexType name="RootType">
 		<xs:annotation>
-			<xs:documentation>Top-level type for Station XML. Required fields are Source (network ID
-				of the institution sending the message), Created (creation time of the document)
-				and one or more Network containers. </xs:documentation>
+			<xs:documentation>Root-level for StationXML documents.
+			 </xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
 			<xs:element name="Source" type="xs:string">
 				<xs:annotation>
-					<xs:documentation>Network ID of the institution sending the
-						message.</xs:documentation>
+					<xs:documentation>Originator of the information contained in the document.
+            It is recommended that archives or services providing StationXML that are not
+            the original creator of the metadata set this to be
+            the empty element, especially because a StationXML document may
+            contain information from many unrelated networks.
+					</xs:documentation>
+          <xs:documentation><warning>This element is likely to be a choice with Sender.</warning></xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:element name="Sender" type="xs:string" minOccurs="0">
 				<xs:annotation>
-					<xs:documentation>Name of the institution sending this
-						message.</xs:documentation>
+					<xs:documentation>Name of the institution sending this document,
+            for example the institution hosting an FDSN Station web service.
+            It is recommended that authoritative StationXML
+            created by the originator of the metadata not use Sender and
+            use Source instead. For example metadata created by a network
+            operator for submission to other data archives would only use Source,
+            The data archive in response to a request would use Sender.
+					</xs:documentation>
+          <xs:documentation><warning>This element is likely to be a choice with Source.</warning></xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:element name="Module" type="xs:string" minOccurs="0">
 				<xs:annotation>
 					<xs:documentation>Name of the software module that generated this document.
 					</xs:documentation>
+					<xs:documentation><example><Module>SeisComp3</Module></example></xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:element name="ModuleURI" type="xs:anyURI" minOccurs="0">
 				<xs:annotation>
-					<xs:documentation> This is the address of the query that generated the document,
-						or, if applicable, the address of the software that generated this document.
+					<xs:documentation>Resource identifier of the query that generated the document,
+						or, if applicable, the resource identifier of the software that generated this document.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Created" type="xs:dateTime">
+				<xs:annotation>
+					<xs:documentation>Date that this document was generated.
 					</xs:documentation>
 				</xs:annotation>
 			</xs:element>
-			<xs:element name="Created" type="xs:dateTime"/>
 			<xs:element name="Network" type="fsx:NetworkType" maxOccurs="unbounded"/>
 			<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
 		</xs:sequence>
 		<xs:attribute name="schemaVersion" type="xs:decimal" use="required">
 			<xs:annotation>
-				<xs:documentation>The schema version compatible with the document.
-				</xs:documentation>
+				<xs:documentation>The StationXML schema version of this document.</xs:documentation>
+				<xs:documentation><example>1.2</example></xs:documentation>
+				<xs:documentation>
+          <warning>
+            This attribute may change to be a string to allow micro versions,
+            and potential dash, '-', separators starting in version 2. Users
+            should not assume 'xs:decimal'.
+          </warning>
+        </xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="NetworkType">
 		<xs:annotation>
-			<xs:documentation>This type represents the Network layer, all station metadata is
-				contained within this element. The official name of the network or other descriptive
-				information can be included in the Description element. The Network can contain 0 or
-				more Stations. </xs:documentation>
+		<xs:documentation>The Network container. All station metadata for this network is contained within this element.
+		A Description element may be included with the official network name and other descriptive information.
+		An Identifier element may be included to designate a persistent identifier (e.g. DOI) to use for citation.
+		A Comment element may be included for additional comments.
+    </xs:documentation>
+      <xs:documentation>
+        An active Network should not use the endDate attribute.
+        Unlike SEED, do not use an endDate in the distant future to mean active.
+      </xs:documentation>
+      <xs:documentation><example><Network code="XX" startDate="2016-01-27T13:00:00Z" /></example></xs:documentation>
 		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:BaseNodeType">
@@ -106,23 +151,25 @@
 					<xs:element name="Operator" type="fsx:OperatorType" minOccurs="0"
 						maxOccurs="unbounded">
 						<xs:annotation>
-							<xs:documentation>An operator and associated contanct persons</xs:documentation>
+							<xs:documentation>Agency and contact persons who manage this network.</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="TotalNumberStations" type="fsx:CounterType" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation> The total number of stations contained in this
+							<xs:documentation>The total number of stations in this
 								network, including inactive or terminated stations.
 							</xs:documentation>
+              <xs:documentation><example><TotalNumberStations>24</TotalNumberStations></example></xs:documentation>
+              <xs:documentation><warning>This element is likely to be removed.</warning></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="SelectedNumberStations" type="fsx:CounterType" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation> The total number of stations in this network that
-								were selected by the query that produced this document, even if the
-								stations do not appear in the document. (This might happen if the
-								user only wants a document that goes contains only information at
-								the Network level.) </xs:documentation>
+							<xs:documentation>The number of stations selected in the request that resulted
+								in this document.
+							</xs:documentation>
+              <xs:documentation><example><SelectedNumberStations>12</SelectedNumberStations></example></xs:documentation>
+              <xs:documentation><warning>This element is likely to be removed.</warning></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Station" type="fsx:StationType" minOccurs="0"
@@ -133,85 +180,111 @@
 	</xs:complexType>
 	<xs:complexType name="StationType">
 		<xs:annotation>
-			<xs:documentation>This type represents a Station epoch. It is common to only have a
-				single station epoch with the station's creation and termination dates as the epoch
-				start and end dates. </xs:documentation>
+		<xs:documentation>The Station container. All channel metadata for this station is contained within this element.
+		A Description element may be included with the official station name and other descriptive information.
+		An Identifier element may be included to designate a persistent identifier (e.g. DOI) to use for citation or reference.
+		A Comment element may be included for additional comments.
+    </xs:documentation>
+      <xs:documentation>
+        An active Station should not use the endDate attribute.
+        Unlike SEED, do not use an endDate in the distant future to mean active.
+      </xs:documentation>
 		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:BaseNodeType">
 				<xs:sequence>
-					<xs:element name="Latitude" type="fsx:LatitudeType"/>
-					<xs:element name="Longitude" type="fsx:LongitudeType"/>
-					<xs:element name="Elevation" type="fsx:DistanceType"/>
-					<xs:element name="Site" type="fsx:SiteType">
+					<xs:element name="Latitude" type="fsx:LatitudeType">
 						<xs:annotation>
-							<xs:documentation>These fields describe the location of the station
-								using geopolitical entities (country, city,
-								etc.).</xs:documentation>
+		<xs:documentation>Station latitude, in degrees. Where the bulk of the equipment is located (or another appropriate site location).
+      The unit is fixed to be degrees, and datum defaults to WGS84.
+    </xs:documentation>
+		<xs:documentation><example><Latitude>34.9459</Latitude></example></xs:documentation>
 						</xs:annotation>
 					</xs:element>
+					<xs:element name="Longitude" type="fsx:LongitudeType">
+						<xs:annotation>
+		<xs:documentation>Station longitude, in degrees. Where the bulk of the equipment is located (or another appropriate site location).
+      The unit is fixed to be degrees, and datum defaults to WGS84.
+    </xs:documentation>
+		<xs:documentation><example><Longitude>-106.4572</Longitude></example></xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Elevation" type="fsx:DistanceType">
+						<xs:annotation>
+							<xs:documentation>Elevation of local ground surface level at station, in meters.</xs:documentation>
+							<xs:documentation><example><Elevation>1850.0</Elevation></example></xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Site" type="fsx:SiteType">
+					</xs:element>
 					<xs:element name="WaterLevel" type="fsx:FloatType" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>Elevation of the water surface in meters for underwater sites,
-								where 0 is sea level.</xs:documentation>
+		<xs:documentation>Elevation of the water surface in meters for underwater sites, where 0 is mean sea level.
+      If you put an OBS on a lake bottom, where the lake surface is at elevation=1200 meters,
+      then you should set WaterLevel=1200. An OBS in the ocean would
+      have WaterLevel=0.
+		</xs:documentation>
+		<xs:documentation><example><WaterLevel>1200</WaterLevel></example></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Vault" type="xs:string" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>Type of vault, e.g. WWSSN, tunnel, transportable
-								array, etc.</xs:documentation>
+							<xs:documentation>Type of vault, e.g. World-Wide Standardized Seismograph Network (WWSSN), tunnel,
+								USArray Transportable Array Generation 2, etc.
+							</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Geology" type="xs:string" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>Type of rock and/or geologic
-								formation.</xs:documentation>
+							<xs:documentation>Type of rock and/or geologic formation at the station.
+							</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Equipment" type="fsx:EquipmentType" minOccurs="0"
 						maxOccurs="unbounded">
 						<xs:annotation>
-							<xs:documentation>Equipment used by all channels at a
-								station.</xs:documentation>
+							<xs:documentation>Equipment used by all channels at a station,
+							Equipment that contributes to or affects the response of a channel should be documented on the channel.</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Operator" type="fsx:OperatorType" minOccurs="0"
 						maxOccurs="unbounded">
 						<xs:annotation>
-							<xs:documentation>An operator and associated contanct persons</xs:documentation>
+							<xs:documentation>Agency who manage this station.
+                Only use if this differs from the Operator of the Network.
+              </xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="CreationDate" type="xs:dateTime" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>Date and time (UTC) when the station was first
-								installed.</xs:documentation>
+              <xs:documentation>Date and time (UTC) when the station was first installed.</xs:documentation>
+              <xs:documentation><warning>This element is likely to be removed.</warning></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="TerminationDate" type="xs:dateTime" minOccurs="0">
 						<xs:annotation>
 							<xs:documentation>Date and time (UTC) when the station was terminated or
-								will be terminated. A blank value should be assumed to mean that the
-								station is still active.</xs:documentation>
+								will be terminated. Do not include this element if a termination date is not available or is not relevant.
+							</xs:documentation>
+              <xs:documentation><warning>This element is likely to be removed.</warning></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="TotalNumberChannels" type="fsx:CounterType" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>Total number of channels recorded at this
-								station.</xs:documentation>
+							<xs:documentation>Total number of channels recorded at this station.</xs:documentation>
+							<xs:documentation><warning>This element is likely to be removed.</warning></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="SelectedNumberChannels" type="fsx:CounterType" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>Number of channels recorded at this station and
-								selected by the query that produced this
-								document.</xs:documentation>
+							<xs:documentation>The number of channels selected in the request that resulted in this document.</xs:documentation>
+							<xs:documentation><warning>This element is likely to be removed.</warning></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="ExternalReference" type="fsx:ExternalReferenceType"
 						minOccurs="0" maxOccurs="unbounded">
 						<xs:annotation>
-							<xs:documentation>URI of any type of external report, such as IRIS data
-								reports or dataless SEED volumes.</xs:documentation>
+							<xs:documentation>URI of any type of external report</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Channel" type="fsx:ChannelType" minOccurs="0"
@@ -223,8 +296,15 @@
 	<!-- End StationType-->
 	<xs:complexType name="ChannelType">
 		<xs:annotation>
-			<xs:documentation>Equivalent to SEED blockette 52 and parent element for the related the
-				response blockettes.</xs:documentation>
+		<xs:documentation>The Channel container.
+		A Description element may be included with other information.
+		An Identifier element may be included to designate a persistent identifier (e.g. DOI) to use for citation or reference.
+		A Comment element may be included for arbitrary comments.
+    </xs:documentation>
+      <xs:documentation>
+        An active Channel should not use the endDate attribute.
+        Unlike SEED, do not use an endDate in the distant future to mean active.
+      </xs:documentation>
 		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:BaseNodeType">
@@ -232,60 +312,65 @@
 					<xs:element name="ExternalReference" type="fsx:ExternalReferenceType"
 						minOccurs="0" maxOccurs="unbounded">
 						<xs:annotation>
-							<xs:documentation>URI of any type of external report, such as data
-								quality reports.</xs:documentation>
+							<xs:documentation>URI of any type of external report, such as data quality reports.</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Latitude" type="fsx:LatitudeType">
 						<xs:annotation>
-							<xs:documentation>Latitude coordinate of this channel's
-								sensor.</xs:documentation>
+							<xs:documentation>Latitude of this channel's sensor, in degrees.
+								Often the same as the station latitude, but
+								when different the channel latitude is the true location of the sensor.
+							</xs:documentation>
+							<xs:documentation><example><Latitude>34.9459</Latitude></example></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Longitude" type="fsx:LongitudeType">
 						<xs:annotation>
-							<xs:documentation>Longitude coordinate of this channel's
-								sensor.</xs:documentation>
+							<xs:documentation>Longitude of this channel's sensor, in degrees.
+								Often the same as the station longitude, but
+								when different the channel longitude is the true location of the sensor.
+							</xs:documentation>
+							<xs:documentation><example><Longitude>-106.4572</Longitude></example></xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Elevation" type="fsx:DistanceType">
 						<xs:annotation>
-							<xs:documentation>Elevation of the sensor.</xs:documentation>
+						  <xs:documentation>Elevation of the sensor, in meters.  To find the local ground surface level,
+                                                  add the Depth value to this elevation. </xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Depth" type="fsx:DistanceType">
 						<xs:annotation>
-							<xs:documentation>The local depth or overburden of the instrument's
-								location. For downhole instruments, the depth of the instrument
-								under the surface ground level. For underground vaults, the distance
-								from the instrument to the local ground level
-								above.</xs:documentation>
+							<xs:documentation>The depth of the sensor relative to the local ground surface level, in meters.
+							</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Azimuth" type="fsx:AzimuthType" minOccurs="0">
-						<xs:annotation>
-							<xs:documentation>Azimuth of the sensor in degrees from north,
-								clockwise.</xs:documentation>
-						</xs:annotation>
 					</xs:element>
 					<xs:element name="Dip" type="fsx:DipType" minOccurs="0">
-						<xs:annotation>
-							<xs:documentation>Dip of the instrument in degrees, down from
-								horizontal</xs:documentation>
-						</xs:annotation>
 					</xs:element>
 					<xs:element name="WaterLevel" type="fsx:FloatType" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>Elevation of the water surface in meters for underwater sites,
-								where 0 is sea level.</xs:documentation>
+							<xs:documentation>Elevation of the water surface in meters for underwater sites, where 0 is mean sea level.
+								If you put an OBS on a lake bottom, where the lake surface is at elevation=1200 meters,
+								then you should set WaterLevel=1200. An OBS in the ocean would
+                have WaterLevel=0.
+							</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="Type" minOccurs="0" maxOccurs="unbounded">
 						<xs:annotation>
-							<xs:documentation>The type of data this channel collects. Corresponds to
-								channel flags in SEED blockette 52. The SEED volume producer could
-								use the first letter of an Output value as the SEED channel
-								flag.</xs:documentation>
+							<xs:documentation>Data type for this channel. One or more &lt;Type&gt; tags
+								can be used to specify the nature of the data this channel collects.
+                The value between the &lt;Type&gt; tags must be one of:
+								TRIGGERED, CONTINUOUS, HEALTH, GEOPHYSICAL, WEATHER, FLAG or SYNTHESIZED.
+							</xs:documentation>
+              <xs:documentation><example><Type>CONTINUOUS</Type></example></xs:documentation>
+  							<xs:documentation>
+                  This element existed primarily to hold the corresponding
+                  value from SEED, but should not be used for new StationXML.
+							</xs:documentation>
+              <xs:documentation><warning>This element is likely to be removed.</warning></xs:documentation>
 						</xs:annotation>
 						<xs:simpleType>
 							<xs:restriction base="xs:NMTOKEN">
@@ -306,95 +391,184 @@
 					<xs:group ref="fsx:SampleRateGroup" minOccurs="0"/>
 					<xs:element name="ClockDrift" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>A tolerance value, measured in seconds per sample,
-								used as a threshold for time error detection in data from the
-								channel.</xs:documentation>
+							<xs:documentation>Tolerance value, measured in seconds per sample,
+								used as a threshold for time error detection in data from the channel.
+							</xs:documentation>
 						</xs:annotation>
 						<xs:complexType>
 							<xs:simpleContent>
 								<xs:restriction base="fsx:FloatType">
 									<xs:minInclusive value="0"/>
-									<xs:attribute name="unit" type="xs:string" use="optional"
-										fixed="SECONDS/SAMPLE"/>
+									<xs:attribute name="unit" type="xs:string" use="optional" fixed="SECONDS/SAMPLE">
+											<xs:annotation>
+												<xs:documentation>The unit of drift value.
+                          This value is fixed to be SECONDS/SAMPLE, setting it is redundant.
+												</xs:documentation>
+											</xs:annotation>
+										</xs:attribute>
 								</xs:restriction>
 							</xs:simpleContent>
 						</xs:complexType>
 					</xs:element>
-					<xs:element name="CalibrationUnits" type="fsx:UnitsType" minOccurs="0"/>
-					<xs:element name="Sensor" type="fsx:EquipmentType" minOccurs="0"/>
-					<xs:element name="PreAmplifier" type="fsx:EquipmentType" minOccurs="0"/>
-					<xs:element name="DataLogger" type="fsx:EquipmentType" minOccurs="0"/>
-					<xs:element name="Equipment" type="fsx:EquipmentType" minOccurs="0" maxOccurs="unbounded"/>
+					<xs:element name="CalibrationUnits" type="fsx:UnitsType" minOccurs="0">
+						<xs:annotation>
+							<xs:documentation>Units of calibration (e.g., V (for Volts) or A (for amps))</xs:documentation>
+							<xs:documentation>Use *SI* units when possible</xs:documentation>
+              <xs:documentation>
+								<example>
+<CalibrationUnits>
+  <Name>V</Name>
+  <Description>Volts</Description>
+</CalibrationUnits>
+								</example>
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Sensor" type="fsx:EquipmentType" minOccurs="0">
+							<xs:annotation>
+								<xs:documentation>Details of the (typically analog) sensor attached to this channel.
+									If this was entered at the Station level, it is not necessary to do it for each Channel,
+									unless you have differences in equipment.
+								</xs:documentation>
+							</xs:annotation>
+						</xs:element>
+					<xs:element name="PreAmplifier" type="fsx:EquipmentType" minOccurs="0">
+						<xs:annotation>
+							<xs:documentation>Preamplifier (if any) used by this channel. If this was entered at the Station level,
+								it is not necessary to do it for each Channel, unless you have differences in equipment.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="DataLogger" type="fsx:EquipmentType" minOccurs="0">
+						<xs:annotation>
+							<xs:documentation>Datalogger that recorded this channel. If this was entered at the Station level,
+								it is not necessary to do it for each Channel, unless you have differences in equipment.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Equipment" type="fsx:EquipmentType" minOccurs="0" maxOccurs="unbounded">
+						<xs:annotation>
+							<xs:documentation>Any equipment that does not have type-specific fields.
+							Equipment such as sensor, data logger and preamplifier that has type-specific fields should be documented in those structures.
+							If the same Equipment is entered at the Station level, it is not necessary to include it for each Channel.
+							If using a preamplifier, sensor, or datalogger, use their appropriate fields instead.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
 					<xs:element name="Response" type="fsx:ResponseType" minOccurs="0"/>
 				</xs:sequence>
-				<xs:attribute name="locationCode" type="xs:string" use="required"/>
+				<xs:attribute name="locationCode" type="xs:string" use="required">
+					<xs:annotation>
+	<xs:documentation>
+		The locationCode is typically used to group channels from a common sensor.
+		For example, the channels of the primary sensor at global IDA-IRIS
+		stations have locationCode = \"00\": 00_BHZ, 00_BHE, 00_BHN, 00_LHZ, ..., etc.
+    Even though it is required, locationCode may be, and often is, an empty string,
+    however, it is recommended that the locationCode not be empty.
+	</xs:documentation>
+	<xs:documentation><example>30</example></xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 			</xs:extension>
 		</xs:complexContent>
 	</xs:complexType>
 	<!-- End ChannelType -->
 	<xs:complexType name="GainType">
 		<xs:annotation>
-			<xs:documentation>Complex type for sensitivity and frequency ranges. This complex type
-				can be used to represent both overall sensitivities and individual stage gains. The
-				FrequencyRangeGroup is an optional construct that defines a pass band in Hertz (
-				FrequencyStart and FrequencyEnd) in which the SensitivityValue is valid within the
-				number of decibels specified in FrequencyDBVariation. </xs:documentation>
+			<xs:documentation>Type used for representing sensitivity at a given frequency. This complex type
+				can be used to represent both total sensitivities and individual stage gains.
+			</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
 			<xs:element name="Value" type="xs:double">
 				<xs:annotation>
-					<xs:documentation>A scalar that, when applied to the data values, converts the
-						data to different units (e.g. Earth units)</xs:documentation>
+          <xs:documentation>
+            A scalar value representing the amount of amplification or diminution, if any,
+            the current stage applies to the input signal.
+					</xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:element name="Frequency" type="xs:double">
 				<xs:annotation>
-					<xs:documentation>The frequency (in Hertz) at which the Value is
-						valid.</xs:documentation>
+					<xs:documentation>The frequency (in Hertz) at which the Value is valid.
+
+            While any frequency in the passband is acceptable, it is preferred that:
+
+            #. For low pass FIR filters, use gain at zero frequency (sum of coefficients)
+            #. If given, use manufacturer frequency/gain without recomputing
+            #. For anything else, frequency should be in the "good" part of the passband
+            #. All stage frequencies should be below the final Nyquist, as long as 2,3 are satisfied
+            #. All stages, except lowpass FIR filters, should use the same frequencies, as long as 2,3 are satisfied
+            #. Overall gain should also use the same frequency as 5, as long as it is below the final Nyquist and in the good part of the final passband
+
+					</xs:documentation>
 				</xs:annotation>
 			</xs:element>
 		</xs:sequence>
 	</xs:complexType>
 	<xs:group name="FrequencyRangeGroup">
+		<xs:annotation>
+			<xs:documentation>Type for defining a pass band (in Hertz) from FrequencyStart to FrequencyEnd
+				in which a sensitivity value is valid within the number of decibels (dB) specified in FrequencyDBVariation.
+			</xs:documentation>
+		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="FrequencyStart" type="xs:double"/>
-			<xs:element name="FrequencyEnd" type="xs:double"/>
+			<xs:element name="FrequencyStart" type="xs:double">
+				<xs:annotation>
+          <xs:documentation>The lowest frequency for which the InstrumentSensitivity is valid.
+            &lt;FrequencyStart&gt;, &lt;FrequencyEnd&gt; and &lt;FrequencyDBVariation&gt; are not
+            required, however, if one of these is present, then all must be present.
+          </xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="FrequencyEnd" type="xs:double">
+				<xs:annotation>
+					<xs:documentation>The highest frequency for which the InstrumentSensitivity is valid.
+            &lt;FrequencyStart&gt;, &lt;FrequencyEnd&gt; and &lt;FrequencyDBVariation&gt; are not
+            required, however, if one of these is present, then all must be present.
+          </xs:documentation>
+				</xs:annotation>
+			</xs:element>
 			<xs:element name="FrequencyDBVariation" type="xs:double">
 				<xs:annotation>
-					<xs:documentation>Variation in decibels within the specified
-						range.</xs:documentation>
+					<xs:documentation>Variation in decibels within the specified frequency range.
+            &lt;FrequencyStart&gt;, &lt;FrequencyEnd&gt; and &lt;FrequencyDBVariation&gt; are not
+            required, however, if one of these is present, then all must be present.
+					</xs:documentation>
 				</xs:annotation>
 			</xs:element>
 		</xs:sequence>
 	</xs:group>
 	<xs:complexType name="SensitivityType">
 		<xs:annotation>
-			<xs:documentation>Sensitivity and frequency ranges. The FrequencyRangeGroup is an
-				optional construct that defines a pass band in Hertz (FrequencyStart and
-				FrequencyEnd) in which the SensitivityValue is valid within the number of decibels
-				specified in FrequencyDBVariation. </xs:documentation>
+			<xs:documentation>Type for sensitivity, input/output units and relevant frequency range.
+			</xs:documentation>
 		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:GainType">
 				<xs:sequence>
 					<xs:element name="InputUnits" type="fsx:UnitsType">
 						<xs:annotation>
-							<xs:documentation> The units of the data as input from the perspective
-								of data acquisition. After correcting data for this response, these
-								would be the resulting units. </xs:documentation>
+              <xs:documentation>
+                The units of the data as input to the sensor. For example
+                if stage 1 represented a seismometer, InputUnits would be 'm/s'
+                and OutputUnits would be 'V'.
+    					</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:element name="OutputUnits" type="fsx:UnitsType">
 						<xs:annotation>
-							<xs:documentation> The units of the data as output from the perspective
-								of data acquisition. These would be the units of the data prior to
-								correcting for this response. </xs:documentation>
+							<xs:documentation> The units of the data as output from data
+                acquisition system. For most channels recorded by
+                systems that use an AtoD, the OutputUnits will be 'count'.
+							</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 					<xs:group ref="fsx:FrequencyRangeGroup" minOccurs="0">
 						<xs:annotation>
-							<xs:documentation>The frequency range for which the SensitivityValue is
-								valid within the dB variation specified.</xs:documentation>
+							<xs:documentation>The frequency range for which the sensitivity value is
+								valid within the dB variation specified.
+							</xs:documentation>
 						</xs:annotation>
 					</xs:group>
 				</xs:sequence>
@@ -402,107 +576,228 @@
 		</xs:complexContent>
 	</xs:complexType>
 	<xs:complexType name="EquipmentType">
+		<xs:annotation>
+			<xs:documentation>A type for equipment related to data acquisition or processing.
+			</xs:documentation>
+		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="Type" type="xs:string" minOccurs="0"/>
-			<xs:element name="Description" type="xs:string" minOccurs="0"/>
-			<xs:element name="Manufacturer" type="xs:string" minOccurs="0"/>
-			<xs:element name="Vendor" type="xs:string" minOccurs="0"/>
-			<xs:element name="Model" type="xs:string" minOccurs="0"/>
-			<xs:element name="SerialNumber" type="xs:string" minOccurs="0"/>
-			<xs:element name="InstallationDate" type="xs:dateTime" minOccurs="0"/>
-			<xs:element name="RemovalDate" type="xs:dateTime" minOccurs="0"/>
-			<xs:element name="CalibrationDate" type="xs:dateTime" minOccurs="0"
-				maxOccurs="unbounded"/>
+			<xs:element name="Type" type="xs:string" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Type of equipment</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Description" type="xs:string" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Description of equipment</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Manufacturer" type="xs:string" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Manufacturer of equipment</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Vendor" type="xs:string" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Vendor of equipment</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Model" type="xs:string" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Model of equipment</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="SerialNumber" type="xs:string" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Serial number of equipment</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="InstallationDate" type="xs:dateTime" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Date this equipment was installed</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="RemovalDate" type="xs:dateTime" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Date this equipment was removed</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="CalibrationDate" type="xs:dateTime" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>Date this equipment was calibrated</xs:documentation>
+				</xs:annotation>
+			</xs:element>
 			<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
 		</xs:sequence>
 		<xs:attribute name="resourceId" type="xs:string" use="optional">
 			<xs:annotation>
-				<xs:documentation>This field contains a string that should serve as a unique
-					resource identifier. This identifier can be interpreted differently depending on
-					the datacenter/software that generated the document. Also, we recommend to use
-					something like GENERATOR:Meaningful ID. As a common behaviour equipment with the
-					same ID should contains the same information/be derived from the same base
-					instruments. </xs:documentation>
+				<xs:documentation> An identifier that serves to uniquely identify this resource.
+					This identifier can be interpreted differently depending on the datacenter/software
+					that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID.
+					It should be expected that equipment with the same ID should indicate the same information or be
+					derived from the same base instruments.
+				</xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="ResponseStageType">
 		<xs:annotation>
-			<xs:documentation> This complex type represents channel response and covers SEED
-				blockettes 53 to 56. </xs:documentation>
+			<xs:documentation>Type for channel response entry or stage.  A full response is
+				represented as an ordered sequence of these stages.
+			</xs:documentation>
+      <xs:documentation>
+				A filter, (PolesZeros, Coefficients, FIR, etc) is not required, but is
+        recommended to provide a place to store the input and output units
+        even in the case of "gain-only" stages.
+
+        For an analog gain-only stage, use a PolesZeros filter with no poles
+        or zeros, PzTransferFunctionType=LAPLACE (RADIANS/SECOND)",
+        NormalizationFactor=1 and NormalizationFrequency=0.
+
+        For a digital gain-only stage, use a FIR filter with one
+        numerator with value 1.0, and symmetry=NONE. While a digital Coefficients
+        filter can serve the same purpose and is common, the FIR filter is more concise.
+      </xs:documentation>
+      <xs:documentation>
+        <warning>
+          A filter, (PolesZeros, Coefficients, FIR, etc) may be required.
+        </warning>
+			</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
 			<xs:choice>
 				<xs:annotation>
-					<xs:documentation>A choice of polynomial versus all other response types.
-						There should be one response per stage.</xs:documentation>
+					<xs:documentation>A choice of polynomial versus all other response types,
+						to enforce one response per stage.
+					</xs:documentation>
 				</xs:annotation>
 				<xs:sequence>
 					<xs:choice>
-						<xs:element name="PolesZeros" type="fsx:PolesZerosType" minOccurs="0"/>
+						<xs:element name="PolesZeros" type="fsx:PolesZerosType" minOccurs="0">
+		          <xs:annotation>
+                <xs:documentation>
+                  Response stage described by the complex poles and zeros of the Laplace Transform (or z-transform)
+                  of the transfer function for this stage.
+                </xs:documentation>
+		          </xs:annotation>
+						</xs:element>
+
 						<xs:element name="Coefficients" type="fsx:CoefficientsType" minOccurs="0"/>
 						<xs:element name="ResponseList" type="fsx:ResponseListType" minOccurs="0"/>
-						<xs:element name="FIR" type="fsx:FIRType" minOccurs="0"/>
+						<xs:element name="FIR" type="fsx:FIRType" minOccurs="0">
+						</xs:element>
 					</xs:choice>
 					<xs:element name="Decimation" type="fsx:DecimationType" minOccurs="0"/>
 					<xs:element name="StageGain" type="fsx:GainType">
 						<xs:annotation>
 							<xs:documentation>The gain at the stage of the encapsulating
-								response element at a specific frequencey and corresponds to SEED blockette 58.
-								In the SEED convention, stage 0 gain represents the overall sensitivity of the channel.
-								In this schema, stage 0 gains are allowed but are considered deprecated.
-								Overall sensitivity should be specified in the InstrumentSensitivity
-								element.</xs:documentation>
+								response element at a specific frequency.
+								Total channel sensitivity should be specified in the InstrumentSensitivity
+								element.
+							</xs:documentation>
 						</xs:annotation>
 					</xs:element>
 				</xs:sequence>
-				<xs:element name="Polynomial" type="fsx:PolynomialType"/>
+				<xs:element name="Polynomial" type="fsx:PolynomialType">
+					<xs:annotation>
+           					<xs:documentation>
+						When a response is given in terms of a polynomial expansion of
+						powers of the sensor output signal (e.g., Volts), a Polynomial stage is
+						required to specify the Maclaurin coefficients of the expansion.
+
+						In addition, an InstrumentPolynomial element must be present at Response level
+						to represent the whole acquisition process, which contains the same Maclaurin
+						coefficients, but scaled by powers of the overall gain for all stages.
+						</xs:documentation>
+            				</xs:annotation>
+        			</xs:element>
 			</xs:choice>
 			<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
 		</xs:sequence>
 		<xs:attribute name="number" type="fsx:CounterType" use="required">
 			<xs:annotation>
-				<xs:documentation>Stage sequence number. This is used in all the response SEED
-					blockettes.</xs:documentation>
+				<xs:documentation>Stage sequence number. This is used in all the response
+					blockettes. Start from name='1' and iterate sequentially.
+				</xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:attribute name="resourceId" type="xs:string">
 			<xs:annotation>
-				<xs:documentation> Same meaning as Equipment:resourceId. </xs:documentation>
+				<xs:documentation>A resource identifier that serves to uniquely identify this response stage.
+					This identifier can be interpreted differently depending on the datacenter/software
+					that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID.
+					It should be expected that equipment with the same ID should indicate the same information.
+				</xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="CommentType">
 		<xs:annotation>
-			<xs:documentation>Container for a comment or log entry. Corresponds to SEED blockettes
-				31, 51 and 59.</xs:documentation>
+			<xs:documentation>Container for a comment or log entry.</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="Value" type="xs:string"/>
-			<xs:element name="BeginEffectiveTime" type="xs:dateTime" minOccurs="0"/>
-			<xs:element name="EndEffectiveTime" type="xs:dateTime" minOccurs="0"/>
-			<xs:element name="Author" type="fsx:PersonType" minOccurs="0" maxOccurs="unbounded"/>
+			<xs:element name="Value" type="xs:string">
+				<xs:annotation>
+					<xs:documentation>Comment text.</xs:documentation>
+					<xs:documentation>
+	          <example  LevelChoice="N"><Value>Temporary network deployment</Value></example>
+	          <example  LevelChoice="S"><Value>GPS Clock is unlocked</Value></example>
+	          <example  LevelChoice="C"><Value>Large number of spikes</Value></example>
+					</xs:documentation>
+			  </xs:annotation>
+      			</xs:element>
+			<xs:element name="BeginEffectiveTime" type="xs:dateTime" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Start time for when comment applies.</xs:documentation>
+					<xs:documentation><example><BeginEffectiveTime>2008-09-15T00:00:00Z</BeginEffectiveTime></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="EndEffectiveTime" type="xs:dateTime" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>End time for when comment applies.</xs:documentation>
+ 					<xs:documentation><example><EndEffectiveTime>2008-09-16T12:00:00Z</EndEffectiveTime></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Author" type="fsx:PersonType" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>Author of Comment.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
 		</xs:sequence>
-		<xs:attribute name="id" type="fsx:CounterType" use="optional"/>
+		<xs:attribute name="id" type="fsx:CounterType" use="optional">
+			<xs:annotation>
+				<xs:documentation>An ID for this comment</xs:documentation>
+				<xs:documentation><example>12345</example></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+
 		<xs:attribute name="subject" type="xs:string" use="optional">
 			<xs:annotation>
 				<xs:documentation>A subject for this comment.  Multiple comments with the same
 					subject should be considered related.
 				</xs:documentation>
+				<xs:documentation><example>Scheduled maintenance</example></xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 	</xs:complexType>
 	<xs:complexType name="PolesZerosType">
-		<xs:annotation>
-			<xs:documentation>Response: complex poles and zeros. Corresponds to SEED blockette
-				53.</xs:documentation>
-		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:BaseFilterType">
 				<xs:sequence>
 					<xs:element name="PzTransferFunctionType">
+						<xs:annotation>
+              <xs:documentation>
+                Allowable values are:"LAPLACE (RADIANS/SECOND)", "LAPLACE (HERTZ)", "DIGITAL (Z-TRANSFORM)".
+                For an analog stage this should be the units of the poles and zeros of
+                the Laplace Transform, either:
+                "LAPLACE (RADIANS/SECOND)" or "LAPLACE (HERTZ)".
+                For a digital z-transform (e.g., for an IIR filter), this should be
+                "DIGITAL (Z-TRANSFORM)"
+							</xs:documentation>
+              <xs:documentation><example><PzTransferFunctionType>LAPLACE (RADIANS/SECOND)</PzTransferFunctionType></example>
+							</xs:documentation>
+						</xs:annotation>
 						<xs:simpleType>
 							<xs:restriction base="xs:string">
 								<xs:enumeration value="LAPLACE (RADIANS/SECOND)"/>
@@ -511,25 +806,59 @@
 							</xs:restriction>
 						</xs:simpleType>
 					</xs:element>
-					<xs:element name="NormalizationFactor" type="xs:double" default="1.0"/>
-					<xs:element name="NormalizationFrequency" type="fsx:FrequencyType"/>
-					<xs:element name="Zero" type="fsx:PoleZeroType" minOccurs="0"
-						maxOccurs="unbounded"/>
-					<xs:element name="Pole" type="fsx:PoleZeroType" minOccurs="0"
-						maxOccurs="unbounded"/>
+					<xs:element name="NormalizationFactor" type="xs:double" default="1.0">
+						<xs:annotation>
+							<xs:documentation>Normalization scale factor</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="NormalizationFrequency" type="fsx:FrequencyType">
+						<xs:annotation>
+							<xs:documentation>Frequency at which the NormalizationFactor is valid.
+								This should be the same for all stages and within the passband, if any.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Zero" type="fsx:PoleZeroType" minOccurs="0" maxOccurs="unbounded">
+		        <xs:annotation>
+			        <xs:documentation>Complex zero of the polezero stage.</xs:documentation>
+		        </xs:annotation>
+					</xs:element>
+					<xs:element name="Pole" type="fsx:PoleZeroType" minOccurs="0" maxOccurs="unbounded">
+		        <xs:annotation>
+			        <xs:documentation>Complex pole of the polezero stage.</xs:documentation>
+		        </xs:annotation>
+					</xs:element>
 				</xs:sequence>
 			</xs:extension>
 		</xs:complexContent>
 	</xs:complexType>
 	<xs:complexType name="FIRType">
 		<xs:annotation>
-			<xs:documentation>Response: FIR filter. Corresponds to SEED blockette 61. FIR filters
-				are also commonly documented using the CoefficientsType element. </xs:documentation>
+			<xs:documentation>Response type for FIR filter.  FIR filters
+				are also commonly documented using a digital Coefficients element with no
+        denominators, but it is preferred to use this type
+				allowing representation of symmetric FIR coefficients without repeating them.
+			</xs:documentation>
+      <xs:documentation>
+        <warning>The NumeratorCoefficient field is likely to be changed to require at least one numerator in future versions of StationXML.</warning>
+      </xs:documentation>
+      <xs:documentation>
+        <warning>The NumeratorCoefficient field is likely to be renamed to Numerator in future versions of StationXML.</warning>
+      </xs:documentation>
 		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:BaseFilterType">
 				<xs:sequence>
 					<xs:element name="Symmetry">
+        		<xs:annotation>
+        			<xs:documentation>
+                The symmetry code. Designates how the factors will be specified.
+
+                * NONE: No Symmetry - all Coefficients are specified, corresponds to A in SEED.
+                * ODD: Odd number Coefficients with symmetry, B in SEED.
+                * EVEN: Even number Coefficients with symmetry, C in SEED.
+              </xs:documentation>
+        		</xs:annotation>
 						<xs:simpleType>
 							<xs:restriction base="xs:NMTOKEN">
 								<xs:enumeration value="NONE"/>
@@ -539,6 +868,15 @@
 						</xs:simpleType>
 					</xs:element>
 					<xs:element name="NumeratorCoefficient" minOccurs="0" maxOccurs="unbounded">
+        		<xs:annotation>
+              <xs:documentation>
+                The coefficients of the FIR filter. Should include at least one.
+              </xs:documentation>
+              <xs:documentation>
+                <warning>At least one Numerator may be required.</warning>
+                <warning>May be renamed to Numerator.</warning>
+              </xs:documentation>
+            </xs:annotation>
 						<xs:complexType>
 							<xs:simpleContent>
 								<xs:extension base="xs:double">
@@ -553,14 +891,23 @@
 	</xs:complexType>
 	<xs:complexType name="CoefficientsType">
 		<xs:annotation>
-			<xs:documentation>Response: coefficients for FIR filter. Laplace transforms or IIR
-				filters can be expressed using type as well but the PolesAndZerosType should be used
-				instead. Corresponds to SEED blockette 54.</xs:documentation>
+			<xs:documentation>Response type for filter giving coefficients. Laplace transforms or analog
+				filters can both be expressed using this type as well but the PolesZeros should be used
+				instead. Digital filters with no denominator should use FIR instead.
+      </xs:documentation>
+      <xs:documentation>
+        <warning>The Numerator element is likely to be changed to require at least one numerator.</warning>
+      </xs:documentation>
 		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:BaseFilterType">
 				<xs:sequence>
 					<xs:element name="CfTransferFunctionType">
+						<xs:annotation>
+							<xs:documentation> Almost always a digital response, but can be an
+								analog response in rad/sec or Hertz.
+							</xs:documentation>
+						</xs:annotation>
 						<xs:simpleType>
 							<xs:restriction base="xs:string">
 								<xs:enumeration value="ANALOG (RADIANS/SECOND)"/>
@@ -570,6 +917,13 @@
 						</xs:simpleType>
 					</xs:element>
 					<xs:element name="Numerator" minOccurs="0" maxOccurs="unbounded">
+						<xs:annotation>
+							<xs:documentation>Numerator for the coefficient. Should include at least one.
+							</xs:documentation>
+              <xs:documentation>
+                <warning>At least one Numerator may be required.</warning>
+              </xs:documentation>
+						</xs:annotation>
 						<xs:complexType>
 							<xs:simpleContent>
 								<xs:extension base="fsx:FloatNoUnitType">
@@ -579,6 +933,10 @@
 						</xs:complexType>
 					</xs:element>
 					<xs:element name="Denominator" minOccurs="0" maxOccurs="unbounded">
+						<xs:annotation>
+							<xs:documentation>Denominator for the coefficient
+							</xs:documentation>
+						</xs:annotation>
 						<xs:complexType>
 							<xs:simpleContent>
 								<xs:extension base="fsx:FloatNoUnitType">
@@ -600,8 +958,10 @@
 	</xs:complexType>
 	<xs:complexType name="ResponseListType">
 		<xs:annotation>
-			<xs:documentation>Response: list of frequency, amplitude and phase values. Corresponds
-				to SEED blockette 55. </xs:documentation>
+      <xs:documentation>Response type for a list of frequency, amplitude, and phase values.
+        Because it is less flexible, the other filter types, PolesZeros,
+        Coefficients, FIR, etc, are preferred.
+      </xs:documentation>
 		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:BaseFilterType">
@@ -614,25 +974,48 @@
 	</xs:complexType>
 	<xs:complexType name="PolynomialType">
 		<xs:annotation>
-			<xs:documentation>Response: expressed as a polynomial (allows non-linear sensors to be
-				described). Corresponds to SEED blockette 62. Can be used to describe a stage of
-				acquisition or a complete system. </xs:documentation>
+			<xs:documentation>Response type for a response represented as a polynomial expansion,
+				which allows non-linear sensors to be described. Used at either a stage of
+				acquisition response or a complete system. </xs:documentation>
 		</xs:annotation>
 		<xs:complexContent>
 			<xs:extension base="fsx:BaseFilterType">
 				<xs:sequence>
 					<xs:element name="ApproximationType" default="MACLAURIN">
+						<xs:annotation>
+							<xs:documentation>The series type for the polynomial approximation</xs:documentation>
+						</xs:annotation>
 						<xs:simpleType>
 							<xs:restriction base="xs:string">
 								<xs:enumeration value="MACLAURIN"/>
 							</xs:restriction>
 						</xs:simpleType>
 					</xs:element>
-					<xs:element name="FrequencyLowerBound" type="fsx:FrequencyType"/>
-					<xs:element name="FrequencyUpperBound" type="fsx:FrequencyType"/>
-					<xs:element name="ApproximationLowerBound" type="xs:double"/>
-					<xs:element name="ApproximationUpperBound" type="xs:double"/>
-					<xs:element name="MaximumError" type="xs:double"/>
+					<xs:element name="FrequencyLowerBound" type="fsx:FrequencyType">
+						<xs:annotation>
+							<xs:documentation>The lower bound of the frequency range.</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="FrequencyUpperBound" type="fsx:FrequencyType">
+						<xs:annotation>
+							<xs:documentation>The upper bound of the frequency range.</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="ApproximationLowerBound" type="xs:double">
+						<xs:annotation>
+							<xs:documentation>The lower bound of the approximation range.</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="ApproximationUpperBound" type="xs:double">
+						<xs:annotation>
+							<xs:documentation>The upper bound of the approximation range.</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="MaximumError" type="xs:double">
+						<xs:annotation>
+							<xs:documentation>The maximum error of the approximation.</xs:documentation>
+						</xs:annotation>
+					</xs:element>
 					<xs:element name="Coefficient" maxOccurs="unbounded">
 						<xs:complexType>
 							<xs:simpleContent>
@@ -648,28 +1031,76 @@
 	</xs:complexType>
 	<xs:complexType name="DecimationType">
 		<xs:annotation>
-			<xs:documentation>Corresponds to SEED blockette 57.</xs:documentation>
+			<xs:documentation>Representation of decimation stage</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
 			<xs:element name="InputSampleRate" type="fsx:FrequencyType"/>
-			<xs:element name="Factor" type="xs:integer"/>
-			<xs:element name="Offset" type="xs:integer"/>
-			<xs:element name="Delay" type="fsx:FloatType"/>
-			<xs:element name="Correction" type="fsx:FloatType"/>
+			<xs:element name="Factor" type="xs:integer">
+				<xs:annotation>
+					<xs:documentation> The factor of the input sample rate by which the rate is reduced.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Offset" type="xs:integer">
+				<xs:annotation>
+					<xs:documentation> Sample offset chosen for use. The value should be greater than or equal to zero,
+						but less than the decimation factor. If the first sample is used, set this field to zero.
+						If the second sample, set it to 1, and so forth.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Delay" type="fsx:FloatType">
+				<xs:annotation>
+					<xs:documentation>The estimated pure delay for the stage. This value will almost always be positive
+					to indicate a delayed signal. Due to the difficulty in estimating the pure delay
+					of a stage and because dispersion is neglected, this value should be
+					considered nominal.  Normally the delay would be corrected by the
+					recording system and the correction applied would be specified in &lt;Correction&gt; below.
+					See the Decimation Section in the StationXML documentation for a schematic description of delay sign convention.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Correction" type="fsx:FloatType">
+				<xs:annotation>
+					<xs:documentation>
+					The time shift, if any, applied to correct for the delay at this stage.
+					The sign convention used is opposite the &lt;Delay&gt; value; a positive sign here
+					indicates that the trace was corrected to an earlier time to cancel the
+					delay caused by the stage and indicated in the &lt;Delay&gt; element.
+					Commonly, the estimated delay and the applied correction are both positive to cancel
+					each other.  A value of zero indicates no correction was applied.
+					See the Decimation Section in the StationXML documentation for a schematic description of delay sign convention.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:element>
 		</xs:sequence>
 	</xs:complexType>
 	<!-- The following elements represent numbers. -->
 	<xs:attributeGroup name="uncertaintyDouble">
 		<xs:annotation>
-			<xs:documentation>Expressing uncertainties or errors with a positive and a negative
-				component. Both values should be given as positive integers, but minus_error is
-				understood to actually be negative. </xs:documentation>
+			<xs:documentation>Attributes for expressing uncertainties or errors with positive and negative
+				components. Both values should be given as positive integers, but the minusError is
+				understood to be negative. </xs:documentation>
 		</xs:annotation>
-		<xs:attribute name="plusError" type="xs:double" use="optional"/>
-		<xs:attribute name="minusError" type="xs:double" use="optional"/>
+		<xs:attribute name="plusError" type="xs:double" use="optional">
+			<xs:annotation>
+				<xs:documentation>plus uncertainty or error in measured value.</xs:documentation>
+				<xs:documentation><example>0.1</example></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="minusError" type="xs:double" use="optional">
+			<xs:annotation>
+				<xs:documentation>minus uncertainty or error in measured value.</xs:documentation>
+				<xs:documentation><example>0.1</example></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
 		<xs:attribute name="measurementMethod" type="xs:string" use="optional"/>
 	</xs:attributeGroup>
 	<xs:complexType name="FloatNoUnitType">
+		<xs:annotation>
+			<xs:documentation>Representation of floating-point numbers without unit.
+			</xs:documentation>
+		</xs:annotation>
 		<xs:simpleContent>
 			<xs:extension base="xs:double">
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
@@ -677,13 +1108,17 @@
 		</xs:simpleContent>
 	</xs:complexType>
 	<xs:complexType name="FloatType">
-		<xs:annotation>
-			<xs:documentation>Representation of floating-point numbers used as
-				measurements.</xs:documentation>
-		</xs:annotation>
 		<xs:simpleContent>
 			<xs:extension base="xs:double">
-				<xs:attribute name="unit" type="xs:string" use="optional"/>
+				<xs:attribute name="unit" type="xs:string" use="optional">
+				  <xs:annotation>
+            <xs:documentation>The unit of measurement. Use *SI* unit names and symbols whenever possible
+              (e.g., 'm' instead of 'METERS').</xs:documentation>
+            <xs:documentation><example>s</example></xs:documentation>
+            <xs:documentation><example ElementChoice="WaterLevel">m</example></xs:documentation>
+            <xs:documentation><example ElementChoice="Amplitude">m</example></xs:documentation>
+				  </xs:annotation>
+				</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:extension>
 		</xs:simpleContent>
@@ -691,11 +1126,17 @@
 	<!-- Derived from FloatType. -->
 	<xs:complexType name="SecondType">
 		<xs:annotation>
-			<xs:documentation>A time value in seconds.</xs:documentation>
+			<xs:documentation>A time duration value in seconds.</xs:documentation>
 		</xs:annotation>
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
-				<xs:attribute name="unit" type="xs:string" fixed="SECONDS"/>
+				<xs:attribute name="unit" type="xs:string" fixed="SECONDS">
+						<xs:annotation>
+							<xs:documentation>The type of unit being used.
+                This value is fixed to be SECONDS, setting it is redundant.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:restriction>
 		</xs:simpleContent>
@@ -703,7 +1144,13 @@
 	<xs:complexType name="VoltageType">
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
-				<xs:attribute name="unit" type="xs:string" fixed="VOLTS"/>
+				<xs:attribute name="unit" type="xs:string" fixed="VOLTS">
+						<xs:annotation>
+							<xs:documentation>The type of unit being used.
+                This value is fixed to be VOLTS, setting it is redundant.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:restriction>
 		</xs:simpleContent>
@@ -713,29 +1160,40 @@
 			<xs:restriction base="fsx:FloatType">
 				<xs:minInclusive value="-360"/>
 				<xs:maxInclusive value="360"/>
-				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES"/>
+				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES">
+					<xs:annotation>
+						<xs:documentation>The type of unit being used.
+              This value is fixed to be DEGREES, setting it is redundant.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:restriction>
 		</xs:simpleContent>
 	</xs:complexType>
 	<xs:complexType name="LatitudeBaseType">
 		<xs:annotation>
-			<xs:documentation>Base latitude type. Because of the limitations of schema, defining
-				this type and then extending it to create the real latitude type is the only way to
-				restrict values while adding datum as an attribute.</xs:documentation>
+			<xs:documentation>Base latitude type.</xs:documentation>
 		</xs:annotation>
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
 				<xs:minInclusive value="-90"/>
 				<xs:maxExclusive value="90"/>
-				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES"/>
+				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES">
+					<xs:annotation>
+						<xs:documentation>The type of unit being used.
+              This value is fixed to be DEGREES, setting it is redundant.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:restriction>
 		</xs:simpleContent>
 	</xs:complexType>
 	<xs:complexType name="LatitudeType">
 		<xs:annotation>
-			<xs:documentation>Type for latitude coordinate.</xs:documentation>
+			<xs:documentation>Latitude type extending the base type to add datum as an attribute with default.
+			</xs:documentation>
 		</xs:annotation>
 		<xs:simpleContent>
 			<xs:extension base="fsx:LatitudeBaseType">
@@ -744,18 +1202,28 @@
 		</xs:simpleContent>
 	</xs:complexType>
 	<xs:complexType name="LongitudeBaseType">
+		<xs:annotation>
+			<xs:documentation>Base longitude type.</xs:documentation>
+		</xs:annotation>
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
 				<xs:minInclusive value="-180"/>
 				<xs:maxInclusive value="180"/>
-				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES"/>
+				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES">
+					<xs:annotation>
+						<xs:documentation>The type of unit being used.
+              This value is fixed to be DEGREES, setting it is redundant.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:restriction>
 		</xs:simpleContent>
 	</xs:complexType>
 	<xs:complexType name="LongitudeType">
 		<xs:annotation>
-			<xs:documentation>Type for longitude coordinate.</xs:documentation>
+			<xs:documentation>Longitude type extending the base type to add datum as an attribute with default.
+			</xs:documentation>
 		</xs:annotation>
 		<xs:simpleContent>
 			<xs:extension base="fsx:LongitudeBaseType">
@@ -765,40 +1233,56 @@
 	</xs:complexType>
 	<xs:complexType name="AzimuthType">
 		<xs:annotation>
-			<xs:documentation>Instrument azimuth, degrees clockwise from North.</xs:documentation>
+      <xs:documentation>Azimuth of the component in degrees clockwise from geographic (true) north.
+			</xs:documentation>
 		</xs:annotation>
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
 				<xs:minInclusive value="0"/>
 				<xs:maxExclusive value="360"/>
-				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES"/>
+				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES">
+					<xs:annotation>
+						<xs:documentation>The type of unit being used.
+              This value is fixed to be DEGREES, setting it is redundant.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:restriction>
 		</xs:simpleContent>
 	</xs:complexType>
 	<xs:complexType name="DipType">
 		<xs:annotation>
-			<xs:documentation>Instrument dip in degrees down from horizontal. Together azimuth and
-				dip describe the direction of the sensitive axis of the instrument.
+      <xs:documentation>Dip of the component in degrees, positive is down from horizontal.
+        For horizontal dip=0, for vertical upwards
+        dip=-90 and for vertical downwards dip=+90.
 			</xs:documentation>
 		</xs:annotation>
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
 				<xs:minInclusive value="-90"/>
 				<xs:maxInclusive value="90"/>
-				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES"/>
+				<xs:attribute name="unit" type="xs:string" use="optional" fixed="DEGREES">
+						<xs:annotation>
+							<xs:documentation>The type of unit being used.
+                This value is fixed to be DEGREES, setting it is redundant.
+							</xs:documentation>
+						</xs:annotation>
+				</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:restriction>
 		</xs:simpleContent>
 	</xs:complexType>
 	<xs:complexType name="DistanceType">
-		<xs:annotation>
-			<xs:documentation>Extension of FloatType for distances, elevations, and
-				depths.</xs:documentation>
-		</xs:annotation>
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
-				<xs:attribute name="unit" type="xs:string" use="optional" default="METERS"/>
+				<xs:attribute name="unit" type="xs:string" use="optional" default="METERS">
+					<xs:annotation>
+						<xs:documentation>The type of unit being used.
+              This value is fixed to be METERS, setting it is redundant.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 				<xs:attributeGroup ref="fsx:uncertaintyDouble"/>
 			</xs:restriction>
 		</xs:simpleContent>
@@ -806,7 +1290,13 @@
 	<xs:complexType name="FrequencyType">
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
-				<xs:attribute name="unit" type="xs:string" use="optional" fixed="HERTZ"/>
+				<xs:attribute name="unit" type="xs:string" use="optional" fixed="HERTZ">
+					<xs:annotation>
+						<xs:documentation>The type of unit being used.
+              This value is fixed to be HERTZ, setting it is redundant.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 			</xs:restriction>
 		</xs:simpleContent>
 	</xs:complexType>
@@ -819,40 +1309,89 @@
 				considered more definitive. </xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="SampleRate" type="fsx:SampleRateType"/>
-			<xs:element name="SampleRateRatio" type="fsx:SampleRateRatioType" minOccurs="0"/>
+			<xs:element name="SampleRate" type="fsx:SampleRateType">
+		    <xs:annotation>
+          <xs:documentation>
+            Sample rate in samples per second.
+            SampleRate is optional unless SampleRateRatio is present, in which case
+            SampleRate is required.
+          </xs:documentation>
+          <xs:documentation>
+            <example><SampleRate>40.0</SampleRate></example>
+          </xs:documentation>
+		    </xs:annotation>
+      </xs:element>
+			<xs:element name="SampleRateRatio" type="fsx:SampleRateRatioType" minOccurs="0">
+		    <xs:annotation>
+          <xs:documentation>
+            Sample rate expressed as number of samples in a number of seconds.
+            If present, then &lt;SampleRate&gt; must also be present.
+            It can be useful for very slow data (e.g., less than a few samples per day),
+            since it allows for greater precision in the stored value.
+          </xs:documentation>
+          <xs:documentation>
+            <example>
+              <SampleRate>0.000023148</SampleRate>
+              <SampleRateRatio>
+                <NumberSamples>2</NumberSamples>
+                <NumberSeconds>86400</NumberSeconds>
+              </SampleRateRatio>
+						</example>
+          </xs:documentation>
+		    </xs:annotation>
+		  </xs:element>
 		</xs:sequence>
 	</xs:group>
 	<xs:complexType name="SampleRateType">
-		<xs:annotation>
-			<xs:documentation> Sample rate in samples per second. </xs:documentation>
-		</xs:annotation>
 		<xs:simpleContent>
 			<xs:restriction base="fsx:FloatType">
-				<xs:attribute name="unit" type="xs:string" use="optional" fixed="SAMPLES/S"/>
+				<xs:attribute name="unit" type="xs:string" use="optional" fixed="SAMPLES/S">
+					<xs:annotation>
+						<xs:documentation>The type of unit being used.
+              This value is fixed to be SAMPLES/S, setting it is redundant.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 			</xs:restriction>
 		</xs:simpleContent>
 	</xs:complexType>
 	<xs:complexType name="SampleRateRatioType">
-		<xs:annotation>
-			<xs:documentation> Sample rate expressed as number of samples in a number of
-				seconds.</xs:documentation>
-		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="NumberSamples" type="xs:integer"/>
-			<xs:element name="NumberSeconds" type="xs:integer"/>
+			<xs:element name="NumberSamples" type="xs:integer">
+					<xs:annotation>
+						<xs:documentation>
+              Integer number of samples that span a number of seconds.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:element>
+			<xs:element name="NumberSeconds" type="xs:integer">
+					<xs:annotation>
+						<xs:documentation>
+              Integer number of seconds that span a number of samples.
+						</xs:documentation>
+					</xs:annotation>
+				</xs:element>
 		</xs:sequence>
 	</xs:complexType>
 	<xs:complexType name="PoleZeroType">
-		<xs:annotation>
-			<xs:documentation> Complex numbers used as poles or zeros in channel
-				response.</xs:documentation>
-		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="Real" type="fsx:FloatNoUnitType"/>
-			<xs:element name="Imaginary" type="fsx:FloatNoUnitType"/>
+			<xs:element name="Real" type="fsx:FloatNoUnitType">
+				<xs:annotation>
+					<xs:documentation>Real part of the complex number.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Imaginary" type="fsx:FloatNoUnitType">
+				<xs:annotation>
+					<xs:documentation>Imaginary part of the complex number.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
 		</xs:sequence>
-		<xs:attribute name="number" type="xs:integer"/>
+		<xs:attribute name="number" type="xs:integer">
+				<xs:annotation>
+					<xs:documentation>The position index of the pole (or zero) in the array of poles[] (or zeros[])</xs:documentation>
+          <xs:documentation><example><Pole number="1" /></example></xs:documentation>
+				</xs:annotation>
+		</xs:attribute>
 	</xs:complexType>
 	<xs:simpleType name="CounterType">
 		<xs:annotation>
@@ -864,77 +1403,125 @@
 	</xs:simpleType>
 	<xs:complexType name="OperatorType">
 		<xs:annotation>
-			<xs:documentation>An operating agency and associated contact persons.
-				Since the Contact element is a generic type that represents any contact
+			<xs:documentation>
+        Since the Contact element is a generic type that represents any contact
 				person, it also has its own optional Agency element.
-				It is expected that typically the contact’s optional Agency tag will match the Operator Agency.
-				Only contacts appropriate for the enclosing element should be include in the Operator tag.</xs:documentation>
+				It is expected that typically the contact's optional Agency tag will match the Operator Agency.
+				Only contacts appropriate for the enclosing element should be included in the Operator tag.
+			</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="Agency" type="xs:string"/>
-			<xs:element name="Contact" type="fsx:PersonType" minOccurs="0"
-				maxOccurs="unbounded"/>
-			<xs:element name="WebSite" type="xs:anyURI" minOccurs="0"/>
+			<xs:element name="Agency" type="xs:string">
+				<xs:annotation>
+			    		<xs:documentation>The operating agency.</xs:documentation>
+					<xs:documentation><example><Agency>USGS</Agency></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Contact" type="fsx:PersonType" minOccurs="0" maxOccurs="unbounded"/>
+			<xs:element name="WebSite" type="xs:anyURI" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>Website of operating agency</xs:documentation>
+					<xs:documentation><example><WebSite>http://usgs.gov</WebSite></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
 		</xs:sequence>
 	</xs:complexType>
 	<xs:complexType name="PersonType">
 		<xs:annotation>
-			<xs:documentation>Representation of a person's contact information. A person can belong
-				to multiple agencies and have multiple email addresses and phone
-				numbers.</xs:documentation>
+			<xs:documentation>Person's contact information. A person can belong
+				to multiple agencies and have multiple email addresses and phone numbers.
+			</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
-			<xs:element name="Agency" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
-			<xs:element name="Email" type="fsx:EmailType" minOccurs="0" maxOccurs="unbounded"/>
-			<xs:element name="Phone" type="fsx:PhoneNumberType" minOccurs="0" maxOccurs="unbounded"
-			/>
+			<xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>Name of contact or author</xs:documentation>
+					<xs:documentation><example><Name>Dr. Jane Doe</Name></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Agency" type="xs:string" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>Agency of contact or author</xs:documentation>
+					<xs:documentation><example><Agency>USGS</Agency></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Email" type="fsx:EmailType" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>Email of contact or author</xs:documentation>
+					<xs:documentation><example><Email>jane_doe@example.com</Email></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Phone" type="fsx:PhoneNumberType" minOccurs="0" maxOccurs="unbounded">
+				<xs:annotation>
+					<xs:documentation>Phone of contact or author</xs:documentation>
+				</xs:annotation>
+			</xs:element>
 		</xs:sequence>
 	</xs:complexType>
 	<xs:complexType name="SiteType">
 		<xs:annotation>
-			<xs:documentation> Description of a site location using name and optional geopolitical
-				boundaries (country, city, etc.). </xs:documentation>
+			<xs:documentation> Description of a location using name and optional geopolitical boundaries (country, city, etc.).
+			</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
 			<xs:element name="Name" type="xs:string">
 				<xs:annotation>
-					<xs:documentation> The commonly used name of this station, equivalent to the
-						SEED blockette 50, field 9. </xs:documentation>
+					<xs:documentation>Name of the site</xs:documentation>
+					<xs:documentation><example><Name>Albuquerque, New Mexico</Name></example></xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:element name="Description" type="xs:string" minOccurs="0">
 				<xs:annotation>
-					<xs:documentation> A longer description of the location of this station, e.g.
-						"NW corner of Yellowstone National Park" or "20 miles west of Highway 40."
-					</xs:documentation>
+					<xs:documentation>A longer description of the location of this station</xs:documentation>
+					<xs:documentation><example><Description>NW corner of Yellowstone National Park</Description></example></xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:element name="Town" type="xs:string" minOccurs="0">
 				<xs:annotation>
-					<xs:documentation> The town or city closest to the station.</xs:documentation>
+					<xs:documentation>The town or city closest to the station.</xs:documentation>
+					<xs:documentation><example><Town>Albuquerque</Town></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="County" type="xs:string" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>The county where the station is located</xs:documentation>
+					<xs:documentation><example><County>Bernalillo</County></example></xs:documentation>
 				</xs:annotation>
 			</xs:element>
-			<xs:element name="County" type="xs:string" minOccurs="0"/>
+
 			<xs:element name="Region" type="xs:string" minOccurs="0">
 				<xs:annotation>
-					<xs:documentation> The state, province, or region of this
-						site.</xs:documentation>
+					<xs:documentation>The state, province, or region of this site.</xs:documentation>
+					<xs:documentation><example><Region>Southwest U.S.</Region></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Country" type="xs:string" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>The country of this site.</xs:documentation>
+					<xs:documentation><example><Country>U.S.A.</Country></example></xs:documentation>
 				</xs:annotation>
 			</xs:element>
-			<xs:element name="Country" type="xs:string" minOccurs="0"/>
 			<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
 		</xs:sequence>
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="ExternalReferenceType">
 		<xs:annotation>
-			<xs:documentation>This type contains a URI and description for external data that users
-				may want to reference in StationXML.</xs:documentation>
+		  <xs:documentation>This type contains a Uniform Resource Identifier (URI) and description
+                  for external information that users may want to reference.
+		  </xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="URI" type="xs:anyURI"/>
-			<xs:element name="Description" type="xs:string"/>
+			<xs:element name="URI" type="xs:anyURI">
+				<xs:annotation>
+					<xs:documentation>URI of the external reference.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Description" type="xs:string">
+				<xs:annotation>
+					<xs:documentation>Description of the external reference.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
 		</xs:sequence>
 	</xs:complexType>
 	<!-- Simple types -->
@@ -951,9 +1538,23 @@
 	</xs:simpleType>
 	<xs:complexType name="PhoneNumberType">
 		<xs:sequence>
-			<xs:element name="CountryCode" type="xs:integer" minOccurs="0"/>
-			<xs:element name="AreaCode" type="xs:integer"/>
+			<xs:element name="CountryCode" type="xs:integer" minOccurs="0">
+				<xs:annotation>
+ 					<xs:documentation>Telephone country code</xs:documentation>
+					<xs:documentation><example><CountryCode>64</CountryCode></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="AreaCode" type="xs:integer">
+				<xs:annotation>
+					<xs:documentation>Telephone area code</xs:documentation>
+					<xs:documentation><example><AreaCode>408</AreaCode></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
 			<xs:element name="PhoneNumber">
+				<xs:annotation>
+					<xs:documentation>Telephone number</xs:documentation>
+					<xs:documentation><example><PhoneNumber>5551212</PhoneNumber></example></xs:documentation>
+				</xs:annotation>
 				<xs:simpleType>
 					<xs:restriction base="xs:string">
 						<xs:pattern value="[0-9]+-[0-9]+"/>
@@ -972,19 +1573,24 @@
 	</xs:simpleType>
 	<xs:complexType name="UnitsType">
 		<xs:annotation>
-			<xs:documentation>A type to document units. Corresponds to SEED blockette
-				34.</xs:documentation>
+			<xs:documentation>A type to document units; use SI whenever possible.</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
 			<xs:element name="Name" type="xs:string">
 				<xs:annotation>
-					<xs:documentation>Name of units, e.g. "M/S", "V", "PA".</xs:documentation>
+					<xs:documentation>Symbol or name of units, e.g. "m/s", "V", "Pa", "C".
+            Use SI whenever possible, along with singular lowercase
+            "count" for digital counts.</xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:element name="Description" type="xs:string" minOccurs="0">
 				<xs:annotation>
 					<xs:documentation>Description of units, e.g. "Velocity in meters per second",
-						"Volts", "Pascals".</xs:documentation>
+						"Volts", "Pascals", "Degrees Celsius".
+            Description is only needed when the unit name is not a well know
+            SI unit or there is need for clarification. Prefer not to use a
+            Description for common units like `m/s`, `m/s**2`, `count`, etc.
+					</xs:documentation>
 				</xs:annotation>
 			</xs:element>
 		</xs:sequence>
@@ -993,12 +1599,23 @@
 		<xs:annotation>
 			<xs:documentation>A type to document persistent identifiers.
 				Identifier values should be specified without a URI scheme (prefix),
-				instead the identifer type is documented as an attribute.
+				instead the identifier type is documented as an attribute.
 			</xs:documentation>
+      <xs:documentation>
+        <example><identifier type="DOI">10.1000/140</identifier></example>
+      </xs:documentation>
+      <xs:documentation><example LevelChoice="N"><identifier type="DOI">10.7914/SN/XX</identifier></example></xs:documentation>
+      <xs:documentation><example LevelChoice="S"><identifier type="DOI">10.5555/12345678</identifier>ABCD</example></xs:documentation>
+      <xs:documentation><example LevelChoice="C"><identifier type="DOI">10.5555/12345678</identifier>BHZ</example></xs:documentation>
 		</xs:annotation>
 		<xs:simpleContent>
 			<xs:extension base="xs:string">
-				<xs:attribute name="type" type="xs:string"> </xs:attribute>
+				<xs:attribute name="type" type="xs:string">
+					<xs:annotation>
+						<xs:documentation>Identifier type</xs:documentation>
+						<xs:documentation><example>DOI</example></xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 			</xs:extension>
 		</xs:simpleContent>
 	</xs:complexType>
@@ -1007,26 +1624,39 @@
 			<xs:documentation> The BaseFilterType is derived by all filters. </xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="Description" type="xs:string" minOccurs="0"/>
+			<xs:element name="Description" type="xs:string" minOccurs="0">
+				<xs:annotation>
+                                  <xs:documentation> The description of the filter/stage/response</xs:documentation>
+				</xs:annotation>
+			</xs:element>
 			<xs:element name="InputUnits" type="fsx:UnitsType">
 				<xs:annotation>
-					<xs:documentation> The units of the data as input from the perspective of data
-						acquisition. After correcting data for this response, these would be the
-						resulting units. </xs:documentation>
+					<xs:documentation>
+            The units of the data as input from the previous stage. For example
+            if stage 1 represented a seismometer, InputUnits would be 'm/s'
+            and OutputUnits would be 'V'.
+					</xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:element name="OutputUnits" type="fsx:UnitsType">
 				<xs:annotation>
-					<xs:documentation> The units of the data as output from the perspective of data
-						acquisition. These would be the units of the data prior to correcting for
-						this response. </xs:documentation>
+					<xs:documentation>
+            The units of the data as output to the following stage. For example
+            if stage 2 represented the AtoD stage of a data logger,
+            InputUnits would be 'V'
+            and OutputUnits would be 'count'.
+					</xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
 		</xs:sequence>
 		<xs:attribute name="resourceId" type="xs:string">
 			<xs:annotation>
-				<xs:documentation> Same meaning as Equipment:resourceId. </xs:documentation>
+				<xs:documentation>A resource identifier that serves to unique identify this filter or response.
+					This identifier can be interpreted differently depending on the datacenter/software
+					that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID.
+					It should be expected that elements with the same resourceId should indicate the same information.
+				</xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:attribute name="name" type="xs:string">
@@ -1037,48 +1667,90 @@
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="ResponseType">
+		<xs:annotation>
+			<xs:documentation>The complete instrument response for this channel that expresses the effect of the
+				geophysical instrumentation used to record the input ground motion.
+				The information can be used to convert raw data to Earth unit measurement at a specified
+				frequency or within a range of frequencies.
+				It is strongly suggested that either InstrumentSensitivity or InstrumentPolynomial should be present.
+			</xs:documentation>
+      <xs:documentation>
+        In cases where the response is unknown, for example really old channels,
+        or where a response is not applicable, like textual log channels,
+        it is preferred that an empty
+        response element be used, &lt;response&gt;&lt;/response&gt;,
+        to positively indicate that no response exists.
+      </xs:documentation>
+		</xs:annotation>
 		<xs:sequence>
 			<xs:choice minOccurs="0">
 				<xs:annotation>
 					<xs:documentation>Instrument sensitivities, or the complete system sensitivity,
 						can be expressed using either a sensitivity value or a polynomial. The
-						information can be used to convert raw data to Earth at a specified
-						frequency or within a range of frequencies. </xs:documentation>
+						information can be used to convert raw data to Earth units at a specified
+						frequency or within a range of frequencies.
+					</xs:documentation>
 				</xs:annotation>
 				<xs:element name="InstrumentSensitivity" type="fsx:SensitivityType" minOccurs="0">
 					<xs:annotation>
-						<xs:documentation> The total sensitivity for a channel, representing the
-							complete acquisition system expressed as a scalar. Equivalent to SEED
-							stage 0 gain with (blockette 58) with the ability to specify a frequency
-							range. </xs:documentation>
+						<xs:documentation>The total sensitivity for a channel, representing the
+							complete acquisition system expressed as a scalar.
+							All instrument responses except polynomial response should have
+							an InstrumentSensitivity.
+						</xs:documentation>
 					</xs:annotation>
 				</xs:element>
 				<xs:element name="InstrumentPolynomial" type="fsx:PolynomialType" minOccurs="0">
 					<xs:annotation>
-						<xs:documentation> The total sensitivity for a channel, representing the
-							complete acquisition system expressed as a polynomial. Equivalent to
-							SEED stage 0 polynomial (blockette 62). </xs:documentation>
+						<xs:documentation>For non-linear sensors (e.g., :math:`N\ge 2`), such as some thermistors,
+						pressure transducers, extensometers, etc.), it is required to
+						express the sensor input (e.g., Temp) as a Maclaurin series expansion of powers of the
+						*output* units (e.g., Volts):
+
+						.. math::
+
+              Temp(V)=\sum_{k=0}^{N} a_k V^{k}
+
+						For such responses, two StationXML components are required to specify the response:
+						1. A Polynomial stage, which contains the values of the Maclaurin coefficients,
+						:math:`a_k`, and 2. An InstrumentPolynomial element that contains the
+						same coefficients, but scaled by powers of the overall gain representing the
+						combined effect of all the stages in the complete acquisition system.
+						</xs:documentation>
 					</xs:annotation>
 				</xs:element>
 			</xs:choice>
 			<xs:element name="Stage" type="fsx:ResponseStageType" minOccurs="0"
-				maxOccurs="unbounded"/>
+				maxOccurs="unbounded">
+			</xs:element>
 			<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
 		</xs:sequence>
 		<xs:attribute name="resourceId" type="xs:string">
 			<xs:annotation>
-				<xs:documentation> Same meaning as Equipment:resourceId. </xs:documentation>
+				<xs:documentation> An identifier that serves to uniquely identify this resource.
+					This identifier can be interpreted differently depending on the datacenter/software
+					that generated the document. Also, we recommend using a prefix, e.g., GENERATOR:Meaningful ID.
+					It should be expected that elements with the same ID should indicate the same information.
+				</xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="BaseNodeType">
 		<xs:annotation>
-			<xs:documentation>A base node type for derivation from: Network, Station and Channel
-				types.</xs:documentation>
+			<xs:documentation>A base node type use in Network, Station, and Channel types.
+			</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
-			<xs:element name="Description" type="xs:string" minOccurs="0"/>
+			<xs:element name="Description" type="xs:string" minOccurs="0">
+				<xs:annotation>
+          <xs:documentation>Description of the Network, Station, or Channel</xs:documentation>
+          <xs:documentation><levelDesc LevelChoice="N">Description of the Network</levelDesc></xs:documentation>
+          <xs:documentation><levelDesc LevelChoice="S">Description of the Station</levelDesc></xs:documentation>
+          <xs:documentation><levelDesc LevelChoice="C">Description of the Channel</levelDesc></xs:documentation>
+					<xs:documentation><example><Description>This is a description</Description></example></xs:documentation>
+				</xs:annotation>
+			</xs:element>
 			<xs:element name="Identifier" type="fsx:IdentifierType" minOccurs="0" maxOccurs="unbounded"/>
 			<xs:element name="Comment" type="fsx:CommentType" minOccurs="0" maxOccurs="unbounded"/>
 			<xs:element name="DataAvailability" type="fsx:DataAvailabilityType" minOccurs="0">
@@ -1087,44 +1759,106 @@
 						information should be considered transient and is primarily useful as a
 						guide for generating time series data requests. The information for a
 						DataAvailability:Span may be specific to the time range used in a request
-						that resulted in the document or limited to the availability of data withing
+						that resulted in the document or limited to the availability of data within
 						the request range. These details may or may not be retained when
-						synchronizing metadata between data centers. </xs:documentation>
+						synchronizing metadata between data centers.
+					</xs:documentation>
 				</xs:annotation>
 			</xs:element>
 			<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
 		</xs:sequence>
-		<xs:attribute name="code" type="xs:string" use="required"/>
-		<xs:attribute name="startDate" type="xs:dateTime"/>
-		<xs:attribute name="endDate" type="xs:dateTime"/>
+		<xs:attribute name="code" type="xs:string" use="required">
+			<xs:annotation>
+        <xs:documentation><levelDesc LevelChoice="N">Name of Network</levelDesc></xs:documentation>
+        <xs:documentation><levelDesc LevelChoice="S">Name of Station</levelDesc></xs:documentation>
+        <xs:documentation><levelDesc LevelChoice="C">Name of Channel</levelDesc></xs:documentation>
+        <xs:documentation><example LevelChoice="N">XX</example></xs:documentation>
+        <xs:documentation><example LevelChoice="S">ABCD</example></xs:documentation>
+        <xs:documentation><example LevelChoice="C">BHZ</example></xs:documentation>
+      </xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="startDate" type="xs:dateTime">
+			<xs:annotation>
+				<xs:documentation>Start date of network/station/channel epoch </xs:documentation>
+        <xs:documentation><levelDesc LevelChoice="N">Start date of network</levelDesc></xs:documentation>
+        <xs:documentation><levelDesc LevelChoice="S">Start date of station epoch</levelDesc></xs:documentation>
+        <xs:documentation><levelDesc LevelChoice="C">Start date of channel epoch</levelDesc></xs:documentation>
+        <xs:documentation><example>2016-07-01T00:00:00Z</example></xs:documentation>
+        <xs:documentation><warning>This attribute is likely to require timezone of Z.</warning></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="endDate" type="xs:dateTime">
+			<xs:annotation>
+        <xs:documentation>End date of network/station/channel epoch</xs:documentation>
+        <xs:documentation><levelDesc LevelChoice="N">End date of network. Do not use if still active, endDate should not be in the future.</levelDesc></xs:documentation>
+        <xs:documentation><levelDesc LevelChoice="S">End date of station epoch. Do not use if still active, endDate should not be in the future.</levelDesc></xs:documentation>
+        <xs:documentation><levelDesc LevelChoice="C">End date of channel epoch. Do not use if still active, endDate should not be in the future.</levelDesc></xs:documentation>
+        <xs:documentation><example>2018-01-27T00:00:00Z</example></xs:documentation>
+        <xs:documentation><warning>This attribute should not be used if it is in the future.</warning></xs:documentation>
+        <xs:documentation><warning>This attribute is likely to require timezone of Z.</warning></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
 		<xs:attribute name="sourceID" type="xs:anyURI">
 			<xs:annotation>
-				<xs:documentation>A data source identifier in URI form</xs:documentation>
+				<xs:documentation>
+          A data source identifier in URI form.
+          It is recommended that this follow the FDSN Source Identifiers
+          specification, http://docs.fdsn.org/projects/source-identifiers
+        </xs:documentation>
+        <xs:documentation>
+          <example LevelChoice="N">FDSN:XX</example>
+          <example LevelChoice="S">FDSN:XX_ABCD</example>
+          <example LevelChoice="C">FDSN:XX_ABCD_00_B_H_Z</example>
+        </xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="restrictedStatus" type="fsx:RestrictedStatusType" use="optional">
+			<xs:annotation>
+				<xs:documentation>One of: \"open\", \"closed\", \"partial\"</xs:documentation>
+				<xs:documentation><example>open</example></xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
-		<xs:attribute name="restrictedStatus" type="fsx:RestrictedStatusType" use="optional"/>
 		<xs:attribute name="alternateCode" type="xs:string" use="optional">
 			<xs:annotation>
-				<xs:documentation> A code used for display or association, alternate to the
-					SEED-compliant code. </xs:documentation>
+        <xs:documentation>A code used for display or association</xs:documentation>
+        <xs:documentation>
+          <example LevelChoice="N">GSN</example>
+          <example LevelChoice="S">ALQ</example>
+          <example LevelChoice="C">Z</example>
+        </xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:attribute name="historicalCode" type="xs:string" use="optional">
 			<xs:annotation>
-				<xs:documentation> A previously used code if different from the current code.
-				</xs:documentation>
+        <xs:documentation>A previously used code if different from the current code</xs:documentation>
+        <xs:documentation>
+          <example LevelChoice="N">XX</example>
+          <example LevelChoice="S">albq</example>
+          <example LevelChoice="C">bhz</example>
+        </xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="DataAvailabilityExtentType">
 		<xs:annotation>
-			<xs:documentation> A type for describing data availability extents, the earliest and
-				latest data available. No information is included about the continuity of the data
-				is included or implied. </xs:documentation>
+			<xs:documentation>Data availability extents, the earliest and
+				latest data available. No information about the continuity of the data
+				is included or implied.
+			</xs:documentation>
 		</xs:annotation>
-		<xs:attribute name="start" type="xs:dateTime" use="required"/>
-		<xs:attribute name="end" type="xs:dateTime" use="required"/>
+		<xs:attribute name="start" type="xs:dateTime" use="required">
+			<xs:annotation>
+				<xs:documentation>start date of extent</xs:documentation>
+				<xs:documentation><example>1988-01-01T00:00:00Z</example></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="end" type="xs:dateTime" use="required">
+			<xs:annotation>
+				<xs:documentation>end date of extent</xs:documentation>
+				<xs:documentation><example>1988-12-31T00:00:00Z</example></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="DataAvailabilitySpanType">
@@ -1133,28 +1867,43 @@
 				continuity. The time range described may be based on the request parameters that
 				generated the document and not necessarily relate to continuity outside of the
 				range. It may also be a smaller time window than the request depending on the data
-				characteristics. </xs:documentation>
+				characteristics.
+			</xs:documentation>
 		</xs:annotation>
-		<xs:attribute name="start" type="xs:dateTime" use="required"/>
-		<xs:attribute name="end" type="xs:dateTime" use="required"/>
+		<xs:attribute name="start" type="xs:dateTime" use="required">
+			<xs:annotation>
+				<xs:documentation>start date of span</xs:documentation>
+				<xs:documentation><example>1988-01-01T00:00:00Z</example></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
+		<xs:attribute name="end" type="xs:dateTime" use="required">
+			<xs:annotation>
+				<xs:documentation>end date of span</xs:documentation>
+				<xs:documentation><example>1988-12-31T00:00:00Z</example></xs:documentation>
+			</xs:annotation>
+		</xs:attribute>
 		<xs:attribute name="numberSegments" type="xs:integer" use="required">
 			<xs:annotation>
 				<xs:documentation> The number of continuous time series segments contained in the
 					specified time range. A value of 1 indicates that the time series is continuous
-					from start to end. </xs:documentation>
+					from start to end.
+				</xs:documentation>
+			  <xs:documentation><example>2</example></xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:attribute name="maximumTimeTear" type="xs:decimal" use="optional">
 			<xs:annotation>
 				<xs:documentation> The maximum time tear (gap or overlap) in seconds between time
-					series segments in the specified range. </xs:documentation>
+					series segments in the specified range.
+				</xs:documentation>
+				<xs:documentation><example>0.01</example></xs:documentation>
 			</xs:annotation>
 		</xs:attribute>
 		<xs:anyAttribute namespace="##other" processContents="lax"/>
 	</xs:complexType>
 	<xs:complexType name="DataAvailabilityType">
 		<xs:annotation>
-			<xs:documentation>An type for describing data availability.</xs:documentation>
+			<xs:documentation>A type for describing data availability.</xs:documentation>
 		</xs:annotation>
 		<xs:sequence>
 			<xs:element name="Extent" type="fsx:DataAvailabilityExtentType" minOccurs="0"/>