Completed vertical datums tutorial

Author: Kyran-Cook

docs/features/height.rst

@@ -1,4 +1,46 @@
 .. _features/height:  
 
 Vertical Datums
-=================
+=================
+
+This module includes functions for dealing with height datums and geoids.
+
+.. note:: GDAL is needed for this module. Please consult the GDAL pypi for instructions on installing GDAL
+
+Converting Between Height Datums
+--------------------------------
+
+The following functions all convert between different height datums with a particular focus on Australian datums.
+
+.. autofunction:: geodepy.height.GPS_to_AHD
+.. autofunction:: geodepy.height.AHD_to_GPS
+.. autofunction:: geodepy.height.GPS_to_AVWS
+.. autofunction:: geodepy.height.AVWS_to_GPS
+.. autofunction:: geodepy.height.AHD_to_AVWS
+.. autofunction:: geodepy.height.AVWS_to_AHD
+.. autofunction:: geodepy.height.GPS_to_AUSGeoid98
+.. autofunction:: geodepy.height.AUSGeoid98_to_GPS
+.. autofunction:: geodepy.height.GPS_to_AUSGeoid09
+.. autofunction:: geodepy.height.AUSGeoid09_to_GPS
+.. autofunction:: geodepy.height.DOV
+.. autofunction:: geodepy.height.DOV_09
+.. autofunction:: geodepy.height.DOV_98
+
+Calculating Gravity
+-------------------
+
+The functions below can be used to calculate different components of gravity.
+
+.. autofunction:: geodepy.height.mean_surface_grav
+.. autofunction:: geodepy.height.interp_grav
+.. autofunction:: geodepy.height.normal_grav
+.. autofunction:: geodepy.height.mean_normal_grav
+.. autofunction:: geodepy.height.normal_correction
+.. autofunction:: geodepy.height.normal_orthometric_correction
+
+Auxilary Function
+-----------------
+
+Functions used to enable other functions in the module.
+
+.. autofunction:: geodepy.height.interp_file

docs/requirements.txt

@@ -1,3 +1,6 @@
 furo
 pandas
-sphinxext-opengraph
+sphinxext-opengraph
+gdal
+numpy>1.0.0 wheel setuptools>=67
+gdal[numpy]=="$(gdal-config --version).*"

docs/tutorials/verticaldatumtut.rst

@@ -1,4 +1,68 @@
 .. _tutorials/vert:
 
 Vertical Datums
-===============
+===============
+
+This tutorial will work through converting between different vertical datums and working with gravity.
+
+Converting Between Vertical Datums
+----------------------------------
+
+Geodepy allows you to convert between different vertical datums within Australia. Below we will convert from 
+an ellipsoidal height to AHD and then to AVWS.
+
+.. code:: python
+
+    import geodepy.height
+
+First we will convert from ellipsoidal height to AHD.
+
+.. code:: python
+
+    rl = geodepy.height.GPS_to_AHD(-35.34405212, 149.15847673, 594.495)
+
+    print(rl[0])
+
+    >>[575.176]
+
+This is the AHD height of this point. Now we can convert to AVWS.
+
+.. code:: python
+
+    rl = geodepy.height.AHD_to_AVWS(-35.34405212, 149.15847673,rl[0])
+
+    print(rl[0])
+
+    >>[575.303]
+
+Finding Gravity Values
+----------------------
+
+Geodepy can also find gravity values at any point around Australia. This can be seen below.
+
+.. code:: python
+
+    import geodepy.height
+
+To find the gravity at any point the geodepy.height.mean_surface_grav function can be used.
+Normally this function is used to find the mean surface gravty between two points however
+if the same lat and long are used for both point A and B then the gravity at a set location can be found.
+
+.. code:: python
+
+    grav = geodepy.height.mean_surface_grav(-35.34405212, 149.15847673, 575.176, -35.34405212, 149.15847673, 575.176,)
+
+    print(grav)
+
+    >>[9.79603591]
+
+To calculate the average gravity between the ellipsoid and a certain height the following function can be used.
+
+.. code:: python
+
+    grav = geodepy.height.mean_normal_grav(-35.34405212, 594.495)
+
+    print(grav)
+
+    >>9.79671297
+