agentsclimarketplace

Environmental simulation

Skill marcinfinitesimal533/Claude-skills-for-Computational-Designers/skills/environmental-simulation

Build Claude Code skills for computational design, parametric modeling, simulation, BIM scripting, and fabrication in AEC

Install
npx -y skills add marcinfinitesimal533/Claude-skills-for-Computational-Designers --skill environmental-simulation

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Daylight analysis, solar radiation, energy simulation, CFD wind analysis, thermal comfort, acoustic simulation, and the Ladybug Tools ecosystem for performance-driven AEC computational design

SKILL.md

55.2 KB, as published. Nobody here has run it

Environmental Simulation for AEC Computational Design

This skill provides a comprehensive reference for environmental performance simulation in the Architecture, Engineering, and Construction industry. It covers daylight analysis, solar radiation studies, energy modeling, computational fluid dynamics for wind, thermal comfort assessment, acoustic simulation, and the Ladybug Tools ecosystem that ties these workflows together within parametric design environments.


1. Performance-Driven Design Philosophy

Why Simulate Early

The single most consequential decision in building performance is made in the first five percent of the design timeline. Orientation, massing, window-to-wall ratio, and floor plate depth are locked in during concept design, yet their impact on energy consumption, daylight quality, and occupant comfort persists for the entire operational life of the building — typically 50 to 100 years.

Late-stage simulation is a diagnostic exercise. Early-stage simulation is a generative tool. The distinction matters because retrofitting performance into an already-resolved form is orders of magnitude more expensive than shaping the form around performance from the beginning.

Cost of late performance analysis:

Stage where issue discoveredRelative cost to fix
Concept design1x (baseline)
Schematic design5x
Design development15x
Construction documents50x
Construction150x
Post-occupancy500x+

These multipliers are well-documented across the AEC industry and reflect the reality that changing a window-to-wall ratio on a sketch costs nothing, but changing it after curtain wall shop drawings are issued can cost hundreds of thousands of dollars.

Integration of Simulation into the Design Loop

Performance simulation must not live in a separate silo from the design model. The traditional workflow — architect designs, sends model to energy consultant, waits two weeks, receives PDF report, ignores half the recommendations because they conflict with the architectural intent — is fundamentally broken.

The correct workflow is a tight feedback loop:

  1. Parametric model defines geometry with variable parameters (orientation, WWR, floor depth, shading depth, envelope composition).
  2. Simulation engine evaluates one or more performance metrics against that geometry.
  3. Results feed back into the model as color-mapped surfaces, numeric dashboards, or fitness values for optimization.
  4. Designer adjusts parameters or launches an automated optimization run.
  5. Repeat at increasing fidelity as the design matures.

This loop should complete in seconds to minutes during early design and in minutes to hours during detailed design. Any simulation that takes days to return results is, by definition, excluded from the design loop and relegated to post-rationalization.

Performance as a Design Driver

Performance-driven design does not mean surrendering architectural intent to a spreadsheet. It means treating environmental performance as a first-class design variable alongside spatial quality, structural logic, and aesthetic expression. The best performing buildings in the world — the Bullitt Center, One Angel Court, the Manitoba Hydro Place — are also among the most architecturally compelling because their designers used performance constraints as creative catalysts.

Metrics that can drive design decisions:

  • Daylight autonomy drives floor plate depth, section profile, and facade design.
  • Solar radiation drives orientation, massing articulation, and shading strategy.
  • Energy use intensity drives envelope specification, HVAC selection, and renewable capacity.
  • Wind comfort drives podium design, canopy placement, and landscape strategy.
  • Thermal comfort drives material selection, ventilation strategy, and public realm design.
  • Acoustic performance drives room proportions, material specification, and partition layout.

Iterative vs. Single-Pass Simulation Strategies

Single-pass simulation runs one analysis on a fixed design. It answers the question "how does this design perform?" This is the minimum viable use of simulation and is appropriate only for compliance checking at the end of a design phase.

Iterative simulation runs multiple analyses across a parameter space. It answers the question "which design performs best?" This is the correct use of simulation in a computational design workflow.

Iterative strategies include:

  • Manual parameter sweeps: Designer changes one variable at a time and observes the effect on performance. Simple but slow and unable to capture multi-variable interactions.
  • Parametric studies: Systematic variation of two or three parameters across defined ranges, producing a response surface that reveals optimal regions.
  • Evolutionary optimization: Genetic algorithms (Galapagos, Wallacei) explore a high-dimensional parameter space, evolving toward Pareto-optimal solutions across multiple conflicting objectives.
  • Machine learning surrogates: A neural network is trained on a sample of simulation results and then used to predict performance across the full parameter space at near zero computational cost. This enables real-time performance feedback during design.

2. Daylight Analysis

Core Metrics

Daylight Factor (DF) The ratio of indoor illuminance to outdoor diffuse horizontal illuminance under a CIE overcast sky, expressed as a percentage. DF is climate-independent and therefore useful for comparing designs but not for predicting actual illuminance.

  • Minimum DF of 2% is generally required for a space to be considered "daylit."
  • Average DF of 5% or more indicates strong daylight availability.
  • DF does not account for direct sunlight, building orientation, or climate.

Spatial Daylight Autonomy (sDA) The percentage of analysis area that achieves at least 300 lux for at least 50% of occupied hours annually. sDA is the primary metric in LEED v4.1 and IES LM-83.

  • sDA300/50% >= 55% is the LEED threshold for 2 points.
  • sDA300/50% >= 75% earns 3 points.
  • Based on annual simulation with climate-specific weather data.
  • Accounts for orientation, context, and dynamic shading.

