STScI Logo

mkimage noao.imred.ccdred.ccdtest


NAME · USAGE · PARAMETERS · DESCRIPTION · EXAMPLES · SEE_ALSO

NAME

mkimage -- Make or modify and image with simple values

USAGE

mkimage image option value [ndim dims]

PARAMETERS

image
Image to create or modify.
option
Editing option which is one one of the following:
make
Make a new image of the specifed size, dimensionality, pixel type, and values.
replace
Replace pixel values in the image.
add
Add to the pixel values in the image.
multiply
Multiply the pixel values in the image.
value
Mean pixel value to be used.
ndim
Number of dimensions when creating a new image.
dims
Image dimensions given as a white space separated string (see the examples).
pixtype = "real"
Pixel datatype when creating an image. The types are "real", "short", "integer", "long", and "double".
slope = 0.
Slope of pixel values per pixel.
sigma = 0.
Gaussian noise of pixel values if not zero.
seed = 0
Seed for random numbers. If zero then the first time the task is called a seed of 1 is used and all subsequent calls while the task is in the process cache continue with new random numbers.

DESCRIPTION

An image is created or modified using simple values. This task is intended for test and demonstration purposes. A image may be created of a specified size, dimensionality, and pixel datatype. The pixel values used in creating or editing an image consist of a sloped plane (which repeats for dimensions greater than 2) with pseudo-Gaussian noise. The sloped plane is defined such that:

pix[i,j] = value + slope * ((ncols + nlines) / 2 - 1) + slope * (i + j)

where i and j are the pixel indices (starting with 1) and ncols and nlines are the number of columns and lines. The interpretation of "value" is that it is the mean of the plane. The Gaussian noise is only approximately random for purposes of speed!

EXAMPLES

1. To create an 2 dimensional real image of size 100 x 200 with all zero values:

cl> mkimage name make 0 2 "100 200"

Note that the dimension string is quoted because of the blank separated values.

2. To add noise with a sigma of 5:

cl> mkimage name add 0 sigma=5

2. To replace a region of the image with the value 10:

cl> mkimage name[10:20,30:40] replace 10

SEE ALSO

artobs, subsection


Source Code · Search Form · STSDAS