Memory Usage¶
The Memory Usage statistics provide time-resolved information on how memory is allocated and utilized by different components of the simulation. The name of this file is MemoryUsage.txt. The data is written as a time series, with each row corresponding to a simulation time and appended at the Statistics Output Write Interval. If your simulation is running out of memory, these statistics help identify the source.
Note
If the simulation fails to start due to memory allocation limitations, the cause is typically excessive lattice resolution. If the simulation runs out of memory during execution, it is most often due to too many particles being introduced into the system.
Statistics Table¶
The index table below shows the statistics that can appear in the Memory Usage output file. Within this table, each statistic corresponds to a column in the output table that evolves with the time column.
Statistics |
Units |
Details |
When Appears |
|---|---|---|---|
Time |
s |
simulation time |
|
Custom Variable |
GB |
amount of memory used by custom variable |
|
Custom Variable |
GB |
amount of memory used by custom variable |
|
Fluid |
GB |
amount of memory used by fluid |
|
Fluid |
GB |
amount of memory used by fluid |
|
Free GPU Memory |
GB |
current free memory available across all GPUs |
|
Global Variable |
GB |
amount of memory used by global variable |
|
Global Variable |
GB |
amount of memory used by global variable |
|
Inlet/Outlet |
GB |
amount of memory used by inlet/outlet |
|
Inlet/Outlet |
GB |
amount of memory used by inlet/outlet |
|
Mean Age |
GB |
amount of memory used by mean age |
|
Mean Age |
GB |
amount of memory used by mean age |
|
Moving Body |
GB |
amount of memory used by moving body |
|
Moving Body |
GB |
amount of memory used by moving body |
|
Moving Inlet/Outlet |
GB |
amount of memory used by moving inlet/outlet |
|
Moving Inlet/Outlet |
GB |
amount of memory used by moving inlet/outlet |
|
Other |
GB |
amount of memory used by non-categorized memory |
|
Other |
GB |
amount of memory used by non-categorized memory |
|
Output |
GB |
amount of memory used by output |
|
Output |
GB |
amount of memory used by output |
|
Particle Set |
GB |
amount of memory used by particle set |
|
Particle Set |
GB |
amount of memory used by particle set |
|
Particle Sink |
GB |
amount of memory used by particle sink |
|
Particle Sink |
GB |
amount of memory used by particle sink |
|
Scalar Field |
GB |
amount of memory used by scalar field |
|
Scalar Field |
GB |
amount of memory used by scalar field |
|
Screen |
GB |
amount of memory used by screen |
|
Screen |
GB |
amount of memory used by screen |
|
Static Body |
GB |
amount of memory used by static body |
|
Static Body |
GB |
amount of memory used by static body |
|
Thermal Field |
GB |
amount of memory used by thermal field |
|
Thermal Field |
GB |
amount of memory used by thermal field |
|
Total GPU Memory Capacity |
GB |
total memory capacity across all GPUs |
|
Total Tracked CPU Memory |
GB |
total CPU memory usage tracked by solver, this is not comprehensive of all memory used by solver |
|
Total Tracked GPU Memory |
GB |
total GPU memory usage tracked by solver, this is not comprehensive of all memory used by solver |
|
Used GPU Memory From System |
GB |
current memory being used across all GPUs as determined from CUDA system call, includes memory being used by other programs |
|
Volume of Fluid |
GB |
amount of memory used by volume of fluid |
|
Volume of Fluid |
GB |
amount of memory used by volume of fluid |
Usage and Interpretation¶
Memory Usage statistics are used to monitor how memory is allocated across the simulation and to diagnose memory-related failures. This output is particularly useful when a simulation runs out of memory. By tracking memory usage over time, users can identify which components, such as particle sets, are consuming the most memory and how that usage evolves over time.