From d4668e79536fba98ea8804a13a372af1b3ba7b71 Mon Sep 17 00:00:00 2001
From: Hassan Kibirige <has2k1@gmail.com>
Date: Tue, 12 Nov 2024 18:44:12 +0300
Subject: [PATCH] Add plot_title/caption_position themeables

closes #838
---
 doc/_quartodoc.yml                            |   2 +
 doc/changelog.qmd                             |  21 ++++
 plotnine/_mpl/layout_manager/_layout_items.py |  58 +++++++---
 plotnine/_mpl/layout_manager/_spaces.py       | 103 ++++++++++++------
 plotnine/themes/theme.py                      |   2 +
 plotnine/themes/theme_gray.py                 |   2 +
 plotnine/themes/theme_matplotlib.py           |   2 +
 plotnine/themes/theme_seaborn.py              |   2 +
 plotnine/themes/theme_void.py                 |   2 +
 plotnine/themes/themeable.py                  |  26 +++++
 .../plot_titles_and_caption_positioning.png   | Bin 0 -> 27860 bytes
 tests/test_layout.py                          |   7 ++
 12 files changed, 177 insertions(+), 50 deletions(-)
 create mode 100644 tests/baseline_images/test_layout/plot_titles_and_caption_positioning.png

diff --git a/doc/_quartodoc.yml b/doc/_quartodoc.yml
index 0ea9a17f0..3ad6ccadd 100644
--- a/doc/_quartodoc.yml
+++ b/doc/_quartodoc.yml
@@ -458,6 +458,7 @@ quartodoc:
         - panel_spacing_y
         - plot_background
         - plot_caption
+        - plot_caption_position
         - plot_margin
         - plot_margin_bottom
         - plot_margin_left
@@ -465,6 +466,7 @@ quartodoc:
         - plot_margin_top
         - plot_subtitle
         - plot_title
+        - plot_title_position
         - rect
         - strip_align
         - strip_align_x
diff --git a/doc/changelog.qmd b/doc/changelog.qmd
index fbaac6afe..680533a2e 100644
--- a/doc/changelog.qmd
+++ b/doc/changelog.qmd
@@ -1,6 +1,27 @@
 ---
 title: Changelog
 ---
+---
+## v0.15.0
+(not-yet-released)
+
+### New Features
+
+- Using
+  [](:class:`~plotnine.themes.themeables.plot_title_position`) and
+  [](:class:`~plotnine.themes.themeables.plot_caption_position`) e.g.
+
+  ```python
+  theme(
+     plot_title_position="plot",
+     plot_caption_position="plot",
+  )
+  ```
+
+  You can now position the `plot_title`, `plot_subtitle` and `plot_caption`
+  by alignment them with respect to the plot. ({{< issue 838 >}})
+
+
 ## v0.14.1
 (2024-11-05)
 
diff --git a/plotnine/_mpl/layout_manager/_layout_items.py b/plotnine/_mpl/layout_manager/_layout_items.py
index 23ef4a18e..ef8fad88a 100644
--- a/plotnine/_mpl/layout_manager/_layout_items.py
+++ b/plotnine/_mpl/layout_manager/_layout_items.py
@@ -450,31 +450,39 @@ def _adjust_positions(self, spaces: LayoutSpaces):
         Set the x,y position of the artists around the panels
         """
         theme = self.plot.theme
+        plot_title_position = theme.getp("plot_title_position", "panel")
+        plot_caption_position = theme.getp("plot_caption_position", "panel")
 
         if self.plot_title:
             ha = theme.getp(("plot_title", "ha"))
             self.plot_title.set_y(spaces.t.edge("plot_title"))
-            horizontally_align_text_with_panels(self.plot_title, ha, spaces)
+            horizontally_align_text(
+                self.plot_title, ha, spaces, plot_title_position
+            )
 
         if self.plot_subtitle:
             ha = theme.getp(("plot_subtitle", "ha"))
             self.plot_subtitle.set_y(spaces.t.edge("plot_subtitle"))
-            horizontally_align_text_with_panels(self.plot_subtitle, ha, spaces)
+            horizontally_align_text(
+                self.plot_subtitle, ha, spaces, plot_title_position
+            )
 
         if self.plot_caption:
             ha = theme.getp(("plot_caption", "ha"), "right")
             self.plot_caption.set_y(spaces.b.edge("plot_caption"))
-            horizontally_align_text_with_panels(self.plot_caption, ha, spaces)
+            horizontally_align_text(
+                self.plot_caption, ha, spaces, plot_caption_position
+            )
 
         if self.axis_title_x:
             ha = theme.getp(("axis_title_x", "ha"), "center")
             self.axis_title_x.set_y(spaces.b.edge("axis_title_x"))
-            horizontally_align_text_with_panels(self.axis_title_x, ha, spaces)
+            horizontally_align_text(self.axis_title_x, ha, spaces)
 
         if self.axis_title_y:
             va = theme.getp(("axis_title_y", "va"), "center")
             self.axis_title_y.set_x(spaces.l.edge("axis_title_y"))
-            vertically_align_text_with_panels(self.axis_title_y, va, spaces)
+            vertically_align_text(self.axis_title_y, va, spaces)
 
         if self.legends:
             set_legends_position(self.legends, spaces)
@@ -487,13 +495,17 @@ def _text_is_visible(text: Text) -> bool:
     return text.get_visible() and text._text  # type: ignore
 
 
-def horizontally_align_text_with_panels(
-    text: Text, ha: str | float, spaces: LayoutSpaces
+def horizontally_align_text(
+    text: Text,
+    ha: str | float,
+    spaces: LayoutSpaces,
+    how: Literal["panel", "plot"] = "panel",
 ):
     """
     Horizontal justification
 
-    Reinterpret horizontal alignment to be justification about the panels.
+    Reinterpret horizontal alignment to be justification about the panels or
+    the plot (depending on the how parameter)
     """
     if isinstance(ha, str):
         lookup = {
@@ -505,20 +517,30 @@ def horizontally_align_text_with_panels(
     else:
         f = ha
 
-    params = spaces.gsparams
+    if how == "panel":
+        left = spaces.l.left
+        right = spaces.r.right
+    else:
+        left = spaces.l.plot_left
+        right = spaces.r.plot_right
+
     width = spaces.items.calc.width(text)
-    x = params.left * (1 - f) + (params.right - width) * f
+    x = left * (1 - f) + (right - width) * f
     text.set_x(x)
     text.set_horizontalalignment("left")
 
 
-def vertically_align_text_with_panels(
-    text: Text, va: str | float, spaces: LayoutSpaces
+def vertically_align_text(
+    text: Text,
+    va: str | float,
+    spaces: LayoutSpaces,
+    how: Literal["panel", "plot"] = "panel",
 ):
     """
     Vertical justification
 
-    Reinterpret vertical alignment to be justification about the panels.
+    Reinterpret vertical alignment to be justification about the panels or
+    the plot (depending on the how parameter).
     """
     if isinstance(va, str):
         lookup = {
@@ -532,9 +554,15 @@ def vertically_align_text_with_panels(
     else:
         f = va
 
-    params = spaces.gsparams
+    if how == "panel":
+        top = spaces.t.top
+        bottom = spaces.b.bottom
+    else:
+        top = spaces.t.plot_top
+        bottom = spaces.b.plot_bottom
+
     height = spaces.items.calc.height(text)
-    y = params.bottom * (1 - f) + (params.top - height) * f
+    y = bottom * (1 - f) + (top - height) * f
     text.set_y(y)
     text.set_verticalalignment("bottom")
 
diff --git a/plotnine/_mpl/layout_manager/_spaces.py b/plotnine/_mpl/layout_manager/_spaces.py
index bed7a7d65..c9d18e773 100644
--- a/plotnine/_mpl/layout_manager/_spaces.py
+++ b/plotnine/_mpl/layout_manager/_spaces.py
@@ -173,6 +173,20 @@ def edge(self, item: str) -> float:
         """
         return self.sum_upto(item)
 
+    @property
+    def left(self):
+        """
+        Left of the panels in figure space
+        """
+        return self.total
+
+    @property
+    def plot_left(self):
+        """
+        Distance in figure space from left edge upto where artists start
+        """
+        return self.edge("legend")
+
 
 @dataclass
 class right_spaces(_side_spaces):
@@ -219,6 +233,20 @@ def edge(self, item: str) -> float:
         """
         return 1 - self.sum_upto(item)
 
+    @property
+    def right(self):
+        """
+        Right of the panels in figure space
+        """
+        return 1 - self.total
+
+    @property
+    def plot_right(self):
+        """
+        Distance in figure space from right edge upto where artists start
+        """
+        return self.edge("legend")
+
 
 @dataclass
 class top_spaces(_side_spaces):
@@ -284,6 +312,20 @@ def edge(self, item: str) -> float:
         """
         return 1 - self.sum_upto(item)
 
