Bugfix #2426 develop buoy

docs/Users_Guide/config_options.rst

@@ -272,6 +272,34 @@ The default table can be found in the installed
 XML content for all stations that allows lookups of latitude, longitude,
 and, in some cases, elevation for all stations based on stationId.
 
+This set of stations comes from 2 online sources
+`The active stations website <https://www.ndbc.noaa.gov/activestations.xml>`_
+and `The complete stations website <https://www.airnow.gov>`_.
+As these lists can change as a function of time, a script can be run to pull
+down the contents of both websites and merge any changes with the existing stations
+file content, creating an updated stations file locally.
+The MET_NDBC_STATIONS environment variable can be then set to refer to this newer
+stations file.  Also, the MET development team will periodically
+run this script and update *share/met/table_files/ndbc_stations.xml*.
+
+To run this utility:
+
+build_ndbc_stations_from_web.py <-d> <-p> <-o OUTPUT_FILE>
+Usage: build_ndbc_stations_from_web.py [options]
+Options:
+  -h, --help            show this help message and exit
+  -d, --diagnostic      Rerun using downlaoded files, skipping download step
+                        (optional, default: False)
+  -p, --prune           Prune files that are no longer online (optional,
+                        default:False)
+  -o OUT_FILE, --out=OUT_FILE
+                         Save the text into the named file (default:
+                        merged.txt )
+
+NOTE: The downloaded files are written to a subdirectory ndbc_temp_data which
+can be deleted once the final output file is created.
+
+
 MET_BASE
 ^^^^^^^^
 

scripts/utility/Makefile.am

@@ -26,7 +26,8 @@
 pythonutilitydir = $(pkgdatadir)/utility
 
 pythonutility_DATA = \
-	print_pointnc2ascii.py
+	print_pointnc2ascii.py \
+	build_ndbc_stations_from_web.py
 
 EXTRA_DIST = ${pythonutility_DATA}
 

scripts/utility/Makefile.in

@@ -298,7 +298,8 @@ top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
 pythonutilitydir = $(pkgdatadir)/utility
 pythonutility_DATA = \
-	print_pointnc2ascii.py
+	print_pointnc2ascii.py \
+	build_ndbc_stations_from_web.py
 
 EXTRA_DIST = ${pythonutility_DATA}
 MAINTAINERCLEANFILES = Makefile.in