Add MesoWest config example

[infoex-autowx.git] / README.md

diff --git a/README.md b/README.md
index 44338289fb499617d129fcf968832b4f8e019a79..3a3a29fd03f9256437d23af7713425d6a8f2adfa 100644 (file)
--- a/README.md
+++ b/README.md
@@ -52,32 +52,34 @@ created earlier):
 Configuration File
 ------------------
 
 Configuration File
 ------------------
 

-The configuration file is separated into two parts, the [wxsite]
-portion, and the [ftp] portion.
+The configuration file is separated into two parts, the
+[nrcs]/[mesowest] portion, and the [infoex] portion.

 
 

-The [wxsite] values describe which NRCS SNOTEL site's data you're after.
-See the next section in this README for instructions on obtaining these
-values.
+The [nrcs]/[mesowest] values describe which NRCS SNOTEL site's data
+you're after.  See the next section in this README for instructions on
+obtaining these values.

 
 

-The [ftp] values describe your credentials for the InfoEx automated
-weather station FTP server.
+The [infoex] values describe your credentials for the InfoEx automated
+weather station FTP server and other InfoEx-related configuration
+options.

 
 

-`[wxsite]`  
+`[nrcs]`  

 `station_triplet = [The NRCS identifier for a particular SNOTEL site]`  
 `desired_data = [A comma-delimited list of NRCS elements you're interested in]`  
 `station_triplet = [The NRCS identifier for a particular SNOTEL site]`  
 `desired_data = [A comma-delimited list of NRCS elements you're interested in]`  

-`location_uuid = [The UUID used by InfoEx to identify your automated Wx site]`  
-`csv_filename = [Arbitrary name of the file that will be uploaded to InfoEx]`  

 
 

-`[ftp]`  
+`[infoex]`  

 `host = [InfoEx FTP host address]`  
 `uuid = [InfoEx-supplied UUID]`  
 `api_key = [InfoEx-supplied API Key]`  
 `host = [InfoEx FTP host address]`  
 `uuid = [InfoEx-supplied UUID]`  
 `api_key = [InfoEx-supplied API Key]`  

+`csv_filename = [Arbitrary name of the file that will be uploaded to InfoEx]`  
+`location_uuid = [The UUID used by InfoEx to identify your automated Wx site]`  

 
 

-Finding Your WXSITE values
---------------------------
+Finding Your NRCS values
+------------------------

 
 

-To complete the [wxsite] configuration section, you must fill in the
+To complete the [nrcs] configuration section, you must fill in the

 attributes of the NRCS SNOTEL site from which you want to import data.
 attributes of the NRCS SNOTEL site from which you want to import data.

+

 Here are the steps to do that:
 
 1. Find your station by clicking through this website:
 Here are the steps to do that:
 
 1. Find your station by clicking through this website:


@@ -126,9 +128,34 @@ indicates that I'd like to import "AIR TEMPERATURE OBSERVED" and
 "PRECIPITATION ACCUMULATION" from the NRCS SNOTEL site at Mud Ridge, OR,
 into InfoEx.
 
 "PRECIPITATION ACCUMULATION" from the NRCS SNOTEL site at Mud Ridge, OR,
 into InfoEx.
 

+Finding your MesoWest values
+----------------------------
+
+To complete the [mesowest] configuration section, you must fill in the
+attributes of the MesoWest station ID from which you want to import
+data.
+
+Here are the steps to do that:
+
+Field names are listed here:
+https://developers.synopticdata.com/about/station-variables/
+
+The MesoWest API supports on-the-fly unit conversion, so that can be
+specified to infoex-autowx via the configuration option `units`. This
+can be either 'english' or 'metric', with 'english' meaning imperial
+units as used in the United States.
+

 Version History
 ---------------
 
 Version History
 ---------------
 

+- 2.0.0 (Jul 2020)
+
+  Implement MesoWest integration.
+
+  This release also makes significant changes to the configuration file,
+  hence the major version bump. Such changes are not taken lightly but
+  given the desire to support multiple data sources, were necessary.
+

 - 1.0.0 (Jun 2020)
 
   First released version. Cleaned up the program and design.
 - 1.0.0 (Jun 2020)
 
   First released version. Cleaned up the program and design.