Play a daily shadow study: the day is traced once between sunrise and sunset, then Play / Time / Speed step through it. Up to eight named time ranges colour the shade and get their own statistics; Export writes the active viewport as PNG frames (and an MP4 when ffmpeg is on PATH).
Input
Name
Nickname
Description
Type
Context
C
Shading geometry: buildings, terrain, canopies.
Geometry
Points
P
Analysis points.
Point
Weather
W
Weather record from Download Weather or Open Weather — its site sets the sun and its time zone the clock (standard time, no daylight saving).
Generic Data
Month
Mon
Month of the study date, 1-12.
Integer
Day
Day of the month of the study date.
Integer
Hours
Hrs
Local hours to animate, e.g. 8 To 18. Always clamped to the date's sunrise and sunset, so the default 0 To 24 is the whole day.
Domain
Step
Minutes between frames, at least 1.
Number
Ranges
Rng
Up to eight named time ranges, one per line: "Morning 7-11", "Lunch 11:30-13:15". They may overlap (the earlier line colours the shared frames; statistics count them in both) or leave gaps (shade there keeps the plain shade colour).
Text
Range Colors
RCol
One colour per range, in order. Missing colours come from a built-in palette.
Colour
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.
Number
Speed
Spd
Playback speed in frames per second (0.1-20); also the MP4's frame rate.
Number
Time
T
Scrub: a local hour (e.g. 14.5) jumps to the nearest frame whenever this value changes. Wire a slider over the Hours range.
Number
Play
Advance one frame per tick while on; off pauses on the current frame.
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
Export
Exp
Capture the active viewport at every frame. Edge-triggered: a click, or a wired value turning true, exports once.
Boolean
Output
Name
Nickname
Description
Type
Time
T
Local hour of the frame shown.
Number
Lit
L
Lit or shaded at each point, this frame.
Boolean
Colors
Col
This frame: sunlit yellow; shaded points take the colour of the range the frame falls in, or the plain shade blue in a gap.
Colour
Sunlit Points
SP
Just the lit points, this frame.
Point
Range Shade
RS
Per range (one branch each, in range order), each point's share of that range's frames spent in shade, 0-1. Empty branch for a range no frame falls in.
Number
Legend
Leg
Legend labels matching Legend Colors: each range with its daylight-clamped hours, then plain shade and sunlit.
Text
Legend Colors
LCol
Colours for Legend.
Colour
Report
R
Daylight window, frames, per-range statistics and the last export's result.