Annual Sunlight Exposure (ASE) The percentage of analysis area that receives more than 1000 lux of direct sunlight for more than 250 occupied hours per year. ASE measures visual discomfort risk from excessive direct sun.

  • ASE1000/250h must be <= 10% for LEED compliance.
  • High ASE indicates glare risk and potential overheating.
  • ASE is often in tension with sDA — maximizing daylight can increase glare risk.

Useful Daylight Illuminance (UDI) The percentage of occupied hours that illuminance falls within a useful range:

UDI categoryIlluminance rangeInterpretation
UDI-fell-short< 100 luxToo dark, electric light needed
UDI-supplementary100–300 luxUseful with supplemental light
UDI-autonomous300–3000 luxIdeal daylight range
UDI-exceeded> 3000 luxToo bright, glare likely

UDI is more nuanced than sDA because it penalizes both under-lit and over-lit conditions.

Daylight Glare Probability (DGP) A metric for evaluating glare from a specific viewpoint, based on luminance distribution in the field of view.

DGP valueGlare perception
< 0.35Imperceptible
0.35–0.40Perceptible
0.40–0.45Disturbing
> 0.45Intolerable

DGP is evaluated using Evalglare from the Radiance suite and requires a rendered fisheye luminance image from the occupant's viewpoint.

Standards Reference

LEED v4.1 IEQ Credit: Daylight

  • Option 1 (Simulation): sDA300/50% >= 55% in 55% of regularly occupied area (2 pts),

    = 75% (3 pts). ASE1000/250h <= 10%. Analysis grid at workplane height (0.76 m).

  • Option 2 (Measurement): Illuminance between 300–3000 lux at 9 AM and 3 PM on equinox.

EN 17037: Daylight in Buildings

  • Target illuminance of 300 lux for 50% of daylight hours at the worst point.
  • Minimum illuminance of 100 lux for 50% of daylight hours across 95% of area.
  • Recommends evaluation of view out, sunlight exposure, and glare protection.

BREEAM Hea 01: Visual Comfort

  • Average daylight factor >= 2% or point daylight factor >= 0.8% at the worst point.
  • Uniformity ratio (minimum DF / average DF) >= 0.4.
  • View of sky from desk height (requirement for higher credits).

Simulation Engines

Radiance The gold standard for physically-based lighting simulation. Uses backward ray-tracing to compute illuminance and luminance with high accuracy. All major daylight standards reference Radiance as a validated engine.

Key Radiance parameters for annual simulation:

ParameterLow qualityMedium qualityHigh quality
-ab (bounces)235
-ad (divisions)51220484096
-as (super-samples)12810242048
-ar (resolution)64128256
-aa (accuracy)0.250.150.1

3-Phase Method Decomposes daylight transport into three matrices:

  1. View matrix (V): sensor points to interior surface patches
  2. Transmission matrix (T): window group behavior
  3. Daylight matrix (D): sky patches to exterior window surfaces

Annual daylight = V * T * D * sky_vector. This allows rapid recalculation when only the window system changes (swap T matrix) without recomputing V or D.

5-Phase Method Adds direct solar contribution more accurately by separating the direct sun component from the diffuse sky component and computing it with higher resolution. Essential for accurate ASE calculations and glare analysis.

Material Properties

Common material reflectances for Radiance modeling:

MaterialReflectanceSpecularityRoughness
White painted wall0.700.00.0
Light grey painted wall0.500.00.0
Dark grey painted wall0.200.00.0
Concrete (raw)0.300.00.05
Wood flooring (light)0.400.020.02
Carpet (medium)0.200.00.0
Ceiling tile (white)0.800.00.0
Glass (clear single)Tvis: 0.88
Glass (clear double)Tvis: 0.78
Glass (low-e double)Tvis: 0.65
Ground (grass)0.200.00.0
Ground (asphalt)0.100.00.0
Ground (concrete paving)0.300.00.0
Red brick0.250.00.03
Aluminum (brushed)0.600.500.05

Grid-Based vs. Point-in-Time Analysis

Grid-based analysis places sensors at regular intervals across a horizontal workplane (typically 0.76 m above floor for offices, 0.85 m for standing desks). Grid spacing should be no larger than 0.5 m for final analysis and no larger than 1.0 m for early design studies. Results are spatial maps showing illuminance distribution.

Point-in-time analysis evaluates illuminance or luminance at a specific moment (date, time, sky condition). Useful for worst-case glare checks (e.g., December 21 at 3 PM with low sun angle) or for visualizing light distribution at critical moments.

Parametric Daylight Optimization Workflow

  1. Define variable parameters: window-to-wall ratio (20–80%), window sill height, head height, external shading depth (0–1.5 m), light shelf depth, room depth.
  2. Set up Honeybee model with Radiance modifiers for all surfaces.
  3. Run annual daylight simulation (Honeybee-Radiance recipe).
  4. Extract sDA, ASE, and UDI from results.
  5. Feed metrics into multi-objective optimizer (Wallacei recommended).
  6. Objectives: maximize sDA, minimize ASE, minimize facade cost.
  7. Analyze Pareto front to select design variants that balance performance and cost.

Common Modeling Mistakes

  • Missing context buildings: Omitting neighboring buildings that cast shadows leads to dramatically overstated daylight predictions. Always include context within at least 200 m radius for urban sites.
  • Wrong material reflectance: Using default white (0.50) for all surfaces when actual materials are much darker (0.20–0.30) can overpredict daylight by 30–50%.
  • Insufficient grid resolution: A 2 m grid misses spatial variation entirely. Use 0.5 m maximum for compliance analysis.
  • Ignoring furniture: Large obstructions like tall storage units significantly affect daylight distribution in deep plans.
  • Wrong analysis period: Using calendar year instead of occupied hours misrepresents sDA values. Always define occupancy schedule correctly.
  • Not modeling window frames: Frames reduce glazed area by 15–30%. Omitting them overpredicts daylight proportionally.

3. Solar Radiation Analysis

Solar Geometry

