one_over_f

one_over_f#

one_over_f stimulus example

You can find an interactive version of this example here

stimupy.noises.naturals.one_over_f(visual_size=None, ppd=None, shape=None, exponent=None, intensity_range=(0, 1), pseudo_noise=False, rng=None)#

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). be aware that not every instance has mean=(max-min)/2.

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

  • rng (numpy.random.Generator, optional) – Random number generator to use. If None, a new default_rng is created. By passing in a custom rng, you can control the randomness of the noise generation, e.g., make it replicable.

Returns:

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

Return type:

dict[str, Any]

Contents