zeromodel-analysis 1.1.0__tar.gz

zeromodel_analysis-1.1.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: zeromodel-analysis
+Version: 1.1.0
+Summary: ZeroModel analysis package
+Author-email: Ernan Hughes <ernanhughes@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/ernanhughes/zeromodel
+Project-URL: Repository, https://github.com/ernanhughes/zeromodel
+Project-URL: Documentation, https://ernanhughes.github.io/zeromodel/
+Keywords: visual-policy-map,vpm,policy-analysis,deterministic-analysis
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: numpy>=1.23
+Requires-Dist: zeromodel==1.1.0
+
+# zeromodel-analysis
+
+`zeromodel-analysis` contains deterministic analysis utilities for ZeroModel
+Visual Policy Map artifacts. It is the second package in the ZeroModel 1.0.13
+split and exposes its API through `zeromodel.analysis`.
+
+The package depends on the validated core distribution, `zeromodel==1.0.13`.
+Core data objects such as `ScoreTable`, `LayoutRecipe`, and `VPMArtifact` should
+be imported from `zeromodel.core`, not re-exported from this package.
+
+## Install
+
+```powershell
+python -m pip install zeromodel==1.0.13 zeromodel-analysis==1.0.13
+```
+
+## Includes
+
+- Field comparison and fuzzy field composition.
+- Hierarchical matrix reduction and pyramids.
+- PHOS packing and top-left concentration analysis.
+- Spatial optimization and optimized view generation.
+- Matrix-pattern detection and discovered views.
+- Decision manifolds and inflection-point detection.
+- Policy diagnostics and finite policy-property checking.
+- Critic, learning, and training-progress artifact builders.
+- Lightweight tracker-export adapters for training checkpoint records.
+
+## Excludes
+
+`zeromodel-analysis` deliberately excludes observation capture, vision encoders,
+video runtime/instrumentation, SQLAlchemy persistence, research orchestration,
+examples, Torch, TorchVision, Transformers, Pillow, and database runtimes.
+
+Analysis functions operate over numeric artifacts and bounded finite policies.
+They do not claim semantic reasoning, causal detection, continuous formal
+verification, or benchmark adjudication beyond the explicit deterministic
+contracts documented by each API.
+
+## Minimal Comparison
+
+```python
+import numpy as np
+
+from zeromodel.analysis import compare_fields, vpm_and
+
+baseline = np.array([[0.2, 0.8], [0.4, 0.1]])
+candidate = np.array([[0.5, 0.7], [0.4, 0.3]])
+
+comparison = compare_fields(baseline, candidate)
+intersection = vpm_and(baseline, candidate)
+```
+
+## Spatial Analysis
+
+```python
+from zeromodel.analysis import SpatialOptimizer, build_optimized_view
+from zeromodel.core import ScoreTable
+
+table = ScoreTable(
+    values=[[0.1, 1.0], [0.9, 0.2], [0.8, 0.3]],
+    row_ids=["background", "target-a", "target-b"],
+    metric_ids=["target", "noise"],
+)
+
+optimizer = SpatialOptimizer(Kc=1, Kr=2, max_evals=20)
+view = build_optimized_view(table, name="target-first", optimizer=optimizer)
+```
+
+## Finite Policy Verification
+
+```python
+from zeromodel.analysis import PolicyPropertyChecker, PolicyPropertySpec
+from zeromodel.core import LayoutRecipe, ScoreTable, build_vpm
+
+table = ScoreTable(
+    values=[[0.0, 1.0], [1.0, 0.0]],
+    row_ids=["enabled=true", "enabled=false"],
+    metric_ids=["WAIT", "ACT"],
+)
+recipe = LayoutRecipe.from_dict(
+    {
+        "version": "vpm-layout/0",
+        "name": "policy",
+        "row_order": {"kind": "source", "tie_break": "row_id"},
+        "column_order": {"kind": "source"},
+        "normalization": {"kind": "per_metric_minmax", "clip": True},
+    }
+)
+artifact = build_vpm(table, recipe)
+
+spec = PolicyPropertySpec.from_dict(
+    {
+        "id": "act_requires_enabled",
+        "version": "1",
+        "assert": {
+            "implies": [
+                {"eq": [{"var": "winner"}, "ACT"]},
+                {"eq": [{"var": "state.enabled"}, True]},
+            ]
+        },
+    }
+)
+report = PolicyPropertyChecker(artifact, action_metric_ids=("WAIT", "ACT")).check(
+    [spec]
+)
+```

zeromodel_analysis-1.1.0/README.md

@@ -0,0 +1,107 @@
+# zeromodel-analysis
+
+`zeromodel-analysis` contains deterministic analysis utilities for ZeroModel
+Visual Policy Map artifacts. It is the second package in the ZeroModel 1.0.13
+split and exposes its API through `zeromodel.analysis`.
+
+The package depends on the validated core distribution, `zeromodel==1.0.13`.
+Core data objects such as `ScoreTable`, `LayoutRecipe`, and `VPMArtifact` should
+be imported from `zeromodel.core`, not re-exported from this package.
+
+## Install
+
+```powershell
+python -m pip install zeromodel==1.0.13 zeromodel-analysis==1.0.13
+```
+
+## Includes
+
+- Field comparison and fuzzy field composition.
+- Hierarchical matrix reduction and pyramids.
+- PHOS packing and top-left concentration analysis.
+- Spatial optimization and optimized view generation.
+- Matrix-pattern detection and discovered views.
+- Decision manifolds and inflection-point detection.
+- Policy diagnostics and finite policy-property checking.
+- Critic, learning, and training-progress artifact builders.
+- Lightweight tracker-export adapters for training checkpoint records.
+
+## Excludes
+
+`zeromodel-analysis` deliberately excludes observation capture, vision encoders,
+video runtime/instrumentation, SQLAlchemy persistence, research orchestration,
+examples, Torch, TorchVision, Transformers, Pillow, and database runtimes.
+
+Analysis functions operate over numeric artifacts and bounded finite policies.
+They do not claim semantic reasoning, causal detection, continuous formal
+verification, or benchmark adjudication beyond the explicit deterministic
+contracts documented by each API.
+
+## Minimal Comparison
+
+```python
+import numpy as np
+
+from zeromodel.analysis import compare_fields, vpm_and
+
+baseline = np.array([[0.2, 0.8], [0.4, 0.1]])
+candidate = np.array([[0.5, 0.7], [0.4, 0.3]])
+
+comparison = compare_fields(baseline, candidate)
+intersection = vpm_and(baseline, candidate)
+```
+
+## Spatial Analysis
+
+```python
+from zeromodel.analysis import SpatialOptimizer, build_optimized_view
+from zeromodel.core import ScoreTable
+
+table = ScoreTable(
+    values=[[0.1, 1.0], [0.9, 0.2], [0.8, 0.3]],
+    row_ids=["background", "target-a", "target-b"],
+    metric_ids=["target", "noise"],
+)
+
+optimizer = SpatialOptimizer(Kc=1, Kr=2, max_evals=20)
+view = build_optimized_view(table, name="target-first", optimizer=optimizer)
+```
+
+## Finite Policy Verification
+
+```python
+from zeromodel.analysis import PolicyPropertyChecker, PolicyPropertySpec
+from zeromodel.core import LayoutRecipe, ScoreTable, build_vpm
+
+table = ScoreTable(
+    values=[[0.0, 1.0], [1.0, 0.0]],
+    row_ids=["enabled=true", "enabled=false"],
+    metric_ids=["WAIT", "ACT"],
+)
+recipe = LayoutRecipe.from_dict(
+    {
+        "version": "vpm-layout/0",
+        "name": "policy",
+        "row_order": {"kind": "source", "tie_break": "row_id"},
+        "column_order": {"kind": "source"},
+        "normalization": {"kind": "per_metric_minmax", "clip": True},
+    }
+)
+artifact = build_vpm(table, recipe)
+
+spec = PolicyPropertySpec.from_dict(
+    {
+        "id": "act_requires_enabled",
+        "version": "1",
+        "assert": {
+            "implies": [
+                {"eq": [{"var": "winner"}, "ACT"]},
+                {"eq": [{"var": "state.enabled"}, True]},
+            ]
+        },
+    }
+)
+report = PolicyPropertyChecker(artifact, action_metric_ids=("WAIT", "ACT")).check(
+    [spec]
+)
+```

zeromodel_analysis-1.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zeromodel-analysis"
+version = "1.1.0"
+description = "ZeroModel analysis package"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [{name = "Ernan Hughes", email = "ernanhughes@gmail.com"}]
+keywords = [
+    "visual-policy-map",
+    "vpm",
+    "policy-analysis",
+    "deterministic-analysis",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "numpy>=1.23",
+    "zeromodel==1.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/ernanhughes/zeromodel"
+Repository = "https://github.com/ernanhughes/zeromodel"
+Documentation = "https://ernanhughes.github.io/zeromodel/"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["zeromodel.analysis*"]

zeromodel_analysis-1.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zeromodel_analysis-1.1.0/src/zeromodel/analysis/__init__.py

@@ -0,0 +1,219 @@
+"""ZeroModel analysis public API."""
+
+from __future__ import annotations
+
+from .adapters.common import (
+    checkpoints_from_export,
+    load_tracker_records,
+    records_to_checkpoints,
+)
+from .adapters.jsonl import (
+    checkpoints_from_csv,
+    checkpoints_from_json,
+    checkpoints_from_jsonl,
+)
+from .adapters.tensorboard import (
+    TENSORBOARD_DEFAULT_ALIASES,
+    checkpoints_from_tensorboard_scalars,
+)
+from .adapters.trackio import (
+    TRACKIO_DEFAULT_ALIASES,
+    checkpoints_from_trackio_export,
+)
+from .adapters.wandb import (
+    WANDB_DEFAULT_ALIASES,
+    checkpoints_from_wandb_export,
+)
+from .compare import (
+    VPMComparison,
+    compare_fields,
+)
+from .compose import (
+    as_field,
+    vpm_add,
+    vpm_and,
+    vpm_not,
+    vpm_or,
+    vpm_subtract,
+    vpm_xor,
+)
+from .controller import (
+    Decision,
+    Policy,
+    Signal,
+    Thresholds,
+    VPMController,
+    VPMRow,
+    default_controller,
+)
+from .critic import (
+    CriticAssessment,
+    CriticObservation,
+    build_critic_vpm,
+    critic_recipe,
+    observations_from_critic_lines,
+)
+from .edge import (
+    TopLeftGate,
+    TopLeftGateResult,
+)
+from .hierarchy import (
+    HierarchyLevel,
+    build_pyramid,
+    reduce_blocks,
+)
+from .learning import (
+    LearningAssessment,
+    LearningObservation,
+    VALID_SPLITS,
+    build_learning_vpm,
+    learning_recipe,
+)
+from .manifold import (
+    DecisionManifold,
+    ManifoldFrame,
+    ManifoldSummary,
+    ManifoldTransition,
+    build_decision_manifold,
+    find_inflection_points,
+)
+from .patterns import (
+    MatrixPatternDetector,
+    OBJECTIVE_IDS,
+    ObjectiveResult,
+    PATTERN_CHECKER_VERSION,
+    PATTERN_METHOD,
+    PatternAnalysisSpec,
+    PatternDiscoveryArtifacts,
+    PatternReport,
+    REPORT_METRICS,
+    build_discovered_view,
+    detect_patterns,
+)
+from .phos import (
+    PHOSResult,
+    guarded_pack_artifact,
+    image_entropy,
+    pack_artifact,
+    phos_sort_pack,
+    robust01,
+    to_square,
+    top_left_concentration,
+)
+from .policy_diagnostics import (
+    CRITICALITY_METRIC_ID,
+    DECISION_MARGIN_METRIC_ID,
+    with_q_diagnostics,
+)
+from .policy_properties import (
+    CHECKER_VERSION,
+    PolicyPropertyChecker,
+    PolicyPropertyResult,
+    PolicyPropertySpec,
+    PolicyPropertyViolation,
+    PolicyVerificationReport,
+    VERIFICATION_METRICS,
+    decode_key_value_row_id,
+)
+from .spatial import (
+    SpatialOptimizationResult,
+    SpatialOptimizer,
+    build_optimized_view,
+    optimize_view_profile,
+)
+from .training import (
+    TrainingCheckpoint,
+    TrainingProgressAssessment,
+    build_training_progress_vpm,
+    training_progress_recipe,
+)
+
+__all__ = [
+    "CHECKER_VERSION",
+    "CRITICALITY_METRIC_ID",
+    "CriticAssessment",
+    "CriticObservation",
+    "DECISION_MARGIN_METRIC_ID",
+    "Decision",
+    "DecisionManifold",
+    "HierarchyLevel",
+    "LearningAssessment",
+    "LearningObservation",
+    "ManifoldFrame",
+    "ManifoldSummary",
+    "ManifoldTransition",
+    "MatrixPatternDetector",
+    "OBJECTIVE_IDS",
+    "ObjectiveResult",
+    "PATTERN_CHECKER_VERSION",
+    "PATTERN_METHOD",
+    "PHOSResult",
+    "PatternAnalysisSpec",
+    "PatternDiscoveryArtifacts",
+    "PatternReport",
+    "Policy",
+    "PolicyPropertyChecker",
+    "PolicyPropertyResult",
+    "PolicyPropertySpec",
+    "PolicyPropertyViolation",
+    "PolicyVerificationReport",
+    "REPORT_METRICS",
+    "Signal",
+    "SpatialOptimizationResult",
+    "SpatialOptimizer",
+    "TENSORBOARD_DEFAULT_ALIASES",
+    "TRACKIO_DEFAULT_ALIASES",
+    "Thresholds",
+    "TopLeftGate",
+    "TopLeftGateResult",
+    "TrainingCheckpoint",
+    "TrainingProgressAssessment",
+    "VALID_SPLITS",
+    "VERIFICATION_METRICS",
+    "VPMComparison",
+    "VPMController",
+    "VPMRow",
+    "WANDB_DEFAULT_ALIASES",
+    "as_field",
+    "build_critic_vpm",
+    "build_decision_manifold",
+    "build_discovered_view",
+    "build_learning_vpm",
+    "build_optimized_view",
+    "build_pyramid",
+    "build_training_progress_vpm",
+    "checkpoints_from_csv",
+    "checkpoints_from_export",
+    "checkpoints_from_json",
+    "checkpoints_from_jsonl",
+    "checkpoints_from_tensorboard_scalars",
+    "checkpoints_from_trackio_export",
+    "checkpoints_from_wandb_export",
+    "compare_fields",
+    "critic_recipe",
+    "decode_key_value_row_id",
+    "default_controller",
+    "detect_patterns",
+    "find_inflection_points",
+    "guarded_pack_artifact",
+    "image_entropy",
+    "learning_recipe",
+    "load_tracker_records",
+    "observations_from_critic_lines",
+    "optimize_view_profile",
+    "pack_artifact",
+    "phos_sort_pack",
+    "records_to_checkpoints",
+    "reduce_blocks",
+    "robust01",
+    "to_square",
+    "top_left_concentration",
+    "training_progress_recipe",
+    "vpm_add",
+    "vpm_and",
+    "vpm_not",
+    "vpm_or",
+    "vpm_subtract",
+    "vpm_xor",
+    "with_q_diagnostics",
+]

zeromodel_analysis-1.1.0/src/zeromodel/analysis/adapters/__init__.py

@@ -0,0 +1,29 @@
+"""Dependency-light adapters from tracker exports to ZeroModel checkpoints."""
+
+from __future__ import annotations
+
+from zeromodel.analysis.adapters.common import (
+    checkpoints_from_export,
+    load_tracker_records,
+    records_to_checkpoints,
+)
+from zeromodel.analysis.adapters.jsonl import (
+    checkpoints_from_csv,
+    checkpoints_from_json,
+    checkpoints_from_jsonl,
+)
+from zeromodel.analysis.adapters.tensorboard import checkpoints_from_tensorboard_scalars
+from zeromodel.analysis.adapters.trackio import checkpoints_from_trackio_export
+from zeromodel.analysis.adapters.wandb import checkpoints_from_wandb_export
+
+__all__ = [
+    "checkpoints_from_csv",
+    "checkpoints_from_export",
+    "checkpoints_from_json",
+    "checkpoints_from_jsonl",
+    "checkpoints_from_tensorboard_scalars",
+    "checkpoints_from_trackio_export",
+    "checkpoints_from_wandb_export",
+    "load_tracker_records",
+    "records_to_checkpoints",
+]