AUGMENTIMAGES Procedure

MUTATE Statement

MUTATE <options>;

The MUTATE statement creates modified versions of images by applying the mutate augmentation. Each mutation is applied to every image in the input data table.

You must specify at least one of the following options:

COLORJITTERING

adds random variations in brightness, contrast value, and saturation.

COLORSHIFTING

adds random constant values to pixels across blue, green, and red channels.

DARKEN (suboptions)

darkens the image pixels by using the gamma suboption values.

You can specify the following suboptions:

GAMMA=number: specifies the gamma value to use in the darkening operation, where number is greater than or equal to 0.001 and less than 1. By default, GAMMA=0.25.
GAMMAMAX=number: specifies the maximum gamma value in a range to use when you randomly darken images, where number is greater than the GAMMAMIN= option value and less than 1. If you specify the GAMMAMAX= option, you must also specify the GAMMAMIN= option.
GAMMAMIN=number: specifies the minimum gamma value in a range to use when you randomly darken images, where number is greater than or equal to 0.001 and less than the GAMMAMAX= option value. If you specify the GAMMAMIN= option, you must also specify the GAMMAMAX= option.

FLIPHORIZONTAL

flips images along the X axis.

FLIPVERTICAL

flips images along the Y axis.

INVERTPIXELS

inverts every pixel of a single-channel image.

LIGHTEN (suboptions)

lightens image pixels by using the gamma suboption values.

You can specify the following suboptions:

GAMMA=number: specifies the gamma value to use in the lightening operation, where number is greater than 1 and less than or equal to 1,000. By default, GAMMA=2.5.
GAMMAMAX=number: specifies the maximum gamma value in a range to use when you randomly lighten images, where number is greater than the GAMMAMIN= option value and less than or equal to 1,000. If you specify the GAMMAMAX= option, you must also specify the GAMMAMIN= option.
GAMMAMIN=number: specifies the minimum gamma value in a range to use when you randomly lighten images, where number is greater than 1 and less than the GAMMAMAX= option value. If you specify the GAMMAMIN= option, you must also specify the GAMMAMAX= option.

PYRAMIDDOWN

downsamples and then blurs the input image.

PYRAMIDUP

upsamples and then blurs the input image.

ROTATELEFT (suboptions)

rotates the input image to the left (counterclockwise) by the number of degrees that you specify in the ANGLE= suboption.

You can specify the following suboptions:

ANGLE=number: specifies the rotation angle in degrees for a counterclockwise rotation operation, where number is in the range (0,180]. By default, ANGLE=5.
ANGLEMAX=number: specifies the maximum angle value in a range to use when you randomly rotate images, where number is greater than the ANGLEMIN= option value and less than or equal to 180. If you specify the ANGLEMAX= option, you must also specify the ANGLEMIN= option.
ANGLEMIN=number: specifies the minimum angle value in a range to use when you randomly rotate images, where number is greater than 0 and less than the ANGLEMAX= option value. If you specify the ANGLEMIN= option, you must also specify the ANGLEMAX= option.

ROTATERIGHT (suboptions)

rotates the input image to the right (clockwise) by the number of degrees that you specify in the ANGLE= suboption.

You can specify the following suboptions:

ANGLE=number: specifies the rotation angle in degrees for a clockwise rotation operation, where number is in the range (0,180]. By default, ANGLE=5.
ANGLEMAX=number: specifies the maximum angle value in a range to use when you randomly rotate images, where number is greater than the ANGLEMIN= option value and less than or equal to 180. If you specify the ANGLEMAX= option, you must also specify the ANGLEMIN= option.
ANGLEMIN=number: specifies the minimum angle value in a range to use when you randomly rotate images, where number is greater than 0 and less than the ANGLEMAX= option value. If you specify the ANGLEMIN= option, you must also specify the ANGLEMAX= option.

SHARPEN

applies the sharpening effect to remove the blur from images.

Last updated: March 26, 2026