Guth
NewsDocs
Page actions
View as Markdown ↗
Explore MCP tools ↗

instrument implementation / implementation-contract

Elevation/Altitude Cooking Adjustment Calculator implementation

A source-bound implementation contract for Elevation/Altitude Cooking Adjustment Calculator; deployment and executable qualification remain separate.

Status: VERIFIED_CLEANLifecycle: implementation-contract

Binding contract

This record describes what an executable surface must bind and validate. It does not claim that a public calculator, package, or production route is deployed.

Record owner
Guth Instruments
Lifecycle
verified-clean
Evidence ID
t7-112
Effect
Computation or source lookup only

Input and validation requirements

  • Division-by-zero or invalid results can occur if an implementation attempts to interpolate with identical elevation-table breakpoints.
  • Negative or nonsensical adjusted leavening can result when a percentage reduction is applied without constraining the result to a nonnegative amount.
  • Altitude alone does not determine atmospheric pressure; weather systems can shift boiling point and effective altitude.
  • Unit confusion between feet and meters can produce severe errors; the input schema should require an explicit unit.
  • A blanket liquid adjustment can overhydrate or underhydrate recipes because required compensation varies by ingredients and recipe scale.
  • A blanket time reduction or increase is unsafe without a defined recipe class, original bake time, and source rule.
  • Oven temperature adjustments should account for oven calibration and whether the recipe temperature is conventional, fan-assisted, or convection.

Required corrections

No binding erratum is attached to this unique-name record. Implementers must still preserve the declared units, domain, and failure behavior.

Inspectable interface fixture

The sample below is evidence for interface and validation tests, not a production implementation.

{
  "inputs": {
    "elevation": 0,
    "elevation_unit": "ft",
    "original_oven_temperature_F": 350,
    "original_leavening_tsp": 2,
    "original_liquid_ml": 240,
    "original_baking_time_min": 30
  },
  "expected_outputs": {
    "water_boiling_point_F": 212,
    "water_boiling_point_C": 100,
    "water_saturation_pressure_kPa": 101.325,
    "adjusted_oven_temperature_F": 350,
    "adjusted_leavening_tsp": 2,
    "adjusted_liquid_ml": 240,
    "baking_time_suggestion_min": null
  },
  "reference_data": {
    "water_boiling_point_sea_level": {
      "elevation_ft": 0,
      "temperature_F": 212,
      "temperature_C": 100,
      "saturation_pressure_kPa": 101.325,
      "source_convention": "widely memorized standard water reference at 1 atm; 100 °C = 212 °F and 101.325 kPa"
    },
    "no_adjustment_band": {
      "elevation_range_ft": "0-2999",
      "oven_delta_F": 0,
      "leavening_multiplier": 1,
      "liquid_delta_ml": 0,
      "source_convention": "widely published Colorado State University Extension/King Arthur empirical high-altitude guideline convention; exact source edition not specified"
    }
  },
  "working": "Elevation = 0 ft, so the sea-level table row applies directly. Boiling point = 212°F = (212 - 32) × 5/9 = 100°C. Standard pressure = 101.325 kPa. In the 0-2999 ft guideline band: oven adjustment = 0°F, so 350 + 0 = 350°F; leavening = 2 × 1 = 2 tsp; liquid = 240 + 0 = 240 mL. Baking-time adjustment is not computable because the specification supplies no time formula, so the result is null."
}

Other records

Sources and evidence

These pointers bind the page to evidence. They do not grant authority or collapse verification into deployment.

  • VERIFIED_LEDGER.json
  • evidence-tranche7/tranche7-results.json