scitex 2.7.0__py3-none-any.whl → 2.8.1__py3-none-any.whl

scitex/bridge/_helpers.py

@@ -117,7 +117,7 @@ def _detect_backend(target) -> Literal["plt", "vis"]:
     """
     # Check for vis FigureModel
     try:
-        from scitex.vis.model import FigureModel
+        from scitex.fig.model import FigureModel
         if isinstance(target, FigureModel):
             return "vis"
     except ImportError:

scitex/bridge/_plt_vis.py

@@ -14,7 +14,7 @@ Provides adapters to:
 from typing import Optional, Dict, Any, List, Tuple, Union
 import warnings
 
-from scitex.vis.model import (
+from scitex.fig.model import (
     FigureModel,
     AxesModel,
     PlotModel,

scitex/bridge/_stats_vis.py

@@ -27,7 +27,7 @@ When bridging between plt and vis, coordinate transformation may be needed.
 from typing import Optional, Dict, Any, List, Tuple
 
 from scitex.schema import StatResult, Position, StatPositioning
-from scitex.vis.model import AnnotationModel, FigureModel, AxesModel, TextStyle
+from scitex.fig.model import AnnotationModel, FigureModel, AxesModel, TextStyle
 
 
 def stat_result_to_annotation(

scitex/dev/plt/__init__.py

@@ -0,0 +1,272 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/dev/plt/__init__.py
+
+"""
+Development plotting utilities with three API layers.
+
+All plotters follow signature: (plt, rng, ax=None) -> (fig, ax)
+
+API Layers:
+-----------
+stx_*  : SciTeX canonical (ArrayLike input, tracked)
+sns_*  : Seaborn-style (DataFrame input, tracked)
+mpl_*  : Matplotlib-style (raw args, tracked)
+
+Usage:
+    from scitex.dev.plt import PLOTTERS_STX, PLOTTERS_SNS, PLOTTERS_MPL
+
+    @stx.session
+    def main(plt=stx.INJECTED, rng_manager=stx.INJECTED):
+        rng = rng_manager("demo")
+
+        # stx_* API (ArrayLike)
+        for name, plotter in PLOTTERS_STX.items():
+            fig, ax = plotter(plt, rng)
+
+        # sns_* API (DataFrame)
+        for name, plotter in PLOTTERS_SNS.items():
+            fig, ax = plotter(plt, rng)
+
+        # mpl_* API (matplotlib-style)
+        for name, plotter in PLOTTERS_MPL.items():
+            fig, ax = plotter(plt, rng)
+"""
+
+# =============================================================================
+# stx_* API Layer - ArrayLike input (25 plotters)
+# =============================================================================
+from .plot_stx_line import plot_stx_line
+from .plot_stx_mean_std import plot_stx_mean_std
+from .plot_stx_mean_ci import plot_stx_mean_ci
+from .plot_stx_median_iqr import plot_stx_median_iqr
+from .plot_stx_shaded_line import plot_stx_shaded_line
+from .plot_stx_box import plot_stx_box
+from .plot_stx_violin import plot_stx_violin
+from .plot_stx_scatter import plot_stx_scatter
+from .plot_stx_bar import plot_stx_bar
+from .plot_stx_barh import plot_stx_barh
+from .plot_stx_errorbar import plot_stx_errorbar
+from .plot_stx_fill_between import plot_stx_fill_between
+from .plot_stx_kde import plot_stx_kde
+from .plot_stx_ecdf import plot_stx_ecdf
+from .plot_stx_heatmap import plot_stx_heatmap
+from .plot_stx_image import plot_stx_image
+from .plot_stx_imshow import plot_stx_imshow
+from .plot_stx_contour import plot_stx_contour
+from .plot_stx_raster import plot_stx_raster
+from .plot_stx_conf_mat import plot_stx_conf_mat
+from .plot_stx_joyplot import plot_stx_joyplot
+from .plot_stx_rectangle import plot_stx_rectangle
+from .plot_stx_fillv import plot_stx_fillv
+from .plot_stx_boxplot import plot_stx_boxplot
+from .plot_stx_violinplot import plot_stx_violinplot
+
+PLOTTERS_STX = {
+    "stx_line": plot_stx_line,
+    "stx_mean_std": plot_stx_mean_std,
+    "stx_mean_ci": plot_stx_mean_ci,
+    "stx_median_iqr": plot_stx_median_iqr,
+    "stx_shaded_line": plot_stx_shaded_line,
+    "stx_box": plot_stx_box,
+    "stx_violin": plot_stx_violin,
+    "stx_scatter": plot_stx_scatter,
+    "stx_bar": plot_stx_bar,
+    "stx_barh": plot_stx_barh,
+    "stx_errorbar": plot_stx_errorbar,
+    "stx_fill_between": plot_stx_fill_between,
+    "stx_kde": plot_stx_kde,
+    "stx_ecdf": plot_stx_ecdf,
+    "stx_heatmap": plot_stx_heatmap,
+    "stx_image": plot_stx_image,
+    "stx_imshow": plot_stx_imshow,
+    "stx_contour": plot_stx_contour,
+    "stx_raster": plot_stx_raster,
+    "stx_conf_mat": plot_stx_conf_mat,
+    "stx_joyplot": plot_stx_joyplot,
+    "stx_rectangle": plot_stx_rectangle,
+    "stx_fillv": plot_stx_fillv,
+    "stx_boxplot": plot_stx_boxplot,
+    "stx_violinplot": plot_stx_violinplot,
+}
+
+# =============================================================================
+# sns_* API Layer - DataFrame input (10 plotters)
+# =============================================================================
+from .plot_sns_boxplot import plot_sns_boxplot
+from .plot_sns_violinplot import plot_sns_violinplot
+from .plot_sns_barplot import plot_sns_barplot
+from .plot_sns_histplot import plot_sns_histplot
+from .plot_sns_kdeplot import plot_sns_kdeplot
+from .plot_sns_scatterplot import plot_sns_scatterplot
+from .plot_sns_lineplot import plot_sns_lineplot
+from .plot_sns_swarmplot import plot_sns_swarmplot
+from .plot_sns_stripplot import plot_sns_stripplot
+from .plot_sns_heatmap import plot_sns_heatmap
+
+PLOTTERS_SNS = {
+    "sns_boxplot": plot_sns_boxplot,
+    "sns_violinplot": plot_sns_violinplot,
+    "sns_barplot": plot_sns_barplot,
+    "sns_histplot": plot_sns_histplot,
+    "sns_kdeplot": plot_sns_kdeplot,
+    "sns_scatterplot": plot_sns_scatterplot,
+    "sns_lineplot": plot_sns_lineplot,
+    "sns_swarmplot": plot_sns_swarmplot,
+    "sns_stripplot": plot_sns_stripplot,
+    "sns_heatmap": plot_sns_heatmap,
+}
+
+# =============================================================================
+# mpl_* API Layer - Matplotlib-style input (26 plotters)
+# =============================================================================
+from .plot_mpl_plot import plot_mpl_plot
+from .plot_mpl_scatter import plot_mpl_scatter
+from .plot_mpl_bar import plot_mpl_bar
+from .plot_mpl_barh import plot_mpl_barh
+from .plot_mpl_hist import plot_mpl_hist
+from .plot_mpl_hist2d import plot_mpl_hist2d
+from .plot_mpl_hexbin import plot_mpl_hexbin
+from .plot_mpl_boxplot import plot_mpl_boxplot
+from .plot_mpl_violinplot import plot_mpl_violinplot
+from .plot_mpl_errorbar import plot_mpl_errorbar
+from .plot_mpl_step import plot_mpl_step
+from .plot_mpl_stem import plot_mpl_stem
+from .plot_mpl_fill import plot_mpl_fill
+from .plot_mpl_fill_between import plot_mpl_fill_between
+from .plot_mpl_stackplot import plot_mpl_stackplot
+from .plot_mpl_contour import plot_mpl_contour
+from .plot_mpl_contourf import plot_mpl_contourf
+from .plot_mpl_imshow import plot_mpl_imshow
+from .plot_mpl_pcolormesh import plot_mpl_pcolormesh
+from .plot_mpl_pie import plot_mpl_pie
+from .plot_mpl_eventplot import plot_mpl_eventplot
+from .plot_mpl_quiver import plot_mpl_quiver
+from .plot_mpl_axhline import plot_mpl_axhline
+from .plot_mpl_axvline import plot_mpl_axvline
+from .plot_mpl_axhspan import plot_mpl_axhspan
+from .plot_mpl_axvspan import plot_mpl_axvspan
+
+PLOTTERS_MPL = {
+    "mpl_plot": plot_mpl_plot,
+    "mpl_scatter": plot_mpl_scatter,
+    "mpl_bar": plot_mpl_bar,
+    "mpl_barh": plot_mpl_barh,
+    "mpl_hist": plot_mpl_hist,
+    "mpl_hist2d": plot_mpl_hist2d,
+    "mpl_hexbin": plot_mpl_hexbin,
+    "mpl_boxplot": plot_mpl_boxplot,
+    "mpl_violinplot": plot_mpl_violinplot,
+    "mpl_errorbar": plot_mpl_errorbar,
+    "mpl_step": plot_mpl_step,
+    "mpl_stem": plot_mpl_stem,
+    "mpl_fill": plot_mpl_fill,
+    "mpl_fill_between": plot_mpl_fill_between,
+    "mpl_stackplot": plot_mpl_stackplot,
+    "mpl_contour": plot_mpl_contour,
+    "mpl_contourf": plot_mpl_contourf,
+    "mpl_imshow": plot_mpl_imshow,
+    "mpl_pcolormesh": plot_mpl_pcolormesh,
+    "mpl_pie": plot_mpl_pie,
+    "mpl_eventplot": plot_mpl_eventplot,
+    "mpl_quiver": plot_mpl_quiver,
+    "mpl_axhline": plot_mpl_axhline,
+    "mpl_axvline": plot_mpl_axvline,
+    "mpl_axhspan": plot_mpl_axhspan,
+    "mpl_axvspan": plot_mpl_axvspan,
+}
+
+# =============================================================================
+# Combined registry
+# =============================================================================
+PLOTTERS = {**PLOTTERS_STX, **PLOTTERS_SNS, **PLOTTERS_MPL}
+
+
+def get_plotter(name):
+    """Get a plotter function by name."""
+    if name in PLOTTERS:
+        return PLOTTERS[name]
+    raise KeyError(f"Unknown plotter: {name}. Available: {list(PLOTTERS.keys())}")
+
+
+def list_plotters():
+    """List all available plotter names."""
+    return list(PLOTTERS.keys())
+
+
+__all__ = [
+    # stx_* plotters (25)
+    "plot_stx_line",
+    "plot_stx_mean_std",
+    "plot_stx_mean_ci",
+    "plot_stx_median_iqr",
+    "plot_stx_shaded_line",
+    "plot_stx_box",
+    "plot_stx_violin",
+    "plot_stx_scatter",
+    "plot_stx_bar",
+    "plot_stx_barh",
+    "plot_stx_errorbar",
+    "plot_stx_fill_between",
+    "plot_stx_kde",
+    "plot_stx_ecdf",
+    "plot_stx_heatmap",
+    "plot_stx_image",
+    "plot_stx_imshow",
+    "plot_stx_contour",
+    "plot_stx_raster",
+    "plot_stx_conf_mat",
+    "plot_stx_joyplot",
+    "plot_stx_rectangle",
+    "plot_stx_fillv",
+    "plot_stx_boxplot",
+    "plot_stx_violinplot",
+    # sns_* plotters (10)
+    "plot_sns_boxplot",
+    "plot_sns_violinplot",
+    "plot_sns_barplot",
+    "plot_sns_histplot",
+    "plot_sns_kdeplot",
+    "plot_sns_scatterplot",
+    "plot_sns_lineplot",
+    "plot_sns_swarmplot",
+    "plot_sns_stripplot",
+    "plot_sns_heatmap",
+    # mpl_* plotters (26)
+    "plot_mpl_plot",
+    "plot_mpl_scatter",
+    "plot_mpl_bar",
+    "plot_mpl_barh",
+    "plot_mpl_hist",
+    "plot_mpl_hist2d",
+    "plot_mpl_hexbin",
+    "plot_mpl_boxplot",
+    "plot_mpl_violinplot",
+    "plot_mpl_errorbar",
+    "plot_mpl_step",
+    "plot_mpl_stem",
+    "plot_mpl_fill",
+    "plot_mpl_fill_between",
+    "plot_mpl_stackplot",
+    "plot_mpl_contour",
+    "plot_mpl_contourf",
+    "plot_mpl_imshow",
+    "plot_mpl_pcolormesh",
+    "plot_mpl_pie",
+    "plot_mpl_eventplot",
+    "plot_mpl_quiver",
+    "plot_mpl_axhline",
+    "plot_mpl_axvline",
+    "plot_mpl_axhspan",
+    "plot_mpl_axvspan",
+    # Registries
+    "PLOTTERS_STX",
+    "PLOTTERS_SNS",
+    "PLOTTERS_MPL",
+    "PLOTTERS",
+    # Helper functions
+    "get_plotter",
+    "list_plotters",
+]
+
+# EOF

scitex/dev/plt/plot_mpl_axhline.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_axhline.py - mpl_axhline demo
+
+"""mpl_axhline: horizontal line."""
+
+import numpy as np
+
+
+def plot_mpl_axhline(plt, rng, ax=None):
+    """mpl_axhline - horizontal line.
+
+    Demonstrates: ax.mpl_axhline() - identical to ax.axhline()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    ax.plot(rng.uniform(0, 10, 20))
+    ax.mpl_axhline(y=5, color='r', linestyle='--', label='threshold')
+    ax.set_xyt("X", "Y", "mpl_axhline")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_axhspan.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_axhspan.py - mpl_axhspan demo
+
+"""mpl_axhspan: horizontal span."""
+
+import numpy as np
+
+
+def plot_mpl_axhspan(plt, rng, ax=None):
+    """mpl_axhspan - horizontal span.
+
+    Demonstrates: ax.mpl_axhspan() - identical to ax.axhspan()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    ax.plot(rng.uniform(0, 10, 20))
+    ax.mpl_axhspan(3, 7, alpha=0.3, color='yellow', label='range')
+    ax.set_xyt("X", "Y", "mpl_axhspan")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_axvline.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_axvline.py - mpl_axvline demo
+
+"""mpl_axvline: vertical line."""
+
+import numpy as np
+
+
+def plot_mpl_axvline(plt, rng, ax=None):
+    """mpl_axvline - vertical line.
+
+    Demonstrates: ax.mpl_axvline() - identical to ax.axvline()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    ax.plot(rng.uniform(0, 10, 20))
+    ax.mpl_axvline(x=10, color='r', linestyle='--', label='event')
+    ax.set_xyt("X", "Y", "mpl_axvline")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_axvspan.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_axvspan.py - mpl_axvspan demo
+
+"""mpl_axvspan: vertical span."""
+
+import numpy as np
+
+
+def plot_mpl_axvspan(plt, rng, ax=None):
+    """mpl_axvspan - vertical span.
+
+    Demonstrates: ax.mpl_axvspan() - identical to ax.axvspan()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    ax.plot(rng.uniform(0, 10, 20))
+    ax.mpl_axvspan(5, 15, alpha=0.3, color='yellow', label='range')
+    ax.set_xyt("X", "Y", "mpl_axvspan")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_bar.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_bar.py - mpl_bar demo
+
+"""mpl_bar: bar plot."""
+
+import numpy as np
+
+
+def plot_mpl_bar(plt, rng, ax=None):
+    """mpl_bar - bar plot.
+
+    Demonstrates: ax.mpl_bar() - identical to ax.bar()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    x = [1, 2, 3, 4, 5]
+    height = rng.uniform(2, 8, 5)
+    ax.mpl_bar(x, height)
+    ax.set_xyt("X", "Y", "mpl_bar")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_barh.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_barh.py - mpl_barh demo
+
+"""mpl_barh: horizontal bar."""
+
+import numpy as np
+
+
+def plot_mpl_barh(plt, rng, ax=None):
+    """mpl_barh - horizontal bar.
+
+    Demonstrates: ax.mpl_barh() - identical to ax.barh()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    y = [1, 2, 3, 4, 5]
+    width = rng.uniform(2, 8, 5)
+    ax.mpl_barh(y, width)
+    ax.set_xyt("X", "Y", "mpl_barh")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_boxplot.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_boxplot.py - mpl_boxplot demo
+
+"""mpl_boxplot: box plot."""
+
+import numpy as np
+
+
+def plot_mpl_boxplot(plt, rng, ax=None):
+    """mpl_boxplot - box plot.
+
+    Demonstrates: ax.mpl_boxplot() - identical to ax.boxplot()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    data = [rng.normal(i, 1, 100) for i in range(4)]
+    ax.mpl_boxplot(data, tick_labels=['A', 'B', 'C', 'D'])
+    ax.set_xyt("X", "Y", "mpl_boxplot")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_contour.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_contour.py - mpl_contour demo
+
+"""mpl_contour: contour plot."""
+
+import numpy as np
+
+
+def plot_mpl_contour(plt, rng, ax=None):
+    """mpl_contour - contour plot.
+
+    Demonstrates: ax.mpl_contour() - identical to ax.contour()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    x = np.linspace(-3, 3, 50)
+    y = np.linspace(-3, 3, 50)
+    X, Y = np.meshgrid(x, y)
+    Z = np.exp(-(X**2 + Y**2))
+    ax.mpl_contour(X, Y, Z, levels=10)
+    ax.set_xyt("X", "Y", "mpl_contour")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_contourf.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_contourf.py - mpl_contourf demo
+
+"""mpl_contourf: filled contour."""
+
+import numpy as np
+
+
+def plot_mpl_contourf(plt, rng, ax=None):
+    """mpl_contourf - filled contour.
+
+    Demonstrates: ax.mpl_contourf() - identical to ax.contourf()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    x = np.linspace(-3, 3, 50)
+    y = np.linspace(-3, 3, 50)
+    X, Y = np.meshgrid(x, y)
+    Z = np.exp(-(X**2 + Y**2))
+    ax.mpl_contourf(X, Y, Z, levels=10)
+    ax.set_xyt("X", "Y", "mpl_contourf")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_errorbar.py

@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_errorbar.py - mpl_errorbar demo
+
+"""mpl_errorbar: error bar."""
+
+import numpy as np
+
+
+def plot_mpl_errorbar(plt, rng, ax=None):
+    """mpl_errorbar - error bar.
+
+    Demonstrates: ax.mpl_errorbar() - identical to ax.errorbar()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    x = np.arange(1, 6)
+    y = rng.uniform(2, 8, 5)
+    yerr = rng.uniform(0.5, 1.5, 5)
+    ax.mpl_errorbar(x, y, yerr=yerr, fmt='o-', capsize=3)
+    ax.set_xyt("X", "Y", "mpl_errorbar")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_eventplot.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_eventplot.py - mpl_eventplot demo
+
+"""mpl_eventplot: event plot."""
+
+import numpy as np
+
+
+def plot_mpl_eventplot(plt, rng, ax=None):
+    """mpl_eventplot - event plot.
+
+    Demonstrates: ax.mpl_eventplot() - identical to ax.eventplot()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    positions = [rng.uniform(0, 10, rng.integers(5, 15)) for _ in range(5)]
+    ax.mpl_eventplot(positions, orientation='horizontal')
+    ax.set_xyt("X", "Y", "mpl_eventplot")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/plot_mpl_fill.py

@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_fill.py - mpl_fill demo
+
+"""mpl_fill: filled polygon."""
+
+import numpy as np
+
+
+def plot_mpl_fill(plt, rng, ax=None):
+    """mpl_fill - filled polygon.
+
+    Demonstrates: ax.mpl_fill() - identical to ax.fill()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    theta = np.linspace(0, 2*np.pi, 100)
+    r = 1 + 0.3 * np.sin(5 * theta)
+    x, y = r * np.cos(theta), r * np.sin(theta)
+    ax.mpl_fill(x, y, alpha=0.5)
+    ax.set_xyt("X", "Y", "mpl_fill")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF