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

scitex/fts/_fig/_editor/_gui/_flask_editor/_plotter.py

@@ -0,0 +1,664 @@
+#!/usr/bin/env python3
+# File: ./src/scitex/vis/editor/flask_editor/plotter.py
+"""CSV plotting functionality for Flask editor."""
+
+from typing import Any, Dict, Optional
+
+import numpy as np
+import pandas as pd
+
+
+def _apply_element_overrides(
+    kwargs: Dict[str, Any],
+    element_key: str,
+    element_overrides: Dict[str, Any],
+    element_type: str,
+) -> Dict[str, Any]:
+    """Apply element-specific overrides to kwargs.
+
+    Args:
+        kwargs: Original kwargs dict
+        element_key: Key to look up in element_overrides (e.g., 'ax_00_scatter_0')
+        element_overrides: Dict mapping element keys to their override values
+        element_type: Type of element ('trace', 'scatter', 'fill', 'bar')
+
+    Returns:
+        Updated kwargs dict with overrides applied
+    """
+    if not element_key or element_key not in element_overrides:
+        return kwargs
+
+    overrides = element_overrides[element_key]
+    result = kwargs.copy()
+
+    if element_type == "trace":
+        # Line/trace overrides: color, linewidth, linestyle, marker, markersize, alpha
+        if "color" in overrides:
+            result["color"] = overrides["color"]
+        if "linewidth" in overrides:
+            result["linewidth"] = overrides["linewidth"]
+        if "linestyle" in overrides:
+            result["linestyle"] = overrides["linestyle"]
+        if "marker" in overrides and overrides["marker"]:
+            result["marker"] = overrides["marker"]
+        if "markersize" in overrides:
+            result["markersize"] = overrides["markersize"]
+        if "alpha" in overrides:
+            result["alpha"] = overrides["alpha"]
+        if "label" in overrides and overrides["label"]:
+            result["label"] = overrides["label"]
+
+    elif element_type == "scatter":
+        # Scatter overrides: color (c), size (s), marker, alpha, edgecolor
+        if "color" in overrides:
+            result["c"] = overrides["color"]
+            # Remove facecolors if present (conflicts with c)
+            result.pop("facecolors", None)
+        if "size" in overrides:
+            result["s"] = overrides["size"]
+        if "marker" in overrides:
+            result["marker"] = overrides["marker"]
+        if "alpha" in overrides:
+            result["alpha"] = overrides["alpha"]
+        if "edgecolor" in overrides:
+            result["edgecolors"] = overrides["edgecolor"]
+
+    elif element_type == "fill":
+        # Fill overrides: color, alpha
+        if "color" in overrides:
+            result["color"] = overrides["color"]
+        if "alpha" in overrides:
+            result["alpha"] = overrides["alpha"]
+
+    elif element_type == "bar":
+        # Bar overrides: facecolor (color), edgecolor, alpha
+        if "facecolor" in overrides:
+            result["color"] = overrides["facecolor"]
+        if "edgecolor" in overrides:
+            result["edgecolor"] = overrides["edgecolor"]
+        if "alpha" in overrides:
+            result["alpha"] = overrides["alpha"]
+
+    return result
+
+
+def plot_from_csv(
+    ax,
+    csv_data: Optional[pd.DataFrame],
+    overrides: Dict[str, Any],
+    linewidth: float = 1.0,
+):
+    """Reconstruct plot from CSV data using trace info from overrides.
+
+    Args:
+        ax: Matplotlib axes object
+        csv_data: DataFrame containing CSV data
+        overrides: Dictionary with override settings including traces
+        linewidth: Default line width in points
+    """
+    if csv_data is None or not isinstance(csv_data, pd.DataFrame):
+        return
+
+    df = csv_data
+    o = overrides
+
+    # Get legend settings from overrides
+    legend_fontsize = o.get("legend_fontsize", 6)
+    legend_visible = o.get("legend_visible", True)
+    legend_frameon = o.get("legend_frameon", False)
+    legend_loc = o.get("legend_loc", "best")
+    legend_x = o.get("legend_x", 0.5)
+    legend_y = o.get("legend_y", 0.5)
+
+    # Get traces from overrides (which may have been edited by user)
+    traces = o.get("traces", [])
+
+    if traces:
+        _plot_with_traces(
+            ax,
+            df,
+            traces,
+            linewidth,
+            legend_fontsize,
+            legend_visible,
+            legend_frameon,
+            legend_loc,
+            legend_x,
+            legend_y,
+        )
+    else:
+        _plot_fallback(
+            ax,
+            df,
+            linewidth,
+            legend_fontsize,
+            legend_visible,
+            legend_frameon,
+            legend_loc,
+            legend_x,
+            legend_y,
+        )
+
+
+def plot_from_recipe(
+    ax,
+    csv_data: Optional[pd.DataFrame],
+    ax_spec: Dict[str, Any],
+    overrides: Dict[str, Any],
+    linewidth: float = 1.0,
+    ax_id: str = "",
+):
+    """Plot from new recipe schema (scitex.plt.figure.recipe).
+
+    Args:
+        ax: Matplotlib axes object
+        csv_data: DataFrame containing CSV data
+        ax_spec: Axis specification from recipe JSON (includes 'calls' list)
+        overrides: Dictionary with override settings
+        linewidth: Default line width in points
+        ax_id: Axis identifier (e.g., 'ax_00') for element override lookup
+    """
+    if csv_data is None or not isinstance(csv_data, pd.DataFrame):
+        return
+
+    df = csv_data
+    calls = ax_spec.get("calls", [])
+
+    # Get element overrides from overrides dict
+    element_overrides = overrides.get("element_overrides", {})
+
+    # Track element indices per type for this axis
+    element_counts = {"trace": 0, "scatter": 0, "fill": 0, "bar": 0}
+
+    for call in calls:
+        method = call.get("method", "")
+        data_ref = call.get("data_ref", {})
+        kwargs = call.get("kwargs", {}).copy()  # Copy to avoid modifying original
+        call_id = call.get("id", "")
+
+        # Build element key for override lookup
+        element_key = None
+
+        try:
+            if method == "plot":
+                element_key = (
+                    f"{ax_id}_trace_{element_counts['trace']}"
+                    if ax_id
+                    else f"trace_{element_counts['trace']}"
+                )
+                kwargs = _apply_element_overrides(
+                    kwargs, element_key, element_overrides, "trace"
+                )
+                _render_plot(ax, df, data_ref, kwargs, linewidth)
+                element_counts["trace"] += 1
+            elif method == "scatter":
+                element_key = (
+                    f"{ax_id}_scatter_{element_counts['scatter']}"
+                    if ax_id
+                    else f"scatter_{element_counts['scatter']}"
+                )
+                kwargs = _apply_element_overrides(
+                    kwargs, element_key, element_overrides, "scatter"
+                )
+                _render_scatter(ax, df, data_ref, kwargs)
+                element_counts["scatter"] += 1
+            elif method == "bar":
+                element_key = (
+                    f"{ax_id}_bar_{element_counts['bar']}"
+                    if ax_id
+                    else f"bar_{element_counts['bar']}"
+                )
+                kwargs = _apply_element_overrides(
+                    kwargs, element_key, element_overrides, "bar"
+                )
+                _render_bar(ax, df, data_ref, kwargs)
+                element_counts["bar"] += 1
+            elif method == "fill_between":
+                element_key = (
+                    f"{ax_id}_fill_{element_counts['fill']}"
+                    if ax_id
+                    else f"fill_{element_counts['fill']}"
+                )
+                kwargs = _apply_element_overrides(
+                    kwargs, element_key, element_overrides, "fill"
+                )
+                _render_fill_between(ax, df, data_ref, kwargs)
+                element_counts["fill"] += 1
+            elif method == "errorbar":
+                _render_errorbar(ax, df, data_ref, kwargs, linewidth)
+            elif method == "imshow":
+                _render_imshow(ax, df, data_ref, kwargs)
+            elif method == "contour":
+                _render_contour(ax, df, data_ref, kwargs)
+            elif method == "contourf":
+                _render_contourf(ax, df, data_ref, kwargs)
+            elif method in (
+                "stx_shaded_line",
+                "stx_fillv",
+                "stx_violin",
+                "stx_box",
+                "stx_rectangle",
+                "stx_raster",
+            ):
+                _render_stx_method(ax, df, method, data_ref, kwargs)
+            elif method == "hist":
+                _render_hist(ax, df, data_ref, kwargs)
+            elif method == "text":
+                _render_text(ax, df, data_ref, kwargs)
+            else:
+                # Try generic approach for unknown methods
+                _render_generic(ax, df, method, data_ref, kwargs, linewidth)
+        except Exception as e:
+            print(f"Error rendering {method} for {call_id}: {e}")
+
+    # Handle legend
+    legend_fontsize = overrides.get("legend_fontsize", 6)
+    legend_visible = overrides.get("legend_visible", True)
+    legend_frameon = overrides.get("legend_frameon", False)
+
+    if legend_visible:
+        handles, labels = ax.get_legend_handles_labels()
+        if handles:
+            ax.legend(fontsize=legend_fontsize, frameon=legend_frameon)
+
+
+def _get_column_data(df, col_ref: str) -> Optional[np.ndarray]:
+    """Get column data from DataFrame, handling missing columns gracefully.
+
+    Handles the naming mismatch between JSON data_ref and CSV columns:
+    - JSON: ax-row-0-col-0_trace-id-ax_00_ch1_variable-x
+    - CSV:  ax-row-0-col-0_trace-id-ch1_variable-x
+    """
+    if not col_ref:
+        return None
+
+    # Direct match
+    if col_ref in df.columns:
+        return df[col_ref].dropna().values
+
+    # Try removing ax_XX_ prefix from trace-id portion
+    # Pattern: ax-row-X-col-Y_trace-id-ax_XX_NAME_variable-Z
+    # Should become: ax-row-X-col-Y_trace-id-NAME_variable-Z
+    import re
+
+    simplified = re.sub(r"(trace-id-)ax_\d+_", r"\1", col_ref)
+    if simplified in df.columns:
+        return df[simplified].dropna().values
+
+    # Try case variations (lowercase the trace-id part)
+    simplified_lower = re.sub(
+        r"(trace-id-)[^_]+", lambda m: m.group(0).lower(), simplified
+    )
+    if simplified_lower in df.columns:
+        return df[simplified_lower].dropna().values
+
+    # Try matching by suffix (variable-x, variable-y, etc.)
+    suffix_match = re.search(r"_variable-(\w+)$", col_ref)
+    if suffix_match:
+        var_suffix = suffix_match.group(0)
+        # Extract trace-id pattern
+        trace_match = re.search(r"trace-id-(?:ax_\d+_)?([^_]+)", col_ref)
+        if trace_match:
+            trace_name = trace_match.group(1).lower()
+            for col in df.columns:
+                if f"trace-id-{trace_name}" in col.lower() and col.endswith(var_suffix):
+                    return df[col].dropna().values
+
+    # Last resort: fuzzy match by ending
+    for col in df.columns:
+        # Match if same variable suffix and similar trace pattern
+        if col_ref.split("_variable-")[-1] == col.split("_variable-")[-1]:
+            # Check if trace-id portion is similar
+            ref_trace = re.search(r"trace-id-(?:ax_\d+_)?(.+?)_variable", col_ref)
+            col_trace = re.search(r"trace-id-(.+?)_variable", col)
+            if ref_trace and col_trace:
+                if ref_trace.group(1).lower() == col_trace.group(1).lower():
+                    return df[col].dropna().values
+
+    return None
+
+
+def _render_plot(ax, df, data_ref, kwargs, linewidth):
+    """Render line plot."""
+    x_col = data_ref.get("x", "")
+    y_col = data_ref.get("y", "")
+
+    x = _get_column_data(df, x_col)
+    y = _get_column_data(df, y_col)
+
+    if x is not None and y is not None and len(x) == len(y):
+        lw = kwargs.pop("linewidth", linewidth)
+        ax.plot(x, y, linewidth=lw, **kwargs)
+
+
+def _render_scatter(ax, df, data_ref, kwargs):
+    """Render scatter plot."""
+    x_col = data_ref.get("x", "")
+    y_col = data_ref.get("y", "")
+
+    x = _get_column_data(df, x_col)
+    y = _get_column_data(df, y_col)
+
+    if x is not None and y is not None and len(x) == len(y):
+        ax.scatter(x, y, **kwargs)
+
+
+def _render_bar(ax, df, data_ref, kwargs):
+    """Render bar plot."""
+    x_col = data_ref.get("x", "")
+    y_col = data_ref.get("y", "")
+
+    x = _get_column_data(df, x_col)
+    y = _get_column_data(df, y_col)
+
+    if x is not None and y is not None and len(x) == len(y):
+        ax.bar(x, y, **kwargs)
+
+
+def _render_fill_between(ax, df, data_ref, kwargs):
+    """Render fill_between."""
+    x_col = data_ref.get("x", "")
+    y1_col = data_ref.get("y1", "")
+    y2_col = data_ref.get("y2", "")
+
+    x = _get_column_data(df, x_col)
+    y1 = _get_column_data(df, y1_col)
+    y2 = _get_column_data(df, y2_col)
+
+    if x is not None and y1 is not None and y2 is not None:
+        min_len = min(len(x), len(y1), len(y2))
+        ax.fill_between(x[:min_len], y1[:min_len], y2[:min_len], **kwargs)
+
+
+def _render_errorbar(ax, df, data_ref, kwargs, linewidth):
+    """Render errorbar plot."""
+    x_col = data_ref.get("x", "")
+    y_col = data_ref.get("y", "")
+    yerr_col = data_ref.get("yerr", "")
+
+    x = _get_column_data(df, x_col)
+    y = _get_column_data(df, y_col)
+    yerr = _get_column_data(df, yerr_col) if yerr_col else None
+
+    if x is not None and y is not None and len(x) == len(y):
+        ax.errorbar(x, y, yerr=yerr, linewidth=linewidth, **kwargs)
+
+
+def _render_imshow(ax, df, data_ref, kwargs):
+    """Render imshow (heatmap)."""
+    data_col = data_ref.get("data", "")
+    # For imshow, data is typically in a special format - try to reconstruct
+    # Look for row/col/value columns
+    row_col = data_ref.get("row", "")
+    col_col = data_ref.get("col", "")
+    value_col = data_ref.get("value", "")
+
+    if row_col and col_col and value_col:
+        rows = _get_column_data(df, row_col)
+        cols = _get_column_data(df, col_col)
+        values = _get_column_data(df, value_col)
+
+        if rows is not None and cols is not None and values is not None:
+            # Reconstruct 2D array
+            n_rows = int(rows.max()) + 1
+            n_cols = int(cols.max()) + 1
+            data = np.zeros((n_rows, n_cols))
+            for r, c, v in zip(rows.astype(int), cols.astype(int), values):
+                data[r, c] = v
+            ax.imshow(data, **kwargs)
+
+
+def _render_contour(ax, df, data_ref, kwargs):
+    """Render contour plot."""
+    x_col = data_ref.get("x", "")
+    y_col = data_ref.get("y", "")
+    z_col = data_ref.get("z", "")
+
+    x = _get_column_data(df, x_col)
+    y = _get_column_data(df, y_col)
+    z = _get_column_data(df, z_col)
+
+    if x is not None and y is not None and z is not None:
+        # Assume data is on a grid - reconstruct
+        n = int(np.sqrt(len(x)))
+        if n * n == len(x):
+            X = x.reshape(n, n)
+            Y = y.reshape(n, n)
+            Z = z.reshape(n, n)
+            ax.contour(X, Y, Z, **kwargs)
+
+
+def _render_contourf(ax, df, data_ref, kwargs):
+    """Render filled contour plot."""
+    x_col = data_ref.get("x", "")
+    y_col = data_ref.get("y", "")
+    z_col = data_ref.get("z", "")
+
+    x = _get_column_data(df, x_col)
+    y = _get_column_data(df, y_col)
+    z = _get_column_data(df, z_col)
+
+    if x is not None and y is not None and z is not None:
+        # Assume data is on a grid - reconstruct
+        n = int(np.sqrt(len(x)))
+        if n * n == len(x):
+            X = x.reshape(n, n)
+            Y = y.reshape(n, n)
+            Z = z.reshape(n, n)
+            ax.contourf(X, Y, Z, **kwargs)
+
+
+def _render_stx_method(ax, df, method, data_ref, kwargs):
+    """Render scitex-specific methods (shaded_line, fillv, etc.)."""
+    # These are custom methods - for now, skip or implement basic versions
+    if method == "stx_shaded_line":
+        x_col = data_ref.get("x", "")
+        y_lower_col = data_ref.get("y_lower", "")
+        y_middle_col = data_ref.get("y_middle", "")
+        y_upper_col = data_ref.get("y_upper", "")
+
+        x = _get_column_data(df, x_col)
+        y_lower = _get_column_data(df, y_lower_col)
+        y_middle = _get_column_data(df, y_middle_col)
+        y_upper = _get_column_data(df, y_upper_col)
+
+        if all(v is not None for v in [x, y_lower, y_middle, y_upper]):
+            min_len = min(len(x), len(y_lower), len(y_middle), len(y_upper))
+            ax.fill_between(
+                x[:min_len],
+                y_lower[:min_len],
+                y_upper[:min_len],
+                alpha=0.3,
+                **{k: v for k, v in kwargs.items() if k not in ["linewidth"]},
+            )
+            ax.plot(x[:min_len], y_middle[:min_len], **kwargs)
+
+
+def _render_hist(ax, df, data_ref, kwargs):
+    """Render histogram."""
+    data_col = data_ref.get("data", data_ref.get("x", ""))
+    data = _get_column_data(df, data_col)
+    if data is not None:
+        ax.hist(data, **kwargs)
+
+
+def _render_text(ax, df, data_ref, kwargs):
+    """Render text annotation."""
+    x_col = data_ref.get("x", "")
+    y_col = data_ref.get("y", "")
+    content_col = data_ref.get("content", "")
+
+    x = _get_column_data(df, x_col)
+    y = _get_column_data(df, y_col)
+
+    if x is not None and y is not None and len(x) > 0:
+        # Get text content from CSV or kwargs
+        text = kwargs.pop("text", "")
+        if not text and content_col:
+            content = _get_column_data(df, content_col)
+            if content is not None and len(content) > 0:
+                text = str(content[0])
+        ax.text(x[0], y[0], text, **kwargs)
+
+
+def _render_generic(ax, df, method, data_ref, kwargs, linewidth):
+    """Try to render using generic approach."""
+    # For unknown methods, try to get x/y data and plot as line
+    x_col = data_ref.get("x", "")
+    y_col = data_ref.get("y", "")
+
+    x = _get_column_data(df, x_col)
+    y = _get_column_data(df, y_col)
+
+    if x is not None and y is not None and len(x) == len(y):
+        # Filter out kwargs that are not valid for ax.plot()
+        invalid_plot_kwargs = {
+            "levels",
+            "extend",
+            "origin",
+            "extent",
+            "aspect",
+            "norm",
+            "vmin",
+            "vmax",
+            "interpolation",
+            "filternorm",
+            "filterrad",
+            "resample",
+            "bins",
+            "range",
+            "density",
+            "weights",
+            "cumulative",
+            "bottom",
+            "histtype",
+            "align",
+            "orientation",
+            "rwidth",
+            "log",
+            "stacked",
+            "data",
+            "width",
+            "height",
+            "edgecolors",
+            "s",
+            "c",
+            "facecolors",
+        }
+        filtered_kwargs = {
+            k: v for k, v in kwargs.items() if k not in invalid_plot_kwargs
+        }
+        ax.plot(x, y, linewidth=linewidth, **filtered_kwargs)
+
+
+def _plot_with_traces(
+    ax,
+    df,
+    traces,
+    linewidth,
+    legend_fontsize,
+    legend_visible,
+    legend_frameon,
+    legend_loc,
+    legend_x,
+    legend_y,
+):
+    """Plot using trace information from overrides."""
+    for trace in traces:
+        # Support both old format (csv_columns.x/y) and new format (x_col/y_col)
+        csv_cols = trace.get("csv_columns", {})
+        x_col = csv_cols.get("x") or trace.get("x_col")
+        y_col = csv_cols.get("y") or trace.get("y_col")
+
+        if x_col and y_col and x_col in df.columns and y_col in df.columns:
+            ax.plot(
+                df[x_col],
+                df[y_col],
+                label=trace.get("label", trace.get("id", "")),
+                color=trace.get("color"),
+                linestyle=trace.get("linestyle", "-"),
+                linewidth=trace.get("linewidth", linewidth),
+                marker=trace.get("marker", None),
+                markersize=trace.get("markersize", 6),
+            )
+
+    # Add legend if there are labeled traces
+    if legend_visible and any(t.get("label") for t in traces):
+        _add_legend(ax, legend_fontsize, legend_frameon, legend_loc, legend_x, legend_y)
+
+
+def _plot_fallback(
+    ax,
+    df,
+    linewidth,
+    legend_fontsize,
+    legend_visible,
+    legend_frameon,
+    legend_loc,
+    legend_x,
+    legend_y,
+):
+    """Fallback plotting when no trace info available - smart parsing of column names."""
+    cols = df.columns.tolist()
+
+    # Group columns by trace ID
+    trace_groups = {}
+    for col in cols:
+        if col.endswith("_x"):
+            trace_id = col[:-2]  # Remove '_x'
+            y_col = trace_id + "_y"
+            if y_col in cols:
+                # Extract label from column name (e.g., ax_00_sine_plot -> sine)
+                parts = trace_id.split("_")
+                label = parts[2] if len(parts) > 2 else trace_id
+                trace_groups[trace_id] = {
+                    "x_col": col,
+                    "y_col": y_col,
+                    "label": label,
+                }
+
+    if trace_groups:
+        for trace_id, info in trace_groups.items():
+            ax.plot(
+                df[info["x_col"]],
+                df[info["y_col"]],
+                label=info["label"],
+                linewidth=linewidth,
+            )
+        if legend_visible:
+            _add_legend(
+                ax, legend_fontsize, legend_frameon, legend_loc, legend_x, legend_y
+            )
+
+    elif len(cols) >= 2:
+        # Last resort: assume first column is x, rest are y
+        x_col = cols[0]
+        for y_col in cols[1:]:
+            try:
+                ax.plot(df[x_col], df[y_col], label=str(y_col), linewidth=linewidth)
+            except Exception:
+                pass
+        if len(cols) > 2 and legend_visible:
+            _add_legend(
+                ax, legend_fontsize, legend_frameon, legend_loc, legend_x, legend_y
+            )
+
+
+def _add_legend(ax, fontsize, frameon, loc, x, y):
+    """Add legend to axes with specified settings."""
+    if loc == "custom":
+        ax.legend(
+            fontsize=fontsize,
+            frameon=frameon,
+            loc="upper left",
+            bbox_to_anchor=(x, y),
+        )
+    else:
+        ax.legend(
+            fontsize=fontsize,
+            frameon=frameon,
+            loc=loc,
+        )
+
+
+# EOF