The position of the sun is defined by two angles:

  • Altitude (elevation): Angle above the horizon (0° at horizon, 90° at zenith).
  • Azimuth: Angle measured clockwise from true north (0° = N, 90° = E, 180° = S, 270° = W).

Solar position depends on latitude, longitude, date, and time. Key concepts:

  • Solar noon: The moment the sun crosses the local meridian (highest altitude).
  • Equation of time: Correction for the difference between solar time and clock time due to Earth's elliptical orbit and axial tilt. Varies by +/- 16 minutes.
  • Declination: The angle between the sun's rays and the equatorial plane. Ranges from +23.45° (summer solstice) to -23.45° (winter solstice).
  • Hour angle: Angular displacement of the sun from solar noon. 15° per hour.

Solar Radiation Components

ComponentSourceBehaviorTypical share (annual)
Direct beamSun diskCasts sharp shadows50–70%
DiffuseSky vault (scattered by atmosphere)Uniform, no shadows25–40%
ReflectedGround and surrounding surfacesDepends on albedo5–15%

Total solar radiation (global) = direct + diffuse + reflected.

Radiation Analysis Types

Cumulative annual radiation: Total solar energy received by a surface over an entire year, measured in kWh/m². This is the most common analysis for facade studies and PV potential assessment. Typical values for a horizontal surface range from 900 kWh/m²/yr (northern Europe) to 2200 kWh/m²/yr (desert regions).

Monthly radiation: Breakdown of annual radiation by month, revealing seasonal patterns. Critical for understanding heating vs. cooling season dynamics.

Hourly radiation: Instantaneous radiation values for specific hours, used for peak load calculations and shadow studies.

Solar Access Hours

Solar access analysis counts the number of hours per year (or per day for a specific date) that a point receives direct sunlight. Used for:

  • Right-to-light assessments (UK planning requirement: 2+ hours on March 21).
  • BRE Site Layout Planning guidelines (25+ hours on March 21 for outdoor amenity).
  • Passive solar design (minimum 4 hours winter solstice for south-facing facades).

Shadow Range Analysis

Shadow range diagrams overlay all shadow positions for a specific date or period, showing which areas are always in shade, always in sun, or intermittently shaded. Useful for:

  • Public space design (ensuring benches get winter sun).
  • Urban planning (assessing impact of new tall buildings on surrounding neighborhoods).
  • PV array siting (avoiding partially shaded zones).

Radiation on Tilted Surfaces

Radiation on a tilted surface differs from horizontal radiation. The optimal tilt angle for annual energy collection is approximately equal to the site latitude. For winter-optimized collection, add 15° to latitude. For summer-optimized, subtract 15°.

Isotropic sky model: Diffuse radiation is uniform across the sky dome. Simple but inaccurate — underestimates radiation near the horizon and circumsolar region.

Perez all-weather model: Divides the sky into circumsolar, horizon brightening, and isotropic components. Most accurate model for tilted surface calculations.

PV Potential Assessment

  1. Calculate annual radiation on candidate surfaces (roof, facade, canopy).
  2. Subtract shading losses from context geometry and self-shading.
  3. Apply panel efficiency (monocrystalline: 20–22%, polycrystalline: 16–18%, thin-film: 10–13%).
  4. Apply system losses (inverter: 3–5%, wiring: 2–3%, soiling: 2–5%, temperature: 5–10%).
  5. Result: annual energy yield in kWh per panel or per m².

Typical yield: 150–200 kWh/m²/yr in northern Europe, 250–350 kWh/m²/yr in southern US and Middle East.

Sky Models

Sky modelUse caseCharacteristics
CIE overcastDaylight factor calculationLuminance varies only with altitude
CIE clearSunny day analysisIncludes circumsolar and horizon zones
CIE intermediatePartly cloudy conditionsBlend of clear and overcast
Perez all-weatherAnnual simulationUses weather data, most accurate
UniformSimple diffuse analysisEqual luminance everywhere (unrealistic)

EPW Weather Files

EPW (EnergyPlus Weather) files contain hourly data for a typical meteorological year:

  • Dry bulb temperature, dew point temperature, relative humidity
  • Direct normal radiation, diffuse horizontal radiation, global horizontal radiation
  • Wind speed, wind direction
  • Atmospheric pressure, sky cover, precipitation

Sources: EnergyPlus.net, Climate.OneBuilding.org (most comprehensive), ASHRAE IWEC2, Meteonorm (commercial, can generate for any location).

TMY methodology: Typical Meteorological Year data is constructed by selecting the most representative month from a 15–30 year record for each calendar month. TMY data represents typical conditions, not extreme conditions. For resilience analysis, use actual year data or future climate projections.


4. Energy Simulation

Building Energy Model Components

A complete building energy model requires the following layers:

  1. Geometry: Thermal zones defined by enclosed volumes. Each zone has a single air temperature assumption. Zones should be separated where significantly different thermal conditions exist (perimeter vs. core, different orientations, different uses).

  2. Constructions: Material layers for each opaque surface (walls, roofs, floors) and glazing properties for windows. Each layer defined by thickness, conductivity, density, and specific heat.

  3. Schedules: Hourly profiles for occupancy, lighting, equipment, thermostat setpoints, HVAC availability, and ventilation rates. Schedules are the single most influential input in energy modeling after geometry.

  4. Internal loads: Heat gains from people (sensible + latent), lighting, and equipment. Specified as peak values modulated by schedules.

  5. HVAC systems: Heating, cooling, and ventilation equipment. Ranges from ideal air (unlimited capacity, perfect efficiency — for early design) to fully detailed systems with specific equipment curves.

  6. Infiltration: Uncontrolled air leakage through the envelope. Specified as ACH (air changes per hour) or flow per unit envelope area.

  7. Natural ventilation: Window opening behavior, stack effect, wind-driven ventilation. Can be modeled as scheduled or as airflow network.

