Allocating Memory in MIPAV

Jump to: navigation, search

When you run MIPAV for the first time you must specify the amount of memory that you would like to allocate, so that MIPAV can take the full advantage of the memory resources available in your machine. For more information about user permissions, memory limits, and memory usage in different operation systems, refer to: FAQ: Understanding Memory.

Note: MIPAV’s memory allocation is a program-level feature and it affects all users of a given MIPAV installation. You can only change the amount of allocated memory, if you are running MIPAV using an administrative account.

To allocate memory when installing MIPAV

Refer to FAQ: Understanding Memory.

To monitor memory usage

The Memory Monitor dialog box

When MIPAV performs a function, such as visualizing an image file, it uses memory. When the function completes (i.e., the visualized image closed), you can manually free the memory so it can be used for another function. The first step is to view how much memory is currently being used and to free needlessly reserved memory. Then, if necessary, you may need to allocate additional memory.

To determine how much memory is currently being used by MIPAV

  1. Select Help » Memory Usage in the MIPAV window. The Memory Monitor dialog box appears.
  2. The Memory Monitor dialog box shows how much memory is allocated and how much memory has been used. The vertical bar on the right of the window displays a pictorial representation of the ratio of allocated memory or amount of memory used. The chart shows the memory usage for the past 3 minutes and 45 seconds. The chart is updated every second.
  3. If you want to constantly monitor your memory resources, you can leave the Memory Monitor dialog box open on your desktop. Otherwise, close it.

To figure out how much memory you actually need, refer to How much memory does MIPAV require to run?

To manually free memory

GarbageCollector.jpg As Java-based programs run, they often leave old variables, objects, or constructors in memory. For instance, if you delineate a VOI, the coordinates of the contours may remain in memory even after you close the image. Java provides a method called the garbage collector (or memory recycling) that automatically freeing objects that are no longer referenced by the program and clears all unnecessarily reserved memory. Generally, the software does this automatically when free memory becomes very limited. However, you can run the garbage collector at any time to free memory by clicking the Garbage Collector button on the main MIPAV window. You can also free memory in the Memory Monitor dialog box by clicking the Free Memory button.

To allocate additional memory

The Change java-runtime Memory Allocation dialog box

For Windows users:

  1. Select Help » Memory allocation in the MIPAV window. The Change JavaRuntime Memory Allocation dialog box opens.
  2. Change the maximum heap size number so that it reflects the maximum amount of memory that should be allocated. In a Microsoft Windows 32 system, you can specify a maximum of 1.3 Gb.
  3. Click OK to close the dialog box.
  4. Restart MIPAV for the changes to take effect. To exit MIPAV, select File » Exit. Then, restart the software.

Now, when additional memory is needed, MIPAV allocates it until the memory reaches the maximum heap size that you specify.

For Linux users:

Refer to FAQ: Understanding Memory.

For Mac OS users:

Refer to FAQ: Understanding Memory.

If you need even more memory

You can allocate virtual memory or disk swap space if there is free space on your hard drive. For instructions on how to do this, refer to the documentation for your system. If you cannot assign more virtual memory or disk swap space, you may need to install additional memory.

Memory limitations

Refer to FAQ: Understanding Memory.

For more information

Refer to: FAQ: Understanding Memory.

See also: