Memory Usage in ImageTools - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : ImageTools Package : Memory Usage in ImageTools

Reducing Memory Usage in ImageTools

 

Introduction

Options

Examples

Introduction

Because an image is stored as an rtable with datatype = float[8], each pixel in each layer requires eight bytes of memory. The memory allocated for large images can be significant. To reduce memory usage, many of the commands in ImageTools have the options inplace and output that permit reusing previously allocated memory. This help page shows how they can be used.

Options

• 

inplace = truefalse

  

Specifies whether the operation is performed in-place. The default is false.

• 

output = Image

  

Specifies a data structure into which the output is written. The size and number of layers must match that of the input. The output image is redimensioned so that its row and column indices match the input. The default is NULL.

Examples

The memory usage for this 480 x 640 x 3 layer image is

(3.1)

Assume that we want to adjust the gamma of layers 2 and 3 of img.  The Gamma command works on all layers, so to do this we need to extract a layer, make the adjustment, and insert the modified layer back into the image.  To reduce memory usage we can allocate a temporary grayscale image that is the size of one layer of the image and then reuse it as needed.  To determine the effect of these options, we compare the memory usage with that when the options are not used.  Assign a procedure that returns the memory allocated by the kernel.

Save the current memory usage.

(3.2)

Create the temporary image.

(3.3)

Extract layer 2, increase its gamma, then reinsert it, inplace, into the original image.

(3.4)

(3.5)

(3.6)

Do the same with layer 3, but decrease its gamma.

(3.7)

(3.8)

(3.9)

Compute the additional memory allocated.

(3.10)

Repeat the computation (actually, do its inverse), but use assignment statements rather than inplace and output to assign tmp and img.

(3.11)

(3.12)

(3.13)

(3.14)

(3.15)

(3.16)

(3.17)

(3.18)

The additional memory allocated is about three times that of the previous method, which used the inplace and output options.

See Also

ImageTools

ImageTools[ImageTypes]

 


Download Help Document