Feature #1060 shapes

[JohnHalleyGotway]

Expected Differences

• Do these changes introduce new tools, command line arguments, or configuration file options? [Yes]
  
  If yes, please describe:
  

This PR enhances the gen_vx_mask tool in two main ways:

1. Adds support for multiple -shapeno values to be specified. When multiple shapes are used, the mask is defined as their union.
2. Adds a new -shape_str command line option allow users to pick which shape(s) to use based on string matching with the corresponding .dbf file.

• Do these changes modify the structure of existing or add new output data types (e.g. statistic line types or NetCDF variables)? [No]
  
  If yes, please describe:
  

Pull Request Testing

• Describe testing already performed for these changes:
  
  Tested primarily using Natural Earth Shapefile data. Tested all sorts of failure conditions to make sure the Debug(3), Debug(4), Warning, and Error messages are useful. Can also see NOAA Shapefiles that include various warning areas.

• Recommend testing for the reviewer(s) to perform, including the location of input datasets, and any additional instructions:
  
  Please find this code compiled on seneca in /d1/projects/MET/MET_pull_requests/met-11.1.0/met-11.1.0-rc1/feature_1060/MET for additional testing. You could test with the same natural earth shapefile data (in /d1/projects/MET/MET_test_data/unit_test/shapefile/ne_110m_admin_0_countries), download/test with different resolution data, or get shapefiles from some other source.

• Do these changes include sufficient documentation updates, ensuring that no errors or warnings exist in the build of the documentation? [Yes]
  Yes, updates to the chapter that includes gen_vx_mask, as well as a few enhancements recommended by @DanielAdriaansen.

• Do these changes include sufficient testing updates? [Yes]
  Added 2 new calls to gen_vx_mask in unit_gen_vx_mask.xml.

• Will this PR result in changes to the test suite? [Yes]
  
  If yes, describe the new output and/or changes to the existing output:
  
  Adds 2 new output files.

1. South_America_mask.nc
   

2. South_America_Spain_Portugal_mask.nc
   

• Please complete this pull request review by [5/9/2023].
  

Pull Request Checklist

See the METplus Workflow for details.

• Review the source issue metadata (required labels, projects, and milestone).
• Complete the PR definition above.
• Ensure the PR title matches the feature or bugfix branch name.
• Define the PR metadata, as permissions allow.
  Select: Reviewer(s)
  Select: Organization level software support Project or Repository level development cycle Project
  Select: Milestone as the version that will include these changes
• After submitting the PR, select Development issue with the original issue number.
• After the PR is approved, merge your changes. If permissions do not allow this, request that the reviewer do the merge.
• Close the linked issue and delete your feature or bugfix branch from GitHub.

[DanielAdriaansen]

@JohnHalleyGotway demonstrated these changes and we discussed some questions I had. I made some final tweaks to the documentation, so please feel free to review @JohnHalleyGotway .

I did not attempt to test the new functionality, but it seems straightforward to me and the required tests and excellent logging messages are included for the user.

I approve.