EnergyPlus Engine Fundamentals

EnergyPlus is a whole-building energy simulation engine developed by the US Department of Energy. It uses a heat-balance method that simultaneously solves:

  • Conduction through opaque surfaces (conduction transfer functions)
  • Solar radiation through windows (detailed optical calculations)
  • Internal convection (TARP algorithm)
  • Longwave radiation exchange between surfaces
  • Air heat balance (zone energy balance)
  • HVAC system response

EnergyPlus runs sub-hourly timesteps (typically 6 per hour = 10-minute intervals) with weather data interpolated from hourly EPW values.

Honeybee-Energy Workflow

  1. Create rooms: Define thermal zone geometry from Rhino surfaces or procedural generation. Each room = one thermal zone.
  2. Assign program types: Predefined combinations of loads, schedules, and setpoints for common space types (office, residential, retail, etc.).
  3. Set construction sets: Climate-appropriate envelope specifications. Honeybee includes ASHRAE baseline construction sets by climate zone.
  4. Define HVAC: Start with IdealAirSystem for early design. Progress to detailed systems (VAV, VRF, DOAS, radiant) for later stages.
  5. Set simulation parameters: Run period, timestep, terrain, solar distribution.
  6. Run simulation: Honeybee generates IDF file and calls EnergyPlus.
  7. Parse results: Monthly/annual energy by end use, zone temperatures, comfort hours.

Key Outputs

Energy Use Intensity (EUI) Total annual energy consumption divided by gross floor area, measured in kWh/m²/yr (or kBtu/ft²/yr in US practice). EUI is the primary benchmark for building energy performance.

Building typeGood EUI (kWh/m²/yr)Average EUIPoor EUI
Office80–120150–200250+
Residential (apt)50–80100–140180+
Retail100–150200–280350+
Education70–110130–170220+
Hospital200–300350–450550+
Hotel120–180220–300400+
Laboratory250–400500–700900+
Warehouse30–5060–100150+

Heating/Cooling Loads Annual energy required for space heating and cooling, broken down monthly. The ratio of heating to cooling reveals the building's dominant load and guides passive strategy selection.

Peak Loads Maximum instantaneous heating and cooling demand, measured in kW or W/m². Peak loads size the HVAC equipment. Reducing peak loads through passive design (thermal mass, shading, high-performance envelope) allows smaller, less expensive mechanical systems.

Early-Stage Energy Estimation

For concept design, full EnergyPlus simulation may be premature. Simplified methods:

  • Degree-day method: Estimate heating/cooling energy from HDD/CDD and envelope UA-value. Fast but ignores solar gains, internal gains, and thermal mass.
  • Lookup tables: Reference EUI values from benchmarking databases (CBECS, CIBSE TM46, EU building typologies) adjusted for climate and building features.
  • Shoebox models: Single-zone energy models representing a typical floor section. Capture the essential physics in 1% of the modeling effort.
  • Regression surrogates: Train a model on thousands of EnergyPlus runs, then predict EUI from a handful of input parameters in milliseconds.

Parametric Energy Optimization

Key parameters for early-stage energy optimization:

ParameterTypical rangeImpact on EUI
Orientation0–360°5–15% (climate-dependent)
WWR (north)15–60%5–20%
WWR (south)15–60%10–30%
WWR (east/west)15–40%10–25%
Wall U-value0.15–0.50 W/m²K5–15%
Roof U-value0.10–0.30 W/m²K3–10%
Glazing U-value0.8–3.0 W/m²K5–20%
Glazing SHGC0.20–0.6010–25%
Shading depth0–2.0 m5–15%
Infiltration rate0.1–1.0 ACH5–15%
Lighting power4–12 W/m²10–20%

Passive Design Strategies Validated by Simulation

  • Orientation: Long axis east-west maximizes southern exposure (northern hemisphere), improving winter solar gain while allowing effective summer shading.
  • Thermal mass: Exposed concrete soffits absorb daytime gains and release heat at night, reducing peak cooling loads by 10–20%.
  • Night purge ventilation: Flushing the building with cool night air pre-cools thermal mass, shifting cooling loads and reducing HVAC energy by 15–30%.
  • External shading: Horizontal overhangs on south, vertical fins on east/west. Fixed shading design derived from sun path analysis.
  • High-performance glazing: Triple glazing with low-e coatings (U < 1.0 W/m²K, SHGC 0.25–0.40) dramatically reduces both heating and cooling loads.
  • Daylighting with dimming: Photosensor-controlled dimming of electric lights in daylit zones reduces lighting energy by 40–60%.

5. CFD Wind Analysis

Outdoor Wind Comfort — Lawson Criteria

The Lawson comfort criteria classify wind conditions by acceptable activity:

CategoryMean wind speed thresholdGust equivalentAcceptable activity
Sitting (long)< 2.5 m/s< 4.0 m/sOutdoor dining, reading
Sitting (short)< 4.0 m/s< 6.0 m/sBus stops, café terraces
Standing< 6.0 m/s< 8.0 m/sWindow shopping, waiting
Walking (leisure)< 8.0 m/s< 10.0 m/sStrolling, walking routes
Business walking< 10.0 m/s< 12.0 m/sWalking to work, commuting
Uncomfortable10–15 m/s12–18 m/sHair disturbed, clothing flaps
Dangerous> 15 m/s> 20 m/sStructural damage risk

Wind comfort is typically assessed at pedestrian level (1.5 m above ground) for the annual wind climate, reporting the worst-season or annual probability of exceedance.

Computational Wind Tunnel Setup

Domain sizing rules (H = tallest building height):

BoundaryDistance from buildingsRationale
Inlet5H upstreamAllow boundary layer to develop
Outlet15H downstreamAllow wake to dissipate
Lateral walls5H from edge of modelPrevent blockage effects (< 3%)
Top5H above tallest pointPrevent artificial acceleration

Blockage ratio (frontal area of buildings / domain cross-section) must be < 3%. Higher blockage artificially accelerates flow around buildings.

Mesh resolution guidelines:

RegionCell size
Near building surfaces0.5–1.0 m
Pedestrian level (0–3 m)0.5–1.0 m
Near-field (within 2H)1.0–3.0 m
Far-field (beyond 2H)3.0–10.0 m
Boundary layer refinementFirst cell < 0.5 m

Total cell count for a typical urban study: 2–10 million cells.

Turbulence Models

RANS (Reynolds-Averaged Navier-Stokes): Time-averaged equations with turbulence closure models. Solves for mean flow quantities. Computationally affordable.

ModelStrengthsWeaknessesUse case
Standard k-epsilonRobust, well-validatedPoor for separation, wakesInitial screening
Realizable k-epsilonBetter for recirculationStill struggles with anisotropyGeneral urban studies
k-omega SSTExcellent near-wall, good separationHigher cost than k-epsilonDetailed pedestrian comfort
Spalart-AllmarasLow cost, good for attached flowPoor for complex urban geometryAerospace, not urban

LES (Large Eddy Simulation): Resolves large-scale turbulent structures directly, models only the smallest scales. Much more accurate for urban flows but 100–1000x more expensive than RANS. Reserved for research and critical safety assessments.

Butterfly (OpenFOAM for Grasshopper) Workflow

  1. Create geometry in Rhino/Grasshopper (buildings as closed Breps).
  2. Define wind tunnel (domain) using Butterfly components.
  3. Set inlet boundary condition: atmospheric boundary layer profile with reference wind speed, direction, roughness length (z0), and reference height.
  4. Set mesh parameters: base cell size, refinement levels near buildings.
  5. Select turbulence model (k-epsilon or k-omega SST).
  6. Run snappyHexMesh for mesh generation.
  7. Run simpleFoam (steady-state RANS solver).
  8. Post-process: extract wind speed at 1.5 m height plane, map to Lawson categories.

Simplified Wind Analysis for Early Design

Full CFD is expensive and time-consuming. For early design, use:

  • Desktop wind assessment: Classify building form using standard typologies (slab, tower, podium-tower, courtyard) and apply known wind behavior patterns.
  • Wind comfort rules of thumb: Tall buildings create downwash proportional to their height. Corner acceleration increases with building width. Through-building passages create venturi effects.
  • Lawson screening tool: Quick assessment based on building height, width, and surroundings without running CFD.
  • Reduced-order models: Pre-computed wind pressure databases for simple shapes.

Natural Ventilation Potential

CFD can assess whether natural ventilation is viable:

  • Calculate pressure coefficients (Cp) on building facades from wind simulation.
  • Derive pressure difference between windward and leeward openings.
  • Estimate ventilation flow rate: Q = Cd * A * sqrt(2 * dP / rho).
  • Compare achieved air change rate against minimum ventilation requirements.

Wind-Driven Rain

Wind-driven rain analysis predicts wetting patterns on building facades:

  • Combines rainfall intensity with wind speed and direction.
  • Identifies facade zones at risk of water penetration.
  • Informs material selection, detailing, and drainage design.
  • Quantified as catch ratio: rain on vertical surface / rain on horizontal surface.

6. Thermal Comfort

Indoor Thermal Comfort

PMV/PPD (Fanger Model) Predicted Mean Vote (PMV) is a steady-state thermal comfort index on a 7-point scale:

PMV valueThermal sensation
-3Cold
-2Cool
-1Slightly cool
0Neutral
+1Slightly warm
+2Warm
+3Hot

Predicted Percentage Dissatisfied (PPD) is derived from PMV. At PMV = 0, PPD = 5% (some people are always dissatisfied). ASHRAE 55 requires -0.5 < PMV < +0.5 (PPD < 10%).

PMV inputs:

ParameterSymbolTypical indoor range
Air temperatureTa18–28°C
Mean radiant temperatureTr16–35°C
Air speedVa0.05–0.5 m/s
Relative humidityRH30–70%
Metabolic rateMet1.0–2.0 met (office: 1.1)
Clothing insulationClo0.5–1.5 clo

Adaptive Model For naturally ventilated buildings, the adaptive model (ASHRAE 55 Section 5.4, EN 15251) defines acceptable indoor temperature as a function of outdoor running mean temperature.

Acceptable operative temperature = 17.8 + 0.31 * outdoor running mean temperature (80% acceptability band: +/- 3.5°C; 90% band: +/- 2.5°C).

The adaptive model acknowledges that occupants in naturally ventilated buildings tolerate wider temperature ranges because they have more control (opening windows, adjusting clothing).

Outdoor Thermal Comfort

Universal Thermal Climate Index (UTCI) An equivalent temperature that represents the physiological response of the human body to the outdoor thermal environment.

UTCI range (°C)Stress categoryThermal perception
> 46Extreme heat stressUnbearable
38–46Very strong heat stressVery hot
32–38Strong heat stressHot
26–32Moderate heat stressWarm
9–26No thermal stressComfortable
0–9Slight cold stressSlightly cool
-13–0Moderate cold stressCool
-27–(-13)Strong cold stressCold
-40–(-27)Very strong cold stressVery cold
< -40Extreme cold stressExtreme cold

Physiological Equivalent Temperature (PET) The air temperature at which the body's heat balance would be the same in a standard indoor reference environment. More intuitive for non-specialists.

Mean Radiant Temperature (MRT) The uniform temperature of an imaginary black enclosure that would result in the same net radiation heat exchange as the actual environment. MRT is often the dominant factor in outdoor comfort and is strongly influenced by:

  • Direct solar radiation (sun exposure vs. shade)
  • Longwave radiation from surrounding surfaces (hot pavement vs. vegetation)
  • Sky view factor (open sky vs. enclosed courtyard)

