multidimensional-evaluation-engine 0.1.1

Core engine for multidimensional evaluation under explicit policy assumptions.

multidimensional-evaluation-engine

A domain-neutral engine for multidimensional evaluation under explicit policy assumptions.

What the Engine Does

The engine:

• applies a configurable policy
• evaluates candidate configurations
• computes weighted scores across dimensions
• interprets scores into qualitative levels
• supports structured comparison across alternative designs

The system is designed to make assumptions explicit and results inspectable.

Important Note

This project does not advocate for a specific solution.

It provides a structured way to examine:

• how design choices affect outcomes
• where tradeoffs become significant
• how governance assumptions shape results

This Project

This project provides a reusable framework for multidimensional evaluation under explicit assumptions and constraints. It:

• supports policy-driven evaluation across multiple domains
• makes tradeoffs visible through configurable dimensions, scales, and weights
• separates evaluation logic from domain-specific explorer interfaces

The goal is to provide a stable core that can support multiple exploratory systems built on a shared evaluation model.

Contribution

The contribution is the engine for structured multidimensional evaluation, not the specific values used in any given scenario.

• Dimensions, scales, weights, and thresholds are configurable
• Assumptions are explicit and inspectable
• Results are comparative and scenario-dependent
• The core logic is domain-neutral

This project does not determine outcomes or recommend decisions. It provides a way to examine how different assumptions and constraints shape results.

Working Files

Working files are found in these areas:

• docs/ - documentation and examples
• src/ - implementation

Capabilities

• Loads policy configuration structures
• Evaluates candidate configurations across weighted dimensions
• Computes score profiles and qualitative levels
• Supports reusable integration into domain-specific explorer systems

Command Reference

Show command reference

In a machine terminal (open in your Repos folder)

After you get a copy of this repo in your own GitHub account, open a machine terminal in your Repos folder:

# Replace username with YOUR GitHub username.
git clone https://github.com/username/multidimensional-evaluation-engine

cd multidimensional-evaluation-engine
code .

In a VS Code terminal

uv self update
uv python pin 3.14
uv sync --extra dev --extra docs --upgrade

uvx pre-commit install
git add -A
uvx pre-commit run --all-files
# repeat if changes were made
git add -A
uvx pre-commit run --all-files

uv run ruff format --check .
uv run ruff check .
uv run pytest --cov=src --cov-report=term-missing

uv run deptry .
uv run bandit -c pyproject.toml -r src
uv run validate-pyproject pyproject.toml
uv run zensical build

git add -A
git commit -m "update"
git push -u origin main


uv sync --reinstall

uv run python -c "import multidimensional_evaluation_engine; print(multidimensional_evaluation_engine.__version__)"

uv run python -c "from multidimensional_evaluation_engine.evaluation.evaluator import evaluate_candidate; print(evaluate_candidate)"

Annotations

ANNOTATIONS.md

Citation

CITATION.cff

License

MIT

SE Manifest

SE_MANIFEST.md