pymel.core.system.memory¶

memory(*args, **kwargs)¶

Used to query essential statistics on memory availability and usage. By default memory sizes are returned in bytes. Since Maya’s command engine only supports 32-bit signed integers, any returned value which cannot fit into 31 bits will be truncated to 2,147,483,647 and a warning message displayed. To avoid having memory sizes truncated use one of the memory size flags to return the value in larger units (e.g. megabytes) or use the asFloat flag to return the value as a float.

Flags:

Long Name / Short Name		Argument Types	Properties
adjustedVirtualMemory / av		bool
	Returns size of adjusted virtual memory allocated by the process. The adjustment is done by computing an offset when the application is launched that will be subtracted from the process virtual memory in order to give the adjusted value. The returned size is an approximation of the memory used by the process that can be more reliable in some cases, for instance on platforms where display drivers can reserve large ranges of memory addresses, therefore increasing the size of the process virtual memory, even though those addresses are actually not used.
asFloat / af		bool
	Causes numeric values to be returned as floats rather than ints. This can be useful if you wish to retain some of the significant digits lost when using the unit size flags.
debug / dbg		bool
	Print debugging statistics on arena memory (if it exists)
freeMemory / fr		bool
	Returns size of free memory
gigaByte / gb		bool
	Return memory sizes in gigabytes (1024*1024*1024 bytes)
heapMemory / he		bool
	Returns size of memory heap
kiloByte / kb		bool
	Return memory sizes in kilobytes (1024 bytes)
megaByte / mb		bool
	Return memory sizes in megabytes (1024*1024 bytes)
pageFaults / pf		bool
	Returns number of page faults
pageReclaims / pr		bool
	Returns number of page reclaims
physicalMemory / phy		bool
	Returns size of physical memory
processVirtualMemory / pv		bool
	Returns size of virtual memory allocated by the process
summary / sum		bool
	Returns a summary of memory usage. The size flags are ignored and all memory sizes are given in megabytes.
swapFree / swf		bool
	Returns size of free swap
swapLogical / swl		bool
	Returns size of logical swap
swapMax / swm		bool
	Returns maximum swap size
swapPhysical / swp		bool
	Returns size of physical swap
swapReserved / swr		bool
	Returns size of reserved swap
swapVirtual / swv		bool
	Returns size of virtual swap
swaps / sw		bool
	Returns number of swaps Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.memory

Example:

import pymel.core as pm

pm.memory(freeMemory=True)
# Result: 0 #

pm.memory(freeMemory=True megaByte=True)
521

pm.memory(freeMemory=True megaByte=True asFloat=True)
521.33203125