Custom Variable¶

Custom Variable statistics record time-evolving descripted statistics associated with defined Voxel Variables. The results are written to tab-separated ASCII .txt files named CustomVar_{DynamicName}.txt, where the dynamic name corresponds to the name of the Custom Variable in the model tree. This file is appended with new data at the Statistics Output Write Interval.

Statistics Table¶

The index table below shows the statistics that will appear in the Custom Variable output file. Within this table, each statistic corresponds to a column in the output table that evolves with the time column. The units described are engineering output units.

Statistics	Units	Details
Time	s	simulation time
Max	[dynamic]	spatial max of custom variable value
Mean	[dynamic]	spatial mean of custom variable value
Min	[dynamic]	spatial min of custom variable value

Usage and Interpretation¶

Custom Variable statistics track the time evolution of user-defined voxel-based quantities. For each Custom Variable, the output reports the spatial mean, minimum, and maximum values across the domain at every statistics write interval. The mean represents the overall magnitude of the variable and the min or max identify localized extremes, such as peaks or depleted regions. In practice, these statistics are used to monitor convergence, assess transient behavior, and detect spatial non-uniformities.