eb-evaluation 0.2.0__tar.gz → 0.2.2__tar.gz

eb_evaluation-0.2.2/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: eb-evaluation
+Version: 0.2.2
+Summary: Electric Barometer: DataFrame-based evaluation utilities for CWSL and related metrics.
+Author-email: "Kyle Corrie (Economistician)" <kcorrie@economistician.com>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/Economistician/eb-evaluation
+Project-URL: Repository, https://github.com/Economistician/eb-evaluation
+Project-URL: Issues, https://github.com/Economistician/eb-evaluation/issues
+Project-URL: Documentation, https://github.com/Economistician/eb-docs
+Keywords: electric-barometer,forecast-evaluation,asymmetric-loss,readiness,forecasting,pandas
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: eb-metrics<0.3,>=0.2
+Requires-Dist: eb-adapters<0.3,>=0.2
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: scikit-learn>=1.3; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Dynamic: license-file
+
+# Electric Barometer · Evaluation (`eb-evaluation`)
+
+[![CI](https://github.com/Economistician/eb-evaluation/actions/workflows/ci.yml/badge.svg)](https://github.com/Economistician/eb-evaluation/actions/workflows/ci.yml)
+![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
+![Python Versions](https://img.shields.io/pypi/pyversions/eb-evaluation)
+![PyPI](https://img.shields.io/pypi/v/eb-evaluation)
+
+Evaluation and model selection utilities for applying Electric Barometer metrics across entities, groups, and operational contexts.
+
+---
+
+## Overview
+
+`eb-evaluation` provides the evaluation and model selection layer of the Electric Barometer ecosystem. It applies metric primitives to forecasts and observations across entities, groups, and hierarchical structures, enabling consistent assessment of forecasting performance in operational settings.
+
+The package focuses on DataFrame-first evaluation workflows, including tolerance-based scoring, cost-sensitive comparison, and readiness-oriented adjustment logic. It does not define feature construction or model interfaces; instead, it consumes standardized inputs from upstream layers and produces evaluation outputs that can be used for model selection, reporting, and decision support.
+
+---
+
+## Role in the Electric Barometer Ecosystem
+
+`eb-evaluation` defines the evaluation and model selection layer used throughout the Electric Barometer ecosystem. It is responsible for applying metric primitives to forecasts and observations across entities, groups, and hierarchies, enabling consistent comparison of forecasting performance in operational contexts.
+
+This package focuses exclusively on evaluation logic, aggregation semantics, and selection workflows. It does not perform feature construction, model training, or metric definition. Those responsibilities are handled by adjacent layers that generate inputs, adapt model interfaces, or define metric behavior.
+
+By separating evaluation orchestration from metric semantics and model implementation details, `eb-evaluation` provides a stable, DataFrame-first foundation for decision-aligned model comparison and readiness assessment across heterogeneous forecasting pipelines.
+
+---
+
+## Installation
+
+`eb-evaluation` is distributed as a standard Python package.
+
+```bash
+pip install eb-evaluation
+```
+
+The package supports Python 3.10 and later.
+
+---
+
+## Core Concepts
+
+- **DataFrame-first evaluation** — Evaluation logic operates directly on tabular forecast and observation data, enabling transparent aggregation, grouping, and comparison across entities and hierarchies.
+- **Cost- and tolerance-aware scoring** — Forecast performance is assessed using metrics that reflect asymmetric cost, acceptable deviation thresholds, and operational risk rather than purely symmetric statistical error.
+- **Hierarchical and panel semantics** — Evaluation respects entity boundaries, grouping structure, and temporal alignment, ensuring correctness in multi-level forecasting environments.
+- **Model comparability** — Forecasts produced by heterogeneous models can be evaluated and compared using a consistent set of metrics and aggregation rules.
+- **Readiness-oriented selection** — Model selection emphasizes execution feasibility and operational adequacy, not just aggregate accuracy, supporting decision-aligned forecasting workflows.
+
+---
+
+## Minimal Example
+
+The example below shows how forecasts and observations can be evaluated and compared across entities using Electric Barometer metrics in a DataFrame-first workflow.
+
+```python
+import pandas as pd
+from eb_evaluation.dataframe.compare import compare_models
+
+# Example evaluation data
+df = pd.DataFrame({
+    "entity_id": ["A", "A", "B", "B"],
+    "date": pd.to_datetime(["2024-01-01", "2024-01-02"] * 2),
+    "actual": [10, 12, 7, 9],
+    "model_a": [9, 11, 8, 10],
+    "model_b": [11, 13, 6, 8],
+})
+
+# Compare models using a common evaluation contract
+results = compare_models(
+    df,
+    actual_col="actual",
+    prediction_cols=["model_a", "model_b"],
+    entity_col="entity_id",
+    time_col="date",
+)
+
+print(results)
+```
+
+---
+
+## License
+
+BSD 3-Clause License.  
+© 2025 Kyle Corrie.

eb_evaluation-0.2.2/README.md

@@ -0,0 +1,86 @@
+# Electric Barometer · Evaluation (`eb-evaluation`)
+
+[![CI](https://github.com/Economistician/eb-evaluation/actions/workflows/ci.yml/badge.svg)](https://github.com/Economistician/eb-evaluation/actions/workflows/ci.yml)
+![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
+![Python Versions](https://img.shields.io/pypi/pyversions/eb-evaluation)
+![PyPI](https://img.shields.io/pypi/v/eb-evaluation)
+
+Evaluation and model selection utilities for applying Electric Barometer metrics across entities, groups, and operational contexts.
+
+---
+
+## Overview
+
+`eb-evaluation` provides the evaluation and model selection layer of the Electric Barometer ecosystem. It applies metric primitives to forecasts and observations across entities, groups, and hierarchical structures, enabling consistent assessment of forecasting performance in operational settings.
+
+The package focuses on DataFrame-first evaluation workflows, including tolerance-based scoring, cost-sensitive comparison, and readiness-oriented adjustment logic. It does not define feature construction or model interfaces; instead, it consumes standardized inputs from upstream layers and produces evaluation outputs that can be used for model selection, reporting, and decision support.
+
+---
+
+## Role in the Electric Barometer Ecosystem
+
+`eb-evaluation` defines the evaluation and model selection layer used throughout the Electric Barometer ecosystem. It is responsible for applying metric primitives to forecasts and observations across entities, groups, and hierarchies, enabling consistent comparison of forecasting performance in operational contexts.
+
+This package focuses exclusively on evaluation logic, aggregation semantics, and selection workflows. It does not perform feature construction, model training, or metric definition. Those responsibilities are handled by adjacent layers that generate inputs, adapt model interfaces, or define metric behavior.
+
+By separating evaluation orchestration from metric semantics and model implementation details, `eb-evaluation` provides a stable, DataFrame-first foundation for decision-aligned model comparison and readiness assessment across heterogeneous forecasting pipelines.
+
+---
+
+## Installation
+
+`eb-evaluation` is distributed as a standard Python package.
+
+```bash
+pip install eb-evaluation
+```
+
+The package supports Python 3.10 and later.
+
+---
+
+## Core Concepts
+
+- **DataFrame-first evaluation** — Evaluation logic operates directly on tabular forecast and observation data, enabling transparent aggregation, grouping, and comparison across entities and hierarchies.
+- **Cost- and tolerance-aware scoring** — Forecast performance is assessed using metrics that reflect asymmetric cost, acceptable deviation thresholds, and operational risk rather than purely symmetric statistical error.
+- **Hierarchical and panel semantics** — Evaluation respects entity boundaries, grouping structure, and temporal alignment, ensuring correctness in multi-level forecasting environments.
+- **Model comparability** — Forecasts produced by heterogeneous models can be evaluated and compared using a consistent set of metrics and aggregation rules.
+- **Readiness-oriented selection** — Model selection emphasizes execution feasibility and operational adequacy, not just aggregate accuracy, supporting decision-aligned forecasting workflows.
+
+---
+
+## Minimal Example
+
+The example below shows how forecasts and observations can be evaluated and compared across entities using Electric Barometer metrics in a DataFrame-first workflow.
+
+```python
+import pandas as pd
+from eb_evaluation.dataframe.compare import compare_models
+
+# Example evaluation data
+df = pd.DataFrame({
+    "entity_id": ["A", "A", "B", "B"],
+    "date": pd.to_datetime(["2024-01-01", "2024-01-02"] * 2),
+    "actual": [10, 12, 7, 9],
+    "model_a": [9, 11, 8, 10],
+    "model_b": [11, 13, 6, 8],
+})
+
+# Compare models using a common evaluation contract
+results = compare_models(
+    df,
+    actual_col="actual",
+    prediction_cols=["model_a", "model_b"],
+    entity_col="entity_id",
+    time_col="date",
+)
+
+print(results)
+```
+
+---
+
+## License
+
+BSD 3-Clause License.  
+© 2025 Kyle Corrie.

eb_evaluation-0.2.2/pyproject.toml

@@ -0,0 +1,92 @@
+######################################
+# Project metadata
+######################################
+[project]
+name = "eb-evaluation"
+version = "0.2.2"
+description = "Electric Barometer: DataFrame-based evaluation utilities for CWSL and related metrics."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "BSD-3-Clause"
+license-files = ["LICENSE*"]
+
+authors = [
+  { name = "Kyle Corrie (Economistician)", email = "kcorrie@economistician.com" }
+]
+
+keywords = [
+  "electric-barometer",
+  "forecast-evaluation",
+  "asymmetric-loss",
+  "readiness",
+  "forecasting",
+  "pandas",
+]
+
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Operating System :: OS Independent",
+]
+
+######################################
+# Core runtime dependencies
+######################################
+dependencies = [
+  "numpy>=1.24",
+  "pandas>=2.0",
+
+  # Electric Barometer compatibility band (0.2.x)
+  "eb-metrics>=0.2,<0.3",
+  "eb-adapters>=0.2,<0.3",
+]
+
+######################################
+# Project URLs
+######################################
+[project.urls]
+Homepage = "https://github.com/Economistician/eb-evaluation"
+Repository = "https://github.com/Economistician/eb-evaluation"
+Issues = "https://github.com/Economistician/eb-evaluation/issues"
+Documentation = "https://github.com/Economistician/eb-docs"
+
+######################################
+# Optional dependencies (extras)
+######################################
+[project.optional-dependencies]
+
+# CI / test-only dependencies
+test = [
+  "pytest>=8.0",
+  "scikit-learn>=1.3",
+]
+
+# Local developer tooling
+dev = [
+  "pytest>=8.0",
+  "pytest-cov>=5.0",
+]
+
+######################################
+# Build system
+######################################
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+######################################
+# Package discovery
+######################################
+[tool.setuptools.packages.find]
+where = ["src"]
+
+######################################
+# Pytest configuration
+######################################
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+addopts = "-ra"

eb_evaluation-0.2.2/src/eb_evaluation.egg-info/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: eb-evaluation
+Version: 0.2.2
+Summary: Electric Barometer: DataFrame-based evaluation utilities for CWSL and related metrics.
+Author-email: "Kyle Corrie (Economistician)" <kcorrie@economistician.com>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/Economistician/eb-evaluation
+Project-URL: Repository, https://github.com/Economistician/eb-evaluation
+Project-URL: Issues, https://github.com/Economistician/eb-evaluation/issues
+Project-URL: Documentation, https://github.com/Economistician/eb-docs
+Keywords: electric-barometer,forecast-evaluation,asymmetric-loss,readiness,forecasting,pandas
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: eb-metrics<0.3,>=0.2
+Requires-Dist: eb-adapters<0.3,>=0.2
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: scikit-learn>=1.3; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Dynamic: license-file
+
+# Electric Barometer · Evaluation (`eb-evaluation`)
+
+[![CI](https://github.com/Economistician/eb-evaluation/actions/workflows/ci.yml/badge.svg)](https://github.com/Economistician/eb-evaluation/actions/workflows/ci.yml)
+![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
+![Python Versions](https://img.shields.io/pypi/pyversions/eb-evaluation)
+![PyPI](https://img.shields.io/pypi/v/eb-evaluation)
+
+Evaluation and model selection utilities for applying Electric Barometer metrics across entities, groups, and operational contexts.
+
+---
+
+## Overview
+
+`eb-evaluation` provides the evaluation and model selection layer of the Electric Barometer ecosystem. It applies metric primitives to forecasts and observations across entities, groups, and hierarchical structures, enabling consistent assessment of forecasting performance in operational settings.
+
+The package focuses on DataFrame-first evaluation workflows, including tolerance-based scoring, cost-sensitive comparison, and readiness-oriented adjustment logic. It does not define feature construction or model interfaces; instead, it consumes standardized inputs from upstream layers and produces evaluation outputs that can be used for model selection, reporting, and decision support.
+
+---
+
+## Role in the Electric Barometer Ecosystem
+
+`eb-evaluation` defines the evaluation and model selection layer used throughout the Electric Barometer ecosystem. It is responsible for applying metric primitives to forecasts and observations across entities, groups, and hierarchies, enabling consistent comparison of forecasting performance in operational contexts.
+
+This package focuses exclusively on evaluation logic, aggregation semantics, and selection workflows. It does not perform feature construction, model training, or metric definition. Those responsibilities are handled by adjacent layers that generate inputs, adapt model interfaces, or define metric behavior.
+
+By separating evaluation orchestration from metric semantics and model implementation details, `eb-evaluation` provides a stable, DataFrame-first foundation for decision-aligned model comparison and readiness assessment across heterogeneous forecasting pipelines.
+
+---
+
+## Installation
+
+`eb-evaluation` is distributed as a standard Python package.
+
+```bash
+pip install eb-evaluation
+```
+
+The package supports Python 3.10 and later.
+
+---
+
+## Core Concepts
+
+- **DataFrame-first evaluation** — Evaluation logic operates directly on tabular forecast and observation data, enabling transparent aggregation, grouping, and comparison across entities and hierarchies.
+- **Cost- and tolerance-aware scoring** — Forecast performance is assessed using metrics that reflect asymmetric cost, acceptable deviation thresholds, and operational risk rather than purely symmetric statistical error.
+- **Hierarchical and panel semantics** — Evaluation respects entity boundaries, grouping structure, and temporal alignment, ensuring correctness in multi-level forecasting environments.
+- **Model comparability** — Forecasts produced by heterogeneous models can be evaluated and compared using a consistent set of metrics and aggregation rules.
+- **Readiness-oriented selection** — Model selection emphasizes execution feasibility and operational adequacy, not just aggregate accuracy, supporting decision-aligned forecasting workflows.
+
+---
+
+## Minimal Example
+
+The example below shows how forecasts and observations can be evaluated and compared across entities using Electric Barometer metrics in a DataFrame-first workflow.
+
+```python
+import pandas as pd
+from eb_evaluation.dataframe.compare import compare_models
+
+# Example evaluation data
+df = pd.DataFrame({
+    "entity_id": ["A", "A", "B", "B"],
+    "date": pd.to_datetime(["2024-01-01", "2024-01-02"] * 2),
+    "actual": [10, 12, 7, 9],
+    "model_a": [9, 11, 8, 10],
+    "model_b": [11, 13, 6, 8],
+})
+
+# Compare models using a common evaluation contract
+results = compare_models(
+    df,
+    actual_col="actual",
+    prediction_cols=["model_a", "model_b"],
+    entity_col="entity_id",
+    time_col="date",
+)
+
+print(results)
+```
+
+---
+
+## License
+
+BSD 3-Clause License.  
+© 2025 Kyle Corrie.

eb_evaluation-0.2.2/src/eb_evaluation.egg-info/requires.txt

@@ -0,0 +1,12 @@
+numpy>=1.24
+pandas>=2.0
+eb-metrics<0.3,>=0.2
+eb-adapters<0.3,>=0.2
+
+[dev]
+pytest>=8.0
+pytest-cov>=5.0
+
+[test]
+pytest>=8.0
+scikit-learn>=1.3

eb_evaluation-0.2.0/PKG-INFO

@@ -1,169 +0,0 @@
-Metadata-Version: 2.4
-Name: eb-evaluation
-Version: 0.2.0
-Summary: Electric Barometer: DataFrame-based evaluation utilities for CWSL and related metrics.
-Author-email: "Kyle Corrie (Economistician)" <kcorrie@economistician.com>
-License-Expression: BSD-3-Clause
-Project-URL: Homepage, https://github.com/Economistician/eb-evaluation
-Project-URL: Repository, https://github.com/Economistician/eb-evaluation
-Project-URL: Issues, https://github.com/Economistician/eb-evaluation/issues
-Project-URL: Documentation, https://github.com/Economistician/eb-docs
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: numpy>=1.24
-Requires-Dist: pandas>=2.0
-Requires-Dist: eb-metrics>=0.1.1
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: pytest-cov>=5.0; extra == "dev"
-Dynamic: license-file
-
-# Electric Barometer Evaluation (`eb-evaluation`)
-
-![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
-![Python Versions](https://img.shields.io/badge/Python-3.10%2B-blue)
-[![Docs](https://img.shields.io/badge/docs-electric--barometer-blue)](https://economistician.github.io/eb-docs/)
-![Project Status](https://img.shields.io/badge/Status-Alpha-yellow)
-
-This repository contains the **evaluation and orchestration layer** of the
-*Electric Barometer* ecosystem.
-
-`eb-evaluation` sits above core metric implementations (`eb-metrics`) and
-provides structured tools for applying Electric Barometer concepts to
-real-world forecasting workflows, including readiness adjustment, model
-comparison, sensitivity analysis, and dataframe-based evaluation.
-
-Conceptual definitions and theoretical framing for the evaluation logic are
-maintained in the companion research repository:
-**`eb-papers`**.
-
----
-
-## Naming convention
-
-Electric Barometer packages follow standard Python packaging conventions:
-
-- **Distribution names** (used with `pip install`) use hyphens  
-  e.g. `pip install eb-evaluation`
-- **Python import paths** use underscores  
-  e.g. `import eb_evaluation`
-
-This distinction is intentional and consistent across the Electric Barometer
-ecosystem.
-
----
-
-## Role Within Electric Barometer
-
-Within the Electric Barometer ecosystem:
-
-- **`eb-papers`** defines *concepts, frameworks, and meaning*
-- **`eb-metrics`** implements *individual metrics*
-- **`eb-evaluation`** orchestrates *how metrics are applied, combined, and interpreted*
-
-This repository focuses on *evaluation logic*, not raw metric computation.
-
----
-
-## What This Library Provides
-
-- **Readiness adjustment logic** for modifying evaluation outputs based on
-  operational readiness signals
-- **Model selection and comparison utilities** grounded in asymmetric loss and
-  readiness-aware metrics
-- **Sensitivity and tolerance analysis** for cost ratios and service thresholds
-- **DataFrame-oriented evaluation tools** for entity-level and time-based analysis
-- **Feature engineering utilities** to support evaluation pipelines
-
----
-
-## Scope
-
-This repository focuses on **evaluation workflows and orchestration**, not
-low-level metric definitions.
-
-**In scope:**
-- Applying EB metrics to datasets and model outputs
-- Combining metrics into readiness-aware evaluation artifacts
-- Model comparison and selection logic
-- Sensitivity analysis and tolerance handling
-
-**Out of scope:**
-- Metric definitions and loss formulations (see `eb-metrics`)
-- Conceptual frameworks and theory (see `eb-papers`)
-- Model training or forecasting algorithms
-
----
-
-## Installation
-
-Once published, the package will be installable via PyPI:
-
-```bash
-pip install eb-evaluation
-```
-
-For development or local use:
-
-```bash
-pip install -e .
-```
-
----
-
-## Package Structure
-
-The repository follows a modern Python package layout:
-
-```text
-eb-evaluation/
-├── src/eb_evaluation/
-│   ├── adjustment/        # Readiness and evaluation adjustments
-│   ├── dataframe/         # DataFrame-based evaluation utilities
-│   ├── features/          # Feature engineering helpers
-│   ├── model_selection/   # Model comparison and selection logic
-│   └── utils/              # Shared validation and helpers
-│
-├── tests/                  # Unit tests mirroring package structure
-├── pyproject.toml          # Build and dependency configuration
-├── README.md               # Project documentation
-└── LICENSE                 # BSD-3-Clause license
-```
-
----
-
-## Relationship to Other EB Repositories
-
-- `eb-papers`  
-  Source of truth for conceptual definitions and evaluation philosophy.
-
-- `eb-metrics`  
-  Provides the metric implementations used during evaluation.
-
-- `eb-evaluation`  
-  Orchestrates evaluation workflows using adapted models.
-
-- `eb-adapters`  
-  Ensures heterogeneous models can be evaluated consistently.
-
-When discrepancies arise, conceptual intent in `eb-papers` should be treated as authoritative.
-
----
-
-## Development and Testing
-
-Tests are located under the `tests/` directory and mirror the package structure.
-
-To run the test suite:
-
-```bash
-pytest
-```
-
----
-
-## Status
-
-This package is under active development.
-Public APIs may evolve prior to the first stable release.

eb_evaluation-0.2.0/README.md

@@ -1,148 +0,0 @@
-# Electric Barometer Evaluation (`eb-evaluation`)
-
-![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
-![Python Versions](https://img.shields.io/badge/Python-3.10%2B-blue)
-[![Docs](https://img.shields.io/badge/docs-electric--barometer-blue)](https://economistician.github.io/eb-docs/)
-![Project Status](https://img.shields.io/badge/Status-Alpha-yellow)
-
-This repository contains the **evaluation and orchestration layer** of the
-*Electric Barometer* ecosystem.
-
-`eb-evaluation` sits above core metric implementations (`eb-metrics`) and
-provides structured tools for applying Electric Barometer concepts to
-real-world forecasting workflows, including readiness adjustment, model
-comparison, sensitivity analysis, and dataframe-based evaluation.
-
-Conceptual definitions and theoretical framing for the evaluation logic are
-maintained in the companion research repository:
-**`eb-papers`**.
-
----
-
-## Naming convention
-
-Electric Barometer packages follow standard Python packaging conventions:
-
-- **Distribution names** (used with `pip install`) use hyphens  
-  e.g. `pip install eb-evaluation`
-- **Python import paths** use underscores  
-  e.g. `import eb_evaluation`
-
-This distinction is intentional and consistent across the Electric Barometer
-ecosystem.
-
----
-
-## Role Within Electric Barometer
-
-Within the Electric Barometer ecosystem:
-
-- **`eb-papers`** defines *concepts, frameworks, and meaning*
-- **`eb-metrics`** implements *individual metrics*
-- **`eb-evaluation`** orchestrates *how metrics are applied, combined, and interpreted*
-
-This repository focuses on *evaluation logic*, not raw metric computation.
-
----
-
-## What This Library Provides
-
-- **Readiness adjustment logic** for modifying evaluation outputs based on
-  operational readiness signals
-- **Model selection and comparison utilities** grounded in asymmetric loss and
-  readiness-aware metrics
-- **Sensitivity and tolerance analysis** for cost ratios and service thresholds
-- **DataFrame-oriented evaluation tools** for entity-level and time-based analysis
-- **Feature engineering utilities** to support evaluation pipelines
-
----
-
-## Scope
-
-This repository focuses on **evaluation workflows and orchestration**, not
-low-level metric definitions.
-
-**In scope:**
-- Applying EB metrics to datasets and model outputs
-- Combining metrics into readiness-aware evaluation artifacts
-- Model comparison and selection logic
-- Sensitivity analysis and tolerance handling
-
-**Out of scope:**
-- Metric definitions and loss formulations (see `eb-metrics`)
-- Conceptual frameworks and theory (see `eb-papers`)
-- Model training or forecasting algorithms
-
----
-
-## Installation
-
-Once published, the package will be installable via PyPI:
-
-```bash
-pip install eb-evaluation
-```
-
-For development or local use:
-
-```bash
-pip install -e .
-```
-
----
-
-## Package Structure
-
-The repository follows a modern Python package layout:
-
-```text
-eb-evaluation/
-├── src/eb_evaluation/
-│   ├── adjustment/        # Readiness and evaluation adjustments
-│   ├── dataframe/         # DataFrame-based evaluation utilities
-│   ├── features/          # Feature engineering helpers
-│   ├── model_selection/   # Model comparison and selection logic
-│   └── utils/              # Shared validation and helpers
-│
-├── tests/                  # Unit tests mirroring package structure
-├── pyproject.toml          # Build and dependency configuration
-├── README.md               # Project documentation
-└── LICENSE                 # BSD-3-Clause license
-```
-
----
-
-## Relationship to Other EB Repositories
-
-- `eb-papers`  
-  Source of truth for conceptual definitions and evaluation philosophy.
-
-- `eb-metrics`  
-  Provides the metric implementations used during evaluation.
-
-- `eb-evaluation`  
-  Orchestrates evaluation workflows using adapted models.
-
-- `eb-adapters`  
-  Ensures heterogeneous models can be evaluated consistently.
-
-When discrepancies arise, conceptual intent in `eb-papers` should be treated as authoritative.
-
----
-
-## Development and Testing
-
-Tests are located under the `tests/` directory and mirror the package structure.
-
-To run the test suite:
-
-```bash
-pytest
-```
-
----
-
-## Status
-
-This package is under active development.
-Public APIs may evolve prior to the first stable release.

eb_evaluation-0.2.0/pyproject.toml

@@ -1,41 +0,0 @@
-[project]
-name = "eb-evaluation"
-version = "0.2.0"
-description = "Electric Barometer: DataFrame-based evaluation utilities for CWSL and related metrics."
-readme = "README.md"
-requires-python = ">=3.10"
-license = "BSD-3-Clause"
-license-files = ["LICENSE*"]
-
-authors = [
-  { name = "Kyle Corrie (Economistician)", email = "kcorrie@economistician.com" }
-]
-
-dependencies = [
-  "numpy>=1.24",
-  "pandas>=2.0",
-  "eb-metrics>=0.1.1",
-]
-
-[project.urls]
-Homepage = "https://github.com/Economistician/eb-evaluation"
-Repository = "https://github.com/Economistician/eb-evaluation"
-Issues = "https://github.com/Economistician/eb-evaluation/issues"
-Documentation = "https://github.com/Economistician/eb-docs"
-
-[project.optional-dependencies]
-dev = [
-  "pytest>=8.0",
-  "pytest-cov>=5.0",
-]
-
-[build-system]
-requires = ["setuptools>=64", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[tool.setuptools.packages.find]
-where = ["src"]
-
-[tool.pytest.ini_options]
-pythonpath = ["src"]
-addopts = "-ra"

eb_evaluation-0.2.0/src/eb_evaluation.egg-info/PKG-INFO

@@ -1,169 +0,0 @@
-Metadata-Version: 2.4
-Name: eb-evaluation
-Version: 0.2.0
-Summary: Electric Barometer: DataFrame-based evaluation utilities for CWSL and related metrics.
-Author-email: "Kyle Corrie (Economistician)" <kcorrie@economistician.com>
-License-Expression: BSD-3-Clause
-Project-URL: Homepage, https://github.com/Economistician/eb-evaluation
-Project-URL: Repository, https://github.com/Economistician/eb-evaluation
-Project-URL: Issues, https://github.com/Economistician/eb-evaluation/issues
-Project-URL: Documentation, https://github.com/Economistician/eb-docs
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: numpy>=1.24
-Requires-Dist: pandas>=2.0
-Requires-Dist: eb-metrics>=0.1.1
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: pytest-cov>=5.0; extra == "dev"
-Dynamic: license-file
-
-# Electric Barometer Evaluation (`eb-evaluation`)
-
-![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)
-![Python Versions](https://img.shields.io/badge/Python-3.10%2B-blue)
-[![Docs](https://img.shields.io/badge/docs-electric--barometer-blue)](https://economistician.github.io/eb-docs/)
-![Project Status](https://img.shields.io/badge/Status-Alpha-yellow)
-
-This repository contains the **evaluation and orchestration layer** of the
-*Electric Barometer* ecosystem.
-
-`eb-evaluation` sits above core metric implementations (`eb-metrics`) and
-provides structured tools for applying Electric Barometer concepts to
-real-world forecasting workflows, including readiness adjustment, model
-comparison, sensitivity analysis, and dataframe-based evaluation.
-
-Conceptual definitions and theoretical framing for the evaluation logic are
-maintained in the companion research repository:
-**`eb-papers`**.
-
----
-
-## Naming convention
-
-Electric Barometer packages follow standard Python packaging conventions:
-
-- **Distribution names** (used with `pip install`) use hyphens  
-  e.g. `pip install eb-evaluation`
-- **Python import paths** use underscores  
-  e.g. `import eb_evaluation`
-
-This distinction is intentional and consistent across the Electric Barometer
-ecosystem.
-
----
-
-## Role Within Electric Barometer
-
-Within the Electric Barometer ecosystem:
-
-- **`eb-papers`** defines *concepts, frameworks, and meaning*
-- **`eb-metrics`** implements *individual metrics*
-- **`eb-evaluation`** orchestrates *how metrics are applied, combined, and interpreted*
-
-This repository focuses on *evaluation logic*, not raw metric computation.
-
----
-
-## What This Library Provides
-
-- **Readiness adjustment logic** for modifying evaluation outputs based on
-  operational readiness signals
-- **Model selection and comparison utilities** grounded in asymmetric loss and
-  readiness-aware metrics
-- **Sensitivity and tolerance analysis** for cost ratios and service thresholds
-- **DataFrame-oriented evaluation tools** for entity-level and time-based analysis
-- **Feature engineering utilities** to support evaluation pipelines
-
----
-
-## Scope
-
-This repository focuses on **evaluation workflows and orchestration**, not
-low-level metric definitions.
-
-**In scope:**
-- Applying EB metrics to datasets and model outputs
-- Combining metrics into readiness-aware evaluation artifacts
-- Model comparison and selection logic
-- Sensitivity analysis and tolerance handling
-
-**Out of scope:**
-- Metric definitions and loss formulations (see `eb-metrics`)
-- Conceptual frameworks and theory (see `eb-papers`)
-- Model training or forecasting algorithms
-
----
-
-## Installation
-
-Once published, the package will be installable via PyPI:
-
-```bash
-pip install eb-evaluation
-```
-
-For development or local use:
-
-```bash
-pip install -e .
-```
-
----
-
-## Package Structure
-
-The repository follows a modern Python package layout:
-
-```text
-eb-evaluation/
-├── src/eb_evaluation/
-│   ├── adjustment/        # Readiness and evaluation adjustments
-│   ├── dataframe/         # DataFrame-based evaluation utilities
-│   ├── features/          # Feature engineering helpers
-│   ├── model_selection/   # Model comparison and selection logic
-│   └── utils/              # Shared validation and helpers
-│
-├── tests/                  # Unit tests mirroring package structure
-├── pyproject.toml          # Build and dependency configuration
-├── README.md               # Project documentation
-└── LICENSE                 # BSD-3-Clause license
-```
-
----
-
-## Relationship to Other EB Repositories
-
-- `eb-papers`  
-  Source of truth for conceptual definitions and evaluation philosophy.
-
-- `eb-metrics`  
-  Provides the metric implementations used during evaluation.
-
-- `eb-evaluation`  
-  Orchestrates evaluation workflows using adapted models.
-
-- `eb-adapters`  
-  Ensures heterogeneous models can be evaluated consistently.
-
-When discrepancies arise, conceptual intent in `eb-papers` should be treated as authoritative.
-
----
-
-## Development and Testing
-
-Tests are located under the `tests/` directory and mirror the package structure.
-
-To run the test suite:
-
-```bash
-pytest
-```
-
----
-
-## Status
-
-This package is under active development.
-Public APIs may evolve prior to the first stable release.

eb_evaluation-0.2.0/src/eb_evaluation.egg-info/requires.txt

@@ -1,7 +0,0 @@
-numpy>=1.24
-pandas>=2.0
-eb-metrics>=0.1.1
-
-[dev]
-pytest>=8.0
-pytest-cov>=5.0