Heating Systems

Document heating systems including distribution circuits, radiators, and underfloor heating.

Heating system components

The heating documentation system consists of:

Heat distribution system

Manage heating system configuration:

• Heating circuits (Two-Pipe or Underfloor Heating circuits)
• Main distribution pipe diameter
• Circuit creation and management

Heat emitters

Document heat emitters in rooms:

• Radiators (with dimensions, type, valve information)
• Underfloor heating loops (with manifold or RTL box information)
• Heat emitter details and measurements

Heating system data

The Heat Distribution System data model includes the main distribution pipe diameter and heating circuits. Current iOS source does not expose a dedicated Heating Distribution System configuration screen, an Edit Heating System control, or an Add Circuit flow.

Main distribution

The main distribution pipe diameter is stored as a numeric millimeter value. The current schema does not define a fixed option list for this field.

Heating circuits

Circuit records include an ID, a user-provided name, and one of these circuit types:

• twoPipe - for radiator systems
• underfloorHeating - for underfloor heating

Heat emitter capture

Heat emitter models cover radiators and underfloor heating loops. Current iOS source exposes a room-level Heating selection for the room heating type, including Radiators and Underfloor heating, but no dedicated localized radiator or underfloor-heating capture screen is exposed in current iOS strings/source.

Radiator data

Radiator heat emitter data can include:

• Circuit ID
• Radiator type: horizontal, vertical, or lowLevel
• Radiator design: unknown, panel, plan, modernSectional, castIronSectional, tubeColumn, narrowColumn, or towel
• Height and length in millimeters
• Connecting pipe diameter in millimeters
• Distance to heating source in meters
• Valve catalog item ID and whether the valve is broken
• Whether the radiator is broken

Underfloor heating data

Underfloor heating loop data can include:

• Circuit ID
• Manifold ID and distance to manifold in meters, when connected to a manifold
• RTL box catalog item ID, when connected to an RTL box
• Distance to heating source in meters
• Floor area in square meters
• Floor material: concrete, woodFloorBoard, woodParquet, ceramicTile, or carpet
• Screed thickness in millimeters
• Pipe spacing in millimeters, with schema options 50, 75, 100, 150, 200, 225, 300, and 375

Notes about heat emitter capture

• Radiators and underfloor heating loops are modeled as individual heat emitters
• Each heat emitter must be assigned to a circuit
• Heat emitter records reference an existing circuit ID
• The app does not capture photos during heat emitter entry - this is a data entry screen
• Use the Notes feature to capture photos of radiators, manifolds, and installations

Link heat emitters to circuits

Heat emitters are linked to circuits through their circuitId field:

• Radiators belong to a circuit by circuitId
• Underfloor heating loops belong to a circuit by circuitId
• Two-pipe and underfloor-heating circuit variants are defined in the heating system schema

Troubleshooting

Heating controls are not visible

• Current iOS source exposes the room Heating selection, but not dedicated Heating Distribution System, Add Circuit, Add Radiator, or Add Underfloor Heating controls.

Radiator data is incomplete

• The schema requires common heat-emitter fields such as circuitId, id, and isBroken.
• Height and length are radiator fields, but they are not marked as required in the current radiator schema.

Underfloor heating data is incomplete

• The schema requires common heat-emitter fields such as circuitId, id, and isBroken.
• Floor area, manifold ID, RTL box, screed thickness, floor material, and pipe spacing are underfloor heating loop fields, but the current schema does not mark floor area, manifold, or RTL box details as required.