noise¶

class BrownNoise(calculation_rate=None, **kwargs)¶

Bases: UGen

A brown noise unit generator.

>>> supriya.ugens.BrownNoise.ar()
BrownNoise.ar()

classmethod ar() → BrownNoise¶

classmethod kr() → BrownNoise¶

class ClipNoise(calculation_rate=None, **kwargs)¶

Bases: UGen

A clipped noise unit generator.

>>> supriya.ugens.ClipNoise.ar()
ClipNoise.ar()

classmethod ar() → ClipNoise¶

classmethod kr() → ClipNoise¶

class CoinGate(calculation_rate=None, probability=0.5, trigger=None, **kwargs)¶

Bases: UGen

A probabilistic trigger gate.

>>> trigger = supriya.ugens.Impulse.ar()
>>> coin_gate = supriya.ugens.CoinGate.ar(
...     probability=0.5,
...     trigger=trigger,
... )
>>> coin_gate
CoinGate.ar()

classmethod ar(probability: SupportsFloat | UGenMethodMixin = 0.5, trigger: SupportsFloat | UGenMethodMixin | None = None) → CoinGate¶

classmethod kr(probability: SupportsFloat | UGenMethodMixin = 0.5, trigger: SupportsFloat | UGenMethodMixin | None = None) → CoinGate¶

property probability : SupportsFloat | UGenMethodMixin¶

property trigger : SupportsFloat | UGenMethodMixin¶

class Crackle(calculation_rate=None, chaos_parameter=1.5, **kwargs)¶

Bases: UGen

A chaotic noise generator.

>>> crackle = supriya.ugens.Crackle.ar(
...     chaos_parameter=1.25,
... )
>>> crackle
Crackle.ar()

classmethod ar(chaos_parameter: SupportsFloat | UGenMethodMixin = 1.5) → Crackle¶

classmethod kr(chaos_parameter: SupportsFloat | UGenMethodMixin = 1.5) → Crackle¶

property chaos_parameter : SupportsFloat | UGenMethodMixin¶

class Dust(calculation_rate=None, density=0.0, **kwargs)¶

Bases: UGen

A unipolar random impulse generator.

>>> dust = supriya.ugens.Dust.ar(
...     density=23,
... )
>>> dust
Dust.ar()

classmethod ar(density: SupportsFloat | UGenMethodMixin = 0.0) → Dust¶

classmethod kr(density: SupportsFloat | UGenMethodMixin = 0.0) → Dust¶

property density : SupportsFloat | UGenMethodMixin¶

class Dust2(calculation_rate=None, density=0.0, **kwargs)¶

Bases: UGen

A bipolar random impulse generator.

>>> dust_2 = supriya.ugens.Dust2.ar(
...     density=23,
... )
>>> dust_2
Dust2.ar()

classmethod ar(density: SupportsFloat | UGenMethodMixin = 0.0) → Dust2¶

classmethod kr(density: SupportsFloat | UGenMethodMixin = 0.0) → Dust2¶

property density : SupportsFloat | UGenMethodMixin¶

class ExpRand(calculation_rate=None, maximum=None, minimum=None)¶

Bases: UGen

An exponential random distribution.

>>> exp_rand = supriya.ugens.ExpRand.ir()
>>> exp_rand
ExpRand.ir()

classmethod ir(minimum: SupportsFloat | UGenMethodMixin = 0.0, maximum: SupportsFloat | UGenMethodMixin = 1.0) → ExpRand¶

property maximum : SupportsFloat | UGenMethodMixin¶

property minimum : SupportsFloat | UGenMethodMixin¶

class GrayNoise(calculation_rate=None, **kwargs)¶

Bases: UGen

A gray noise unit generator.

>>> supriya.ugens.GrayNoise.ar()
GrayNoise.ar()

classmethod ar() → GrayNoise¶

classmethod kr() → GrayNoise¶

class Hasher(calculation_rate=None, source=None, **kwargs)¶

Bases: UGen

A signal hasher.

>>> source = supriya.ugens.SinOsc.ar()
>>> hasher = supriya.ugens.Hasher.ar(
...     source=source,
... )
>>> hasher
Hasher.ar()

classmethod ar(source: SupportsFloat | UGenMethodMixin | None = None) → Hasher¶

classmethod kr(source: SupportsFloat | UGenMethodMixin | None = None) → Hasher¶

property source : SupportsFloat | UGenMethodMixin¶

class IRand(calculation_rate=None, minimum=0, maximum=127, **kwargs)¶

Bases: UGen

An integer uniform random distribution.