MRT can be 20–30°C higher in direct sun than in shade. This is why shade trees and canopies are the single most effective microclimate intervention in hot climates.

Microclimate Simulation Workflow

  1. Model urban geometry (buildings, ground surfaces, vegetation).
  2. Assign surface materials (albedo, emissivity, thermal admittance).
  3. Set meteorological boundary conditions from EPW data.
  4. Run coupled simulation: radiation (solar + longwave) + CFD (wind field) + energy balance (surface temperatures).
  5. Calculate MRT at pedestrian height from radiation field.
  6. Compute UTCI or PET at grid of points.
  7. Map comfort categories spatially and temporally.

Tools: ENVI-met (most comprehensive urban microclimate tool), Ladybug Tools (MRT and UTCI from weather data and simplified radiation), RayMan, SOLWEIG.


7. Acoustic Simulation

Room Acoustics Metrics

MetricFull nameTarget (speech)Target (music)
RT60Reverberation time (60 dB decay)0.4–0.8 s (office)1.5–2.5 s (concert)
EDTEarly Decay Time≈ RT60≈ RT60 (uniform)
C80Clarity (ratio early/late)-2 to +4 dB
D50Definition (early/total ratio)> 0.50
STISpeech Transmission Index> 0.60 (good)
GStrength (dB re: 10 m free field)0 to +10 dB

RT60 is the most commonly specified acoustic metric. It depends on room volume and total absorption:

Sabine equation: RT60 = 0.161 * V / A

Where V = room volume (m³) and A = total absorption (m² Sabins).

Eyring equation (more accurate for highly absorptive rooms): RT60 = 0.161 * V / (-S * ln(1 - alpha_avg))

Where S = total surface area and alpha_avg = average absorption coefficient.

Material Absorption Coefficients

Material125 Hz250 Hz500 Hz1 kHz2 kHz4 kHz
Concrete (painted)0.010.010.020.020.020.03
Brick (unglazed)0.030.030.030.040.050.07
Plasterboard on studs0.290.100.060.050.040.04
Glass (window)0.350.250.180.120.070.04
Timber floor0.150.110.100.070.060.07
Carpet (heavy on pad)0.080.240.570.690.710.73
Acoustic ceiling tile0.500.700.600.700.700.50
Curtain (heavy, draped)0.070.310.490.750.700.60
Mineral wool (50 mm)0.150.450.700.800.800.80
Perforated metal + absorber0.400.700.800.850.750.65
Upholstered seat (occupied)0.600.750.850.900.900.85
Open doorway1.001.001.001.001.001.00

Ray-Tracing Acoustic Simulation

Pachyderm Acoustics is a Grasshopper plugin for room acoustics simulation:

  1. Define room geometry as closed meshes in Rhino.
  2. Assign absorption and scattering coefficients to each surface.
  3. Place source and receiver points.
  4. Run ray-tracing simulation (10,000–100,000 rays).
  5. Extract impulse response at each receiver.
  6. Compute RT60, EDT, C80, D50, STI from impulse response.
  7. Visualize sound pressure level distribution as color map.

Sound Insulation

STC (Sound Transmission Class): Single-number rating for airborne sound insulation of partitions (North American standard, ASTM E413).

STC ratingPerformance
25Normal speech easily understood
30Loud speech understood, normal speech audible
35Loud speech audible but not easily understood
40Loud speech audible as murmur
45Loud speech not audible
50Very loud sounds barely heard
55+Most sounds inaudible

Rw (Weighted Sound Reduction Index): ISO equivalent of STC (ISO 717-1).

Typical constructions:

  • Single plasterboard on studs: STC 33–38
  • Double plasterboard on studs with insulation: STC 45–50
  • Concrete block (200 mm): STC 45–50
  • Concrete slab (200 mm): STC 50–55
  • Double stud wall with resilient channels: STC 55–60

Outdoor Noise Propagation

Environmental noise from roads, railways, and aircraft is assessed using:

  • ISO 9613-2: Attenuation of sound during outdoor propagation (geometric spreading, atmospheric absorption, ground effect, screening by barriers).
  • CNOSSOS-EU: Harmonized European noise calculation method.
  • Distance attenuation: Point source: -6 dB per doubling of distance. Line source (road): -3 dB per doubling of distance.
  • Barrier effect: A solid barrier provides 5–15 dB insertion loss depending on path length difference.
  • Noise mapping: Color-coded maps of facade or free-field noise levels, typically at 4 m height. Required for Environmental Impact Assessments.

8. Ladybug Tools Ecosystem

Overview

Ladybug Tools is an open-source collection of plugins for Grasshopper (Rhino) that provides comprehensive environmental analysis capabilities for building and urban design. It connects parametric geometry to validated simulation engines.

Ladybug (Weather Data and Outdoor Analysis)

Core capabilities:

  • EPW import and visualization: Dry bulb temperature, radiation, wind, humidity as hourly heatmaps, bar charts, and statistical summaries.
  • Sun path diagram: 3D stereographic or orthographic sun path with hourly sun positions, analemmas, and sun vectors for any location.
  • Wind rose: Frequency and speed distribution by direction for any analysis period.
  • Radiation rose: Directional radiation distribution for facade orientation studies.
  • Shadow study: Calculate sunlight hours on test surfaces with context geometry.
  • Outdoor comfort: UTCI, PET, and other outdoor comfort models from weather data.
  • Sky dome: Visualize sky luminance/radiance distribution (Tregenza sky patches).
  • Direct sun hours: Mesh-based analysis of solar access hours.
  • View analysis: Assess visual exposure from points to targets.

Honeybee (Building Simulation)

