Simulation Core - Revision history

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

2026-07-10T13:14:42Z

← Older revision		Revision as of 13:14, 10 July 2026
Line 12:		Line 12:
	'''Step 1:''' The API [[Triggers]] (with timing BEFORE) are executed.		'''Step 1:''' The API [[Triggers]] (with timing BEFORE) are executed.

	'''Step 2:''' Then all [[Update (TQL)\|<code>UPDATE</code>]] queries (with timing BEFORE) of [[Indicator]]s, [[Panel]]s and ~~query~~ [[Global]]s.		'''Step 2:''' Then all [[Update (TQL)\|<code>UPDATE</code>]] queries (with timing BEFORE) of [[Indicator]]s, [[Panel]]s and [[Global]]s.

	'''Step 3:''' Grids are calculated:		'''Step 3:''' Grids are calculated:
Line 20:		Line 20:
	* When all jobs have finished the Simulation model compresses the resulting data into a compact format which is stored in the Overlay.		* When all jobs have finished the Simulation model compresses the resulting data into a compact format which is stored in the Overlay.

	'''Step 4:''' Then all [[Update (TQL)\|<code>UPDATE</code>]] queries (with timing AFTER) of [[Indicators]], [[Panels]] and ~~query~~ [[Globals]].		'''Step 4:''' Then all [[Update (TQL)\|<code>UPDATE</code>]] queries (with timing AFTER) of [[Indicators]], [[Panels]] and [[Globals]].

	'''Step 5:''' Update Calculators:		'''Step 5:''' Update Calculators:
	* All Calculators ([[Indicators]], [[Panels~~]] and [[Globals~~]]) execute all their TQL queries simultaneously (note: simultaneously means that you cannot update an attribute in one calculator and fetch it in the other).		* All Calculators ([[Indicators]] and [[Panels]]) execute all their TQL queries simultaneously (note: simultaneously means that you cannot update an attribute in one calculator and fetch it in the other).
	* 5A: Update calculators without a <code>SCORE</code> query.		* 5A: Update calculators without a <code>SCORE</code> query.
	* 5B: Sequentially update all calculators containing a <code>SCORE</code> query (calculated in step 5A).		* 5B: Sequentially update all calculators containing a <code>SCORE</code> query (calculated in step 5A).

Frank@tygron.nl at 13:33, 8 July 2026

2026-07-08T13:33:06Z

