Template:Shade calculation model - Revision history

Frank@tygron.nl: Frank@tygron.nl moved page Shade calculation model to Template:Shade calculation model

2026-03-11T09:01:21Z

Frank@tygron.nl moved page Shade calculation model to Template:Shade calculation model

← Older revision	Revision as of 09:01, 11 March 2026
(No difference)

Frank@tygron.nl at 08:34, 11 March 2026

2026-03-11T08:34:10Z

← Older revision		Revision as of 08:34, 11 March 2026
Line 27:		Line 27:
	}}		}}
	</includeonly>		</includeonly>
	<noinclude>		<noinclude>This page is a template page, for the contextual Shade calculation model pages see:
	This page is a template page, for the contextual Shade calculation model pages see:
	*[[Shade calculation model (Heat Overlay)]]		*[[Shade calculation model (Heat Overlay)]]
	*[[Shade calculation model (Shadow Overlay)]]		*[[Shade calculation model (Shadow Overlay)]]
	</noinclude>		</noinclude>

Frank@tygron.nl at 08:34, 11 March 2026

2026-03-11T08:34:01Z

← Older revision		Revision as of 08:34, 11 March 2026
Line 30:		Line 30:
	This page is a template page, for the contextual Shade calculation model pages see:		This page is a template page, for the contextual Shade calculation model pages see:
	*[[Shade calculation model (Heat Overlay)]]		*[[Shade calculation model (Heat Overlay)]]
	*[[Shade calculation model (~~Shade~~ Overlay)]]		*[[Shade calculation model (Shadow Overlay)]]
	</noinclude>		</noinclude>

Frank@tygron.nl at 08:33, 11 March 2026

2026-03-11T08:33:49Z

← Older revision		Revision as of 08:33, 11 March 2026
Line 27:		Line 27:
	}}		}}
	</includeonly>		</includeonly>
			<noinclude>
			This page is a template page, for the contextual Shade calculation model pages see:
			*[[Shade calculation model (Heat Overlay)]]
			*[[Shade calculation model (Shade Overlay)]]
			</noinclude>

Frank@tygron.nl at 12:34, 5 March 2026

2026-03-05T12:34:50Z

← Older revision		Revision as of 12:34, 5 March 2026
Line 1:		Line 1:
			<includeonly>
	The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates ({{{1\|}}})\|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 ({{{1\|}}})\|date and the time of day]] and the world location of the project.

Line 26:		Line 26:
	* [[Shade result type ({{{1\|}}})]]		* [[Shade result type ({{{1\|}}})]]
	}}		}}
			</includeonly>

Frank@tygron.nl at 11:24, 13 February 2025

2025-02-13T11:24:49Z

← Older revision		Revision as of 11:24, 13 February 2025
Line 22:		Line 22:
	\|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 ({{{1}}})\|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 ({{{1\|}}})\|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 ({{{1}}})]]		* [[Shade result type ({{{1\|}}})]]
	}}		}}

Frank@tygron.nl at 11:24, 13 February 2025

2025-02-13T11:24:15Z

← Older revision		Revision as of 11:24, 13 February 2025
Line 1:		Line 1:

	The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates ({{{1}}})\|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 ({{{1\|}}})\|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 ({{{1}}})\|sun altitude]] and [[Sun azimuth ({{{1}}})\|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the [[Dates ({{{1}}})\|date]] of the timeframe.		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 ({{{1\|}}})\|sun altitude]] and [[Sun azimuth ({{{1\|}}})\|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the [[Dates ({{{1\|}}})\|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:

Frank@tygron.nl at 10:53, 13 February 2025

2025-02-13T10:53:00Z

← Older revision		Revision as of 10:53, 13 February 2025
Line 1:		Line 1:

	The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates ({{1}})\|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 ({{{1}}})\|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 ({{1}})\|sun altitude]] and [[Sun azimuth ({{1}})\|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the [[Dates ({{1}})\|date]] of the timeframe.		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 ({{{1}}})\|sun altitude]] and [[Sun azimuth ({{{1}}})\|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the [[Dates ({{{1}}})\|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 22:		Line 22:
	\|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 ({{1}})\|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 ({{{1}}})\|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 ({{1}})]]		* [[Shade result type ({{{1}}})]]
	}}		}}

Frank@tygron.nl: Created page with " The shade is dependent on the location of the sun. This in turn is dependent on the 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 and sun azimuth angle. These angles are calculated automatically based on the world location of your project and the..."

2025-02-13T10:52:20Z

Created page with " The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates ({{1}})|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 ({{1}})|sun altitude]] and [[Sun azimuth ({{1}})|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the..."

New page

The shade is dependent on the location of the sun. This in turn is dependent on the [[Dates ({{1}})|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 ({{1}})|sun altitude]] and [[Sun azimuth ({{1}})|sun azimuth angle]]. These angles are calculated automatically based on the world location of your project and the [[Dates ({{1}})|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 ({{1}})|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 ({{1}})]]
}}