Skip to content
HALOWERK

Rechenwerk

heat pump sizing

Required heating output = (design heat load + mean hot-water load) x 24 / (24 - blocking hours). Hot water energy per day = volume x density (Kell 1975) x 4.18 kJ/(kg K) x temperature rise. The heating load line runs linearly from the design load at the design outdoor temperature to zero at the heating limit temperature; with manufacturer capacity points the bivalence point is the intersection of both curves (linear interpolation, no extrapolation). Optional checks: § 43(5) GModG hybrid.

POST https://rechen.halowerk.com/v1/heat-pump-sizing

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
design_heat_load_kwnumberYesBuilding heat load at the design outdoor temperature (kW), e.g. from DIN EN 12831-1.
design_outdoor_temp_cnumberYesDesign outdoor temperature of the site (°C).
heating_limit_temp_cnumberNoOutdoor temperature above which no space heating is needed (°C).
hot_waterobjectNo
blocking_hours_per_daynumberNoHours per day the utility may switch the heat pump off (tariff contract).
capacity_curvearrayNoHeat pump heating capacity at outdoor temperatures for the planned flow temperature (data sheet).
hybridobjectNo
annual_heat_demand_kwhnumberNoAnnual heat demand incl. hot water (kWh).
seasonal_performance_factornumberNoExpected seasonal performance factor (JAZ, e.g. per VDI 4650).
refrigerant_naturalbooleanNoUses a natural refrigerant (R290, R600a, R1270, R717, R718, R744).
heat_sourcestringNoHeat source for the BEG ETAs check (water-based heating).
etas_35_percentnumberNoSeasonal space heating energy efficiency ETAs at 35 °C, average climate (ecodesign label data, %).
etas_55_percentnumberNoETAs at 55 °C (%); not required for low-temperature heat pumps.
low_temperature_heat_pumpbooleanNoLow-temperature heat pump under the ecodesign rules (only the 35 °C value is checked).
installation_yearintegerNoYear of installation (for the BEG refrigerant rule from 2028).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "design_heat_load_kw",
    "design_outdoor_temp_c"
  ],
  "properties": {
    "design_heat_load_kw": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000,
      "description": "Building heat load at the design outdoor temperature (kW), e.g. from DIN EN 12831-1."
    },
    "design_outdoor_temp_c": {
      "type": "number",
      "minimum": -30,
      "maximum": 5,
      "description": "Design outdoor temperature of the site (°C)."
    },
    "heating_limit_temp_c": {
      "type": "number",
      "minimum": 8,
      "maximum": 20,
      "default": 15,
      "description": "Outdoor temperature above which no space heating is needed (°C)."
    },
    "hot_water": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "litres_per_day"
      ],
      "properties": {
        "litres_per_day": {
          "type": "number",
          "minimum": 0,
          "maximum": 100000,
          "description": "Hot water consumption per day (l)."
        },
        "hot_c": {
          "type": "number",
          "minimum": 30,
          "maximum": 80,
          "default": 50
        },
        "cold_c": {
          "type": "number",
          "minimum": 0,
          "maximum": 25,
          "default": 10
        },
        "loss_factor": {
          "type": "number",
          "minimum": 1,
          "maximum": 3,
          "default": 1,
          "description": "Factor for storage and circulation losses (1 = none)."
        }
      }
    },
    "blocking_hours_per_day": {
      "type": "number",
      "minimum": 0,
      "maximum": 12,
      "default": 0,
      "description": "Hours per day the utility may switch the heat pump off (tariff contract)."
    },
    "capacity_curve": {
      "type": "array",
      "minItems": 2,
      "maxItems": 20,
      "description": "Heat pump heating capacity at outdoor temperatures for the planned flow temperature (data sheet).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "outdoor_c",
          "capacity_kw"
        ],
        "properties": {
          "outdoor_c": {
            "type": "number",
            "minimum": -30,
            "maximum": 30
          },
          "capacity_kw": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000
          }
        }
      }
    },
    "hybrid": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "capacity_point_a_kw",
        "peak_generator_kw",
        "operation"
      ],
      "properties": {
        "capacity_point_a_kw": {
          "type": "number",
          "minimum": 0,
          "maximum": 10000,
          "description": "Heat pump output at part load point A under DIN EN 14825 (data sheet)."
        },
        "peak_generator_kw": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 10000
        },
        "operation": {
          "type": "string",
          "enum": [
            "parallel",
            "partly_parallel",
            "alternative"
          ]
        }
      }
    },
    "annual_heat_demand_kwh": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "description": "Annual heat demand incl. hot water (kWh)."
    },
    "seasonal_performance_factor": {
      "type": "number",
      "minimum": 1,
      "maximum": 10,
      "description": "Expected seasonal performance factor (JAZ, e.g. per VDI 4650)."
    },
    "refrigerant_natural": {
      "type": "boolean",
      "description": "Uses a natural refrigerant (R290, R600a, R1270, R717, R718, R744)."
    },
    "heat_source": {
      "type": "string",
      "enum": [
        "air",
        "ground",
        "water",
        "other"
      ],
      "description": "Heat source for the BEG ETAs check (water-based heating)."
    },
    "etas_35_percent": {
      "type": "number",
      "minimum": 50,
      "maximum": 400,
      "description": "Seasonal space heating energy efficiency ETAs at 35 °C, average climate (ecodesign label data, %)."
    },
    "etas_55_percent": {
      "type": "number",
      "minimum": 50,
      "maximum": 400,
      "description": "ETAs at 55 °C (%); not required for low-temperature heat pumps."
    },
    "low_temperature_heat_pump": {
      "type": "boolean",
      "default": false,
      "description": "Low-temperature heat pump under the ecodesign rules (only the 35 °C value is checked)."
    },
    "installation_year": {
      "type": "integer",
      "minimum": 2024,
      "maximum": 2035,
      "description": "Year of installation (for the BEG refrigerant rule from 2028)."
    }
  }
}

Open original schema

Published input example

{
  "design_heat_load_kw": 8,
  "design_outdoor_temp_c": -12,
  "hot_water": {
    "litres_per_day": 200
  },
  "blocking_hours_per_day": 2,
  "capacity_curve": [
    {
      "outdoor_c": -15,
      "capacity_kw": 5
    },
    {
      "outdoor_c": -7,
      "capacity_kw": 6
    },
    {
      "outdoor_c": 2,
      "capacity_kw": 7.5
    },
    {
      "outdoor_c": 7,
      "capacity_kw": 8.5
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →