fastplotpy 0.3.0a1__py3-none-win_amd64.whl

fastplotpy/defaults/line-axes.json

@@ -0,0 +1,28 @@
+{
+  "defaultTicks": 5,
+  "maxDecimals": 10,
+  "plotBounds": { "left": 48, "top": 16, "right": 16, "bottom": 36 },
+  "axisColor": "#64748b",
+  "gridColor": "#cbd5e1",
+  "axisLineWidth": 1,
+  "gridLineWidth": 0.5,
+  "minorGridAlpha": 0.45,
+  "minorTickAlpha": 0.6,
+  "minorLabelAlpha": 0.65,
+  "majorTickLength": 5,
+  "majorTickDirection": "outside",
+  "majorTickLabelOffset": 8,
+  "majorTickLabelGap": 3,
+  "minorLabelMinDistanceX": 18,
+  "minorLabelMinDistanceY": 14,
+  "minorDefault": { "show": true, "ticks": "outside", "ticklen": 3, "grid": false },
+  "labelColor": "#475569",
+  "labelFont": "11px system-ui, sans-serif",
+  "labelRotationDegrees": 0,
+  "labelCollision": "allow",
+  "labelFormatter": null,
+  "titleColor": "#334155",
+  "titleFont": "600 12px system-ui, sans-serif",
+  "titleLineHeight": 16,
+  "titleGap": 8
+}

fastplotpy/defaults/line3d.json

@@ -0,0 +1,13 @@
+{
+  "lineWidth": 2,
+  "lineOpacity": 1,
+  "minimumHitRadius": 1,
+  "interpolation": "linear",
+  "smoothSamplesPerSegment": 12,
+  "lod": {
+    "enabled": false,
+    "strategy": "largest-triangle-3d",
+    "maxSourceSegments": 250
+  },
+  "maxSegments": 1000000
+}

fastplotpy/defaults/markers.json

@@ -0,0 +1,6 @@
+{
+  "show": false,
+  "size": 3,
+  "shape": "circle",
+  "minSize": 1
+}

fastplotpy/defaults/mesh3d.json

@@ -0,0 +1,13 @@
+{
+  "opacity": 0.82,
+  "maxFaces": 500000,
+  "lod": {
+    "strategy": "largest-area-stratified",
+    "maxFaces": 1000
+  },
+  "backfaceCulling": false,
+  "wireframeShow": false,
+  "wireframeColor": "#0f172a",
+  "wireframeWidth": 1,
+  "wireframeOpacity": 0.65
+}

fastplotpy/defaults/pan.json

@@ -0,0 +1,7 @@
+{
+  "mode": "xy",
+  "mouseButton": 0,
+  "modifierKey": "shift",
+  "preventDefault": true,
+  "minDragDistance": 2
+}

fastplotpy/defaults/pie.json

@@ -0,0 +1,27 @@
+{
+  "startAngleDegrees": -90,
+  "clockwise": true,
+  "sectorGapDegrees": 0,
+  "sectorOpacity": 1,
+  "borderColor": "rgba(15, 23, 42, 0.28)",
+  "borderWidth": 1,
+  "innerRadiusRatio": 0,
+  "outerRadiusRatio": 1,
+  "colors": [],
+  "labels": {
+    "show": false,
+    "position": "inside",
+    "content": "label",
+    "color": "#ffffff",
+    "font": "12px system-ui, sans-serif",
+    "lineHeight": 15,
+    "decimals": 1,
+    "prefix": "",
+    "suffix": "",
+    "minSectorAngleDegrees": 12,
+    "radiusRatio": 0.66,
+    "offset": 14,
+    "collisionPadding": 2,
+    "formatter": null
+  }
+}

fastplotpy/defaults/pie3d.json

@@ -0,0 +1,7 @@
+{
+  "extrusionDepth": 0.15,
+  "curveTolerance": 1,
+  "seamStrokeWidth": 1,
+  "seamLineJoin": "round",
+  "maxCurveStepDegrees": 90
+}

fastplotpy/defaults/point-labels.json

@@ -0,0 +1,13 @@
+{
+  "show": false,
+  "color": "#0f172a",
+  "font": "11px Inter, system-ui, sans-serif",
+  "lineHeight": 14,
+  "position": "auto",
+  "offset": 6,
+  "decimals": 0,
+  "prefix": "",
+  "suffix": "",
+  "collisionPadding": 2,
+  "formatter": null
+}

fastplotpy/defaults/pointClick.json

@@ -0,0 +1,6 @@
+{
+  "enabled": false,
+  "mouseButton": 0,
+  "maxMovement": 4,
+  "radius": 8
+}

fastplotpy/defaults/pointSelection.json

@@ -0,0 +1,13 @@
+{
+  "enabled": false,
+  "mode": "single",
+  "keyboard": false,
+  "mouseButton": 0,
+  "maxMovement": 4,
+  "radius": 8,
+  "strokeColor": "#2563eb",
+  "fillColor": "rgba(37, 99, 235, 0.16)",
+  "lineWidth": 2,
+  "padding": 3,
+  "markerlessRadius": 3
+}

fastplotpy/defaults/polar.json

@@ -0,0 +1,71 @@
+{
+  "mode": "windrose",
+  "radialScale": "linear",
+  "sectorMode": "grouped",
+  "angleCategories": [],
+  "sectorWidthDegrees": 24,
+  "sectorGapDegrees": 0,
+  "sectorOpacity": 1,
+  "startAngleDegrees": -90,
+  "clockwise": true,
+  "innerRadiusRatio": 0,
+  "outerRadiusRatio": 0.92,
+  "minRadius": 0,
+  "maxRadius": null,
+  "borderWidth": 1,
+  "borderColor": "rgba(15, 23, 42, 0.28)",
+  "sectorLabels": {
+    "show": false,
+    "color": "#ffffff",
+    "font": "11px Inter, system-ui, sans-serif",
+    "lineHeight": 14,
+    "decimals": 0,
+    "prefix": "",
+    "suffix": "",
+    "minSectorRadius": 14,
+    "minSectorAngleDegrees": 6,
+    "radiusRatio": 0.62,
+    "collisionPadding": 2,
+    "formatter": null
+  },
+  "grid": {
+    "show": false,
+    "rings": 4,
+    "ringValues": [],
+    "spokes": 12,
+    "ringColor": "rgba(100, 116, 139, 0.34)",
+    "spokeColor": "rgba(100, 116, 139, 0.28)",
+    "ringLineWidth": 1,
+    "spokeLineWidth": 1,
+    "labels": {
+      "show": false,
+      "color": "#475569",
+      "font": "11px system-ui, sans-serif",
+      "decimals": 0,
+      "angleDegrees": 90,
+      "offset": 6,
+      "prefix": "",
+      "suffix": "",
+      "formatter": null
+    },
+    "angleLabels": {
+      "show": false,
+      "color": "#475569",
+      "font": "11px system-ui, sans-serif",
+      "decimals": 0,
+      "offset": 14,
+      "labels": [],
+      "prefix": "",
+      "suffix": "\u00b0",
+      "formatter": null
+    }
+  },
+  "vectors": {
+    "show": false,
+    "directions": [],
+    "color": "",
+    "lineWidth": 2,
+    "headSize": 8,
+    "headAngleDegrees": 28
+  }
+}

fastplotpy/defaults/polarRotate.json

@@ -0,0 +1,5 @@
+{
+  "mouseButton": 0,
+  "preventDefault": true,
+  "minDragDistance": 2
+}

fastplotpy/defaults/scatter3d.json

@@ -0,0 +1,39 @@
+{
+  "markerSize": 6,
+  "markerOpacity": 0.9,
+  "markerShape": "circle",
+  "lod": {
+    "enabled": false,
+    "strategy": "spatial-grid",
+    "maxPoints": 5000
+  },
+  "valueScale": "linear",
+  "lowColor": "#e0f2fe",
+  "highColor": "#7c3aed",
+  "colorStops": [],
+  "sizeScale": {
+    "enabled": false,
+    "minSize": 3,
+    "maxSize": 14,
+    "minValue": null,
+    "maxValue": null
+  },
+  "opacityScale": {
+    "enabled": false,
+    "minOpacity": 0.2,
+    "maxOpacity": 1,
+    "minValue": null,
+    "maxValue": null
+  },
+  "colorScaleLegend": true,
+  "legendWidth": 12,
+  "legendHeight": 120,
+  "legendOffset": 12,
+  "legendTitle": "value",
+  "legendTickCount": 3,
+  "legendFont": "11px system-ui, sans-serif",
+  "legendColor": "#475569",
+  "legendLabelGap": 4,
+  "legendGlyphWidth": 7,
+  "legendMinimumLabelHeight": 32
+}

fastplotpy/defaults/scene3d.json

@@ -0,0 +1,61 @@
+{
+  "renderer": "canvas",
+  "webgl2BatchVertexCount": 65532,
+  "webgl2MaxBufferBytes": 8388608,
+  "nodePngMaxPixels": 16777216,
+  "projection": "perspective",
+  "eye": [1.8, 1.4, 1.8],
+  "target": [0, 0, 0],
+  "up": [0, 1, 0],
+  "fieldOfViewDegrees": 45,
+  "orthographicScale": 2.5,
+  "near": 0.1,
+  "far": 100,
+  "lightingShow": false,
+  "lightingDirection": [1, 1, 1],
+  "lightingAmbient": 0.35,
+  "lightingDiffuse": 0.65,
+  "lightingSpecular": 0,
+  "lightingShininess": 32,
+  "lightingTwoSided": true,
+  "axisPadding": 0.08,
+  "showAxes": true,
+  "showGrid": true,
+  "gridSteps": 4,
+  "axisColor": "#52606d",
+  "gridColor": "#d9e2ec",
+  "axisLineWidth": 1.5,
+  "gridLineWidth": 1,
+  "axisLabelFont": "600 12px system-ui, sans-serif",
+  "axisLabelOffset": 8,
+  "axisTickCount": 5,
+  "axisTickMinCount": 2,
+  "axisTickMaxCount": 12,
+  "axisTickWorldLength": 0.03,
+  "axisTickLabelFont": "11px system-ui, sans-serif",
+  "axisTickLabelOffset": 7,
+  "axisTickLabelMinGap": 4,
+  "axisTickLabelGlyphWidth": 6.5,
+  "axisTickLabelMinWidth": 7,
+  "axisTickLabelLineHeight": 12,
+  "axisTickLabelBoundsInset": 1,
+  "axisTickMaxDecimals": 12,
+  "axisTickAutoMaxDecimals": 10,
+  "axisTickScientificLowerMagnitude": 0.0001,
+  "axisTickScientificUpperMagnitude": 10000000,
+  "axisTickScientificDecimals": 3,
+  "axisTickZeroToleranceFloor": 1e-15,
+  "axisTickStepFloor": 1e-12,
+  "axisTickLineWidthScale": 0.75,
+  "axisTickMinLineWidth": 1,
+  "maxPoints": 100000,
+  "accessibilityMaxRows": 50,
+  "accessibilityIncludeTable": true,
+  "accessibilityScatter3dLabel": "Scatter3D chart",
+  "accessibilityLine3dLabel": "Line3D chart",
+  "accessibilitySurfaceLabel": "Surface chart",
+  "accessibilityMesh3dLabel": "Mesh3D chart",
+  "accessibilityCollectionLabel": "3D chart data summary",
+  "staticFallbackDescription": "Static three-dimensional chart fallback generated from the renderer-neutral scene.",
+  "staticFallbackDecimals": 6
+}

fastplotpy/defaults/surface.json

