Shade calculation model (Shadow Overlay) - Revision history

Frank@tygron.nl at 14:21, 13 July 2026

2026-07-13T14:21:03Z

← Older revision		Revision as of 14:21, 13 July 2026
Line 12:		Line 12:

	<gallery mode="nolines">		<gallery mode="nolines">
	File:shaded Heat Overlay.png\|300px\|Rays to the sky are blocked by a tall ~~construction~~, so the cell is considered to be in the shade.		File:shaded Heat Overlay.png\|300px\|Rays to the sky are blocked by a tall Building, so the cell is considered to be in the shade.
	File:unshaded Heat Overlay.png\|300px\|Rays to the sky are uninterrupted, so the cell is in direct sunlight.		File:unshaded Heat Overlay.png\|300px\|Rays to the sky are uninterrupted, so the cell is in direct sunlight.
	</gallery>		</gallery>

Frank@tygron.nl at 07:57, 10 July 2026

2026-07-10T07:57:32Z

← Older revision		Revision as of 07:57, 10 July 2026
Line 24:		Line 24:
	\|seealso=		\|seealso=
	* [[Shade result type (Shadow Overlay)]]		* [[Shade result type (Shadow Overlay)]]
			\|api=* [[Api session items overlays]]
			* [[Api session event editor overlay add]]
			* [[Api session event editor overlay add result child]]
			* [[Api session event editor overlay set key value]]
			* [[Api session event editor overlay set prequel]]
			* [[Api session event editor overlay set attribute]]
	}}		}}

	{{ShadowOverlay nav}}		{{ShadowOverlay nav}}

Frank@tygron.nl at 07:56, 10 July 2026

2026-07-10T07:56:33Z

← Older revision		Revision as of 07:56, 10 July 2026
Line 23:		Line 23:
	* This model uses a maximum ray testing range, which can be configured using the [[Max shadow distance (Shadow Overlay)\|MAX_SHADOW_DISTANCE]]. This setting can be configured with a values between 100 m and 1000 m. This also means that calculated shadows cannot potentially be larger than the configured distance. The maximum shadow distance has no effect on the orientation of the shade.		* This model uses a maximum ray testing range, which can be configured using the [[Max shadow distance (Shadow Overlay)\|MAX_SHADOW_DISTANCE]]. This setting can be configured with a values between 100 m and 1000 m. This also means that calculated shadows cannot potentially be larger than the configured distance. The maximum shadow distance has no effect on the orientation of the shade.
	\|seealso=		\|seealso=
	* [[Shade result type (Shadow Overlay]]		* [[Shade result type (Shadow Overlay)]]
	}}		}}

	{{ShadowOverlay nav}}		{{ShadowOverlay nav}}

Frank@tygron.nl at 07:56, 10 July 2026

2026-07-10T07:56:27Z

