Image.Random

classmethod Image.Random(*, size: int | Sequence[int] | None = None, colororder: str | None = None, dtype: Dtype | None = None, maxval: int | float | None = None, pdf: np.ndarray | None = None, like=None) → Self

Create image with random pixel values

Parameters:

• size (int, 2-tuple or 3-tuple) – image size: size, (width, height) or (width, height, nplanes)

• colororder (str) – color plane names, defaults to None

• dtype (str or NumPy dtype, optional) – NumPy datatype, defaults to ‘uint8’

The short-name aliases 'int', 'float', 'double', 'half' are also accepted and resolve to the Toolbox’s own defaults (uint8, float32, float64, float16 respectively) – this matters because NumPy’s own np.dtype('float') resolves to float64, not float32. See DTYPE_ALIASES. :param maxval: maximum value for random values, defaults to None :type maxval: same as dtype, optional :param pdf: probability density function for pixel values, defaults to None :type pdf: 1D or 2D array_like, optional :param like: template image supplying default size, dtype and

colororder when those are not given explicitly

Returns:

image of random values

Return type:

Image

The dimensions can be specified by a single scalar, a 2-tuple or a 3-tuple. If a single scalar is given the image is square. If a 2-tuple is given the image has one plane, if a 3-tuple is given the last element specifies the number of planes.

Creates a new image where pixels are initialized to random values:

• for an integer image the values are uniformly distributed in the range 0 to maxval. If maxval is not given then the values span the range 0 to the maximum positive value of the datatype. For a floating image the values span the range 0.0 to 1.0.

• if pdf is given then the pixel values are drawn from the given probability density function, which should be normalized to sum to 1. If pdf is a 1D array then the same pdf is used for all planes, if it is a 2D array then each column gives the pdf for the corresponding plane. This option is only supported for uint8 images, and if given then maxval is ignored.

Example:

>>> from machinevisiontoolbox import Image
>>> img = Image.Random(size=3)
>>> img.print()
   184  35  63
    24  70  87
   180 221  73
>>> img = Image.Random(size=3, colororder='RGB')
>>> img.print()
  plane R:
     253  56 131
      13  46  22
     188  22 152
  plane G:
     202  66 179
      77 208  35
     178 220  46
  plane B:
      61 196  98
       9  52 161
      85  48 128
>>> img.red().print()
   253  56 131
    13  46  22
   188  22 152
>>> img = Image.Random(size=3, dtype='float32')
>>> img.print
<bound method Image.print of Image(size=(3, 3), dtype=float32)>
>>> Image.Random(size=100).disp()
<matplotlib.image.AxesImage object at 0x7f781570cd40>

(Source code, png, hires.png, pdf)

We could, for example, create a random image with the same histogram as an existing image:

>>> from machinevisiontoolbox import Image
>>> img = Image.Read("street.png")
>>> h = img.hist()
>>> h.plot('pdf')
>>> img2 = Image.Random(size=img.size, pdf=h.pdf)
>>> img2.hist().plot('pdf')

(Source code, png, hires.png, pdf)

Seealso:

Constant