Analysis Heatmap

Colours any analysis mesh from its values: flat cells, smooth gradient, contour bands with labelled isolines, or report classes (UTCI, Lawson wind comfort, noise, slope bands, flood depth). Also reports the % of area in each band.

Site Analysis Nickname: Heatmap

Overview

Colours any analysis mesh from its values: flat cells, smooth gradient, contour bands with labelled isolines, or comfort classes (UTCI, Lawson, noise). Also reports the % of area in each band.

Inputs (16)

  • Mesh (Mesh): Analysis mesh, e.g. Fast CFD WindMesh (with its VertexSpeeds as Values and BuildingMask as Mask), Sun Hours or Noise mesh
  • Values (Number): One value per mesh vertex or per mesh face (detected automatically)
  • Mode (Text): Cells, Smooth, Contour or Classes (0-3 also accepted)
  • Levels (Integer): Contour: number of bands (rounded to nice steps when Min/Max are not set)
  • Smooth (Integer): Smoothing passes on the values (0 = none, 1-3 light, 5-10 strong). Masked cells are left out
  • Min (Number): Colour range minimum (default: data minimum). Set the same Min/Max on every option to compare them fairly
  • Max (Number): Colour range maximum (default: data maximum)
  • Palette (Text): Palette name (Viridis, Cividis, Turbo, Ladybug, Thermal, Wind, RdBu...). Add ' r' / '_r' to reverse
  • Colors (Colour): Custom gradient (overrides Palette)
  • Mask (Boolean): Optional: one bool per face, True = building / no data (kept grey, excluded from smoothing, contours and stats)
  • Scheme (Text): Classes mode: UTCI (°C), Lawson (m/s), Noise (dB), Slope (%: 0-5, 5-15, 15-30, >30) or Flood depth (m: 0.1, 0.3, 0.5)
  • Title (Text): Legend title, e.g. 'Wind speed (m/s)'
  • LabelSpacing (Number): Distance between isoline labels (0 = no labels, default: 15% of the map size)
  • LabelSize (Number): Label text height (default: 1.2% of the map size)
  • Peaks (Integer): Number of high-point labels (0 = none). Negative = label low points instead
  • Run (Boolean): Optional. False = skip the analysis and keep showing the last results (cached). Share one toggle with the Analysis Dashboard to switch everything on/off together.

Outputs (10)

  • Heatmap (Mesh): Coloured mesh
  • Isolines (Curve): Contour lines (Contour / Classes modes)
  • IsoValues (Number): Value of each isoline
  • LabelPlanes (Plane): Isoline + peak label planes, aligned with the line and always readable (feed Text Tag 3D)
  • LabelText (Text): Label strings
  • LabelSize (Number): Text height used for the labels
  • BandStats (Text): % of the (unmasked) area in each band / class, for report tables
  • BandAreas (Number): Area of each band / class (model units²)
  • Dashboard Data (Text): JSON legend payload for Legend Geometry / Analysis Dashboard
  • Info (Text): Component information and interpretation

Method, assumptions and simplifications

The same notes appear in the component's Info output.

Method

  1. Values are matched to the mesh per vertex or per face from their count. Per-face meshes are welded so neighbouring cells share vertices; face values are averaged onto vertices (and vertex values averaged onto faces where needed).
  2. Optional smoothing: Smooth passes of Laplacian averaging along mesh edges (each vertex = mean of itself and its neighbours); masked faces do not contribute, so values do not bleed across buildings.
  3. Band edges: without Min and Max, the data range is split into round steps (1, 2, 2.5 or 5 × 10ⁿ) aiming at Levels bands; with Min or Max set, the range is split into exactly Levels equal bands. Classes mode uses the fixed edges of the Scheme.
  4. Cells: one flat colour per face from the gradient. Smooth: vertex colours blended across faces. Contour and Classes: faces are clipped exactly at the band edges into filled band polygons, and isolines are traced at each inner edge.
  5. Class schemes: UTCI (−40, −27, −13, 0, 9, 26, 32, 38, 46 °C), Lawson LDDC (4, 6, 8, 10 m/s: sitting to uncomfortable), Noise (45 to 75 dB(A) in 5 dB steps), Slope (5, 15, 30 %), Flood depth (0.1, 0.3, 0.5 m).
  6. Band areas: in Cells mode each whole face counts in its own band; in the other modes the clipped band polygons are measured. BandStats gives each band as a % of the unmasked area.
  7. Labels: values are placed along isolines every LabelSpacing (default 15% of the bounding-box diagonal), turned to read left to right and kept apart; Peaks labels local maxima (or minima if negative). Text size defaults to 1.2% of the diagonal.
  8. Geometry is cached: changing only label inputs or Title does not rebuild the bands.

Assumptions

  • Mask has one item per face; True means building or no data.
  • Values outside a set Min / Max are clamped into the first or last band.
  • BandAreas are in model units²; Report Metrics converts them to ha assuming metres.

Simplifications and limits

  • Per-vertex data shown in Cells mode is the mean of the face's vertices, not an exact cell value.
  • Smoothing is a plain graph Laplacian: it is not area-weighted and lowers peaks.
  • Isolines and bands assume values vary linearly along each triangle edge.

Workflow

  • Fast CFD, Sun Hours, Noise, slope or flood results -> Mesh, Values, Mask.
  • LabelPlanes, LabelText, LabelSize -> Text Tag 3D. Dashboard Data -> Legend Geometry, Analysis Dashboard or Report Metrics.

References

  • Blazejczyk K. et al. (2012), An introduction to the Universal Thermal Climate Index (UTCI), Geographia Polonica 85(1): UTCI stress categories.
  • Lawson T.V., Lawson (LDDC) pedestrian wind comfort criteria.