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

scitex/fts/_schemas/node.schema.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://scitex.ai/schemas/fts/node.schema.json",
+  "title": "FTS Node Schema",
+  "description": "Schema for FTS bundle node specification",
+  "type": "object",
+  "required": ["id", "kind", "bbox_norm"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique identifier (UUID) for this node"
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["figure", "plot", "table", "stats", "text", "shape", "image"],
+      "description": "Node kind: figure (composite), plot/table/stats/text/shape/image (leaf)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable name"
+    },
+    "scitex_schema": {
+      "type": "string",
+      "description": "Schema identifier",
+      "default": "scitex.fts.spec"
+    },
+    "scitex_schema_version": {
+      "type": "string",
+      "description": "Schema version",
+      "default": "1.0.0"
+    },
+    "bbox_norm": {
+      "type": "object",
+      "description": "Bounding box in normalized coordinates (0-1)",
+      "required": ["x0", "y0", "x1", "y1"],
+      "properties": {
+        "x0": {"type": "number", "minimum": 0, "maximum": 1},
+        "y0": {"type": "number", "minimum": 0, "maximum": 1},
+        "x1": {"type": "number", "minimum": 0, "maximum": 1},
+        "y1": {"type": "number", "minimum": 0, "maximum": 1}
+      }
+    },
+    "size_mm": {
+      "type": "object",
+      "description": "Physical size in millimeters",
+      "properties": {
+        "width": {"type": "number", "minimum": 0},
+        "height": {"type": "number", "minimum": 0}
+      }
+    },
+    "axes": {
+      "type": "object",
+      "description": "Axis configuration (for plot nodes)",
+      "properties": {
+        "xlim": {
+          "type": "array",
+          "items": {"type": "number"},
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "ylim": {
+          "type": "array",
+          "items": {"type": "number"},
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "xscale": {"type": "string", "enum": ["linear", "log", "symlog"]},
+        "yscale": {"type": "string", "enum": ["linear", "log", "symlog"]},
+        "xlabel": {"type": "string"},
+        "ylabel": {"type": "string"}
+      }
+    },
+    "children": {
+      "type": "array",
+      "description": "Child node references (for figure composite kind only)",
+      "items": {"type": "string"}
+    },
+    "layout": {
+      "type": "object",
+      "description": "Layout configuration for composite figures",
+      "properties": {
+        "rows": {"type": "integer", "minimum": 1},
+        "cols": {"type": "integer", "minimum": 1},
+        "panels": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "child": {"type": "string"},
+              "child_id": {"type": "string"},
+              "label": {"type": "string"},
+              "row": {"type": "integer"},
+              "col": {"type": "integer"},
+              "row_span": {"type": "integer", "default": 1},
+              "col_span": {"type": "integer", "default": 1}
+            }
+          }
+        }
+      }
+    },
+    "payload_schema": {
+      "type": "string",
+      "description": "Payload schema for leaf kinds (e.g., scitex.fts.payload.plot@1)"
+    },
+    "text": {
+      "type": "object",
+      "description": "Text content (for kind=text)",
+      "properties": {
+        "content": {"type": "string"},
+        "fontsize": {"type": "number"},
+        "fontweight": {"type": "string"},
+        "ha": {"type": "string", "enum": ["left", "center", "right"]},
+        "va": {"type": "string", "enum": ["top", "center", "bottom"]}
+      }
+    },
+    "shape": {
+      "type": "object",
+      "description": "Shape parameters (for kind=shape)",
+      "properties": {
+        "shape_type": {"type": "string", "enum": ["rectangle", "ellipse", "arrow", "line"]},
+        "color": {"type": "string"},
+        "linewidth": {"type": "number"},
+        "fill": {"type": "boolean"}
+      }
+    },
+    "refs": {
+      "type": "object",
+      "description": "References to associated files",
+      "properties": {
+        "encoding": {"type": "string"},
+        "theme": {"type": "string"},
+        "data": {"type": "string"},
+        "stats": {"type": "string"}
+      }
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "modified_at": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}

