Update develop-ref after #2422 (#2424)

Co-authored-by: Howard Soh <[email protected]> Co-authored-by: Dave Albo <[email protected]> Co-authored-by: John Halley Gotway <[email protected]> Co-authored-by: Seth Linden <[email protected]> Co-authored-by: johnhg <[email protected]> Co-authored-by: Lisa Goodrich <[email protected]> Co-authored-by: jprestop <[email protected]> Co-authored-by: MET Tools Test Account <[email protected]> Co-authored-by: j-opatz <[email protected]> Co-authored-by: George McCabe <[email protected]> Co-authored-by: Julie Prestopnik <[email protected]> Co-authored-by: Jonathan Vigh <[email protected]> Co-authored-by: hsoh-u <[email protected]> Co-authored-by: bikegeek <[email protected]> Co-authored-by: davidalbo <[email protected]> Co-authored-by: Julie Prestopnik <[email protected]> Co-authored-by: Seth Linden <[email protected]> Co-authored-by: lisagoodrich <[email protected]> Co-authored-by: Daniel Adriaansen <[email protected]>
dtcenter · Jan 26, 2023 · 4c6206f · 4c6206f
1 parent c0f28f7
commit 4c6206f
Show file tree

Hide file tree

Showing 199 changed files with 1,284 additions and 1,012 deletions.
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -1,7 +1,7 @@
 ---
 name: Bug report
 about: Fix something that's not working
-title: ''
+title: 'Bugfix: '
 labels: 'alert: NEED ACCOUNT KEY, alert: NEED MORE DEFINITION, alert: NEED PROJECT ASSIGNMENT, type: bug'
 assignees: ''
 

diff --git a/.github/workflows/testing.yml b/.github/workflows/testing.yml
@@ -1,27 +1,27 @@
 name: Testing
 
-# Compile MET and run unit tests
-# for pull requests into develop branch
+# Compile MET for feature branches
+# Run unit tests for pull requests
 
 on:
 
-  pull_request:
-    types: [opened, reopened, synchronize]
+  push:
     branches:
       - develop
-      - 'main_v*'
+      - develop-ref
+      - 'feature_**'
+      - 'main_v**'
+      - 'bugfix_**'
     paths-ignore:
-      - 'met/docs/**'
+      - 'docs/**'
 
-  push:
+  pull_request:
+    types: [opened, reopened, synchronize]
     branches:
-      - 'feature_*'
-      - 'bugfix_*'
-      - 'develop'
-      - 'develop-ref'
-      - 'main_v*'
+      - develop
+      - 'main_v**'
     paths-ignore:
-      - 'met/docs/**'
+      - 'docs/**'
 
   workflow_dispatch:
     inputs:
@@ -104,7 +104,7 @@ jobs:
     needs: [job_control]
     if: ${{ needs.job_control.outputs.run_unit_tests == 'true' }}
     steps:
-      - uses: dtcenter/metplus-action-data-update@v1
+      - uses: dtcenter/metplus-action-data-update@v2
         with:
           docker_name: ${{ secrets.DOCKER_USERNAME }}
           docker_pass: ${{ secrets.DOCKER_PASSWORD }}

diff --git a/Makefile.in b/Makefile.in
@@ -274,6 +274,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/configure b/configure
@@ -746,6 +746,7 @@ MET_GSLINC
 MET_GSL
 MET_PYTHON_LD
 MET_PYTHON_CC
+MET_PYTHON_BIN_EXE
 GRIB2CLIB_NAME
 MET_GRIB2CLIB
 MET_GRIB2CINC
@@ -897,6 +898,7 @@ MET_GRIB2C
 MET_GRIB2CINC
 MET_GRIB2CLIB
 GRIB2CLIB_NAME
+MET_PYTHON_BIN_EXE
 MET_PYTHON_CC
 MET_PYTHON_LD
 MET_GSL
@@ -1647,13 +1649,16 @@ Some influential environment variables:
               Name of grib2c library to link with. For example,
               -lgrib2c_v1.6.0 or -lgrib2c, etc. If it is -lgrib2c, you don't
               have to specify it.
+  MET_PYTHON_BIN_EXE
+              Full path to the python executable corresponding to
+              MET_PYTHON_CC and MET_PYTHON_LD, e.g. /usr/bin/python3.
   MET_PYTHON_CC
               Where the python header files are located, e.g. -I<include dir>.