Honeybee-Radiance (daylight):

  • Create Radiance models from Grasshopper geometry.
  • Assign material modifiers (plastic, glass, trans, BSDF).
  • Define sensor grids and views.
  • Run point-in-time illuminance, daylight factor, annual daylight (sDA/ASE/UDI).
  • Glare analysis with Evalglare.
  • Parametric blind/shade studies.

Honeybee-Energy (thermal/energy):

  • Create thermal zones (rooms) from geometry.
  • Assign program types (loads and schedules by space type).
  • Define construction sets (opaque + glazing assemblies).
  • Set HVAC systems (ideal air, detailed systems).
  • Run EnergyPlus simulations.
  • Parse results: energy by end use, zone temperatures, comfort.

Key Honeybee concepts:

  • Room: A closed volume representing one thermal zone.
  • Face: A planar surface bounding a room (wall, floor, roof/ceiling).
  • Aperture: A window or skylight within a face.
  • Door: An opaque or glass door within a face.
  • Shade: An external shading surface (overhang, fin, context building).
  • Modifier: Radiance material properties (reflectance, transmittance).
  • Construction: Energy material layers (conductivity, density, specific heat).
  • ProgramType: Combination of people, lighting, equipment, ventilation, setpoints.
  • ConstructionSet: Collection of constructions for all face types.

Butterfly (CFD)

  • Wraps OpenFOAM for use in Grasshopper.
  • Creates computational domain (wind tunnel) around building geometry.
  • Generates block-structured mesh with refinement regions.
  • Sets boundary conditions (inlet velocity profile, outlet, walls).
  • Runs steady-state RANS solver (simpleFoam).
  • Extracts velocity and pressure fields for visualization.
  • Current status: Less actively maintained than Ladybug/Honeybee. For production CFD work, consider standalone OpenFOAM or commercial tools.

Dragonfly (Urban Scale)

  • Urban weather generator (UWG): Modifies rural EPW data to account for urban heat island effect, producing urban-specific weather data.
  • District energy modeling: Aggregates building energy models for neighborhood-scale analysis.
  • Urban geometry: Creates building footprint extrusions from GIS data.
  • REopt integration: Optimizes distributed energy resources (PV, storage, CHP).
  • Urban microclimate: Couples with other tools for outdoor comfort mapping.

Version Compatibility

ComponentCurrent versionRhino compatibilityPython
Ladybug1.8.xRhino 7, Rhino 8IronPython / CPython
Honeybee1.8.xRhino 7, Rhino 8IronPython / CPython
Honeybee-Radiance1.66.xRhino 7, Rhino 8CPython 3.7+
Honeybee-Energy1.104.xRhino 7, Rhino 8CPython 3.7+
Butterfly0.0.xRhino 6, Rhino 7IronPython
Dragonfly1.8.xRhino 7, Rhino 8CPython 3.7+

Note: Ladybug Tools 1.x (LBT) uses the Pollination installer, which manages Radiance, EnergyPlus, and OpenStudio dependencies automatically.

Installation

  1. Install Rhino 7 or 8.
  2. Download Pollination Grasshopper installer from pollination.cloud.
  3. Run installer — it sets up Ladybug Tools, Radiance 5.4+, EnergyPlus 23.1+, and OpenStudio 3.7+ automatically.
  4. Alternatively, install from Food4Rhino and manually configure engine paths.
  5. Verify installation: drop LB Versioner component on Grasshopper canvas.

Common Workflows

WorkflowComponents usedEngineOutput
Daylight factorHB Model, HB Modifier, HB Grid, HB DFRadianceDF spatial map
Annual daylight (sDA/ASE)HB Model, HB Annual DaylightRadiancesDA, ASE percentages
Point-in-time illuminanceHB Model, HB Point-in-TimeRadianceIlluminance grid
Glare analysisHB Model, HB Glare, EvalglareRadianceDGP images
Energy model (annual)HB Room, HB Program, HB Construction, HB EnergyEnergyPlusEUI, loads, temps
Outdoor solar radiationLB Direct Sun Hours, LB RadiationBuilt-inkWh/m² map
Sun path + shadow studyLB Sun Path, LB Shadow StudyBuilt-inHours of sunlight
Wind roseLB Wind RoseBuilt-inDirectional wind plot
Outdoor comfort (UTCI)LB UTCI, LB MRTBuilt-inUTCI spatial map
Parametric optimizationAbove + Galapagos / WallaceiVariousPareto-optimal designs

Integration with Optimization

Galapagos (single-objective): Built into Grasshopper. Uses genetic algorithm. Connect performance metric to fitness input. Good for single-metric optimization (e.g., minimize EUI). Limited to one objective.

Wallacei (multi-objective): NSGA-2 algorithm for Grasshopper. Handles 2–10+ objectives simultaneously. Produces Pareto front of non-dominated solutions. Includes built-in analytics for exploring the solution space. Recommended for performance-driven design where multiple conflicting objectives exist.

Colibri (design space exploration): Records every iteration of a parametric study (inputs and outputs) to a structured data file. Pairs with Design Explorer web app for parallel coordinates visualization. Useful for understanding parameter sensitivity before launching optimization.


9. Simulation Quality Assurance

Validation Strategies

Every simulation result should be viewed with appropriate skepticism. Validation builds confidence in results:

  • Analytical validation: Compare simulation output against known analytical solutions for simple cases (e.g., steady-state heat flow through a wall, illuminance from a point source). If the engine cannot reproduce analytical results, something is fundamentally wrong.
  • Empirical validation: Compare simulation output against measured data from real buildings or controlled experiments. ASHRAE Standard 140 (BESTEST) provides standardized test cases for energy simulation engines.
  • Comparative validation: Compare results from two different simulation engines on the same model. Agreement builds confidence; disagreement demands investigation.
  • Sensitivity analysis: Vary uncertain inputs (material properties, schedules, weather data) and observe the effect on outputs. If results are highly sensitive to an uncertain input, invest effort in getting that input right.

