Reducing Memory Usage in ImageTools
Because an image is stored as an rtable with datatype = float, 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.
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.
imgfile ≔ cat⁡kernelopts⁡datadir,/images/fjords.jpg:
img ≔ Read⁡imgfile:
The memory usage for this 480 x 640 x 3 layer image is
size ≔ length⁡img⁢kernelopts⁡'wordsize'⁢'bit':
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.
memalloc ≔ →evalf2⁡convert⁡kernelopts⁡'bytesalloc'⁢'byte',units,mebibyte:
Save the current memory usage.
mem ≔ memalloc⁡
Create the temporary image.
tmp ≔ Create⁡Height⁡img,Width⁡img:memalloc⁡
Extract layer 2, increase its gamma, then reinsert it, inplace, into the original image.
layer ≔ 2:
Do the same with layer 3, but decrease its gamma.
layer ≔ 3:
Compute the additional memory allocated.
Repeat the computation (actually, do its inverse), but use assignment statements rather than inplace and output to assign tmp and img.
tmp ≔ GetLayer⁡img,layer:memalloc⁡
tmp ≔ Gamma⁡tmp,11.2:memalloc⁡
img ≔ SetLayer⁡img,tmp,layer:memalloc⁡
tmp ≔ Gamma⁡tmp,10.8:memalloc⁡
The additional memory allocated is about three times that of the previous method, which used the inplace and output options.
Download Help Document
What kind of issue would you like to report? (Optional)