mpl-spaceplot 0.2.0__tar.gz → 0.3.0__tar.gz

{mpl_spaceplot-0.2.0/src/mpl_spaceplot.egg-info → mpl_spaceplot-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mpl-spaceplot
-Version: 0.2.0
+Version: 0.3.0
 Summary: layout wrappers for matplotlib
 Author-email: Florian Raths <raths.f@gmail.com>
 License: MIT

{mpl_spaceplot-0.2.0 → mpl_spaceplot-0.3.0}/pyproject.toml

@@ -7,9 +7,19 @@ build-backend = "setuptools.build_meta"
 where = ["src"]
 include = ["spaceplot*"]
 
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"spaceplot.resources" = [
+    "fonts/*/*.ttf",
+    "fonts/*/*.otf",
+    "palettes/*",
+]
+
 [project]
 name = "mpl-spaceplot"
-version = "0.2.0"
+version = "0.3.0"
 description = "layout wrappers for matplotlib"
 keywords = ["matplotlib", "plotting", "wrappers"]
 classifiers = [

{mpl_spaceplot-0.2.0 → mpl_spaceplot-0.3.0/src/mpl_spaceplot.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mpl-spaceplot
-Version: 0.2.0
+Version: 0.3.0
 Summary: layout wrappers for matplotlib
 Author-email: Florian Raths <raths.f@gmail.com>
 License: MIT

mpl_spaceplot-0.3.0/src/mpl_spaceplot.egg-info/SOURCES.txt

@@ -0,0 +1,132 @@
+LICENSE
+README.md
+pyproject.toml
+src/mpl_spaceplot.egg-info/PKG-INFO
+src/mpl_spaceplot.egg-info/SOURCES.txt
+src/mpl_spaceplot.egg-info/dependency_links.txt
+src/mpl_spaceplot.egg-info/requires.txt
+src/mpl_spaceplot.egg-info/top_level.txt
+src/spaceplot/__init__.py
+src/spaceplot/aligner.py
+src/spaceplot/montage_plot.py
+src/spaceplot/simulate_data.py
+src/spaceplot/utils.py
+src/spaceplot/appearance/__init__.py
+src/spaceplot/appearance/_layout.py
+src/spaceplot/appearance/display.py
+src/spaceplot/appearance/inline.py
+src/spaceplot/appearance/layout.py
+src/spaceplot/appearance/palettes.py
+src/spaceplot/appearance/styles.py
+src/spaceplot/appearance/tools.py
+src/spaceplot/decorators/__init__.py
+src/spaceplot/decorators/decorators.py
+src/spaceplot/decorators/tools.py
+src/spaceplot/plotting/__init__.py
+src/spaceplot/plotting/plotting.py
+src/spaceplot/plotting/tools.py
+src/spaceplot/resources/font_loader.py
+src/spaceplot/resources/fonts/FiraCode/FiraCode-Bold.ttf
+src/spaceplot/resources/fonts/FiraCode/FiraCode-Light.ttf
+src/spaceplot/resources/fonts/FiraCode/FiraCode-Medium.ttf
+src/spaceplot/resources/fonts/FiraCode/FiraCode-Regular.ttf
+src/spaceplot/resources/fonts/FiraCode/FiraCode-SemiBold.ttf
+src/spaceplot/resources/fonts/FiraMath/FiraMath-Bold.ttf
+src/spaceplot/resources/fonts/FiraMath/FiraMath-ExtraLight.ttf
+src/spaceplot/resources/fonts/FiraMath/FiraMath-Heavy.ttf
+src/spaceplot/resources/fonts/FiraMath/FiraMath-Light.ttf
+src/spaceplot/resources/fonts/FiraMath/FiraMath-Medium.ttf
+src/spaceplot/resources/fonts/FiraMath/FiraMath-Regular.ttf
+src/spaceplot/resources/fonts/FiraMath/FiraMath-SemiBold.ttf
+src/spaceplot/resources/fonts/FiraMath/FiraMath-UltraLight.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-Black.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-BlackItalic.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-Bold.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-BoldItalic.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-ExtraBold.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-ExtraBoldItalic.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-ExtraLight.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-ExtraLightItalic.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-Italic.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-Light.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-LightItalic.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-Medium.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-MediumItalic.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-Regular.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-SemiBold.ttf
+src/spaceplot/resources/fonts/FiraSans/FiraSans-SemiBoldItalic.ttf
+src/spaceplot/resources/fonts/Lato/Lato-Black.ttf
+src/spaceplot/resources/fonts/Lato/Lato-BlackItalic.ttf
+src/spaceplot/resources/fonts/Lato/Lato-Bold.ttf
+src/spaceplot/resources/fonts/Lato/Lato-BoldItalic.ttf
+src/spaceplot/resources/fonts/Lato/Lato-Italic.ttf
+src/spaceplot/resources/fonts/Lato/Lato-Light.ttf
+src/spaceplot/resources/fonts/Lato/Lato-LightItalic.ttf
+src/spaceplot/resources/fonts/Lato/Lato-Regular.ttf
+src/spaceplot/resources/fonts/Lato/Lato-Thin.ttf
+src/spaceplot/resources/fonts/Lato/Lato-ThinItalic.ttf
+src/spaceplot/resources/fonts/NotoSans/NotoSans-Bold.ttf
+src/spaceplot/resources/fonts/NotoSans/NotoSans-BoldItalic.ttf
+src/spaceplot/resources/fonts/NotoSans/NotoSans-Italic.ttf
+src/spaceplot/resources/fonts/NotoSans/NotoSans-Regular.ttf
+src/spaceplot/resources/fonts/NotoSerif/NotoSerif-Bold.ttf
+src/spaceplot/resources/fonts/NotoSerif/NotoSerif-BoldItalic.ttf
+src/spaceplot/resources/fonts/NotoSerif/NotoSerif-Italic.ttf
+src/spaceplot/resources/fonts/NotoSerif/NotoSerif-Regular.ttf
+src/spaceplot/resources/fonts/OpenSans/OpenSans-Bold.ttf
+src/spaceplot/resources/fonts/OpenSans/OpenSans-BoldItalic.ttf
+src/spaceplot/resources/fonts/OpenSans/OpenSans-Italic.ttf
+src/spaceplot/resources/fonts/OpenSans/OpenSans-Regular.ttf
+src/spaceplot/resources/fonts/OpenSans/OpenSans-Semibold.ttf
+src/spaceplot/resources/fonts/OpenSans/OpenSans-SemiboldItalic.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-Black.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-BlackItalic.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-Bold.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-BoldItalic.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-Italic.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-Light.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-LightItalic.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-Medium.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-MediumItalic.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-Regular.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-Thin.ttf
+src/spaceplot/resources/fonts/Roboto/Roboto-ThinItalic.ttf
+src/spaceplot/resources/fonts/Roboto/RobotoCondensed-Bold.ttf
+src/spaceplot/resources/fonts/Roboto/RobotoCondensed-BoldItalic.ttf
+src/spaceplot/resources/fonts/Roboto/RobotoCondensed-Italic.ttf
+src/spaceplot/resources/fonts/Roboto/RobotoCondensed-Light.ttf
+src/spaceplot/resources/fonts/Roboto/RobotoCondensed-LightItalic.ttf
+src/spaceplot/resources/fonts/Roboto/RobotoCondensed-Regular.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-Black.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-BlackItalic.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-Bold.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-BoldItalic.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-ExtraLight.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-ExtraLightItalic.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-Italic.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-Light.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-LightItalic.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-Regular.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-SemiBold.ttf
+src/spaceplot/resources/fonts/SourceSans/SourceSansPro-SemiBoldItalic.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-Black.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-BlackItalic.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-Bold.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-BoldItalic.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-ExtraLight.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-ExtraLightItalic.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-Italic.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-Light.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-LightItalic.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-Regular.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-SemiBold.ttf
+src/spaceplot/resources/fonts/SourceSerif/SourceSerifPro-SemiBoldItalic.ttf
+src/spaceplot/resources/fonts/Ubuntu/Ubuntu-Bold.ttf
+src/spaceplot/resources/fonts/Ubuntu/Ubuntu-BoldItalic.ttf
+src/spaceplot/resources/fonts/Ubuntu/Ubuntu-Italic.ttf
+src/spaceplot/resources/fonts/Ubuntu/Ubuntu-Light.ttf
+src/spaceplot/resources/fonts/Ubuntu/Ubuntu-LightItalic.ttf
+src/spaceplot/resources/fonts/Ubuntu/Ubuntu-Medium.ttf
+src/spaceplot/resources/fonts/Ubuntu/Ubuntu-MediumItalic.ttf
+src/spaceplot/resources/fonts/Ubuntu/Ubuntu-Regular.ttf
+src/spaceplot/resources/palettes/pal1.txt

{mpl_spaceplot-0.2.0 → mpl_spaceplot-0.3.0}/src/spaceplot/__init__.py

@@ -7,7 +7,7 @@ from .appearance import palettes as plts
 from .appearance.display import Theme, display
 from .appearance.layout import layout
 from .montage_plot import montage_plot
-from .plotting import plt_category, plt_continous, plt_image
+from .plotting import plt_category, plt_continous
 
 __all__ = [
     'aligner',
@@ -20,6 +20,5 @@ __all__ = [
     'montage_plot',
     'plt_category',
     'plt_continous',
-    'plt_image',
     'plt',
 ]

mpl_spaceplot-0.2.0/src/spaceplot/appearance/layout.py → mpl_spaceplot-0.3.0/src/spaceplot/appearance/_layout.py

@@ -15,7 +15,7 @@ def layout(
     axs,
     *,
     axis: str = 'both',
-    title: str = None,
+    title: str | list = None,
     x_label: str = None,
     y_label: str = None,
     abc: str | bool = None,
@@ -47,7 +47,7 @@ def layout(
     # ensure axs is a list
     if not isinstance(axs, Iterable):
         axs = [axs]
-    if not isinstance(title, Iterable):
+    if not isinstance(title, list):
         title = [title]
 
     handle_abc_labels(axs, abc, **kwargs)
@@ -93,7 +93,6 @@ def handle_abc_labels(axs, abc=None, **kwargs):
             decs.place_abc_label(
                 ax,
                 label=ax_labels[i],
-                pad=0.2,
                 **abc_params,
             )
 

mpl_spaceplot-0.3.0/src/spaceplot/appearance/layout.py

@@ -0,0 +1,378 @@
+from collections.abc import Iterable
+from itertools import cycle
+from typing import Literal
+
+import numpy as np
+
+from .. import decorators as decs
+from .. import utils
+from . import tools
+
+_tick_vis = Literal[True, False, '1', '2', 'both', 'all', None]
+_grid_vis = Literal[True, False, 'both', 'major', 'minor', None]
+_spine_vis = Literal[True, False, 'top', 'bottom', 'left', 'right', None]
+
+major_grid_style = 'solid'
+minor_grid_style = (0, (1, 2))
+
+# TODO tick param hygiene... there are likely some grid, tick, minor params that don't belong
+# I think currently, tick visibility will override settings from other setters... need to fix that
+
+
+def layout(
+    axs,
+    *,
+    title: str | list = None,
+    abc: str | bool = None,
+    margins: float = None,
+    aspect: str | float | tuple = None,
+    ticks: _tick_vis = None,
+    spines: _spine_vis = None,
+    grid: _grid_vis = None,
+    minor: bool = None,
+    label: str = None,
+    breaks: list[float] = None,
+    lims: list[float] = None,
+    scale: str = None,
+    ticklabels: list[str] = None,
+    **kwargs,
+):
+    local_args = {
+        k: v
+        for k, v in {
+            'label': label,
+            'margins': margins,
+            'breaks': breaks,
+            'lims': lims,
+            'scale': scale,
+            'ticklabels': ticklabels,
+        }.items()
+        if v is not None
+    }
+
+    merged = {**local_args, **kwargs}
+
+    axis_params, static_kwargs = merge_axis_kwargs(merged)
+    x_label_params, x_tick_params, x_params = compile_axis_settings(axis_params, axis='x')
+    y_label_params, y_tick_params, y_params = compile_axis_settings(axis_params, axis='y')
+
+    title_settings = utils.get_hook_dict_v2(static_kwargs, 'title_', remove_hook=True)
+
+    # ensure axs is a list
+    if not isinstance(axs, Iterable):
+        axs = [axs]
+    if not isinstance(title, list):
+        title = [title]
+
+    handle_abc_labels(axs, abc, **kwargs)
+
+    pairs = list(zip(axs, cycle(title)))
+
+    for ax, title in pairs:
+        viz(ax, ticks=ticks, grid=grid, minor=minor, **kwargs)
+
+        handle_tick_settings(ax, 'y', y_tick_params)
+        handle_tick_settings(ax, 'x', x_tick_params)
+
+        # handle other layout elements
+        handle_title(ax, title, title_settings)
+        handle_text_element(ax.get_xlabel, ax.set_xlabel, x_params['label'], x_label_params)
+        handle_text_element(ax.get_ylabel, ax.set_ylabel, y_params['label'], y_label_params)
+
+        handle_spines(ax, spines)
+        handle_breaks(ax, x_params['breaks'], y_params['breaks'])
+        handle_scales(ax, x_params['scale'], y_params['scale'])
+        handle_lims(ax, x_params['lims'], y_params['lims'])
+
+        handle_tick_labels(ax, x_params['ticklabels'], y_params['ticklabels'])
+
+        handle_aspect(ax, aspect)
+
+        # ly.handle_margins(ax, margins, make_square)
+        ax.set_xmargin(x_params['margins']) if x_params['margins'] is not None else None
+        ax.set_ymargin(y_params['margins']) if y_params['margins'] is not None else None
+
+
+def viz(
+    ax,
+    *,
+    ticks: _tick_vis = None,
+    grid: _grid_vis = None,
+    minor: _tick_vis = None,
+    **kwargs,
+):
+    def value_check(param, value):
+        if value is None:
+            return
+        if type(value) is bool:
+            return
+        if value not in [v for v in _tick_vis.__args__ if type(v) is str]:
+            raise ValueError(f'Invalid {param} param: {value} ')
+
+    value_check('ticks', ticks)
+    value_check('minor', minor)
+    for k, v in kwargs.items():
+        if k.endswith('_ticks'):
+            value_check(k, v)
+        if k.endswith('_minor'):
+            value_check(k, v)
+
+    viz_args = {
+        k: v
+        for k, v in {
+            'ticks': ticks,
+            'grid': grid,
+            'minor': minor,
+        }.items()
+        if v is not None
+    }
+
+    ax_below = False if 'grid_zorder' in kwargs else True
+    ax.set_axisbelow(ax_below)
+
+    # filter kwargs and merge with args to a single dict
+    viz_kwargs = {k: v for k, v in kwargs.items() if any([k.endswith(h) for h in ['_ticks', '_grid', '_minor']])}
+    merged = {**viz_args, **viz_kwargs}
+
+    # break down merged into x_ and y_ specific params
+    viz_params = parse_axis_params(params=merged)
+    xviz = utils.get_hook_dict_v2(viz_params, 'x_', remove_hook=True, check=False)
+    yviz = utils.get_hook_dict_v2(viz_params, 'y_', remove_hook=True, check=False)
+
+    # apply settings
+    set_tick_grid_visibility(ax, axis='x', **xviz)
+    set_tick_grid_visibility(ax, axis='y', **yviz)
+
+
+def set_tick_grid_visibility(ax, *, axis='x', ticks=None, minor=False, grid=None):
+    axis_obj = getattr(ax, f'{axis}axis')
+
+    # mapping for tick visibility in x/y axis
+    p1 = 'bottom' if axis == 'x' else 'left'
+    p2 = 'top' if axis == 'x' else 'right'
+
+    keys = [p1, f'label{p1}', p2, f'label{p2}']
+    curr_params = axis_obj.get_tick_params()
+    curr_params = {k: v for k, v in curr_params.items() if k in keys}
+
+    # this determines the logic for tick visibility
+    def apply_logic(value):
+        logic_1 = True if value in ('1', 'both', 'all', True) else False
+        logic_2 = True if value in ('2', 'both', 'all') else False
+
+        viz = {
+            p1: logic_1,
+            f'label{p1}': logic_1,
+            p2: logic_2,
+            f'label{p2}': logic_2,
+        }
+
+        return viz
+
+    if ticks is None:
+        viz = curr_params
+    else:
+        viz = apply_logic(ticks)
+
+    if minor is None and ticks is None:
+        viz_min = {}
+    elif minor is None and ticks:
+        viz_min = {}
+    elif minor is True and not ticks:
+        viz_min = curr_params
+    elif minor is True and ticks:
+        viz_min = viz.copy()
+    else:
+        viz_min = apply_logic(minor)
+
+    axis_obj.minorticks_on()
+    grid_maj, grid_min = parse_grid_visibility(grid=grid, minor=minor)
+
+    axis_obj.set_tick_params(which='major', gridOn=grid_maj, **viz)
+    axis_obj.set_tick_params(which='minor', gridOn=grid_min, **viz_min)
+
+
+def parse_grid_visibility(
+    grid: _grid_vis | None = None,
+    minor: bool | None = None,
+):
+    if grid is None:
+        return None, None
+
+    if isinstance(grid, bool):
+        if not grid:
+            major_setter = minor_setter = False
+        else:
+            major_setter = grid
+            minor_setter = grid if minor is None else minor
+    elif isinstance(grid, str):
+        major_setter = True if grid in ('both', 'major') else False
+        minor_setter = True if grid in ('both', 'minor') else False
+
+    return major_setter, minor_setter
+
+
+def parse_axis_params(params: dict):
+    """
+    separates explicit axis params (i.e: x_tick_size) from global axis params (i.e: tick_size)
+    and merges them into a single dict of xy related axis params
+    """
+    specific_axis_params = {}
+    global_axis_params = {}
+    for key, value in params.items():
+        if any([key.startswith(h) for h in ['x_', 'y_']]):
+            specific_axis_params[key] = value
+        else:
+            global_axis_params[key] = value
+
+    # 3: expand global axis params to x_ and y_ versions
+    x_global = {'x_' + key: value for key, value in global_axis_params.items()}
+    y_global = {'y_' + key: value for key, value in global_axis_params.items()}
+    axis_global = {**x_global, **y_global}
+
+    # 4: check for duplicates and merge
+    duplicate_keys = set(specific_axis_params.keys()) & set(axis_global.keys())
+    if duplicate_keys:
+        param_names = [p.removeprefix('x_') if p.startswith('x_') else p.removeprefix('y_') for p in duplicate_keys]
+        raise ValueError(f'Duplicate axis param for: {duplicate_keys} and {param_names}')
+
+    axis_params = {**specific_axis_params, **axis_global}
+
+    return axis_params
+
+
+def merge_axis_kwargs(kwargs):
+    axis_hooks = ['x_', 'y_', 'tick_', 'margins', 'grid', 'label', 'lims', 'breaks', 'scale', 'ticklabels']
+    # 1: separate axis and static params
+    axis_params = {}
+    static_params = {}
+    for key, value in kwargs.items():
+        if any([key.startswith(h) for h in axis_hooks]):
+            axis_params[key] = value
+        else:
+            static_params[key] = value
+
+    axis_params = parse_axis_params(axis_params)
+
+    return axis_params, static_params
+
+
+def compile_axis_settings(axis_params, axis: str) -> dict:
+    settings = utils.get_hook_dict_v2(axis_params, f'{axis}_', remove_hook=True, check=False)
+
+    tick_settings = utils.get_hook_dict_v2(settings, 'tick_', remove_hook=True)
+    grid_settings = utils.get_hook_dict_v2(settings, 'grid_', remove_hook=False)
+    label_settings = utils.get_hook_dict_v2(settings, 'label_', remove_hook=True)
+
+    tick_settings.update(grid_settings)
+    other_params = {k: v for k, v in settings.items() if not (k.startswith('tick_') or k.startswith('grid_'))}
+
+    complete_other = {}
+    for i in ['grid', 'margins', 'label', 'breaks', 'lims', 'scale', 'ticklabels']:
+        complete_other[i] = other_params.get(i, None)
+
+    return label_settings, tick_settings, complete_other
+
+
+def handle_text_element(getter, setter, text: str = None, params: dict = {}):
+    """Generic helper to get current text if needed and set it with params."""
+    if text is None and len(params) == 0:
+        return
+
+    if text is None and len(params) > 0:
+        text = getter()
+
+    setter(text, **params)
+
+
+def handle_title(ax, title, title_params):
+    if title is None and len(title_params) == 0:
+        return
+
+    if title is None:
+        title = ax.get_title()
+        title = None if len(title) == 0 else title
+
+    if title is not None or len(title_params) > 0:
+        handle_text_element(ax.get_title, ax.set_title, title, title_params)
+
+
+def handle_tick_labels(ax, x_tick_labels, y_tick_labels):
+    if x_tick_labels is not None:
+        ax.set_xticklabels(x_tick_labels)
+
+    if y_tick_labels is not None:
+        ax.set_yticklabels(y_tick_labels)
+
+
+def handle_lims(ax, x_lims, y_lims):
+    if y_lims is not None:
+        ax.set_ylim(y_lims)
+
+    if x_lims is not None:
+        ax.set_xlim(x_lims)
+
+
+def handle_spines(ax, spines):
+    if spines is not None:
+        tools.set_spine_visibility(ax, spines)
+
+
+def handle_aspect(ax, aspect):
+    if aspect is not None:
+        aspect = [aspect] if not isinstance(aspect, (list, tuple)) else aspect
+        adjustable = None if len(aspect) < 2 else aspect[1]
+        aspect_params = {'aspect': aspect[0], 'adjustable': adjustable}
+        ax.set_aspect(**aspect_params)
+
+
+def handle_breaks(ax, x_breaks, y_breaks):
+    if x_breaks is not None:
+        ax.set_xticks(x_breaks)
+
+    if y_breaks is not None:
+        ax.set_yticks(y_breaks)
+
+
+def handle_scales(ax, x_scale, y_scale):
+    if y_scale is not None:
+        scale_params = tools.parse_scale(scale=y_scale)
+        ax.set_yscale(**scale_params)
+
+    if x_scale is not None:
+        scale_params = tools.parse_scale(scale=x_scale)
+        ax.set_xscale(**scale_params)
+
+
+def handle_tick_settings(ax, axis, tick_settings):
+    # Set default grid style, since rcParams don't offer minor grid style
+    if 'grid_linestyle' not in tick_settings:
+        tick_settings['grid_linestyle'] = [major_grid_style, minor_grid_style]
+
+    # if len(tick_settings) == 0:
+    #     return
+
+    majmin_settings = {k: utils.maj_min_args(maj_min=v) for k, v in tick_settings.items()}
+
+    for i, which in enumerate(['major', 'minor']):
+        tick_settings_select = {k: v[i] for k, v in majmin_settings.items()}
+        ax.tick_params(axis=axis, which=which, **tick_settings_select)
+
+
+def handle_abc_labels(axs, abc=None, **kwargs):
+    if abc:
+        ax_labels = np.arange(1, len(axs) + 1)
+        if abc == 'ABC':
+            ax_labels = [chr(64 + num) for num in ax_labels]
+        elif abc == 'abc':
+            ax_labels = [chr(96 + num) for num in ax_labels]
+
+        abc_params = utils.get_hook_dict_v2(kwargs, 'abc_', check=True)
+        abc_params['loc'] = abc_params['loc'] if 'loc' in abc_params else 'tl'
+        abc_params['size'] = abc_params['size'] if 'size' in abc_params else 18
+        for i, ax in enumerate(axs):
+            decs.place_abc_label(
+                ax,
+                label=ax_labels[i],
+                **abc_params,
+            )

{mpl_spaceplot-0.2.0 → mpl_spaceplot-0.3.0}/src/spaceplot/decorators/decorators.py

@@ -147,7 +147,7 @@ def place_abc_label(
     loc='tl',
     label_pos='c',
     style='alpha_box',
-    pad=0.1,
+    pad=0.2,
     box=None,
     clip_on=True,
     **kwargs,

mpl_spaceplot-0.3.0/src/spaceplot/plotting/__init__.py

@@ -0,0 +1,6 @@
+from .plotting import plt_category, plt_continous
+
+__all__ = [
+    'plt_category',
+    'plt_continous',
+]