memory

These commands report the current state of LaGriT's dynamic memory allocation. LaGriT arrays are referenced by memory management by a two part name, block name and partition name. It is allocated in integer or real blocks(real is implemented as real*8). Each memory block is preceeded by a header and terminated by a trailer. Different platforms will have different values for integer and real word lengths. LaGriT developers read more on LaGriT memory management at Memory Manager

The following memory keywords are recognized:

memory / verify
verify the integerity of LaGriT memory manager storage by checking that the known blocks have not been overwritten. If corruption is detected, an array map will be printed. Nothing is printed if there memory is successfully verified.

memory / print
print an address map of the LaGriT managed arrays. For each array the following is printed; index, length, type, memory address, associated name, and partition. The partition is the grouping of arrays by usage. Common partitions include the mesh object (by name), global memory, and temporary memory for work arrays.
MEMORY SIZES : 
 Sizeof char    (type 3) =  1 bytes      Sizeof long        =   4 bytes
 Sizeof real*8  (type 2) =  8 bytes      Sizeof pointer     =   4 bytes
 Sizeof integer (type 1) =  4 bytes      Sizeof INT_PTRSIZE =   4 bytes

INDEX         LENGTH    TYPE     ADDRESS     NAME                           PARTITION
  29          40000000   2     -1894248416 xic                              cmo1    
   1                10   3       143632720 global_name                      global_lg
  31          40000000   2      1760710688 zic                              cmo1    
  30          40000000   2      2080714784 yic                              cmo1   

Total BYTES =    2.400E+09   Total MEGABYTES =    2.400E+03
memory / maxmalloc
Report estimate of possible amount of memory available for allocation by LaGriT. This test will make incremental calls to internal LaGriT memory allocation (mmgetblk) until failure. The report will include the total Megabytes where allocation succeeded, and amount at which allocation failed. This command will also print a map of the memory manager storage.
 .... 

 MMGETBLK ERROR: value exceeds sizeof:            4
 MAX ALLOC SIZE:    4294967296.0000000     
 ATTEMPTED SIZE:    6553600048.0000000     
 MMGETBLK: return early with error flag:          -21
  
 Succeeded at     819.20000000000005       MEGABYTES
 Failed at        1638.4000000000001       MEGABYTES

 
The 64 bit version for memory routines will look slightly different:
MEMORY SIZES : 
 Sizeof char    (type 3) =  1 bytes      Sizeof long        =   8 bytes
 Sizeof real*8  (type 2) =  8 bytes      Sizeof pointer     =   8 bytes
 Sizeof integer (type 1) =  4 bytes      Sizeof INT_PTRSIZE =   8 bytes

....

util_malloc_: Out of memory, malloc return: (nil) 
   Requested value: 104857600000.000000 =    8 bit unsigned int 
 MMGETBLK FAILED: Array array_01 with bytes:          104857600096
 MMGETBLK: return ending with error flag:                    -1
  
 Succeeded at     52428.800000000003       MEGABYTES
 Failed at        104857.60000000001       MEGABYTES

EXAMPLES:
memory / verify
memory / print
memory / maxmalloc