>>> supriya.ugens.IRand.ir()
IRand.ir()

classmethod ir(minimum: SupportsFloat | UGenMethodMixin = 0, maximum: SupportsFloat | UGenMethodMixin = 127) → IRand¶

property maximum : SupportsFloat | UGenMethodMixin¶

property minimum : SupportsFloat | UGenMethodMixin¶

class LFClipNoise(calculation_rate=None, frequency=500.0, **kwargs)¶

Bases: UGen

A dynamic clipped noise generator.

>>> supriya.ugens.LFClipNoise.ar()
LFClipNoise.ar()

classmethod ar(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFClipNoise¶

classmethod kr(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFClipNoise¶

property frequency : SupportsFloat | UGenMethodMixin¶

class LFDClipNoise(calculation_rate=None, frequency=500.0, **kwargs)¶

Bases: UGen

A clipped noise generator.

>>> supriya.ugens.LFDClipNoise.ar()
LFDClipNoise.ar()

classmethod ar(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFDClipNoise¶

classmethod kr(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFDClipNoise¶

property frequency : SupportsFloat | UGenMethodMixin¶

class LFDNoise0(calculation_rate=None, frequency=500.0, **kwargs)¶

Bases: UGen

A dynamic step noise generator.

>>> supriya.ugens.LFDNoise0.ar()
LFDNoise0.ar()

classmethod ar(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFDNoise0¶

classmethod kr(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFDNoise0¶

property frequency : SupportsFloat | UGenMethodMixin¶

class LFDNoise1(calculation_rate=None, frequency=500.0, **kwargs)¶

Bases: UGen

A dynamic ramp noise generator.

>>> supriya.ugens.LFDNoise1.ar()
LFDNoise1.ar()

classmethod ar(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFDNoise1¶

classmethod kr(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFDNoise1¶

property frequency : SupportsFloat | UGenMethodMixin¶

class LFDNoise3(calculation_rate=None, frequency=500.0, **kwargs)¶

Bases: UGen

A dynamic polynomial noise generator.

>>> supriya.ugens.LFDNoise3.ar()
LFDNoise3.ar()

classmethod ar(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFDNoise3¶

classmethod kr(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFDNoise3¶

property frequency : SupportsFloat | UGenMethodMixin¶

class LFNoise0(calculation_rate=None, frequency=500.0, **kwargs)¶

Bases: UGen

A step noise generator.

>>> supriya.ugens.LFNoise0.ar()
LFNoise0.ar()

classmethod ar(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFNoise0¶

classmethod kr(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFNoise0¶

property frequency : SupportsFloat | UGenMethodMixin¶

class LFNoise1(calculation_rate=None, frequency=500.0, **kwargs)¶

Bases: UGen

A ramp noise generator.

>>> supriya.ugens.LFNoise1.ar()
LFNoise1.ar()

classmethod ar(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFNoise1¶

classmethod kr(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFNoise1¶

property frequency : SupportsFloat | UGenMethodMixin¶

class LFNoise2(calculation_rate=None, frequency=500.0, **kwargs)¶

Bases: UGen

A quadratic noise generator.

>>> supriya.ugens.LFNoise2.ar()
LFNoise2.ar()

classmethod ar(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFNoise2¶

classmethod kr(frequency: SupportsFloat | UGenMethodMixin = 500.0) → LFNoise2¶

property frequency : SupportsFloat | UGenMethodMixin¶

class LinRand(calculation_rate=None, minimum=0.0, maximum=1.0, skew=0, **kwargs)¶

Bases: UGen

A skewed linear random distribution.

>>> lin_rand = supriya.ugens.LinRand.ir(
...     minimum=-1.0,
...     maximum=1.0,
...     skew=0.5,
... )
>>> lin_rand
LinRand.ir()

classmethod ir(minimum: SupportsFloat | UGenMethodMixin = 0.0, maximum: SupportsFloat | UGenMethodMixin = 1.0, skew: SupportsFloat | UGenMethodMixin = 0) → LinRand¶

property maximum : SupportsFloat | UGenMethodMixin¶

property minimum : SupportsFloat | UGenMethodMixin¶

property skew : SupportsFloat | UGenMethodMixin¶

class Logistic(calculation_rate=None, chaos_parameter=3, frequency=1000, initial_y=0.5, **kwargs)¶

Bases: UGen

A chaotic noise function.

>>> logistic = supriya.ugens.Logistic.ar(
...     chaos_parameter=3.0,
...     frequency=1000,
...     initial_y=0.5,
... )
>>> logistic
Logistic.ar()

classmethod ar(chaos_parameter: SupportsFloat | UGenMethodMixin = 3, frequency: SupportsFloat | UGenMethodMixin = 1000, initial_y: SupportsFloat | UGenMethodMixin = 0.5) → Logistic¶

classmethod kr(chaos_parameter: SupportsFloat | UGenMethodMixin = 3, frequency: SupportsFloat | UGenMethodMixin = 1000, initial_y: SupportsFloat | UGenMethodMixin = 0.5) → Logistic¶

property chaos_parameter : SupportsFloat | UGenMethodMixin¶

property frequency : SupportsFloat | UGenMethodMixin¶

property initial_y : SupportsFloat | UGenMethodMixin¶

class MantissaMask(calculation_rate=None, source=0, bits=3, **kwargs)¶

Bases: UGen

A floating-point mantissa mask.

>>> source = supriya.ugens.SinOsc.ar()
>>> mantissa_mask = supriya.ugens.MantissaMask.ar(
...     source=source,
...     bits=3,
... )
>>> mantissa_mask
MantissaMask.ar()

classmethod ar(source: SupportsFloat | UGenMethodMixin = 0, bits: SupportsFloat | UGenMethodMixin = 3) → MantissaMask¶

classmethod kr(source: SupportsFloat | UGenMethodMixin = 0, bits: SupportsFloat | UGenMethodMixin = 3) → MantissaMask¶

property bits : SupportsFloat | UGenMethodMixin¶

property source : SupportsFloat | UGenMethodMixin¶

class NRand(calculation_rate=None, minimum=0.0, maximum=1.0, n=1, **kwargs)¶

Bases: UGen

A sum of n uniform distributions.

>>> n_rand = supriya.ugens.NRand.ir(
...     minimum=-1,
...     maximum=1,
...     n=1,
... )
>>> n_rand
NRand.ir()

classmethod ir(minimum: SupportsFloat | UGenMethodMixin = 0.0, maximum: SupportsFloat | UGenMethodMixin = 1.0, n: SupportsFloat | UGenMethodMixin = 1) → NRand¶

property maximum : SupportsFloat | UGenMethodMixin¶

property minimum : SupportsFloat | UGenMethodMixin¶

property n : SupportsFloat | UGenMethodMixin¶

class PinkNoise(calculation_rate=None, **kwargs)¶

Bases: UGen

A pink noise unit generator.

>>> supriya.ugens.PinkNoise.ar()
PinkNoise.ar()

classmethod ar() → PinkNoise¶

classmethod kr() → PinkNoise¶

class Rand(calculation_rate=None, minimum=0.0, maximum=1.0, **kwargs)¶

Bases: UGen

A uniform random distribution.

>>> supriya.ugens.Rand.ir()
Rand.ir()

classmethod ir(minimum: SupportsFloat | UGenMethodMixin = 0.0, maximum: SupportsFloat | UGenMethodMixin = 1.0) → Rand¶

property maximum : SupportsFloat | UGenMethodMixin¶

property minimum : SupportsFloat | UGenMethodMixin¶

class RandID(calculation_rate=None, rand_id=1, **kwargs)¶

Bases: UGen

Sets the synth’s random generator ID.

>>> rand_id = supriya.ugens.RandID.ir(
...     rand_id=1,
... )
>>> rand_id
RandID.ir()

classmethod ir(rand_id: SupportsFloat | UGenMethodMixin = 1) → RandID¶

classmethod kr(rand_id: SupportsFloat | UGenMethodMixin = 1) → RandID¶

property rand_id : SupportsFloat | UGenMethodMixin¶

class RandSeed(calculation_rate=None, trigger=0, seed=56789, **kwargs)¶

Bases: UGen

Sets the synth’s random generator seed.

>>> trigger = supriya.ugens.Impulse.ar()
>>> rand_seed = supriya.ugens.RandSeed.ar(
...     seed=1,
...     trigger=trigger,
... )
>>> rand_seed
RandSeed.ar()

classmethod ar(trigger: SupportsFloat | UGenMethodMixin = 0, seed: SupportsFloat | UGenMethodMixin = 56789) → RandSeed¶

classmethod ir(trigger: SupportsFloat | UGenMethodMixin = 0, seed: SupportsFloat | UGenMethodMixin = 56789) → RandSeed¶

classmethod kr(trigger: SupportsFloat | UGenMethodMixin = 0, seed: SupportsFloat | UGenMethodMixin = 56789) → RandSeed¶

property seed : SupportsFloat | UGenMethodMixin¶

property trigger : SupportsFloat | UGenMethodMixin¶

class TExpRand(calculation_rate=None, minimum=0.01, maximum=1.0, trigger=0, **kwargs)¶

Bases: UGen

A triggered exponential random number generator.

>>> trigger = supriya.ugens.Impulse.ar()
>>> t_exp_rand = supriya.ugens.TExpRand.ar(
...     minimum=-1.0,
...     maximum=1.0,
...     trigger=trigger,
... )
>>> t_exp_rand
TExpRand.ar()

classmethod ar(minimum: SupportsFloat | UGenMethodMixin = 0.01, maximum: SupportsFloat | UGenMethodMixin = 1.0, trigger: SupportsFloat | UGenMethodMixin = 0) → TExpRand¶

classmethod kr(minimum: SupportsFloat | UGenMethodMixin = 0.01, maximum: SupportsFloat | UGenMethodMixin = 1.0, trigger: SupportsFloat | UGenMethodMixin = 0) → TExpRand¶

property maximum : SupportsFloat | UGenMethodMixin¶

property minimum : SupportsFloat | UGenMethodMixin¶

property trigger : SupportsFloat | UGenMethodMixin¶

class TIRand(calculation_rate=None, maximum=127, minimum=0, trigger=0)¶

Bases: UGen

A triggered integer random number generator.

>>> trigger = supriya.ugens.Impulse.ar()
>>> t_i_rand = supriya.ugens.TIRand.ar(
...     minimum=0,
...     maximum=127,
...     trigger=trigger,
... )
>>> t_i_rand
TIRand.ar()

classmethod ar(minimum: SupportsFloat | UGenMethodMixin = 0, maximum: SupportsFloat | UGenMethodMixin = 127, trigger: SupportsFloat | UGenMethodMixin = 0) → TIRand¶

classmethod kr(minimum: SupportsFloat | UGenMethodMixin = 0, maximum: SupportsFloat | UGenMethodMixin = 127, trigger: SupportsFloat | UGenMethodMixin = 0) → TIRand¶

property maximum : SupportsFloat | UGenMethodMixin¶

property minimum : SupportsFloat | UGenMethodMixin¶

property trigger : SupportsFloat | UGenMethodMixin¶

class TRand(calculation_rate=None, minimum=0.0, maximum=1.0, trigger=0, **kwargs)¶

Bases: UGen

A triggered random number generator.

>>> trigger = supriya.ugens.Impulse.ar()
>>> t_rand = supriya.ugens.TRand.ar(
...     minimum=-1.0,
...     maximum=1.0,
...     trigger=trigger,
... )
>>> t_rand
TRand.ar()

classmethod ar(minimum: SupportsFloat | UGenMethodMixin = 0.0, maximum: SupportsFloat | UGenMethodMixin = 1.0, trigger: SupportsFloat | UGenMethodMixin = 0) → TRand¶

classmethod kr(minimum: SupportsFloat | UGenMethodMixin = 0.0, maximum: SupportsFloat | UGenMethodMixin = 1.0, trigger: SupportsFloat | UGenMethodMixin = 0) → TRand¶

property maximum : SupportsFloat | UGenMethodMixin¶

property minimum : SupportsFloat | UGenMethodMixin¶

property trigger : SupportsFloat | UGenMethodMixin¶

class TWindex(calculation_rate=None, trigger=None, normalize=0, array=None, **kwargs)¶

Bases: UGen

A triggered windex.

>>> trigger = supriya.ugens.Impulse.ar()
>>> t_windex = supriya.ugens.TWindex.ar(
...     trigger=trigger,
...     normalize=0,
...     array=[1, 2, 3],
... )
>>> t_windex
TWindex.ar()

classmethod ar(trigger: SupportsFloat | UGenMethodMixin | None = None, normalize: SupportsFloat | UGenMethodMixin = 0, array: SupportsFloat | UGenMethodMixin | None = None) → TWindex¶

classmethod kr(trigger: SupportsFloat | UGenMethodMixin | None = None, normalize: SupportsFloat | UGenMethodMixin = 0, array: SupportsFloat | UGenMethodMixin | None = None) → TWindex¶

property array : SupportsFloat | UGenMethodMixin¶

property normalize : SupportsFloat | UGenMethodMixin¶

property trigger : SupportsFloat | UGenMethodMixin¶

class WhiteNoise(calculation_rate=None, **kwargs)¶

Bases: UGen

A white noise unit generator.

>>> supriya.ugens.WhiteNoise.ar()
WhiteNoise.ar()

classmethod ar() → WhiteNoise¶

classmethod kr() → WhiteNoise¶