Mesh Independence Studies

For any spatially discretized simulation (daylight grids, CFD meshes, FEM meshes):

  1. Run the simulation with a coarse mesh.
  2. Refine the mesh (halve cell size) and rerun.
  3. Compare results at key locations.
  4. If results change by more than 5%, refine further.
  5. Repeat until results converge (< 2% change between successive refinements).
  6. Report the final mesh resolution and the convergence behavior.

Mesh independence is non-negotiable for CFD and strongly recommended for daylight grids. A simulation on an inadequate mesh is not worth the computation time.

Result Interpretation Guidelines

  • Order of magnitude: Do results fall within the expected range for this building type and climate? An EUI of 500 kWh/m²/yr for a well-insulated office is wrong.
  • Spatial distribution: Do daylight, temperature, and wind maps show physically plausible patterns? Symmetric buildings should produce symmetric results.
  • Temporal patterns: Do energy loads follow expected seasonal patterns? Cooling should peak in summer, heating in winter (for most climates).
  • Comparative ranking: Even if absolute values are uncertain, the relative ranking of design options is usually reliable. Use simulation for comparison, not prediction.

Common Errors and Diagnostic Checklist

ErrorSymptomFix
Missing surfacesUnrealistic heat loss / daylightCheck for gaps in geometry
Wrong boundary conditionsAdiabatic exterior wallsVerify face types (wall/floor/roof)
Interior walls as exteriorExcessive heating/cooling loadsCheck adjacencies between rooms
Wrong weather fileResults don't match climateVerify EPW location matches project
Schedule errorsOvernight loads in unoccupied buildingReview occupancy and HVAC schedules
Unit confusionValues 10x too high or lowCheck W vs kW, m² vs ft², °C vs °F
Insufficient Radiance bouncesDark interiors, low daylight valuesIncrease -ab parameter
Coarse CFD meshSmoothed-out wind patternsRefine mesh, check independence
Wrong material propertiesUnrealistic surface temperaturesVerify conductivity, reflectance, etc.
Unconverged CFDOscillating residualsImprove mesh quality, check BC setup

When to Trust Results vs. Use Engineering Judgment

Trust simulation results when:

  • The model has been validated against analytical or empirical benchmarks.
  • Mesh independence has been demonstrated.
  • Material properties and boundary conditions are well-characterized.
  • Results are within expected physical ranges.
  • Sensitivity analysis shows results are robust to uncertain inputs.

Use engineering judgment when:

  • Input data is highly uncertain (occupant behavior, future climate).
  • The simulation engine has known limitations for the specific case.
  • Results contradict well-established physical principles.
  • The model uses significant simplifications (shoebox model, ideal HVAC).
  • Computational constraints prevented adequate mesh resolution.

Reporting Simulation Results

Professional simulation reports should include:

  1. Executive summary: Key findings and recommendations in non-technical language.
  2. Model description: Geometry, materials, boundary conditions, assumptions.
  3. Simulation setup: Engine, version, settings, mesh details, weather data.
  4. Results: Spatial maps, charts, tables with clear units and legends.
  5. Interpretation: What the results mean for design decisions.
  6. Limitations: What the simulation does not capture, uncertainty bounds.
  7. Recommendations: Specific design actions supported by the analysis.
  8. Appendices: Detailed input data, convergence plots, sensitivity results.

Never present simulation results without stating the assumptions and limitations. A number without context is more dangerous than no number at all.


Quick Reference: Simulation Engine Selection

Analysis needRecommended engineLadybug toolAccuracy level
Daylight factorRadianceHoneybeeHigh
Annual daylight (sDA/ASE)Radiance (3/5-phase)HoneybeeHigh
Glare analysisRadiance + EvalglareHoneybeeHigh
Solar radiationBuilt-in (Tregenza method)LadybugMedium-High
Sun hours / shadowBuilt-in (ray intersection)LadybugHigh
Building energy (annual)EnergyPlusHoneybeeHigh
Building energy (early stage)Degree-day / lookupManualLow-Medium
Outdoor wind comfortOpenFOAMButterflyMedium-High
Indoor thermal comfort (PMV)EnergyPlusHoneybeeHigh
Outdoor thermal comfort (UTCI)Built-inLadybugMedium
Urban microclimateENVI-metExternalHigh
Room acousticsPachydermExternal (GH)Medium-High
Outdoor noiseISO 9613 / CadnaAExternalMedium-High

Key Formulas Reference

Daylight Factor: DF = (Ei / Eo) * 100% Where Ei = indoor illuminance, Eo = unobstructed outdoor diffuse horizontal illuminance.

Sabine reverberation time: RT60 = 0.161 * V / A Where V = volume (m³), A = total absorption (m² Sabins).

Natural ventilation flow rate: Q = Cd * A * sqrt(2 * deltaP / rho) Where Cd = discharge coefficient (~0.6), A = opening area, deltaP = pressure difference, rho = air density.

Solar heat gain through glazing: Qsolar = A_glazing * SHGC * I_solar Where SHGC = solar heat gain coefficient, I_solar = incident solar radiation (W/m²).

Thermal transmittance (U-value): U = 1 / R_total R_total = R_si + sum(d_i / k_i) + R_se Where R_si/R_se = surface resistances, d = thickness, k = conductivity.

UTCI (simplified approximation): UTCI ≈ f(Ta, Tr, va, RH) — computed via 6th-order polynomial regression.

Reynolds number: Re = rho * v * L / mu Where rho = air density, v = velocity, L = characteristic length, mu = dynamic viscosity. Re > 4000 indicates turbulent flow (for external aerodynamics, Re >> 10^6 always turbulent).

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.