From 3e2bb68c4477195f48fc0282a4de2e75b5ddbca8 Mon Sep 17 00:00:00 2001 From: Florian Charlier Date: Sun, 25 Jul 2021 17:25:18 +0200 Subject: [PATCH] Add example to readme Signed-off-by: Florian Charlier --- README.md | 2 ++ usage/HorizontalBarplotOutside.png | Bin 0 -> 31511 bytes 2 files changed, 2 insertions(+) create mode 100644 usage/HorizontalBarplotOutside.png diff --git a/README.md b/README.md index fff5153..36ab668 100644 --- a/README.md +++ b/README.md @@ -111,6 +111,8 @@ annotator.apply_and_annotate() ![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) + ## Requirements + Python >= 3.6 diff --git a/usage/HorizontalBarplotOutside.png b/usage/HorizontalBarplotOutside.png new file mode 100644 index 0000000000000000000000000000000000000000..223a9b8d84ca025a5e40c9ed85f239148e0fe0fc GIT binary patch literal 31511 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