← Older revision		Revision as of 13:33, 8 July 2026
Line 46:		Line 46:
	{{article end		{{article end
	\|notes=		\|notes=
	* When the project contains multiple iterations the process is ~~restarted at~~ step 1 and loops until all iterations have been completed.		* When the project contains multiple iterations the process is repeated from step 2 and loops until all iterations have been completed.
	\|seealso=		\|seealso=
	* [[Calculation panel]]		* [[Calculation panel]]

Frank@tygron.nl at 09:59, 7 July 2026

2026-07-07T09:59:33Z

← Older revision		Revision as of 09:59, 7 July 2026
Line 32:		Line 32:

	=Limit Map=		=Limit Map=
	* [[Limit Map]] ~~determines the rectangle that will be part of~~ the simulation, ~~when empty~~ the entire map is used.		* The [[Limit Map]] defines the simulation area; if left empty, the entire map is used.
	* ~~When you do not want~~ to ~~calculate the entire map (e.g. due~~ to ~~memory limits or performance) but only~~ a ~~rectangle~~ subsection ~~use this option~~.		* Use this option to limit calculations to a rectangular subsection for better performance or lower memory usage.

	=Iterations=		=Iterations=

Maxim@tygron.com at 15:49, 2 July 2026

2026-07-02T15:49:53Z

← Older revision		Revision as of 15:49, 2 July 2026
Line 1:		Line 1:
	Each Project in the {{software}} features its own Simulation Core, which is responsible for updating the [[Excel]] file, managing [[~~Triggers~~]], and handling [[Grid Overlay]]s.		Each Project in the {{software}} features its own Simulation Core, which is responsible for updating the [[Excel]] file, managing [[Trigger]]s, and handling [[Grid Overlay]]s.

	* An update is initiated by a User via the [[Editor]], an [[API]] call, or when the state changes, such as the addition of a new building, while "auto update" is enabled. Triggering a [[Calculation_panel#Reset_X-Queries\|Reset X-Queries]] also executes '''Init''' again.		* An update is initiated by a User via the [[Editor]], an [[API]] call, or when the state changes, such as the addition of a new building, while "auto update" is enabled. Triggering a [[Calculation_panel#Reset_X-Queries\|Reset X-Queries]] also executes '''Init''' again.
Line 8:		Line 8:
	Below is an overview of each step involved:		Below is an overview of each step involved:

	'''Init:''' Simulation models for [[~~Overlays~~]] are created and most attributes are initialized. For example the Water model initialized if groundwater is active or not. Also the [[Excel]] files are initialized and [[X query (Excel)\|X-queries]] are created.		'''Init:''' Simulation models for [[Overlay]]s are created and most attributes are initialized. For example, the Water model is initialized if groundwater is active or not. Also the [[Excel]] files are initialized and [[X query (Excel)\|X-queries]] are created.

	'''Step 1:''' The API [[Triggers]] (with timing BEFORE) are executed.		'''Step 1:''' The API [[Triggers]] (with timing BEFORE) are executed.

	'''Step 2:''' Then all [[Update (TQL)\|<code>UPDATE</code>]] queries (with timing BEFORE) of [[~~Indicators~~]], [[~~Panels~~]] and query [[~~Globals~~]].		'''Step 2:''' Then all [[Update (TQL)\|<code>UPDATE</code>]] queries (with timing BEFORE) of [[Indicator]]s, [[Panel]]s and query [[Global]]s.

	'''Step 3:''' Grids are calculated:		'''Step 3:''' Grids are calculated:
	* [[Rasterization]] starts: All polygon data ([[~~buildings~~]], [[~~terrains~~]], [[~~areas~~]], etc) is converted into grid data. This process is shared by all active [[~~Overlays~~]] for faster execution and is also the reason why all active Overlays must have the same cell size.		* [[Rasterization]] starts: All polygon data ([[Building]]s, [[Terrain]]s, [[Area]]s, etc) is converted into grid data. This process is shared by all active [[Overlay]]s for faster execution and is also the reason why all active Overlays must have the same cell size.
	* The Simulation models now ~~contains~~ the required grid data and may do some additional validation on them. For example are ~~there~~ no elevation values above 10.000 meters.		* The Simulation models now contain the required grid data and may do some additional validation on them. For example, ensuring there are no elevation values above 10,000 meters.
	* The Simulation model schedules jobs that are executed either on an GPU Cluster or regular CPU. The jobs are scheduled in such a way that [[~~prequel~~]] Overlays will be executed before the receiving [[Overlay]].		* The Simulation model schedules jobs that are executed either on a [[GPU Cluster]] or regular CPU. The jobs are scheduled in such a way that [[Prequel]] Overlays will be executed before the receiving [[Overlay]].
	* When all jobs have finished the Simulation model compresses the resulting data into a compact format which is stored in the Overlay.		* When all jobs have finished the Simulation model compresses the resulting data into a compact format which is stored in the Overlay.

Line 37:		Line 37:
	=Iterations=		=Iterations=
	{{technical\|type=section}}		{{technical\|type=section}}
	* The [[Setting]] <code>ITERATIONS</code> determines how many times this ~~processes~~ is repeated from step 2.		* The [[Setting]] <code>ITERATIONS</code> determines how many times this process is repeated from step 2.
	* When the [[Grid Overlay]] has a [[Iteration active (Grid Overlay)\|ITERATION_ACTIVE]] attribute, only the iteration numbers set in this attribute will be executed. For example <code>ITERATION_ACTIVE: 0 5</code> will only calculate in iteration 0 and 5.		* When the [[Grid Overlay]] has a [[Iteration active (Grid Overlay)\|ITERATION_ACTIVE]] attribute, only the iteration numbers set in this attribute will be executed. For example <code>ITERATION_ACTIVE: 0 5</code> will only calculate in iteration 0 and 5.

Line 46:		Line 46:
	{{article end		{{article end
	\|notes=		\|notes=
	* When the project contains multiple iterations the process is restarted at step 1 and loops ~~untill~~ all ~~iteration~~ have been completed.		* When the project contains multiple iterations the process is restarted at step 1 and loops until all iterations have been completed.
	\|seealso=		\|seealso=
	* [[Calculation panel]]		* [[Calculation panel]]
	* [[Limit Map]]		* [[Limit Map]]
	* [[Iteration active (Grid Overlay)\|ITERATION_ACTIVE]]		* [[Iteration active (Grid Overlay)\|ITERATION_ACTIVE]]
			\|api=
			[[Api session event editor update]]
	}}		}}

Maxim@tygron.com at 14:33, 6 March 2026

2026-03-06T14:33:24Z

← Older revision		Revision as of 14:33, 6 March 2026
Line 15:		Line 15:

	'''Step 3:''' Grids are calculated:		'''Step 3:''' Grids are calculated:
	* [[~~Rasterization model\|~~Rasterization]] starts: All polygon data ([[buildings]], [[terrains]], [[areas]], etc) is converted into grid data. This process is shared by all active [[Overlays]] for faster execution and is also the reason why all active Overlays must have the same cell size.		* [[Rasterization]] starts: All polygon data ([[buildings]], [[terrains]], [[areas]], etc) is converted into grid data. This process is shared by all active [[Overlays]] for faster execution and is also the reason why all active Overlays must have the same cell size.
	* The Simulation models now contains the required grid data and may do some additional validation on them. For example are there no elevation values above 10.000 meters.		* The Simulation models now contains the required grid data and may do some additional validation on them. For example are there no elevation values above 10.000 meters.
	* The Simulation model schedules jobs that are executed either on an GPU Cluster or regular CPU. The jobs are scheduled in such a way that [[prequel]] Overlays will be executed before the receiving [[Overlay]].		* The Simulation model schedules jobs that are executed either on an GPU Cluster or regular CPU. The jobs are scheduled in such a way that [[prequel]] Overlays will be executed before the receiving [[Overlay]].

Maxim@tygron.com: /* Rasterization */

2026-03-06T14:31:10Z

Rasterization

← Older revision		Revision as of 14:31, 6 March 2026
Line 41:		Line 41:

	=Rasterization=		=Rasterization=
	* The [[Rasterization ~~model~~]] determines how polygons are converted to grid cells.		* The [[Rasterization]] determines how polygons are converted to grid cells.
	* By default the combined option is selected.		* By default the combined option is selected.

Maxim@tygron.com: /* Steps */

2026-03-05T12:01:38Z

Steps

← Older revision		Revision as of 12:01, 5 March 2026
Line 15:		Line 15:

	'''Step 3:''' Grids are calculated:		'''Step 3:''' Grids are calculated:
	* Rasterization starts: All polygon data ([[buildings]], [[terrains]], [[areas]], etc) is converted into grid data. This process is shared by all active [[Overlays]] for faster execution and is also the reason why all active Overlays must have the same cell size.		* [[Rasterization model\|Rasterization]] starts: All polygon data ([[buildings]], [[terrains]], [[areas]], etc) is converted into grid data. This process is shared by all active [[Overlays]] for faster execution and is also the reason why all active Overlays must have the same cell size.
	* The Simulation models now contains the required grid data and may do some additional validation on them. For example are there no elevation values above 10.000 meters.		* The Simulation models now contains the required grid data and may do some additional validation on them. For example are there no elevation values above 10.000 meters.
	* The Simulation model schedules jobs that are executed either on an GPU Cluster or regular CPU. The jobs are scheduled in such a way that [[prequel]] Overlays will be executed before the receiving [[Overlay]].		* The Simulation model schedules jobs that are executed either on an GPU Cluster or regular CPU. The jobs are scheduled in such a way that [[prequel]] Overlays will be executed before the receiving [[Overlay]].

Maxim@tygron.com at 09:26, 13 February 2026

2026-02-13T09:26:04Z

← Older revision		Revision as of 09:26, 13 February 2026
Line 23:		Line 23:

	'''Step 5:''' Update Calculators:		'''Step 5:''' Update Calculators:
	* All Calculators ([[Indicators]], [[Panels]] and [[Globals]]) execute all their TQL queries simultaneously.		* All Calculators ([[Indicators]], [[Panels]] and [[Globals]]) execute all their TQL queries simultaneously (note: simultaneously means that you cannot update an attribute in one calculator and fetch it in the other).
	* 5A: Update calculators without a <code>SCORE</code> query.		* 5A: Update calculators without a <code>SCORE</code> query.
	* 5B: Sequentially update all calculators containing a <code>SCORE</code> query (calculated in step 5A).		* 5B: Sequentially update all calculators containing a <code>SCORE</code> query (calculated in step 5A).

Maxim@tygron.com: /* Rasterization */

2026-02-09T13:13:53Z

Rasterization

← Older revision		Revision as of 13:13, 9 February 2026
Line 41:		Line 41:

	=Rasterization=		=Rasterization=
	* The [[Rasterization ~~Model~~]] determines how polygons are converted to grid cells.		* The [[Rasterization model]] determines how polygons are converted to grid cells.
	* By default the combined option is selected.		* By default the combined option is selected.



	{{article end		{{article end

Maxim@tygron.com at 13:13, 9 February 2026

2026-02-09T13:13:33Z

← Older revision		Revision as of 13:13, 9 February 2026
Line 39:		Line 39:
	* The [[Setting]] <code>ITERATIONS</code> determines how many times this processes is repeated from step 2.		* The [[Setting]] <code>ITERATIONS</code> determines how many times this processes is repeated from step 2.
	* When the [[Grid Overlay]] has a [[Iteration active (Grid Overlay)\|ITERATION_ACTIVE]] attribute, only the iteration numbers set in this attribute will be executed. For example <code>ITERATION_ACTIVE: 0 5</code> will only calculate in iteration 0 and 5.		* When the [[Grid Overlay]] has a [[Iteration active (Grid Overlay)\|ITERATION_ACTIVE]] attribute, only the iteration numbers set in this attribute will be executed. For example <code>ITERATION_ACTIVE: 0 5</code> will only calculate in iteration 0 and 5.

			=Rasterization=
			* The [[Rasterization Model]] determines how polygons are converted to grid cells.
			* By default the combined option is selected.



	{{article end		{{article end