Shade analysis in a canopy configurator: sun path, shaded area and clear height
How a canopy and shade sail configurator calculates shade: sun position, projection, share of the area in shade, the clear height check and roof rules.
Short answer: a canopy or shade sail configurator works out shade in three steps. It finds the sun position from latitude, season, time and orientation, projects every roof face along the sun direction onto the ground, and counts how much of the covered area lies in shade. Add a clear height check against the buyer's requirement and rules for which roof type goes with which mounting and roofing. Our example configurator does all of this with example values.
How is the sun position calculated?
In the example configurator the user sets four things:
- Latitude: 52°, 45°, 38° or 30° north.
- Season: June, equinox or December, with a solar declination of +23.44°, 0° or −23.44°.
- Time: solar time in quarter hours. There is no equation of time, and the slider only covers times when the sun is at least 8° above the horizon.
- Orientation: the compass direction the front faces, in eight steps. The model stays put; the compass and the sun turn.
The sun height follows from an hour angle of 15° per hour from noon. Worked example: 52° N, 21 June, 3 pm solar time, so an hour angle of 45°. sin h = sin 52° · sin 23.44° + cos 52° · cos 23.44° · cos 45° = 0.7129, so the sun stands 45.5° high, from 247.7° (west-south-west). The demo shows 45.47° and 247.68°. Noon in June gives 61.4° and noon in December 14.6°; both matched the hand calculation in the independent check.
How are the shaded area and the share in shade found?
Every triangle of the roof surface is projected along the sun direction onto the ground and written into a grid of up to about 160,000 cells. That gives two numbers:
- Shaded area in m²: every cell the shadow falls on.
- Share of the covered area in shade: the shadow overlaid on the roof footprint, divided by the footprint.
For wall mounts, the part behind the facade is left out. The same grid draws the shade on the ground, so the overlay, the 3D view and the number always agree.
A checked example: the 9 × 5 m playground canopy with a mono-pitch roof casts 48.7 m² of shade at 3 pm in June over a 46.5 m² covered footprint. With an eaves height of about 2.9 m, the shadow moves roughly 2.7 m east and 1.1 m north, so only 55 % of the covered area is in shade. At noon in December the shadow is larger, 68.3 m², but misses the area under the roof completely: 0 %. That is exactly what a buyer cannot see when only roof area is on sale.
The shade table sums it up: the share in shade at 9 am, noon and 3 pm in the three seasons. If the sun is below 8° at one of those times, the cell shows a dash.
What does the roofing's light transmission do?
Each of the six roofings carries a sample light-transmission value: clear polycarbonate 0.80, opal 0.45, tinted 0.30, steel 0, HDPE fabric 0.18, PVC fabric 0.06. The value makes the overlay lighter or darker. It does not change the shaded area, which is a geometric projection. From 0.6 upwards the roof casts no real-time shadow in the 3D view. In your configurator these become the values from your datasheets, with their source.
How is the clear height checked?
The buyer picks a minimum: 2.10, 2.50 or 3.00 m. The check compares it with the clear height at the lowest underside. Depending on the roof type, that is the eaves beam, the underside of the cantilever arms at the posts, the front edge of a wall canopy, or the low corners of a sail. If the height falls short, the dimension line and the height label turn red and the check states both values. In testing, 2.60 m against a 3.00 m requirement produced exactly that warning; at 3.00 m it was met.
Which roof type goes with which mounting and roofing?
| Roof type | Mounting | Walkways | Roofings in the example |
|---|---|---|---|
| Mono-pitch | Freestanding or wall | Yes | Clear, opal or tinted polycarbonate, steel, PVC fabric |
| Curved | Freestanding or wall | Yes | As mono-pitch |
| Hip-end | Freestanding only | No | Opal polycarbonate, steel, HDPE and PVC fabric |
| Hypar sail | Freestanding only | No | HDPE and PVC fabric |
| Cantilever | Freestanding or wall | No | Clear, opal or tinted polycarbonate, steel |
Further example rules: no gutters on sails or on permeable HDPE fabric. No side screens on sails or wall canopies, no back screen when wall-mounted, and only end screens on walkways with corners. If the user picks a combination the example range does not offer, the configurator switches to a valid one and explains why.
Walkways follow their own logic. The route is straight or has corners as an L, U or Z, and the user picks a maximum post spacing between 2.5 and 5.0 m. Each section gets as many bays as it needs to stay within that spacing. At a corner two roofs cross; the example has no dedicated corner gutters.
What goes into the summary, enquiry and PDF?
The summary shows the same rows as the enquiry text and the PDF, plus the shade table and the checks. The PDF carries a three-quarter view and a top view with the shade. In testing, all 15 rows were identical in summary, enquiry text and PDF, in metres in German and in feet and inches in English.
Example configurator · fictional product
Canopy & shade structure configurator
Plan a canopy for a school, walkway, entrance or play area: choose the roof type, size, bays, roofing and colour – then move the sun and see how much shade it casts, and when.
Try it in the canopy and shade structure configurator. Who benefits from such a configurator is covered in canopy and shade structure configurators. How the sun model, phones and data upkeep are handled is in implementing outdoor structure configurators; the project itself in custom 3D configurator development.
Frequently asked questions
How accurate is the shade value?
It is a geometric estimate of direct sun, without reflections, trees or neighbouring buildings, and without the light transmission in the area. That can be enough for a first committee discussion; it does not replace a shading study.
Why solar time rather than clock time?
Solar time puts the sun's highest point at noon and keeps the calculation simple. Time zone and equation of time for a specific site can be added in a project.
Does the configurator check the structure?
No. Structure, foundations, snow and wind loads are confirmed by the manufacturer for the actual site. The demo says so explicitly in its checks.
Sources
- Modelwright library: canopy and shade structure configurator, "Live in this demo" list, read 14 November 2026: modelwright.de/en/library/canopy-shade-configurator/


