Skip to content
HALOWERK

Rechenwerk

hydraulic balance

Each radiator output follows Q = Q_N x (dT_ln / dT_ln,N)^n with the logarithmic mean temperature difference dT_ln = (t_v - t_r) / ln((t_v - t_i) / (t_r - t_i)) and the caller’s rating point (default 75/65/20 °C) and exponent. Mode lowest_supply finds the lowest flow temperature at which every radiator covers its room heat load with at least the minimum spread; mode fixed_supply uses the given flow temperature. Per radiator the return temperature is solved by bisection and the mass flow is m.

POST https://rechen.halowerk.com/v1/hydraulic-balance

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
modestringNolowest_supply = find the lowest flow temperature covering all rooms; fixed_supply = use supply_temperature_c.
supply_temperature_cnumberNoSystem flow temperature for mode fixed_supply (°C).
min_spread_knumberNoMinimum temperature spread of the critical radiator in mode lowest_supply (K).
radiatorsarrayYes
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "radiators"
  ],
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "lowest_supply",
        "fixed_supply"
      ],
      "default": "lowest_supply",
      "description": "lowest_supply = find the lowest flow temperature covering all rooms; fixed_supply = use supply_temperature_c."
    },
    "supply_temperature_c": {
      "type": "number",
      "minimum": 25,
      "maximum": 110,
      "description": "System flow temperature for mode fixed_supply (°C)."
    },
    "min_spread_k": {
      "type": "number",
      "minimum": 1,
      "maximum": 40,
      "default": 5,
      "description": "Minimum temperature spread of the critical radiator in mode lowest_supply (K)."
    },
    "radiators": {
      "type": "array",
      "minItems": 1,
      "maxItems": 200,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "room_heat_load_w",
          "rated_output_w"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Radiator or room label."
          },
          "room_heat_load_w": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100000,
            "description": "Design heat load the radiator must cover (W)."
          },
          "rated_output_w": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100000,
            "description": "Rated output from the data sheet at the rating point (W)."
          },
          "rated_supply_c": {
            "type": "number",
            "minimum": 30,
            "maximum": 110,
            "default": 75
          },
          "rated_return_c": {
            "type": "number",
            "minimum": 25,
            "maximum": 105,
            "default": 65
          },
          "rated_room_c": {
            "type": "number",
            "minimum": 5,
            "maximum": 30,
            "default": 20
          },
          "exponent": {
            "type": "number",
            "minimum": 1,
            "maximum": 2,
            "default": 1.3,
            "description": "Radiator exponent n from the data sheet (panel radiators typically about 1.3)."
          },
          "room_temperature_c": {
            "type": "number",
            "minimum": 5,
            "maximum": 30,
            "default": 20,
            "description": "Design room temperature (°C)."
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "radiators": [
    {
      "id": "living",
      "room_heat_load_w": 600,
      "rated_output_w": 1000
    },
    {
      "id": "bedroom",
      "room_heat_load_w": 600,
      "rated_output_w": 1500
    }
  ]
}

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 →