@@ -0,0 +1,35 @@
+{
+  "lowColor": "#0ea5e9",
+  "highColor": "#f97316",
+  "colorStops": [],
+  "opacity": 1,
+  "wireframeShow": false,
+  "wireframeColor": "#0f172a",
+  "wireframeWidth": 1,
+  "wireframeOpacity": 0.65,
+  "contourShow": false,
+  "contourCount": 5,
+  "contourColor": "#0f172a",
+  "contourWidth": 1.25,
+  "contourOpacity": 0.8,
+  "maxContourLevels": 32,
+  "lod": {
+    "enabled": false,
+    "strategy": "grid-stride",
+    "maxCells": 10000
+  },
+  "missingCells": "gap",
+  "maxTriangles": 200000,
+  "maxContourSegments": 500000,
+  "colorScaleLegend": true,
+  "legendWidth": 12,
+  "legendHeight": 120,
+  "legendOffset": 12,
+  "legendTitle": "z",
+  "legendTickCount": 3,
+  "legendFont": "11px system-ui, sans-serif",
+  "legendColor": "#475569",
+  "legendLabelGap": 4,
+  "legendGlyphWidth": 7,
+  "legendMinimumLabelHeight": 32
+}

fastplotpy/defaults/tooltip.json

@@ -0,0 +1,18 @@
+{
+  "enabled": false,
+  "mode": "default",
+  "lineMode": "points",
+  "shared": false,
+  "sharedXMode": "exact",
+  "radius": 8,
+  "font": "12px system-ui, sans-serif",
+  "textLineHeight": 16,
+  "textColor": "#f8fafc",
+  "fallbackDarkTextColor": "#0f172a",
+  "backgroundColor": "#0f172a",
+  "borderColor": "#1e293b",
+  "borderWidth": 1,
+  "borderRadius": 4,
+  "padding": 8,
+  "minimumContrastRatio": 4.5
+}

fastplotpy/defaults/trace-colors.json

@@ -0,0 +1,10 @@
+[
+  "#2563eb",
+  "#dc2626",
+  "#16a34a",
+  "#d97706",
+  "#7c3aed",
+  "#0891b2",
+  "#db2777",
+  "#4b5563"
+]

fastplotpy/defaults/trace-options.json

@@ -0,0 +1,24 @@
+{
+  "connectGaps": false,
+  "lineWidth": 1.5,
+  "opacity": 1,
+  "interpolation": "linear",
+  "smoothInterpolationSamplesPerSegment": 12,
+  "pattern": "solid",
+  "patternSegments": {
+    "solid": [],
+    "dashed": [8, 4],
+    "dotted": [1, 4],
+    "dash-dot": [8, 4, 1, 4]
+  },
+  "trendline": {
+    "show": false,
+    "method": "linear",
+    "degree": 2,
+    "samples": 120,
+    "minDegree": 1,
+    "maxDegree": 6,
+    "minSamples": 2,
+    "maxSamples": 512
+  }
+}

fastplotpy/defaults/wonderplot.json

@@ -0,0 +1,58 @@
+{
+  "valueScale": "linear",
+  "markerSize": 5,
+  "markerOpacity": 1,
+  "markerShape": "circle",
+  "lowColor": "#e0f2fe",
+  "highColor": "#7c3aed",
+  "colorStops": [],
+  "sizeScale": {
+    "enabled": false,
+    "minSize": 3,
+    "maxSize": 14,
+    "minValue": null,
+    "maxValue": null
+  },
+  "opacityScale": {
+    "enabled": false,
+    "minOpacity": 0.2,
+    "maxOpacity": 1,
+    "minValue": null,
+    "maxValue": null
+  },
+  "borderWidth": 0,
+  "borderColor": "rgba(15, 23, 42, 0.28)",
+  "markerLabels": {
+    "show": false,
+    "color": "#0f172a",
+    "font": "11px system-ui, sans-serif",
+    "lineHeight": 14,
+    "decimals": 0,
+    "prefix": "",
+    "suffix": "",
+    "offsetY": 6,
+      "collisionPadding": 2,
+      "formatter": null
+  },
+  "colorScaleLegend": {
+    "show": false,
+    "position": "right",
+    "title": "",
+    "width": 12,
+    "height": 128,
+    "offset": 16,
+    "tickCount": 3,
+    "tickValues": [],
+    "tickSize": 6,
+    "labelGap": 6,
+    "labelPrefix": "",
+    "labelSuffix": "",
+    "decimals": 0,
+    "font": "11px system-ui, sans-serif",
+    "color": "#475569",
+    "lineHeight": 14,
+    "titleGap": 4,
+    "borderColor": "rgba(15, 23, 42, 0.28)",
+    "borderWidth": 1
+  }
+}

fastplotpy/defaults/zoom.json

@@ -0,0 +1,12 @@
+{
+  "wheel": false,
+  "drag": false,
+  "pinch": false,
+  "mode": "xy",
+  "factor": 1.2,
+  "preventDefault": true,
+  "minDragDistance": 6,
+  "selectionFillStyle": "rgba(37, 99, 235, 0.12)",
+  "selectionStrokeStyle": "rgba(37, 99, 235, 0.8)",
+  "selectionLineWidth": 1
+}

fastplotpy/defaults.py

@@ -0,0 +1,15 @@
+"""Source-pinned configurable defaults shared by the Python chart builders."""
+
+from importlib import resources
+import json
+
+
+def get_defaults(name: str):
+    """Return a fresh copy of a fastPlotJs default JSON document."""
+    if "/" in name or "\\" in name or not name.removesuffix(".json").replace("-", "").isalnum():
+        raise ValueError("Invalid defaults name")
+    filename = name if name.endswith(".json") else f"{name}.json"
+    return json.loads(resources.files("fastplotpy").joinpath("defaults", filename).read_text(encoding="utf-8"))
+
+
+DEFAULT_TRACE_COLORS = tuple(get_defaults("trace-colors"))

fastplotpy/error_bars.py

@@ -0,0 +1,118 @@
+"""Cartesian error-bar resolution and geometry from the source contract."""
+
+from __future__ import annotations
+
+from math import isfinite
+from typing import Mapping
+
+from .defaults import get_defaults
+
+
+def _option(value, inherited, name):
+    if value is None:
+        return inherited
+    if isinstance(value, bool) or not isinstance(value, (int, float)) or not isfinite(value) or value < 0:
+        raise ValueError(f"{name} must be a finite number >= 0")
+    return value
+
+
+def resolve_error_bars(plot_value, trace_value, color):
+    defaults = get_defaults("error-bars")
+    plot_options = plot_value if isinstance(plot_value, Mapping) else {}
+    trace_options = trace_value if isinstance(trace_value, Mapping) else {}
+    plot_show = plot_value if isinstance(plot_value, bool) else plot_options.get("show", defaults["show"]) if isinstance(plot_value, Mapping) else False
+    show = trace_value if isinstance(trace_value, bool) else trace_options.get("show", defaults["show"]) if isinstance(trace_value, Mapping) else plot_show
+    plot_width = _option(plot_options.get("lineWidth"), defaults["lineWidth"], "errorBars.lineWidth")
+    plot_cap = _option(plot_options.get("capSize"), defaults["capSize"], "errorBars.capSize")
+    style = {
+        "color": trace_options.get("color") if isinstance(trace_options.get("color"), str) and trace_options["color"].strip()
+                 else plot_options.get("color") if isinstance(plot_options.get("color"), str) and plot_options["color"].strip() else color,
+        "lineWidth": _option(trace_options.get("lineWidth"), plot_width, "trace.errorBars.lineWidth"),
+        "capSize": _option(trace_options.get("capSize"), plot_cap, "trace.errorBars.capSize"),
+    }
+    return {"show": show, "x": trace_options.get("x", plot_options.get("x", defaults["x"])),
+            "y": trace_options.get("y", plot_options.get("y", defaults["y"])), "style": style}
+
+
+def endpoints(point: Mapping, dimension: str, axis: Mapping, source_index: int):
+    error = point.get(dimension + "Error")
+    if error is None:
+        return None
+    name = f"data[{source_index}].{dimension}Error"
+    if isinstance(error, bool):
+        raise ValueError(f"{name} must be a finite number >= 0")
+    if isinstance(error, (int, float)):
+        if not isfinite(error) or error < 0:
+            raise ValueError(f"{name} must be a finite number >= 0")
+        minus = plus = error
+    elif isinstance(error, Mapping):
+        minus, plus = error.get("minus"), error.get("plus")
+        if any(isinstance(value, bool) or not isinstance(value, (int, float)) or not isfinite(value) or value < 0 for value in (minus, plus)):
+            raise ValueError(f"{name} must contain finite minus/plus values >= 0")
+    else:
+        raise ValueError(f"{name} must contain finite minus/plus values >= 0")
+    if axis.get("categories"):
+        raise ValueError(f"{dimension}Error is not supported on categorical axes")
+    from .scene import _number, _scaled
+    value = _number(point[dimension], axis)
+    low, high = value - minus, value + plus
+    _scaled(low, axis)
+    _scaled(high, axis)
+    return low, high
+
+
+def error_domain_values(trace: Mapping, resolved: Mapping, x_axis: Mapping, y_axis: Mapping):
+    x_values, y_values = [], []
+    if not resolved["show"]:
+        return x_values, y_values
+    for index, point in enumerate(trace.get("data") or []):
+        if point.get("x") is None or point.get("y") is None:
+            continue
+        for dimension, axis, output in (("x", x_axis, x_values), ("y", y_axis, y_values)):
+            if resolved[dimension]:
+                value = endpoints(point, dimension, axis, index)
+                if value:
+                    output.extend(value)
+    return x_values, y_values
+
+
+def error_geometry(trace: Mapping, resolved: Mapping, x_axis: Mapping, y_axis: Mapping,
+                   x_domain: tuple[float, float], y_domain: tuple[float, float],
+                   width: float, height: float, anchors: Mapping[int, Mapping] | None = None):
+    if not resolved["show"] or not (resolved["x"] or resolved["y"]) or resolved["style"]["lineWidth"] == 0:
+        return None
+    from .scene import _number, _scaled
+    def screen(value, domain, axis, size, invert=False):
+        position = (_scaled(value, axis) - domain[0]) / max(domain[1] - domain[0], 2.220446049250313e-16) * size
+        return size - position if invert else position
+    output = []
+    for index, point in enumerate(trace.get("data") or []):
+        if point.get("x") is None or point.get("y") is None:
+            continue
+        if anchors is not None and index not in anchors:
+            continue
+        anchor = anchors[index] if anchors is not None else None
+        center_x = anchor["x"] if anchor else screen(_number(point["x"], x_axis), x_domain, x_axis, width)
+        center_y = anchor["y"] if anchor else screen(_number(point["y"], y_axis), y_domain, y_axis, height, True)
+        if not 0 <= center_x <= width or not 0 <= center_y <= height:
+            continue
+        for dimension, axis, domain, size in (("x", x_axis, x_domain, width), ("y", y_axis, y_domain, height)):
+            if not resolved[dimension]:
+                continue
+            value = endpoints(point, dimension, axis, index)
+            if not value:
+                continue
+            raw = [screen(endpoint, domain, axis, size, dimension == "y") for endpoint in value]
+            start, end = sorted(raw)
+            if end < 0 or start > size:
+                continue
+            if dimension == "x":
+                bar = {"axis": "x", "sourceIndex": index, "x1": max(0, start), "y1": center_y,
+                       "x2": min(width, end), "y2": center_y}
+            else:
+                bar = {"axis": "y", "sourceIndex": index, "x1": center_x, "y1": max(0, start),
+                       "x2": center_x, "y2": min(height, end)}
+            bar["startCap"] = 0 <= start <= size
+            bar["endCap"] = 0 <= end <= size
+            output.append(bar)
+    return output or None