Skip to content

Shadow - [source code]

Lit or shaded at each analysis point for one or more sun instants — the shadow's position, not accumulated sun hours.

Input

Name Nickname Description Type
Context C Shading geometry: buildings, terrain, canopies. Geometry
Points P Analysis points. Point
Normals N Optional per-point normals. A sun below a point's own horizon counts as shaded without tracing — a floor cannot be lit from beneath. Vector
Weather W Weather record from Download Weather or Open Weather. The sun's position for each evaluated hour comes from this file. Generic Data
HOY H Hours of the year to evaluate [1-8760], one result branch per hour — wire the Hour Of Year component to name a date and time. Left empty, every DAYLIGHT hour of the year is evaluated, which on a large grid is a long run. Integer
Offset O Distance to lift each point off its surface before tracing. Number
North Nth Counter-clockwise degrees from the model's +Y axis to true north (Ladybug's convention). The sun is rotated, not the model. Number
Engine Eng Who traces the rays. Auto: the OpenCL GPU when there is one, else the CPU. GPU: the OpenCL GPU; a fallback to the CPU is reported, never silent. CPU: the SIMD BVH on every core. Text
Date A report date — equinox (20 Mar), summer solstice (21 Jun) or winter solstice (21 Dec) — evaluates every daylight hour of that day and overrides HOY. Custom leaves HOY in charge. One component per date feeds the Sun Report's shadow grid. Text

Output

Name Nickname Description Type
Lit L True where the sun's disc is visible. One branch per sun sample. Boolean
Colors Col Sunlit yellow / shaded blue, matching the Sun Hours ramp's endpoints. Colour
Sunlit Points SP Just the lit points, flattened — convenient for a preview. Point
Report R Instants evaluated and the lit fraction of each. Text
Result Res The whole solve — every point at every instant — as ONE item. Feed it to Deconstruct Shadow to expand only the instants you want to look at. This is the output to use for anything longer than a handful of hours: the trees above are points x instants of boxed Grasshopper data, and an annual study is tens of millions of them. Generic Data