Merge propplot

Author: Jacobluke-

dabest/_api.py

@@ -46,7 +46,12 @@ def load(data, idx=None, x=None, y=None, paired=None, id_col=None,
         bootstrap resampling, ensuring that the confidence intervals
         reported are replicable.
     proportional : boolean, default False. 
-        TO INCLUDE MORE DESCRIPTION ABOUT DATA FORMAT
+        An indicator of whether the data is binary or not. When set to True, it
+        specifies that the data consists of binary data, where the values are
+        limited to 0 and 1. The code is not suitable for analyzing proportion
+        data that contains non-numeric values, such as strings like ‘yes’ and ‘no’.
+        When False or not provided, the algorithm assumes that
+        the data is continuous and uses a non-proportional representation.
     delta2 : boolean, default False
         Indicator of delta-delta experiment
     experiment : String, default None

dabest/_classes.py

@@ -2708,8 +2708,6 @@ def __pre_calc(self):
                 reprs.append(text_repr)
 
 
-        reprs.insert(0, print_greeting())
-
         self.__for_print = "\n\n".join(reprs)
 
         out_             = pd.DataFrame(out)
@@ -2785,6 +2783,7 @@ def __pre_calc(self):
         "use `{}.{}.statistical_tests`".format(varname, self.__effect_size)
         reprs.append(lastline)
 
+        reprs.insert(0, print_greeting())
 
         self.__for_print = "\n\n".join(reprs)
 

docs/source/_images/prop_5.png

@@ -297,7 +297,7 @@ This will plot the bootstrap effect sizes below the raw data.
 
 .. image:: _images/prop_3.png
 
-You can also modify the width of bars as you expect by setting ``bar_width`` in the ``plot()`` method. The color of error bar can be modified by setting 'err_color'.
+You can also modify the width of bars as you expect by setting ``bar_width`` in the ``plot()`` method. 
 
 .. code-block:: python3
   :linenos:
@@ -307,6 +307,38 @@ You can also modify the width of bars as you expect by setting ``bar_width`` in
 
 .. image:: _images/prop_4.png
 
+
+The ``bar_desat`` is used to control the amount of desaturation applied to the bar colors. A value of 0.0 means full desaturation (i.e., grayscale), 
+while a value of 1.0 means no desaturation (i.e., full color saturation). Default is 0.8.
+
+.. code-block:: python3
+  :linenos:
+
+
+    two_groups_unpaired.mean_diff.plot(bar_desat=1.0);
+
+.. image:: _images/prop_5.png
+
+``bar_label`` and ``contrast_label`` can be used to set labels for the y-axis of the bar plot and the contrast plot.
+
+.. code-block:: python3
+  :linenos:
+
+
+    two_groups_unpaired.mean_diff.plot(bar_label="success",contrast_label="difference");
+
+.. image:: _images/prop_6.png
+
+The color of error bar can be modified by setting 'err_color'.
+
+.. code-block:: python3
+  :linenos:
+
+
+    two_groups_unpaired.mean_diff.plot(err_color="purple");
+
+.. image:: _images/prop_7.png
+
 Producing Paired Proportion Plots
 ---------------------------------
 For paired version of proportional plot, we adapt the style of Sankey Diagram. The width of each bar in each xticks represent