← Older revision		Revision as of 07:56, 10 July 2026
Line 1:		Line 1:
	The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates (Shadow Overlay\|date and the time of day]] and the world location of the project.		The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates (Shadow Overlay)\|date and the time of day]] and the world location of the project.

	Since each timeframe result of a [[~~{{{1\|}}}~~]] is related to a particular date and time of day, each time frame will have a related [[Sun altitude (Shadow Overlay\|sun altitude]] and [[Sun azimuth (Shadow Overlay\|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the [[Dates (Shadow Overlay\|date]] of the timeframe.		Since each timeframe result of a [[Shadow Overlay]] is related to a particular date and time of day, each time frame will have a related [[Sun altitude (Shadow Overlay)\|sun altitude]] and [[Sun azimuth (Shadow Overlay)\|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the [[Dates (Shadow Overlay)\|date]] of the timeframe.

	Once the sun angles and the building, terrain and foliage height are known, whether the cell is shaded or not is computed as follows for each cell:		Once the sun angles and the building, terrain and foliage height are known, whether the cell is shaded or not is computed as follows for each cell:
Line 21:		Line 21:
	\|notes=		\|notes=
	* Shade calculations are based on the heights of [[Building]]s starting from the ground. When a [[Building]]s references to a [[Custom Geometry]], for any grid cell a building is considered solid all the way from the ground up to the highest part of the [[Custom Geometry]] within that grid cell. This allows for detailed roofs, shadows, and tapering shapes, but will not include holes within the height of the building, such as spaces under balconies. The exact interpreted heights can be inspected via a [[Digital Surface Model Overlay]].		* Shade calculations are based on the heights of [[Building]]s starting from the ground. When a [[Building]]s references to a [[Custom Geometry]], for any grid cell a building is considered solid all the way from the ground up to the highest part of the [[Custom Geometry]] within that grid cell. This allows for detailed roofs, shadows, and tapering shapes, but will not include holes within the height of the building, such as spaces under balconies. The exact interpreted heights can be inspected via a [[Digital Surface Model Overlay]].
	* This model uses a maximum ray testing range, which can be configured using the [[Max shadow distance (Shadow Overlay\|MAX_SHADOW_DISTANCE]]. This setting can be configured with a values between 100 m and 1000 m. This also means that calculated shadows cannot potentially be larger than the configured distance. The maximum shadow distance has no effect on the orientation of the shade.		* This model uses a maximum ray testing range, which can be configured using the [[Max shadow distance (Shadow Overlay)\|MAX_SHADOW_DISTANCE]]. This setting can be configured with a values between 100 m and 1000 m. This also means that calculated shadows cannot potentially be larger than the configured distance. The maximum shadow distance has no effect on the orientation of the shade.
	\|seealso=		\|seealso=
	* [[Shade result type (Shadow Overlay]]		* [[Shade result type (Shadow Overlay]]

Frank@tygron.nl at 07:55, 10 July 2026

2026-07-10T07:55:52Z

← Older revision		Revision as of 07:55, 10 July 2026
Line 1:		Line 1:
	~~<includeonly>~~
	The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates (Shadow Overlay\|date and the time of day]] and the world location of the project.		The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates (Shadow Overlay\|date and the time of day]] and the world location of the project.

Line 26:		Line 25:
	* [[Shade result type (Shadow Overlay]]		* [[Shade result type (Shadow Overlay]]
	}}		}}
	~~</includeonly>~~
	~~<noinclude>This page is a template page, for the contextual Shade calculation model pages see:~~
	*[[Shade calculation model (Heat Overlay)]]
	*[[Shade calculation model (Shadow Overlay)]]
	~~</noinclude>~~

	{{ShadowOverlay nav}}		{{ShadowOverlay nav}}

Frank@tygron.nl at 07:55, 10 July 2026

2026-07-10T07:55:26Z

← Older revision		Revision as of 07:55, 10 July 2026
Line 1:		Line 1:
	{{Shade ~~calculation~~ model \|Shadow Overlay}}		<includeonly>
			The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates (Shadow Overlay\|date and the time of day]] and the world location of the project.

			Since each timeframe result of a [[{{{1\|}}}]] is related to a particular date and time of day, each time frame will have a related [[Sun altitude (Shadow Overlay\|sun altitude]] and [[Sun azimuth (Shadow Overlay\|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the [[Dates (Shadow Overlay\|date]] of the timeframe.

			Once the sun angles and the building, terrain and foliage height are known, whether the cell is shaded or not is computed as follows for each cell:
			# Travel away from the cell in the direction of the sun azimuth angle.
			# For each cell traversed this way, calculate the height of the sun ray based on the altitude angle.
			# Compare the sun ray altitude with the maximum height (terrain, building and foliage) at the traversed cell.
			## If the surface height in the traversed cell higher, the cell is shaded and we can stop.
			## If the sun ray altitude in the traversed cell is higher, the calculation is performed again for the next traversed cell.
			## If all cells are traversed and the computation didn't stop in any cell, the cell can be reached by direct sunlight and the cell is not shaded.

			<gallery mode="nolines">
			File:shaded Heat Overlay.png\|300px\|Rays to the sky are blocked by a tall construction, so the cell is considered to be in the shade.
			File:unshaded Heat Overlay.png\|300px\|Rays to the sky are uninterrupted, so the cell is in direct sunlight.
			</gallery>

			[[File:Shade top_down.png\|400px]]

			{{article end
			\|notes=
			* Shade calculations are based on the heights of [[Building]]s starting from the ground. When a [[Building]]s references to a [[Custom Geometry]], for any grid cell a building is considered solid all the way from the ground up to the highest part of the [[Custom Geometry]] within that grid cell. This allows for detailed roofs, shadows, and tapering shapes, but will not include holes within the height of the building, such as spaces under balconies. The exact interpreted heights can be inspected via a [[Digital Surface Model Overlay]].
			* This model uses a maximum ray testing range, which can be configured using the [[Max shadow distance (Shadow Overlay\|MAX_SHADOW_DISTANCE]]. This setting can be configured with a values between 100 m and 1000 m. This also means that calculated shadows cannot potentially be larger than the configured distance. The maximum shadow distance has no effect on the orientation of the shade.
			\|seealso=
			* [[Shade result type (Shadow Overlay]]
			}}
			</includeonly>
			<noinclude>This page is a template page, for the contextual Shade calculation model pages see:
			*[[Shade calculation model (Heat Overlay)]]
			*[[Shade calculation model (Shadow Overlay)]]
			</noinclude>

	{{ShadowOverlay nav}}		{{ShadowOverlay nav}}

Frank@tygron.nl at 09:01, 11 March 2026

2026-03-11T09:01:55Z

← Older revision		Revision as of 09:01, 11 March 2026
Line 1:		Line 1:
	{{: Shade calculation model \|Shadow Overlay}}		{{Shade calculation model \|Shadow Overlay}}

	{{ShadowOverlay nav}}		{{ShadowOverlay nav}}

Frank@tygron.nl: Created page with "{{: Shade calculation model |Shadow Overlay}} {{ShadowOverlay nav}}"

2025-02-13T11:26:35Z

Created page with "{{: Shade calculation model |Shadow Overlay}} {{ShadowOverlay nav}}"

New page