scitex/fts/_schemas/render_manifest.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://scitex.ai/schemas/fts/render_manifest.schema.json",
+  "title": "FTS Render Manifest Schema",
+  "description": "Schema for render/export settings (cache - regenerable)",
+  "type": "object",
+  "properties": {
+    "dpi": {
+      "type": "integer",
+      "minimum": 72,
+      "maximum": 1200,
+      "default": 300,
+      "description": "Resolution in dots per inch"
+    },
+    "size_mm": {
+      "type": "object",
+      "properties": {
+        "width": {"type": "number", "minimum": 0},
+        "height": {"type": "number", "minimum": 0}
+      }
+    },
+    "size_px": {
+      "type": "object",
+      "description": "Derived from size_mm and dpi",
+      "properties": {
+        "width": {"type": "integer", "minimum": 0},
+        "height": {"type": "integer", "minimum": 0}
+      }
+    },
+    "formats": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["png", "svg", "pdf", "eps", "tiff"]
+      },
+      "default": ["png", "svg", "pdf"]
+    },
+    "backend": {
+      "type": "string",
+      "enum": ["matplotlib", "plotly", "bokeh", "altair"],
+      "default": "matplotlib"
+    },
+    "options": {
+      "type": "object",
+      "properties": {
+        "bbox_inches": {"type": "string", "default": "tight"},
+        "pad_inches": {"type": "number", "default": 0.1},
+        "transparent": {"type": "boolean", "default": false},
+        "facecolor": {"type": "string"},
+        "edgecolor": {"type": "string"}
+      }
+    },
+    "rendered_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "render_time_ms": {
+      "type": "number",
+      "description": "Time taken to render in milliseconds"
+    }
+  }
+}

scitex/fts/_schemas/stats.schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://scitex.ai/schemas/fts/stats.schema.json",
+  "title": "FTS Stats Schema",
+  "description": "Schema for statistical analysis results with full reproducibility",
+  "type": "object",
+  "properties": {
+    "analyses": {
+      "type": "array",
+      "description": "List of statistical analyses",
+      "items": {
+        "type": "object",
+        "required": ["result_id", "method", "inputs", "results"],
+        "properties": {
+          "result_id": {
+            "type": "string",
+            "description": "Unique identifier for referencing this result"
+          },
+          "method": {
+            "type": "object",
+            "required": ["name"],
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Statistical test name (e.g., 't-test', 'ANOVA', 'Mann-Whitney')"
+              },
+              "variant": {
+                "type": "string",
+                "description": "Specific variant (e.g., 'paired', 'independent', 'one-way')"
+              },
+              "parameters": {
+                "type": "object",
+                "description": "Test-specific parameters"
+              },
+              "correction": {
+                "type": "object",
+                "description": "Multiple comparison correction",
+                "properties": {
+                  "method": {"type": "string", "enum": ["none", "bonferroni", "holm", "fdr_bh", "fdr_by"]},
+                  "n_comparisons": {"type": "integer", "minimum": 1}
+                }
+              }
+            }
+          },
+          "inputs": {
+            "type": "object",
+            "description": "Input data references for reproducibility",
+            "properties": {
+              "data_refs": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "path": {"type": "string"},
+                    "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+                    "columns": {"type": "array", "items": {"type": "string"}},
+                    "filter": {"type": "string", "description": "Filter expression applied"}
+                  }
+                }
+              },
+              "groups": {
+                "type": "array",
+                "items": {"type": "string"}
+              },
+              "n_per_group": {
+                "type": "array",
+                "items": {"type": "integer", "minimum": 0}
+              }
+            }
+          },
+          "results": {
+            "type": "object",
+            "properties": {
+              "statistic": {"type": "number"},
+              "statistic_name": {"type": "string", "description": "e.g., 't', 'F', 'U', 'chi2'"},
+              "p_value": {"type": "number", "minimum": 0, "maximum": 1},
+              "p_corrected": {"type": "number", "minimum": 0, "maximum": 1},
+              "df": {"type": ["number", "array"], "description": "Degrees of freedom"},
+              "effect_size": {
+                "type": "object",
+                "properties": {
+                  "name": {"type": "string", "description": "e.g., 'cohens_d', 'eta_squared', 'r'"},
+                  "value": {"type": "number"},
+                  "ci_lower": {"type": "number"},
+                  "ci_upper": {"type": "number"}
+                }
+              },
+              "ci": {
+                "type": "object",
+                "description": "Confidence interval for difference",
+                "properties": {
+                  "level": {"type": "number", "default": 0.95},
+                  "lower": {"type": "number"},
+                  "upper": {"type": "number"}
+                }
+              },
+              "power": {"type": "number", "minimum": 0, "maximum": 1}
+            }
+          },
+          "display": {
+            "type": "object",
+            "description": "How to display this result in the figure",
+            "properties": {
+              "significance_label": {
+                "type": "string",
+                "description": "e.g., '***', 'n.s.', 'p < 0.001'"
+              },
+              "bracket": {
+                "type": "object",
+                "properties": {
+                  "start": {"type": "string", "description": "Element ID or position"},
+                  "end": {"type": "string"}
+                }
+              }
+            }
+          },
+          "created_at": {"type": "string", "format": "date-time"}
+        }
+      }
+    },
+    "software": {
+      "type": "object",
+      "description": "Software versions for reproducibility",
+      "properties": {
+        "python": {"type": "string"},
+        "scipy": {"type": "string"},
+        "statsmodels": {"type": "string"},
+        "fsb": {"type": "string"}
+      }
+    }
+  }
+}

scitex/fts/_schemas/theme.schema.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://scitex.ai/schemas/fts/theme.schema.json",
+  "title": "FTS Theme Schema",
+  "description": "Schema for visual aesthetics (decorative properties that don't affect data meaning)",
+  "type": "object",
+  "properties": {
+    "mode": {
+      "type": "string",
+      "enum": ["light", "dark"],
+      "default": "light",
+      "description": "Color mode for the theme"
+    },
+    "preset": {
+      "type": "string",
+      "enum": ["nature", "science", "cell", "ieee", "acs", "minimal", "presentation"],
+      "description": "Named preset for journal-specific styling"
+    },
+    "colors": {
+      "type": "object",
+      "description": "Color palette configuration",
+      "properties": {
+        "palette": {
+          "type": "array",
+          "items": {"type": "string"},
+          "description": "Color cycle for multiple traces"
+        },
+        "primary": {"type": "string", "description": "Primary accent color"},
+        "secondary": {"type": "string", "description": "Secondary accent color"},
+        "background": {"type": "string", "default": "#ffffff"},
+        "text": {"type": "string", "default": "#000000"},
+        "axis": {"type": "string", "default": "#333333"},
+        "grid": {"type": "string", "default": "#e0e0e0"}
+      }
+    },
+    "typography": {
+      "type": "object",
+      "description": "Font configuration",
+      "properties": {
+        "family": {"type": "string", "default": "sans-serif"},
+        "size_pt": {"type": "number", "minimum": 1, "default": 8},
+        "title_size_pt": {"type": "number", "minimum": 1, "default": 10},
+        "label_size_pt": {"type": "number", "minimum": 1, "default": 8},
+        "tick_size_pt": {"type": "number", "minimum": 1, "default": 7}
+      }
+    },
+    "fonts": {
+      "type": "object",
+      "description": "Alternative font configuration (alias for typography)",
+      "properties": {
+        "family": {"type": "string"},
+        "title_size": {"type": "number"},
+        "label_size": {"type": "number"},
+        "tick_size": {"type": "number"}
+      }
+    },
+    "lines": {
+      "type": "object",
+      "description": "Line style configuration",
+      "properties": {
+        "width_pt": {"type": "number", "minimum": 0, "default": 1},
+        "style": {"type": "string", "enum": ["solid", "dashed", "dotted", "dashdot"], "default": "solid"}
+      }
+    },
+    "markers": {
+      "type": "object",
+      "description": "Marker style configuration",
+      "properties": {
+        "size_pt": {"type": "number", "minimum": 0, "default": 4},
+        "symbol": {"type": "string", "enum": ["circle", "square", "triangle", "cross", "diamond"], "default": "circle"}
+      }
+    },
+    "grid": {
+      "type": "object",
+      "description": "Grid line configuration",
+      "properties": {
+        "show": {"type": "boolean", "default": true},
+        "major_width_pt": {"type": "number", "default": 0.5},
+        "minor_width_pt": {"type": "number", "default": 0.25},
+        "major_alpha": {"type": "number", "minimum": 0, "maximum": 1, "default": 0.3},
+        "minor_alpha": {"type": "number", "minimum": 0, "maximum": 1, "default": 0.1}
+      }
+    },
+    "traces": {
+      "type": "array",
+      "description": "Per-trace style overrides",
+      "items": {
+        "type": "object",
+        "required": ["trace_id"],
+        "properties": {
+          "trace_id": {"type": "string"},
+          "color": {"type": "string"},
+          "line_width_pt": {"type": "number"},
+          "marker_size_pt": {"type": "number"},
+          "alpha": {"type": "number", "minimum": 0, "maximum": 1}
+        }
+      }
+    },
+    "figure_title": {
+      "type": "object",
+      "description": "Figure title configuration for publications",
+      "properties": {
+        "text": {"type": "string", "description": "Title text"},
+        "prefix": {"type": "string", "default": "Figure", "description": "Prefix (e.g., 'Figure', 'Fig.')"},
+        "number": {"type": "integer", "description": "Figure number"},
+        "fontsize": {"type": "number"},
+        "fontweight": {"type": "string", "enum": ["normal", "bold"]}
+      }
+    },
+    "caption": {
+      "type": "object",
+      "description": "Figure caption for publications",
+      "properties": {
+        "text": {"type": "string", "description": "Main caption text"},
+        "panels": {
+          "type": "array",
+          "description": "Per-panel descriptions",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {"type": "string", "description": "Panel label (A, B, C, etc.)"},
+              "description": {"type": "string", "description": "Panel description"}
+            }
+          }
+        }
+      }
+    },
+    "panel_labels": {
+      "type": "object",
+      "description": "Panel label styling (A, B, C, etc.)",
+      "properties": {
+        "style": {"type": "string", "enum": ["uppercase", "lowercase", "numeric"], "default": "uppercase"},
+        "fontsize": {"type": "number", "default": 12},
+        "fontweight": {"type": "string", "enum": ["normal", "bold"], "default": "bold"},
+        "position": {"type": "string", "enum": ["top-left", "top-right", "bottom-left", "bottom-right"], "default": "top-left"},
+        "offset_x": {"type": "number", "default": 0.02},
+        "offset_y": {"type": "number", "default": 0.98}
+      }
+    }
+  }
+}

scitex/fts/_stats/__init__.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+# Timestamp: 2025-12-20
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/fts/_stats/__init__.py
+
+"""FTS Stats - Statistics dataclasses with GUI support."""
+
+# Public dataclasses
+from ._dataclasses import (
+    STATS_VERSION,
+    Stats,
+    # Type aliases
+    PositionMode,
+    UnitType,
+    SymbolStyle,
+    # GUI classes
+    Position,
+    StatStyling,
+    StatPositioning,
+    # Core classes
+    DataRef,
+    EffectSize,
+    StatMethod,
+    StatResult,
+    StatDisplay,
+    Analysis,
+)
+
+__all__ = [
+    "STATS_VERSION",
+    "Stats",
+    # Type aliases
+    "PositionMode",
+    "UnitType",
+    "SymbolStyle",
+    # GUI classes
+    "Position",
+    "StatStyling",
+    "StatPositioning",
+    # Core classes
+    "DataRef",
+    "EffectSize",
+    "StatMethod",
+    "StatResult",
+    "StatDisplay",
+    "Analysis",
+]
+
+# EOF