+    @property
+    def top(self):
+        """
+        Top of the panels in figure space
+        """
+        return 1 - self.total
+
+    @property
+    def plot_top(self):
+        """
+        Distance in figure space from top edge upto where artists start
+        """
+        return self.edge("legend")
+
 
 @dataclass
 class bottom_spaces(_side_spaces):
@@ -353,6 +395,20 @@ def edge(self, item: str) -> float:
         """
         return self.sum_upto(item)
 
+    @property
+    def bottom(self):
+        """
+        Bottom of the panels in figure space
+        """
+        return self.total
+
+    @property
+    def plot_bottom(self):
+        """
+        Distance in figure space from bottom edge upto where artists start
+        """
+        return self.edge("legend")
+
 
 @dataclass
 class LayoutSpaces:
@@ -434,34 +490,6 @@ def __post_init__(self):
                 # Increase aspect ratio, wider panels
                 self._reduce_height(ratio)
 
-    @property
-    def left(self):
-        """
-        Left of the panels in figure space
-        """
-        return self.l.total
-
-    @property
-    def right(self):
-        """
-        Right of the panels in figure space
-        """
-        return 1 - self.r.total
-
-    @property
-    def top(self):
-        """
-        Top of the panels in figure space
-        """
-        return 1 - self.t.total
-
-    @property
-    def bottom(self):
-        """
-        Bottom of the panels in figure space
-        """
-        return self.b.total
-
     def increase_horizontal_plot_margin(self, dw: float):
         """
         Increase the plot_margin to the right & left of the panels
@@ -494,7 +522,12 @@ def _calculate_panel_spacing(self) -> GridSpecParams:
             raise TypeError(f"Unknown type of facet: {type(self.plot.facet)}")
 
         return GridSpecParams(
-            self.left, self.right, self.top, self.bottom, wspace, hspace
+            self.l.left,
+            self.r.right,
+            self.t.top,
+            self.b.bottom,
+            wspace,
+            hspace,
         )
 
     def _calculate_panel_spacing_facet_grid(self) -> tuple[float, float]:
@@ -513,8 +546,8 @@ def _calculate_panel_spacing_facet_grid(self) -> tuple[float, float]:
         self.sh = theme.getp("panel_spacing_y") * self.W / self.H
 
         # width and height of axes as fraction of figure width & height
-        self.w = ((self.right - self.left) - self.sw * (ncol - 1)) / ncol
-        self.h = ((self.top - self.bottom) - self.sh * (nrow - 1)) / nrow
+        self.w = ((self.r.right - self.l.left) - self.sw * (ncol - 1)) / ncol
+        self.h = ((self.t.top - self.b.bottom) - self.sh * (nrow - 1)) / nrow
 
         # Spacing as fraction of axes width & height
         wspace = self.sw / self.w
@@ -559,8 +592,8 @@ def _calculate_panel_spacing_facet_wrap(self) -> tuple[float, float]:
             ) + self.items.axis_ticks_y_max_width("all")
 
         # width and height of axes as fraction of figure width & height
-        self.w = ((self.right - self.left) - self.sw * (ncol - 1)) / ncol
-        self.h = ((self.top - self.bottom) - self.sh * (nrow - 1)) / nrow
+        self.w = ((self.r.right - self.l.left) - self.sw * (ncol - 1)) / ncol
+        self.h = ((self.t.top - self.b.bottom) - self.sh * (nrow - 1)) / nrow
 
         # Spacing as fraction of axes width & height
         wspace = self.sw / self.w
@@ -571,8 +604,8 @@ def _calculate_panel_spacing_facet_null(self) -> tuple[float, float]:
         """
         Calculate spacing parts for facet_null
         """
-        self.w = self.right - self.left
-        self.h = self.top - self.bottom
+        self.w = self.r.right - self.l.left
+        self.h = self.t.top - self.b.bottom
         self.sw = 0
         self.sh = 0
         return 0, 0
diff --git a/plotnine/themes/theme.py b/plotnine/themes/theme.py
index 2c8e9c095..39dd40388 100644
--- a/plotnine/themes/theme.py
+++ b/plotnine/themes/theme.py
@@ -122,6 +122,8 @@ def __init__(
         plot_title=None,
         plot_subtitle=None,
         plot_caption=None,
+        plot_title_position=None,
+        plot_caption_position=None,
         strip_text_x=None,
         strip_text_y=None,
         strip_text=None,
diff --git a/plotnine/themes/theme_gray.py b/plotnine/themes/theme_gray.py
index 74cdc9cfa..189d6e073 100644
--- a/plotnine/themes/theme_gray.py
+++ b/plotnine/themes/theme_gray.py
@@ -126,6 +126,8 @@ def __init__(self, base_size=11, base_family=None):
                 ma="left",
                 margin={"b": m, "units": "fig"},
             ),
+            plot_title_position="panel",
+            plot_caption_position="panel",
             strip_align=0,
             strip_background=element_rect(color="none", fill="#D9D9D9"),
             strip_background_x=element_rect(width=1),
diff --git a/plotnine/themes/theme_matplotlib.py b/plotnine/themes/theme_matplotlib.py
index 476c89592..4a56d591f 100644
--- a/plotnine/themes/theme_matplotlib.py
+++ b/plotnine/themes/theme_matplotlib.py
@@ -104,6 +104,8 @@ def __init__(self, rc=None, fname=None, use_defaults=True):
                 ma="left",
                 margin={"b": m, "units": "fig"},
             ),
+            plot_title_position="panel",
+            plot_caption_position="panel",
             strip_align=0,
             strip_background=element_rect(
                 fill="#D9D9D9", color="black", size=linewidth
diff --git a/plotnine/themes/theme_seaborn.py b/plotnine/themes/theme_seaborn.py
index ef2dff00a..c1220096f 100644
--- a/plotnine/themes/theme_seaborn.py
+++ b/plotnine/themes/theme_seaborn.py
@@ -116,6 +116,8 @@ def __init__(
                 ma="left",
                 margin={"b": m, "units": "fig"},
             ),
+            plot_title_position="panel",
+            plot_caption_position="panel",
             strip_align=0,
             strip_background=element_rect(color="none", fill="#D1CDDF"),
             strip_text=element_text(
diff --git a/plotnine/themes/theme_void.py b/plotnine/themes/theme_void.py
index 0c43eb487..28c3a9527 100644
--- a/plotnine/themes/theme_void.py
+++ b/plotnine/themes/theme_void.py
@@ -93,6 +93,8 @@ def __init__(self, base_size=11, base_family=None):
                 ma="left",
                 margin={"b": m, "units": "fig"},
             ),
+            plot_title_position="panel",
+            plot_caption_position="panel",
             strip_align=0,
             strip_text=element_text(
                 color="#1A1A1A",
diff --git a/plotnine/themes/themeable.py b/plotnine/themes/themeable.py
index a20a489cb..89a41fccc 100644
--- a/plotnine/themes/themeable.py
+++ b/plotnine/themes/themeable.py
@@ -742,6 +742,32 @@ def blank_figure(self, figure: Figure, targets: ThemeTargets):
                 text.set_visible(False)
 
 
+class plot_title_position(themeable):
+    """
+    How to align the plot title and plot subtitle
+
+    Parameters
+    ----------
+    theme_element : Literal["panel", "plot"], default = "panel"
+        If "panel", the title / subtitle are aligned with respect
+        to the panels. If "plot", they are aligned with the plot,
+        excluding the margin space
+    """
+
+
+class plot_caption_position(themeable):
+    """
+    How to align the plot caption
+
+    Parameters
+    ----------
+    theme_element : Literal["panel", "plot"], default = "panel"
+        If "panel", the caption is aligned with respect to the
+        panels. If "plot", it is aligned with the plot, excluding
+        the margin space.
+    """
+
+
 class strip_text_y(MixinSequenceOfValues):
     """
     Facet labels along the vertical axis
diff --git a/tests/baseline_images/test_layout/plot_titles_and_caption_positioning.png b/tests/baseline_images/test_layout/plot_titles_and_caption_positioning.png
new file mode 100644
index 0000000000000000000000000000000000000000..115731389a367cd610af1f3b5e8c4b41f14d3135
GIT binary patch
literal 27860
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
GoBj=eTNk4M

literal 0
HcmV?d00001

diff --git a/tests/test_layout.py b/tests/test_layout.py
index e875cc527..7e08d3548 100644
--- a/tests/test_layout.py
+++ b/tests/test_layout.py
@@ -154,6 +154,13 @@ def test_different_colorbar_themes(self):
 
         assert p == "different_colorbar_themes"
 
+    def test_plot_titles_and_caption_positioning(self):
+        p = self.g + theme(
+            plot_title_position="plot",
+            plot_caption_position="plot",
+        )
+        assert p == "plot_titles_and_caption_positioning"
+
 
 class TestLegendPositioning:
     g = ggplot(mtcars, aes(x="wt", y="mpg", color="gear")) + geom_point()