update YAML appendix with aircraft options

Author: rschwant

docs/appendix/yaml.rst

@@ -364,7 +364,7 @@ where domain_type is equal to domain_name.
 (e.g., ['R1','R2','R3','R4','R5','R6','R7','R8','R9','R10']
 
 **urban_rural_name:** list of only one string input, which is variable used to
-determine wheter urban or rural site. (e.g., ['msa_name'])
+determine whether urban or rural site. (e.g., ['msa_name'])
 
 **urban_rural_differentiate_value:** string of value used to determine whether 
 variable is rural or urban. (e.g., '').
@@ -381,7 +381,57 @@ for csi plot, list of model names (only) user choose to set as labels.
 
 **score_name:** csi plot only. list of scores user can choose to plot. examples are "Critical Success Index' 'False Alarm Rate' 'Hit Rate'.
 
-**threshold_tick_style:** csi plot only. (optional) control for spacing of threshold (x-axis) ticks. example: use ``nonlinear`` when nonlinear xticks including all thresholds are desired. Any other selection (default = None) will choose xticks that are equally spaced between min(threshold_list):max(threshold_list) and likely won't include all thresholds. 
+**threshold_tick_style:** csi plot only. (optional) control for spacing of threshold (x-axis) ticks. example: use ``nonlinear`` when nonlinear xticks including all thresholds are desired. Any other selection (default = None) will choose xticks that are equally spaced between min(threshold_list):max(threshold_list) and likely won't include all thresholds.
+
+**altitude_variable:** For "vert_profile" plot only. Name of altitude variable in observational 
+dataset (e.g., altitude)
+
+**vertprofile_bins:** For "vert_profile" plot only. List of vertical bins, on which to analyze the data.
+Units should be identical to the units of the altitude_variable specified above (e.g., 
+[0, 500, 1000, 1500, 2000, 2500, 3000, 3500, 4000] if altitude is in meters)
+
+**color_map:** For 'scatter_density' plot only. Specify a default colormap in Matplotlib (e.g., 'RdBu_r'). 
+To use a custom colormap, leave color_map blank and provide the following options:
+
+   * **colors:** Specify a list of colors (e.g., ['royalblue', 'cyan', 'yellow', 'orange']).
+   * **over:** Specify the color for data greater than the color bar (e.g., 'red')
+   * **under:** Specify the color for data less than the color bar (e.g., 'blue')
+
+**fill:** For 'scatter_density' plot only. Set to True if you want to to create a KDE plot
+(i.e., fill the area under the density curve) and set to False to create a scatter plot.
+
+**shade_lowest:** For 'scatter_density' plot and if fill is set to True above (i.e., for KDE 
+plots only.) Set to True if you want to shade the lowest contour.
+
+**vcenter:** For 'scatter_density' plot only. Optionally, provide the central value for TwoSlopeNorm.
+
+**color_map_custom:** For 'curtain' plot only. Set to True, to use a custom Matplotlib colormap and 
+specify “colors” and "color_levels". To use a standard Matplotlib colormap, set to False and specify 
+a “color_map”.
+
+**colors:** For 'curtain' plot only. Used only if "color_map_custom" is set to True. Provide
+a list of colors (e.g., ["#ff8cff", "#dd6ff2", "#bb52e5", "#9935d8", "#7718cb", "#0000bb", "#002ccc", 
+"#0058dd", "#0084ee", "#00afff", "#00ebff", "#27ffd7", "#63ff9b", "#a3ff5b", "#d3ff2b", "#ffff00", 
+"#ffcf00", "#ff9f00", "#ff6f00", "#ff3f00", "#ff0000", "#d8000f", "#b2001f", "#8c002f", "#66003f",
+"#343434", "#606060", "#8c8c8c", "#b8b8b8", "#e4e4e4"]).
+
+**color_levels:** For 'curtain' plot only. Used only if "color_map_custom" is set to True. 
+Define the number of distinct colors in the color bar (e.g., 30).
+
+**color_map:** For 'curtain' plot only. Used only if "color_map_custom" is set to False 
+(e.g., 'Spectral_r').
+
+**vmin:** For 'curtain' plot only. Set y-axis minimum limit (e.g., 50).
+
+**vmax:** For 'curtain' plot only. Set y-axis maximum limit (e.g., 1200).
+
+**num_levels:** For 'curtain' plot only. Set the number of vertical levels for interpolation
+(e.g., 100).
+ 
+**interval:** For 'curtain' plot only. Set the y-axis tick interval (e.g., 100).
+
+**pressure_units:** For 'curtain' plot only. Units to use only for the y-axis label. 
+No conversions occur. Current options are only 'hPa' and 'Pa'.
 
 **data:** This a list of model / observation pairs to be plotted where the 
 observation label is first and the model label is second 
@@ -428,7 +478,26 @@ observation label is first and the model label is second
    * **ts_avg_window:** This is for timeseries plots only. This is the averaging 
      window applied to the data. No averaging done if not provided in the yaml file (i.e., ts_avg_window is optional). Averaging is done if a pandas 
      resample rule (e.g., 'H' is hourly, 'D' is daily) is specified.
-   
+   * **altitude_yax2:** This is for "timeseries" plots for aircraft evaluation only. 
+     This allows users to add a secondary right y-axis to the timeseries plot. Additional YAML options 
+     are described below:
+     
+      * **altitude_variable:** Name of altitude variable in observational 
+        dataset (e.g., altitude)
+      * **altitude_ticks:** Option to set tick increments (e.g., 1000)
+      * **ylabel2:** Option to set secondary right y-axis label (e.g., Altitude (m))
+      * **plot_kwargs_y2:** Optional kwargs for secondary right y-axis (e.g., color: g)
+      * **filter_dict:** Optionally provide the following options to specify the min and max 
+        values of altitude for the secondary right y-axis
+	
+         * **altitude:**
+	   
+            * **oper:** Set to "between".
+            * **value:** Set to a list of the vim and vmax (e., [2000,8000]).
+   * **interquartile_style:** For "vert_profile" plot only. Specify 'shading' to 
+     plot shaded curves of the 25th and 75th percentile range of each vertical bin or 
+     'box' to plot box-plots of each vertical bin.
+
 Stats
 -----
 All input needed to calculate the statistics. The supported statistics available