Merge branch 'develop' into develop

docs/appendix/machine-specific-install.rst

@@ -60,7 +60,7 @@ environment for running and developing MELODIES MONET.
    * You will need a NOAA HPC account to access the RDHPCS wiki link above.
 
    * Both Anaconda/Miniconda will work well for MELODIES MONET. See
-     `conda instructions <https://docs.conda.io/projects/conda/en/latest/user-guide/install/download.html#anaconda-or-miniconda>`__
+     `conda instructions <https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html#installing-conda>`__
      to determine, which is the best option for you.
 
    * Pick a directory for your download and run the following wget command with 

docs/appendix/yaml.rst

@@ -284,7 +284,7 @@ For each plotting group, update the label and include the following information.
 Note: the labels need to be unique, but otherwise are not used.
 
 **type:** The plot type. Options are: "timeseries", "taylor", "spatial_bias",
-"spatial_overlay", "spatial_bias_exceedance", and "boxplot"
+"spatial_overlay", "spatial_bias_exceedance", "boxplot", "multi-boxplot"
 Note: "spatial_bias_exceedance" plots only work when regulatory = True.
 
 **fig_kwargs:** This is optional to provide a dictionary with figure 
@@ -323,6 +323,14 @@ data will be used and the domain_name is used only in the plot title. If
 domain_type is not equal to all, MELODIES MONET will query all of the data 
 where domain_type is equal to domain_name.
 
+**region_name:** multi-box plot only. user specified variable from which the region information
+will be used to plot. if use 'epa+region' then a total of 61 regions can be choose from.
+
+**region_list:** multi-box plot only. list of regions in the above 'region_name' variable 
+user want to plot.
+
+**model_name_list:** multi-box plot only. list of observation and model names user choose to set as x-labels
+
 **data:** This a list of model / observation pairs to be plotted where the 
 observation label is first and the model label is second 
 (e.g., ['airnow_cmaq_expt', 'airnow_rrfs_13km', 'airnow_wrfchem_v4.2'])

docs/cli.rst

@@ -15,6 +15,8 @@ any Python code::
 * |run|_ -- run a control file
 * |get-airnow|_ -- get AirNow data
 * |get-aeronet|_ -- get AERONET data
+* |get-ish|_ -- get ISH data
+* |get-ish-lite|_ -- get ISH-Lite data
 
 .. |run| replace:: ``run``
 .. _run: #melodies-monet-run
@@ -25,6 +27,11 @@ any Python code::
 .. |get-aeronet| replace:: ``get-aeronet``
 .. _get-aeronet: #melodies-monet-get-aeronet
 
+.. |get-ish| replace:: ``get-ish``
+.. _get-ish: #melodies-monet-get-ish
+
+.. |get-ish-lite| replace:: ``get-ish-lite``
+.. _get-ish-lite: #melodies-monet-get-ish-lite
 
 .. click:: melodies_monet._cli:_typer_click_object
    :prog: melodies-monet

docs/environment-docs.yml

@@ -16,6 +16,7 @@ dependencies:
   #
   # Extras
   - pooch
+  - timezonefinder
   - typer
   - wrf-python  # for WRF-Chem reader in monetio
   #

docs/examples/control_wrfchem_mech-0905_2.yaml

@@ -188,6 +188,22 @@ plots:
       rem_obs_nan: True
       set_axis: False
 
+  plot_grp6:
+    type: "multi_boxplot"
+    fig_kwargs:
+      figsize: [10, 8]
+    text_kwargs:
+      fontsize: 20.
+    domain_type: ["all"]
+    domain_name: ["CONUS"]
+    region_name: ['epa_region']
+    region_list: ['R1','R2','R3','R4','R5','R6','R7','R8','R9','R10'] 
+    model_name_list: ['AirNow','WRF-Chem','WRF-Chem vcp']
+    data: ["airnow_RACM_ESRL", "airnow_RACM_ESRL_VCP"]
+    data_proc:
+      rem_obs_nan: True
+      set_axis: False
+
 stats:
   # Stats require positive numbers, so if you want to calculate temperature use Kelvin!
   # Wind direction has special calculations for AirNow if obs name is 'WD'