-              Set to the output of 'python-config --cflags'.
+              Set to the output of 'python3-config --cflags'.
   MET_PYTHON_LD
               Where the python library files are located, e.g. -L<lib dir>,
               followed by the python library names, e.g. -l<library>. Set to
-              the output of 'python-config --ldflags'.
+              the output of 'python3-config --ldflags'.
   MET_GSL     Where gsl lib and include subdirectories are located. If they
               are installed in /usr/local, you don't have to specify them.
   MET_GSLINC  Where gsl include files are located. Use if the libraries and
@@ -4648,14 +4653,35 @@ if test -n "$MET_GRIB2CLIB"; then
 fi
 
 #
-# Look for the PYTHON library
+# Look for the PYTHON executable and library
 #
 
 # Configure the variables.  The help text will appear if the user uses "configure --help".
 
 
 
 
+
+# Ensure that all or none are specified.
+
+if (test -n "$MET_PYTHON_BIN_EXE" || \
+    test -n "$MET_PYTHON_CC" || \
+    test -n "$MET_PYTHON_LD"); then
+  if test -z "$MET_PYTHON_BIN_EXE"; then
+    as_fn_error $? "MET_PYTHON_CC or MET_PYTHON_LD environment variable set, but MET_PYTHON_BIN_EXE not set.  If one of these variables is set, then all must be set." "$LINENO" 5
+  elif test -z "$MET_PYTHON_CC"; then
+    as_fn_error $? "MET_PYTHON_BIN_EXE or MET_PYTHON_LD environment variable set, but MET_PYTHON_CC not set.  If one of these variables is set, then all must be set." "$LINENO" 5
+  elif test -z "$MET_PYTHON_LD"; then
+    as_fn_error $? "MET_PYTHON_BIN_EXE or MET_PYTHON_CC environment variable set, but MET_PYTHON_LD not set.  If one of these variables is set, then all must be set." "$LINENO" 5
+  fi
+fi
+
+# Add MET_PYTHON_BIN_EXE to the CPPFLAGS
+
+if test -n "$MET_PYTHON_BIN_EXE"; then
+   CPPFLAGS=$CPPFLAGS' -DMET_PYTHON_BIN_EXE="\"${MET_PYTHON_BIN_EXE}\""'
+fi
+
 if test -n "$MET_PYTHON_CC"; then
    CPPFLAGS="${CPPFLAGS} -I../../basic/vx_log -I../../basic/vx_util ${MET_PYTHON_CC}"
 fi

diff --git a/configure.ac b/configure.ac
@@ -155,13 +155,34 @@ if test -n "$MET_GRIB2CLIB"; then
 fi
 
 #
-# Look for the PYTHON library
+# Look for the PYTHON executable and library
 #
 
 # Configure the variables.  The help text will appear if the user uses "configure --help".
 
-AC_ARG_VAR([MET_PYTHON_CC], [Where the python header files are located, e.g. -I<include dir>. Set to the output of 'python-config --cflags'.])
-AC_ARG_VAR([MET_PYTHON_LD], [Where the python library files are located, e.g. -L<lib dir>, followed by the python library names, e.g. -l<library>. Set to the output of 'python-config --ldflags'.])
+AC_ARG_VAR([MET_PYTHON_BIN_EXE], [Full path to the python executable corresponding to MET_PYTHON_CC and MET_PYTHON_LD, e.g. /usr/bin/python3.])
+AC_ARG_VAR([MET_PYTHON_CC], [Where the python header files are located, e.g. -I<include dir>. Set to the output of 'python3-config --cflags'.])
+AC_ARG_VAR([MET_PYTHON_LD], [Where the python library files are located, e.g. -L<lib dir>, followed by the python library names, e.g. -l<library>. Set to the output of 'python3-config --ldflags'.])
+
+# Ensure that all or none are specified.
+
+if (test -n "$MET_PYTHON_BIN_EXE" || \
+    test -n "$MET_PYTHON_CC" || \
+    test -n "$MET_PYTHON_LD"); then
+  if test -z "$MET_PYTHON_BIN_EXE"; then
+    AC_MSG_ERROR([MET_PYTHON_CC or MET_PYTHON_LD environment variable set, but MET_PYTHON_BIN_EXE not set.  If one of these variables is set, then all must be set.])
+  elif test -z "$MET_PYTHON_CC"; then
+    AC_MSG_ERROR([MET_PYTHON_BIN_EXE or MET_PYTHON_LD environment variable set, but MET_PYTHON_CC not set.  If one of these variables is set, then all must be set.])
+  elif test -z "$MET_PYTHON_LD"; then
+    AC_MSG_ERROR([MET_PYTHON_BIN_EXE or MET_PYTHON_CC environment variable set, but MET_PYTHON_LD not set.  If one of these variables is set, then all must be set.])
+  fi
+fi
+
+# Add MET_PYTHON_BIN_EXE to the CPPFLAGS
+
+if test -n "$MET_PYTHON_BIN_EXE"; then
+   CPPFLAGS=$CPPFLAGS' -DMET_PYTHON_BIN_EXE="\"${MET_PYTHON_BIN_EXE}\""'
+fi
 
 if test -n "$MET_PYTHON_CC"; then
    CPPFLAGS="${CPPFLAGS} -I../../basic/vx_log -I../../basic/vx_util ${MET_PYTHON_CC}"

diff --git a/data/Makefile.in b/data/Makefile.in
@@ -279,6 +279,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/climo/Makefile.in b/data/climo/Makefile.in
@@ -249,6 +249,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/climo/seeps/Makefile.in b/data/climo/seeps/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/colortables/Makefile.in b/data/colortables/Makefile.in
@@ -279,6 +279,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/colortables/NCL_colortables/Makefile.in b/data/colortables/NCL_colortables/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/config/Makefile.in b/data/config/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/map/Makefile.in b/data/map/Makefile.in
@@ -279,6 +279,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/map/admin_by_country/Makefile.in b/data/map/admin_by_country/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/poly/HMT_masks/Makefile.in b/data/poly/HMT_masks/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/poly/Makefile.in b/data/poly/Makefile.in
@@ -279,6 +279,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/poly/NCEP_masks/Makefile.in b/data/poly/NCEP_masks/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/ps/Makefile.in b/data/ps/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/table_files/Makefile.in b/data/table_files/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/tc_data/Makefile.in b/data/tc_data/Makefile.in
@@ -219,6 +219,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/wrappers/Makefile.in b/data/wrappers/Makefile.in
@@ -279,6 +279,7 @@ MET_HDFLIB = @MET_HDFLIB@
 MET_NETCDF = @MET_NETCDF@
 MET_NETCDFINC = @MET_NETCDFINC@
 MET_NETCDFLIB = @MET_NETCDFLIB@
+MET_PYTHON_BIN_EXE = @MET_PYTHON_BIN_EXE@
 MET_PYTHON_CC = @MET_PYTHON_CC@
 MET_PYTHON_LD = @MET_PYTHON_LD@
 MKDIR_P = @MKDIR_P@

diff --git a/data/wrappers/set_python_env.py b/data/wrappers/set_python_env.py
@@ -7,3 +7,4 @@
 import os
 import sys
 import numpy as np
+print(f'Python executable: {sys.executable}')
diff --git a/data/wrappers/write_tmp_dataplane.py b/data/wrappers/write_tmp_dataplane.py
@@ -21,6 +21,10 @@
 pyembed_module_name = sys.argv[2]
 sys.argv = sys.argv[2:]
 
+# add share/met/python directory to system path to find met_point_obs
+sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__),
+                                             os.pardir, 'python')))
+
 # append user script dir to system path
 pyembed_dir, pyembed_file = os.path.split(pyembed_module_name)
 if pyembed_dir:

diff --git a/data/wrappers/write_tmp_mpr.py b/data/wrappers/write_tmp_mpr.py
@@ -20,6 +20,10 @@
 pyembed_module_name = sys.argv[2]
 sys.argv = sys.argv[2:]
 
+# add share/met/python directory to system path to find met_point_obs
+sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__),
+                                             os.pardir, 'python')))
+
 # append user script dir to system path
 pyembed_dir, pyembed_file = os.path.split(pyembed_module_name)
 if pyembed_dir:

diff --git a/data/wrappers/write_tmp_point.py b/data/wrappers/write_tmp_point.py
@@ -20,6 +20,10 @@
 pyembed_module_name = sys.argv[2]
 sys.argv = sys.argv[2:]
 
+# add share/met/python directory to system path to find met_point_obs
+sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__),
+                                             os.pardir, 'python')))
+
 # append user script dir to system path
 pyembed_dir, pyembed_file = os.path.split(pyembed_module_name)
 if pyembed_dir:

diff --git a/docs/Flowchart/MET_flowchart.pptx b/docs/Flowchart/MET_flowchart.pptx
diff --git a/docs/Flowchart/MET_flowchart_v11.0.0.png b/docs/Flowchart/MET_flowchart_v11.0.0.png
diff --git a/docs/Users_Guide/appendixF.rst b/docs/Users_Guide/appendixF.rst
@@ -16,7 +16,9 @@ In order to use Python embedding, the user's local Python installation must have
 
 The local Python installation must also support a minimum set of required packages. The MET build includes some python wrapper scripts to facilitate the passing of data in memory as well as the reading and writing of temporary files. The packages required by those wrapper scripts are **sys, os, argparse, importlib, numpy and netCDF4**. While most of these are standard packages and readily available, numpy and netCDF4 may not be. Users are advised to confirm their availability prior to compiling MET with python embedding support.
 
-In addition to the **configure** option mentioned above, two variables, **MET_PYTHON_CC** and **MET_PYTHON_LD**, must also be set for the configuration process. These may either be set as environment variables or as command line options to **configure**. These constants are passed as compiler command line options when building MET to enable the compiler to find the requisite Python header files and libraries in the user's local filesystem. Fortunately, Python provides a way to set these variables properly. This frees the user from the necessity of having any expert knowledge of the compiling and linking process. Along with the **Python** executable, there should be another executable called **python3-config**, whose output can be used to set these environment variables as follows:
+In addition to the **configure** option mentioned above, three variables, **MET_PYTHON_BIN_EXE**, **MET_PYTHON_CC**, and **MET_PYTHON_LD**, must also be set for the configuration process. These may either be set as environment variables or as command line options to **configure**. These constants are passed as compiler command line options when building MET to enable the compiler to find the requisite Python executable, header files, and libraries in the user's local filesystem. Fortunately, Python provides a way to set these variables properly. This frees the user from the necessity of having any expert knowledge of the compiling and linking process. Along with the **Python** executable, there should be another executable called **python3-config**, whose output can be used to set these environment variables as follows:
+
+• Set **MET_PYTHON_BIN_EXE** to the full path of the desired python executable.
 
 • On the command line, run "**python3-config --cflags**". Set the value of **MET_PYTHON_CC** to the output of that command.
 

diff --git a/docs/Users_Guide/config_options.rst b/docs/Users_Guide/config_options.rst
@@ -1318,8 +1318,9 @@ of several entires defining the climatology file names and fields to be used.
 
 * The "hour_interval" entry is an integer specifying the spacing in hours of
   the climatology data for each day. This should be set between 0 and 24,
-  with 6 and 12 being common choices. Use "NA" if the timing of the
-  climatology data should not be checked.
+  with 6 and 12 being common choices. For example, use 6 for climatology data
+  with 4 times per day, such as 00Z, 06Z, 12Z, and 18Z. Use "NA" if the timing
+  of the climatology data should not be checked.
 
 * The "day_interval" and "hour_interval" entries replace the deprecated
   entries "match_month", "match_day", and "time_step".

diff --git a/docs/Users_Guide/figure/overview-figure.png b/docs/Users_Guide/figure/overview-figure.png
diff --git a/docs/Users_Guide/installation.rst b/docs/Users_Guide/installation.rst
@@ -201,10 +201,11 @@ The following environment variables should also be set:
 
 * If compiling support for GRIB2, set $MET_GRIB2CINC and $MET_GRIB2CLIB to point to the main GRIB2C directory which contains both the include and library files. These are used instead of $MET_GRIB2C since the main GRIB2C directory does not contain include and lib subdirectories.
 
-* If compiling support for PYTHON, set $MET_PYTHON_CC and $MET_PYTHON_LD to specify the compiler (-I) and linker (-L) flags required for python. Set $MET_PYTHON_CC for the directory containing the "Python.h" header file. Set $MET_PYTHON_LD for the directory containing the python library file and indicate the name of that file. For example:
+* If compiling support for PYTHON, set $MET_PYTHON_BIN_EXE to specify the desired python executable to be used. Also set $MET_PYTHON_CC, and $MET_PYTHON_LD to specify the compiler (-I) and linker (-L) flags required for python. Set $MET_PYTHON_CC for the directory containing the "Python.h" header file. Set $MET_PYTHON_LD for the directory containing the python library file and indicate the name of that file. For example:
 
   .. code-block:: none
 
+    MET_PYTHON_BIN_EXE='/usr/bin/python3.6'
     MET_PYTHON_CC='-I/usr/include/python3.6'
     MET_PYTHON_LD='-L/usr/lib/python3.6/config-x86_64-linux-gnu -lpython3.6m'