stimupy.noises.naturals#

Demos#

Noises - Naturals

Functions#

one_over_f

Draw 1 / (f**exponent) noise texture

pink

Draw pink (1 / f) noise texture

brown

Draw brown (1 / (f**2.0)) noise texture

one_over_f(visual_size=None, ppd=None, shape=None, exponent=None, intensity_range=(0, 1), pseudo_noise=False)[source]#

Draw 1 / (f**exponent) noise texture

Parameters:
  • visual_size (Sequence[Number, Number], Number, or None (default)) – visual size [height, width] of grating, in degrees

  • ppd (Sequence[Number, Number], Number, or None (default)) – pixels per degree [vertical, horizontal]

  • shape (Sequence[Number, Number], Number, or None (default)) – shape [height, width] of grating, in pixels

  • exponent – exponent used to create 1 / (f**exponent) noise

  • intensity_range (Sequence[Number, Number]) – minimum and maximum intensity value; default: (0, 1)

  • pseudo_noise (bool) – if True, generate pseudo-random noise with ideal power spectrum.

Returns:

dict with the stimulus (key: “img”), and additional keys containing stimulus parameters

Return type:

dict[str, Any]

pink(visual_size=None, ppd=None, shape=None, intensity_range=(0, 1), pseudo_noise=False)[source]#

Draw pink (1 / f) noise texture

Parameters:
  • visual_size (Sequence[Number, Number], Number, or None (default)) – visual size [height, width] of grating, in degrees

  • ppd (Sequence[Number, Number], Number, or None (default)) – pixels per degree [vertical, horizontal]

  • shape (Sequence[Number, Number], Number, or None (default)) – shape [height, width] of grating, in pixels

  • intensity_range (Sequence[Number, Number]) – minimum and maximum intensity value; default: (0, 1)

  • pseudo_noise (bool) – if True, generate pseudo-random noise with ideal power spectrum

Return type:

A stimulus dictionary with the noise array [‘img’]

brown(visual_size=None, ppd=None, shape=None, intensity_range=(0, 1), pseudo_noise=False)[source]#

Draw brown (1 / (f**2.0)) noise texture

Parameters:
  • visual_size (Sequence[Number, Number], Number, or None (default)) – visual size [height, width] of grating, in degrees

  • ppd (Sequence[Number, Number], Number, or None (default)) – pixels per degree [vertical, horizontal]

  • shape (Sequence[Number, Number], Number, or None (default)) – shape [height, width] of grating, in pixels

  • intensity_range (Sequence[Number, Number]) – minimum and maximum intensity value; default: (0, 1)

  • pseudo_noise (bool) – if True, generate pseudo-random noise with ideal power spectrum

Return type:

A stimulus dictionary with the noise array [‘img’]