Jira progress: loading…

CALC

Calculation Engines

1. Overview

Calculation Engines (CALC) are micro-engines within the ZAYAZ Computation Hub responsible for performing primary computations from raw input data.

CALC engines produce the first-order quantitative results used throughout the platform (e.g. emissions, intensities, scores, indicators).

CALC is an engine type within the MICE taxonomy.
Concrete implementations are registered as micro-engine instances (MEIDs) that implement the CALC type.

2. Design Principles

1. Deterministic Computation
   Given identical inputs and configuration, a CALC engine must always produce the same output.

2. Explicit Logic
   All formulas, coefficients, and logic paths must be explicit and versioned.

3. Input-Bound Responsibility
   CALC engines operate directly on raw or pre-validated inputs, not on derived results.

3. Scope of Responsibility

What CALC Engines Do

• Compute quantitative values from input datasets
• Apply domain-specific formulas or algorithms
• Produce structured, schema-validated outputs

Examples:

• GHG emissions calculation
• Water withdrawal totals
• Energy intensity metrics
• Risk or performance scores

4. What CALC Engines Do Not Do

• ❌ Structural validation (VALI)
• ❌ Unit or format conversion (TRFM)
• ❌ Aggregation or roll-ups (AGGR)
• ❌ Estimation of missing data (SEM)
• ❌ Policy enforcement or routing (TRPG / ZADIF)

5. Inputs

• Raw input payloads (activity data, measurements, financials)
• Calculation parameters and method options
• Contextual metadata (scope, boundaries)

All inputs must conform to declared input schemas.

6. Outputs

• Computed result payload
• Declared unit and metric semantics
• Execution metadata and provenance hooks

Outputs from CALC engines are typically consumed by:

• VALI
• TRFM
• AGGR
• SEM (when gaps exist)

7. Canonical Identification

• Engine Type: CALC
• USO Code: CALC
• Category: Micro Engine (MICE)

8. Related Engine Types

• VALI — Validation Engines
• TRFM — Transformation Engines
• AGGR — Aggregation Engines
• SEM — Stochastic Extrapolation Module

---

Status: Stable
Owner: Computation Hub / MICE