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.
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
- 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).
- 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.
- 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.
- 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.
- 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).
- 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.
- 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.
- 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.