Merge pull request #29 from trevismd/dev

plot and annotate, use in FacetGrid

CHANGELOG.md

@@ -1,4 +1,9 @@
 ## v0.4
+### v0.4.2
+ - Support of `FacetGrid` with
+   - Support empty initialization only defining pairs
+   - `plot_and_annotate_facets`
+
 ### v0.4.1
  - Support for horizontal orientation
 

README.md

@@ -32,6 +32,7 @@ corresponding branch).
     - **Swarm plots**
     - **Strip plots**
     - **Violin plots** 
+    - Supporting `FacetGrid`
 - Integrated statistical tests (binding to `scipy.stats` methods):
     - Mann-Whitney
     - t-test (independent and paired)
@@ -101,20 +102,21 @@ annotator.apply_and_annotate()
 
 ## Examples
 
-![Example 1](https://raw.githubusercontent.com/trevismd/statannotations/master/usage/example_non-hue_outside.png)
-
 ![Example 2](https://raw.githubusercontent.com/trevismd/statannotations/master/usage/example_hue_layout.png)
 
 ![Example 3](https://raw.githubusercontent.com/trevismd/statannotations/master/usage/flu_dataset_log_scale_in_axes.svg)
 
 ![Example 4](https://raw.githubusercontent.com/trevismd/statannotations/master/usage/HorizontalBarplotOutside.png)
 
+![Example 5](https://raw.githubusercontent.com/trevismd/statannotations/master/usage/example_2facets.png)
+
 ## Documentation
 
 - Usage examples in a jupyter notebook [usage/example.ipynb](https://github.com/trevismd/statannotations/master/usage/example.ipynb),
-- A step-by-step introductory tutorial in a separate [repository](https://github.com/trevismd/statannotations-tutorials) 
-  — [First part here](https://github.com/trevismd/statannotations-tutorials/blob/main/Tutorial_1/Statannotations-Tutorial-1.ipynb)
-- *in-progress* sphinx documentation in `/docs`, available on https://statannotations.readthedocs.io/en/latest/index.html
+- A multipart step-by-step tutorial in a separate [repository](https://github.com/trevismd/statannotations-tutorials) 
+  — [First part here](https://github.com/trevismd/statannotations-tutorials/blob/main/Tutorial_1/Statannotations-Tutorial-1.ipynb),
+  also as a blog post on [Medium](https://levelup.gitconnected.com/statistics-on-seaborn-plots-with-statannotations-2bfce0394c00). 
+- *In-progress* sphinx documentation in `/docs`, available on https://statannotations.readthedocs.io/en/latest/index.html
 
 ## Requirements
 

docs/build/html/genindex.html

@@ -160,9 +160,11 @@ <h1 id="index">Index</h1>
  <a href="#A"><strong>A</strong></a>
  | <a href="#C"><strong>C</strong></a>
  | <a href="#D"><strong>D</strong></a>
+ | <a href="#E"><strong>E</strong></a>
  | <a href="#F"><strong>F</strong></a>
  | <a href="#G"><strong>G</strong></a>
  | <a href="#H"><strong>H</strong></a>
+ | <a href="#I"><strong>I</strong></a>
  | <a href="#L"><strong>L</strong></a>
  | <a href="#M"><strong>M</strong></a>
  | <a href="#N"><strong>N</strong></a>
@@ -253,6 +255,14 @@ <h2 id="D">D</h2>
   </ul></td>
 </tr></table>
 
+<h2 id="E">E</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="statannotations.html#statannotations.utils.empty_dict_if_none">empty_dict_if_none() (in module statannotations.utils)</a>
+</li>
+  </ul></td>
+</tr></table>
+
 <h2 id="F">F</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
@@ -292,9 +302,11 @@ <h2 id="G">G</h2>
         <li><a href="statannotations.html#statannotations.PValueFormat.PValueFormat.get_configuration">(statannotations.PValueFormat.PValueFormat method)</a>
 </li>
       </ul></li>
+      <li><a href="statannotations.stats.html#statannotations.stats.ComparisonsCorrection.get_correction_parameters">get_correction_parameters() (in module statannotations.stats.ComparisonsCorrection)</a>
+</li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="statannotations.stats.html#statannotations.stats.ComparisonsCorrection.get_correction_parameters">get_correction_parameters() (in module statannotations.stats.ComparisonsCorrection)</a>
+      <li><a href="statannotations.html#statannotations.Annotator.Annotator.get_empty_annotator">get_empty_annotator() (statannotations.Annotator.Annotator static method)</a>
 </li>
       <li><a href="statannotations.stats.html#statannotations.stats.utils.get_num_comparisons">get_num_comparisons() (in module statannotations.stats.utils)</a>
 </li>
@@ -315,6 +327,14 @@ <h2 id="H">H</h2>
   </ul></td>
 </tr></table>
 
+<h2 id="I">I</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="statannotations.html#statannotations.utils.InvalidParametersError">InvalidParametersError</a>
+</li>
+  </ul></td>
+</tr></table>
+
 <h2 id="L">L</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
@@ -377,16 +397,20 @@ <h2 id="O">O</h2>
 <h2 id="P">P</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="statannotations.html#statannotations.Annotator.Annotator.plot_and_annotate">plot_and_annotate() (statannotations.Annotator.Annotator static method)</a>
+</li>
+      <li><a href="statannotations.html#statannotations.Annotator.Annotator.plot_and_annotate_facets">plot_and_annotate_facets() (statannotations.Annotator.Annotator method)</a>
+</li>
       <li><a href="statannotations.html#statannotations.Annotation.Annotation.print_labels_and_content">print_labels_and_content() (statannotations.Annotation.Annotation method)</a>
 </li>
       <li><a href="statannotations.html#statannotations.PValueFormat.PValueFormat.print_legend_if_used">print_legend_if_used() (statannotations.PValueFormat.PValueFormat method)</a>
 </li>
       <li><a href="statannotations.html#statannotations.Annotator.Annotator.print_pvalue_legend">print_pvalue_legend() (statannotations.Annotator.Annotator method)</a>
-</li>
-      <li><a href="statannotations.html#statannotations.format_annotations.pval_annotation_text">pval_annotation_text() (in module statannotations.format_annotations)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="statannotations.html#statannotations.format_annotations.pval_annotation_text">pval_annotation_text() (in module statannotations.format_annotations)</a>
+</li>
       <li><a href="statannotations.html#statannotations.Annotator.Annotator.pvalue_format">pvalue_format (statannotations.Annotator.Annotator property)</a>
 </li>
       <li><a href="statannotations.html#statannotations.PValueFormat.PValueFormat.pvalue_format_string">pvalue_format_string (statannotations.PValueFormat.PValueFormat property)</a>