JSL Syntax Reference • JSL Messages • Images
Previous
 • 
Next
Images
The Scripting Index provides examples for processing images. In JMP, select Help > Scripting Index to view this interactive resource.
Additional resources are available from the JMP File Exchange at https://community.jmp.com/community/file-exchange.
img<<Crop(Left(pix), Right(pix), Top(pix), Bottom(pix))
Creates a new image from an existing image to the specified dimensions (in pixels).
img<<Filter("name", <n>)
Filters the image based on the specified algorithm. Filtering is useful for cleaning up noise in the image.
Note: All of the JMP image filters are supported at the operating system level. Images that are processed on Windows might differ from images processed on Macintosh.
Argument
name
A quoted string contains the name of a JMP image filter. The following filters are available:
‒
"despeckle" removes defects (that is, speckles) from a scanned or captured image (for example, scratches, dust, etc.).
‒
"edge" identifies pixels in an image where the brightness changes sharply and darkens pixels with no sharp change. Edge detection is used to detect changes in surface, depth, material, and lighting.
‒
"enhance" reduces the contrast between pixels in a noisy image.
‒
"median" reduces noise (that is, the random variation) and smooths an image by comparing each pixel’s brightness with its neighbors’ and, if the value is very different, replaces it with the average of the neighbors’ values.
‒
"negate" creates the negative of the color or gray-scale image by changing each pixel color to its complementary color.
‒
"normalize" changes a color image’s pixels to use the full range of the file format’s number system. Normalization will make the image’s colors more intense.
‒
"sharpen" reduces blur by sharpening edges of an image.
‒
"contrast", n brightens or darkens an image. A higher number (>0.0) brightens an image; a lower number (<0.0) darkens an image.
‒
"gamma", n corrects the image visual display (brightness and intensity) to account for differences in monitor hardware. A higher number (> 1.0) lightens the image; a lower number (< 1.0) darkens the image.
‒
"reduce noise", n reduces the random variation (or noise) that occurs with higher ISO sensitivity or longer exposure times.
‒
"gaussian blur", radius, sigma reduces image noise and detail creating a smoother image. Radius is equal to the blur radius around each pixel and sigma is the standard deviation of the Gaussian distribution. Gaussian blur is commonly used when resizing or performing edge detection.
img<<Flip Both
Flips the image from left to right and top to bottom.
img<<Flip Horizontal
Flips the image from left to right.
img<<Flip Vertical
Flips the image from top to bottom.
img<<Get Size
img<<Size
Returns a list containing the width and height (in pixels) of the image.
img<<Rotate(degrees)
Rotates the image by the specified number of degrees.
img<<Save Image("filepath")
Saves the image to the specified path and filename (filepath).
img<<Scale(n, <n>)
Resizes the image by the specified dimensions. Provide one argument to resize both the width and height. Provide two arguments to resize the width and height separately.
Examples
img = New Image( "$SAMPLE_IMAGES/tile.jpg" );
xs = 2;
img << Scale( xs );
New Window( "Tile x 2", img );
 
// Scale image width by 2 and height by 1/2
img = New Image( "$SAMPLE_IMAGES/tile.jpg" );
img << Scale( 2, 0.5 );
New Window( "Tile squished", img );
Notes
Using Scale is an alternative to getting the size of the image, multiplying by the scale factor, and then setting the size.
img<<Set Size(width, height)
Resizes the image to the specified dimensions (in pixels). To scale the image proportionally, specify a width and height that correspond to the aspect ratio in the original image.
img<<Transparency(fraction)
Sets the transparency for the image where the fraction is between 0.0 (full transparency) to 1.0 (no transparency).