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

scitex/dev/plt/__init__.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # File: /home/ywatanabe/proj/scitex-code/src/scitex/dev/plt/__init__.py
 
 """
@@ -36,31 +35,31 @@ Usage:
 # =============================================================================
 # 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
+from .demo_plotters.plot_stx_bar import plot_stx_bar
+from .demo_plotters.plot_stx_barh import plot_stx_barh
+from .demo_plotters.plot_stx_box import plot_stx_box
+from .demo_plotters.plot_stx_boxplot import plot_stx_boxplot
+from .demo_plotters.plot_stx_conf_mat import plot_stx_conf_mat
+from .demo_plotters.plot_stx_contour import plot_stx_contour
+from .demo_plotters.plot_stx_ecdf import plot_stx_ecdf
+from .demo_plotters.plot_stx_errorbar import plot_stx_errorbar
+from .demo_plotters.plot_stx_fill_between import plot_stx_fill_between
+from .demo_plotters.plot_stx_fillv import plot_stx_fillv
+from .demo_plotters.plot_stx_heatmap import plot_stx_heatmap
+from .demo_plotters.plot_stx_image import plot_stx_image
+from .demo_plotters.plot_stx_imshow import plot_stx_imshow
+from .demo_plotters.plot_stx_joyplot import plot_stx_joyplot
+from .demo_plotters.plot_stx_kde import plot_stx_kde
+from .demo_plotters.plot_stx_line import plot_stx_line
+from .demo_plotters.plot_stx_mean_ci import plot_stx_mean_ci
+from .demo_plotters.plot_stx_mean_std import plot_stx_mean_std
+from .demo_plotters.plot_stx_median_iqr import plot_stx_median_iqr
+from .demo_plotters.plot_stx_raster import plot_stx_raster
+from .demo_plotters.plot_stx_rectangle import plot_stx_rectangle
+from .demo_plotters.plot_stx_scatter import plot_stx_scatter
+from .demo_plotters.plot_stx_shaded_line import plot_stx_shaded_line
+from .demo_plotters.plot_stx_violin import plot_stx_violin
+from .demo_plotters.plot_stx_violinplot import plot_stx_violinplot
 
 PLOTTERS_STX = {
     "stx_line": plot_stx_line,
@@ -93,16 +92,16 @@ PLOTTERS_STX = {
 # =============================================================================
 # 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
+from .demo_plotters.plot_sns_barplot import plot_sns_barplot
+from .demo_plotters.plot_sns_boxplot import plot_sns_boxplot
+from .demo_plotters.plot_sns_heatmap import plot_sns_heatmap
+from .demo_plotters.plot_sns_histplot import plot_sns_histplot
+from .demo_plotters.plot_sns_kdeplot import plot_sns_kdeplot
+from .demo_plotters.plot_sns_lineplot import plot_sns_lineplot
+from .demo_plotters.plot_sns_scatterplot import plot_sns_scatterplot
+from .demo_plotters.plot_sns_stripplot import plot_sns_stripplot
+from .demo_plotters.plot_sns_swarmplot import plot_sns_swarmplot
+from .demo_plotters.plot_sns_violinplot import plot_sns_violinplot
 
 PLOTTERS_SNS = {
     "sns_boxplot": plot_sns_boxplot,
@@ -120,32 +119,32 @@ PLOTTERS_SNS = {
 # =============================================================================
 # 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
+from .demo_plotters.plot_mpl_axhline import plot_mpl_axhline
+from .demo_plotters.plot_mpl_axhspan import plot_mpl_axhspan
+from .demo_plotters.plot_mpl_axvline import plot_mpl_axvline
+from .demo_plotters.plot_mpl_axvspan import plot_mpl_axvspan
+from .demo_plotters.plot_mpl_bar import plot_mpl_bar
+from .demo_plotters.plot_mpl_barh import plot_mpl_barh
+from .demo_plotters.plot_mpl_boxplot import plot_mpl_boxplot
+from .demo_plotters.plot_mpl_contour import plot_mpl_contour
+from .demo_plotters.plot_mpl_contourf import plot_mpl_contourf
+from .demo_plotters.plot_mpl_errorbar import plot_mpl_errorbar
+from .demo_plotters.plot_mpl_eventplot import plot_mpl_eventplot
+from .demo_plotters.plot_mpl_fill import plot_mpl_fill
+from .demo_plotters.plot_mpl_fill_between import plot_mpl_fill_between
+from .demo_plotters.plot_mpl_hexbin import plot_mpl_hexbin
+from .demo_plotters.plot_mpl_hist import plot_mpl_hist
+from .demo_plotters.plot_mpl_hist2d import plot_mpl_hist2d
+from .demo_plotters.plot_mpl_imshow import plot_mpl_imshow
+from .demo_plotters.plot_mpl_pcolormesh import plot_mpl_pcolormesh
+from .demo_plotters.plot_mpl_pie import plot_mpl_pie
+from .demo_plotters.plot_mpl_plot import plot_mpl_plot
+from .demo_plotters.plot_mpl_quiver import plot_mpl_quiver
+from .demo_plotters.plot_mpl_scatter import plot_mpl_scatter
+from .demo_plotters.plot_mpl_stackplot import plot_mpl_stackplot
+from .demo_plotters.plot_mpl_stem import plot_mpl_stem
+from .demo_plotters.plot_mpl_step import plot_mpl_step
+from .demo_plotters.plot_mpl_violinplot import plot_mpl_violinplot
 
 PLOTTERS_MPL = {
     "mpl_plot": plot_mpl_plot,

scitex/dev/plt/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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/demo_plotters/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

scitex/dev/plt/demo_plotters/plot_mpl_fill_between.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_fill_between.py - mpl_fill_between demo
+
+"""mpl_fill_between: fill between."""
+
+import numpy as np
+
+
+def plot_mpl_fill_between(plt, rng, ax=None):
+    """mpl_fill_between - fill between.
+
+    Demonstrates: ax.mpl_fill_between() - identical to ax.fill_between()
+    """
+    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(0, 2*np.pi, 100)
+    y1, y2 = np.sin(x), np.sin(x) + 0.5
+    ax.mpl_fill_between(x, y1, y2, alpha=0.3)
+    ax.plot(x, y1)
+    ax.plot(x, y2)
+    ax.set_xyt("X", "Y", "mpl_fill_between")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/demo_plotters/plot_mpl_hexbin.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_hexbin.py - mpl_hexbin demo
+
+"""mpl_hexbin: hexbin plot."""
+
+import numpy as np
+
+
+def plot_mpl_hexbin(plt, rng, ax=None):
+    """mpl_hexbin - hexbin plot.
+
+    Demonstrates: ax.mpl_hexbin() - identical to ax.hexbin()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    x, y = rng.normal(0, 1, 1000), rng.normal(0, 1, 1000)
+    ax.mpl_hexbin(x, y, gridsize=15)
+    ax.set_xyt("X", "Y", "mpl_hexbin")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/demo_plotters/plot_mpl_hist.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_hist.py - mpl_hist demo
+
+"""mpl_hist: histogram."""
+
+import numpy as np
+
+
+def plot_mpl_hist(plt, rng, ax=None):
+    """mpl_hist - histogram.
+
+    Demonstrates: ax.mpl_hist() - identical to ax.hist()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    data = rng.standard_normal(1000)
+    ax.mpl_hist(data, bins=30, edgecolor='white', alpha=0.8)
+    ax.set_xyt("X", "Y", "mpl_hist")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/demo_plotters/plot_mpl_hist2d.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_hist2d.py - mpl_hist2d demo
+
+"""mpl_hist2d: 2D histogram."""
+
+import numpy as np
+
+
+def plot_mpl_hist2d(plt, rng, ax=None):
+    """mpl_hist2d - 2D histogram.
+
+    Demonstrates: ax.mpl_hist2d() - identical to ax.hist2d()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    x, y = rng.normal(0, 1, 1000), rng.normal(0, 1, 1000)
+    ax.mpl_hist2d(x, y, bins=20)
+    ax.set_xyt("X", "Y", "mpl_hist2d")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF

scitex/dev/plt/demo_plotters/plot_mpl_imshow.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# File: plot_mpl_imshow.py - mpl_imshow demo
+
+"""mpl_imshow: image show."""
+
+import numpy as np
+
+
+def plot_mpl_imshow(plt, rng, ax=None):
+    """mpl_imshow - image show.
+
+    Demonstrates: ax.mpl_imshow() - identical to ax.imshow()
+    """
+    if ax is None:
+        fig, ax = plt.subplots()
+    else:
+        fig = ax.get_figure() if hasattr(ax, "get_figure") else ax._fig_scitex
+
+    data = rng.uniform(0, 1, (10, 10))
+    im = ax.mpl_imshow(data, cmap='viridis', aspect='auto')
+    fig.colorbar(im, ax=ax)
+    ax.set_xyt("X", "Y", "mpl_imshow")
+    if hasattr(ax, 'legend') and ax.get_legend_handles_labels()[0]:
+        ax.legend()
+    return fig, ax
+
+
+# EOF