Dynamic management¶

Objects to modify the dynamic range and sample quality of audio signals.

Objects in this category¶

Clip : Clips a signal to a predefined limit.
Degrade : Signal quality reducer.
Mirror : Reflects the signal that exceeds the min and max thresholds.
Compress : Reduces the dynamic range of an audio signal.
Gate : Allows a signal to pass only when its amplitude is above a set threshold.
Balance : Adjust rms power of an audio signal according to the rms power of another.
Min : Outputs the minimum of two values.
Max : Outputs the maximum of two values.
Wrap : Wraps-around the signal that exceeds the min and max thresholds.
Expand : Expand the dynamic range of an audio signal.

Clip¶

class Clip(input, min=-1.0, max=1.0, mul=1, add=0)[source]¶

Clips a signal to a predefined limit.

Parent

PyoObject

Args

input: PyoObject: Input signal to process.
min: float or PyoObject, optional: Minimum possible value. Defaults to -1.
max: float or PyoObject, optional: Maximum possible value. Defaults to 1.

See also

Mirror, Wrap

>>> s = Server().boot()
>>> s.start()
>>> a = SfPlayer(SNDS_PATH + "/transparent.aif", loop=True)
>>> lfoup = Sine(freq=.25, mul=.48, add=.5)
>>> lfodown = 0 - lfoup
>>> c = Clip(a, min=lfodown, max=lfoup, mul=.4).mix(2).out()

Public Data Attributes:

`input`	PyoObject.
`min`	float or PyoObject.
`max`	float or PyoObject.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, min, max, mul, add])
`setInput`(x[, fadetime])	Replace the input attribute.
`setMin`(x)	Replace the min attribute.
`setMax`(x)	Replace the max attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Defaults to 0.05.

setMin(x)[source]¶

Replace the min attribute.

Args

x: float or PyoObject: New min attribute.

setMax(x)[source]¶

Replace the max attribute.

Args

x: float or PyoObject: New max attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property min¶: float or PyoObject. Minimum possible value.

property max¶: float or PyoObject. Maximum possible value.

Degrade¶

class Degrade(input, bitdepth=16, srscale=1.0, mul=1, add=0)[source]¶

Signal quality reducer.

Degrade takes an audio signal and reduces the sampling rate and/or bit-depth as specified.

Parent

PyoObject

Args

input: PyoObject: Input signal to process.
bitdepth: float or PyoObject, optional: Signal quantization in bits. Must be in range 1 -> 32. Defaults to 16.
srscale: float or PyoObject, optional: Sampling rate multiplier. Must be in range 0.0009765625 -> 1. Defaults to 1.

See also

Disto, Clip

>>> s = Server().boot()
>>> s.start()
>>> t = SquareTable()
>>> a = Osc(table=t, freq=[100,101], mul=.5)
>>> lfo = Sine(freq=.2, mul=6, add=8)
>>> lfo2 = Sine(freq=.25, mul=.45, add=.55)
>>> b = Degrade(a, bitdepth=lfo, srscale=lfo2, mul=.3).out()

Public Data Attributes:

`input`	PyoObject.
`bitdepth`	float or PyoObject.
`srscale`	float or PyoObject.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, bitdepth, srscale, mul, add])
`setInput`(x[, fadetime])	Replace the input attribute.
`setBitdepth`(x)	Replace the bitdepth attribute.
`setSrscale`(x)	Replace the srscale attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Defaults to 0.05.

setBitdepth(x)[source]¶

Replace the bitdepth attribute.

Args

x: float or PyoObject: New bitdepth attribute.

setSrscale(x)[source]¶

Replace the srscale attribute.

Args

x: float or PyoObject: New srscale attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property bitdepth¶: float or PyoObject. Signal quantization in bits.

property srscale¶: float or PyoObject. Sampling rate multiplier.

Mirror¶

class Mirror(input, min=0.0, max=1.0, mul=1, add=0)[source]¶

Reflects the signal that exceeds the min and max thresholds.

This object is useful for table indexing or for clipping and modeling an audio signal.

Parent

PyoObject

Args

input: PyoObject: Input signal to process.
min: float or PyoObject, optional: Minimum possible value. Defaults to 0.
max: float or PyoObject, optional: Maximum possible value. Defaults to 1.

Note

If min is higher than max, then the output will be the average of the two.

See also

Clip, Wrap

>>> s = Server().boot()
>>> s.start()
>>> a = Sine(freq=[300,301])
>>> lfmin = Sine(freq=1.5, mul=.25, add=-0.75)
>>> lfmax = Sine(freq=2, mul=.25, add=0.75)
>>> b = Mirror(a, min=lfmin, max=lfmax)
>>> c = Tone(b, freq=2500, mul=.15).out()

Public Data Attributes:

`input`	PyoObject.
`min`	float or PyoObject.
`max`	float or PyoObject.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, min, max, mul, add])
`setInput`(x[, fadetime])	Replace the input attribute.
`setMin`(x)	Replace the min attribute.
`setMax`(x)	Replace the max attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Defaults to 0.05.

setMin(x)[source]¶

Replace the min attribute.

Args

x: float or PyoObject: New min attribute.

setMax(x)[source]¶

Replace the max attribute.

Args

x: float or PyoObject: New max attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property min¶: float or PyoObject. Minimum possible value.

property max¶: float or PyoObject. Maximum possible value.

Compress¶

class Compress(input, thresh=-20, ratio=2, risetime=0.01, falltime=0.1, lookahead=5.0, knee=0, outputAmp=False, mul=1, add=0)[source]¶

Reduces the dynamic range of an audio signal.

Compress reduces the volume of loud sounds or amplifies quiet sounds by narrowing or compressing an audio signal’s dynamic range.

Parent

PyoObject

Args

input: PyoObject

Input signal to process.

thresh: float or PyoObject, optional

Level, expressed in dB, above which the signal is reduced. Reference level is 0dB. Defaults to -20.

ratio: float or PyoObject, optional

Determines the input/output ratio for signals above the threshold. Defaults to 2.

risetime: float or PyoObject, optional

Used in amplitude follower, time to reach upward value in seconds. Defaults to 0.01.

falltime: float or PyoObject, optional

Used in amplitude follower, time to reach downward value in seconds. Defaults to 0.1.

lookahead: float, optional

Delay length, in ms, for the “look-ahead” buffer. Range is 0 -> 25 ms. Defaults to 5.0.

knee: float optional

Shape of the transfert function around the threshold, specified in the range 0 -> 1.

A value of 0 means a hard knee and a value of 1.0 means a softer knee. Defaults to 0.

outputAmp: boolean, optional

If True, the object’s output signal will be the compression level alone, not the compressed signal.

It can be useful if 2 or more channels need to be linked on the same compression slope. Defaults to False.

Available at initialization only.

See also

Gate, Expand

>>> s = Server().boot()
>>> s.start()
>>> a = SfPlayer(SNDS_PATH + '/transparent.aif', loop=True)
>>> b = Compress(a, thresh=-24, ratio=6, risetime=.01, falltime=.2, knee=0.5).mix(2).out()

Public Data Attributes:

`input`	PyoObject.
`thresh`	float or PyoObject.
`ratio`	float or PyoObject.
`risetime`	float or PyoObject.
`falltime`	float or PyoObject.
`lookahead`	float.
`knee`	float.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, thresh, ratio, risetime, ...])
`setInput`(x[, fadetime])	Replace the input attribute.
`setThresh`(x)	Replace the thresh attribute.
`setRatio`(x)	Replace the ratio attribute.
`setRiseTime`(x)	Replace the risetime attribute.
`setFallTime`(x)	Replace the falltime attribute.
`setLookAhead`(x)	Replace the lookahead attribute.
`setKnee`(x)	Replace the knee attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Defaults to 0.05.

setThresh(x)[source]¶

Replace the thresh attribute.

Args

x: float or PyoObject: New thresh attribute.

setRatio(x)[source]¶

Replace the ratio attribute.

Args

x: float or PyoObject: New ratio attribute.

setRiseTime(x)[source]¶

Replace the risetime attribute.

Args

x: float or PyoObject: New risetime attribute.

setFallTime(x)[source]¶

Replace the falltime attribute.

Args

x: float or PyoObject: New falltime attribute.

setLookAhead(x)[source]¶

Replace the lookahead attribute.

Args

x: float: New lookahead attribute.

setKnee(x)[source]¶

Replace the knee attribute.

Args

x: float: New knee attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property thresh¶: float or PyoObject. Level above which the signal is reduced.

property ratio¶: float or PyoObject. in/out ratio for signals above the threshold.

property risetime¶: float or PyoObject. Time to reach upward value in seconds.

property falltime¶: float or PyoObject. Time to reach downward value in seconds.

property lookahead¶: float. Delay length, in ms, of the “look-ahead” buffer.

property knee¶: float. Shape of the transfert function around the threshold.

Gate¶

class Gate(input, thresh=-70, risetime=0.01, falltime=0.05, lookahead=5.0, outputAmp=False, mul=1, add=0)[source]¶

Allows a signal to pass only when its amplitude is above a set threshold.

A noise gate is used when the level of the signal is below the level of the noise floor. The threshold is set above the level of the noise and so when there is no signal the gate is closed. A noise gate does not remove noise from the signal. When the gate is open both the signal and the noise will pass through.

Parent

PyoObject

Args

input: PyoObject

Input signal to process.

thresh: float or PyoObject, optional

Level, expressed in dB, below which the gate is closed. Reference level is 0dB. Defaults to -70.

risetime: float or PyoObject, optional

Time to open the gate in seconds. Defaults to 0.01.

falltime: float or PyoObject, optional

Time to close the gate in seconds. Defaults to 0.05.

lookahead: float, optional

Delay length, in ms, for the “look-ahead” buffer. Range is 0 -> 25 ms. Defaults to 5.0.

outputAmp: boolean, optional

If True, the object’s output signal will be the gating level alone, not the gated signal.

It can be useful if 2 or more channels need to linked on the same gating slope. Defaults to False.

Available at initialization only.

See also

Compress, Expand

>>> s = Server().boot()
>>> s.start()
>>> sf = SfPlayer(SNDS_PATH + '/transparent.aif', speed=[1,.5], loop=True)
>>> gt = Gate(sf, thresh=-24, risetime=0.005, falltime=0.01, lookahead=5, mul=.4).out()

Public Data Attributes:

`input`	PyoObject.
`thresh`	float or PyoObject.
`risetime`	float or PyoObject.
`falltime`	float or PyoObject.
`lookahead`	float.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, thresh, risetime, ...])
`setInput`(x[, fadetime])	Replace the input attribute.
`setThresh`(x)	Replace the thresh attribute.
`setRiseTime`(x)	Replace the risetime attribute.
`setFallTime`(x)	Replace the falltime attribute.
`setLookAhead`(x)	Replace the lookahead attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Defaults to 0.05.

setThresh(x)[source]¶

Replace the thresh attribute.

Args

x: float or PyoObject: New thresh attribute.

setRiseTime(x)[source]¶

Replace the risetime attribute.

Args

x: float or PyoObject: New risetime attribute.

setFallTime(x)[source]¶

Replace the falltime attribute.

Args

x: float or PyoObject: New falltime attribute.

setLookAhead(x)[source]¶

Replace the lookahead attribute.

Args

x: float: New lookahead attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property thresh¶: float or PyoObject. Level below which the gate is closed.

property risetime¶: float or PyoObject. Time to open the gate in seconds.

property falltime¶: float or PyoObject. Time to close the gate in seconds.

property lookahead¶: float. Delay length, in ms, of the “look-ahead” buffer.

Balance¶

class Balance(input, input2, freq=10, mul=1, add=0)[source]¶

Adjust rms power of an audio signal according to the rms power of another.

The rms power of a signal is adjusted to match that of a comparator signal.

Parent

PyoObject

Args

input: PyoObject: Input signal to process.
input2: PyoObject: Comparator signal.
freq: float or PyoObject, optional: Cutoff frequency of the lowpass filter in hertz. Default to 10.

>>> s = Server().boot()
>>> s.start()
>>> sf = SfPlayer(SNDS_PATH + '/accord.aif', speed=[.99,1], loop=True, mul=.3)
>>> comp = SfPlayer(SNDS_PATH + '/transparent.aif', speed=[.99,1], loop=True, mul=.3)
>>> out = Balance(sf, comp, freq=10).out()

Public Data Attributes:

`input`	PyoObject.
`input2`	PyoObject.
`freq`	float or PyoObject.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input, input2[, freq, mul, add])
`setInput`(x[, fadetime])	Replace the input attribute.
`setInput2`(x[, fadetime])	Replace the input2 attribute.
`setFreq`(x)	Replace the freq attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Input signal to process.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Default to 0.05.

setInput2(x, fadetime=0.05)[source]¶

Replace the input2 attribute.

Comparator signal.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Default to 0.05.

setFreq(x)[source]¶

Replace the freq attribute.

Cutoff frequency of the lowpass filter, in Hertz.

Args

x: float or PyoObject: New freq attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property input2¶: PyoObject. Comparator signal.

property freq¶: float or PyoObject. Cutoff frequency of the lowpass filter.

Min¶

class Min(input, comp=0.5, mul=1, add=0)[source]¶

Outputs the minimum of two values.

Parent

PyoObject

Args

input: PyoObject: Input signal to process.
comp: float or PyoObject, optional: Comparison value. If input is lower than this value, input is send to the output, otherwise, comp is outputted.

>>> s = Server().boot()
>>> s.start()
>>> # Triangle wave
>>> a = Phasor([249,250])
>>> b = Min(a, comp=a*-1+1, mul=4, add=-1)
>>> c = Tone(b, freq=1500, mul=.5).out()

Public Data Attributes:

`input`	PyoObject.
`comp`	float or PyoObject.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, comp, mul, add])
`setInput`(x[, fadetime])	Replace the input attribute.
`setComp`(x)	Replace the comp attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Default to 0.05.

setComp(x)[source]¶

Replace the comp attribute.

Args

x: float or PyoObject: New comp attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property comp¶: float or PyoObject. Comparison value.

Max¶

class Max(input, comp=0.5, mul=1, add=0)[source]¶

Outputs the maximum of two values.

Parent

PyoObject

Args

input: PyoObject: Input signal to process.
comp: float or PyoObject, optional: Comparison value. If input is higher than this value, input is send to the output, otherwise, comp is outputted.

>>> s = Server().boot()
>>> s.start()
>>> # Assimetrical clipping
>>> a = Phasor(500, mul=2, add=-1)
>>> b = Max(a, comp=-0.3)
>>> c = Tone(b, freq=1500, mul=.5).out()

Public Data Attributes:

`input`	PyoObject.
`comp`	float or PyoObject.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, comp, mul, add])
`setInput`(x[, fadetime])	Replace the input attribute.
`setComp`(x)	Replace the comp attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Default to 0.05.

setComp(x)[source]¶

Replace the comp attribute.

Args

x: float or PyoObject: New comp attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property comp¶: float or PyoObject. Comparison value.

Wrap¶

class Wrap(input, min=0.0, max=1.0, mul=1, add=0)[source]¶

Wraps-around the signal that exceeds the min and max thresholds.

This object is useful for table indexing, phase shifting or for clipping and modeling an audio signal.

Parent

PyoObject

Args

input: PyoObject: Input signal to process.
min: float or PyoObject, optional: Minimum possible value. Defaults to 0.
max: float or PyoObject, optional: Maximum possible value. Defaults to 1.

Note

If min is higher than max, then the output will be the average of the two.

See also

Clip, Mirror

>>> s = Server().boot()
>>> s.start()
>>> # Time-varying overlaping envelopes
>>> env = HannTable()
>>> lff = Sine(.5, mul=3, add=4)
>>> ph1 = Phasor(lff)
>>> ph2 = Wrap(ph1+0.5, min=0, max=1)
>>> amp1 = Pointer(env, ph1, mul=.25)
>>> amp2 = Pointer(env, ph2, mul=.25)
>>> a = SineLoop(250, feedback=.1, mul=amp1).out()
>>> b = SineLoop(300, feedback=.1, mul=amp2).out(1)

Public Data Attributes:

`input`	PyoObject.
`min`	float or PyoObject.
`max`	float or PyoObject.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, min, max, mul, add])
`setInput`(x[, fadetime])	Replace the input attribute.
`setMin`(x)	Replace the min attribute.
`setMax`(x)	Replace the max attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Defaults to 0.05.

setMin(x)[source]¶

Replace the min attribute.

Args

x: float or PyoObject: New min attribute.

setMax(x)[source]¶

Replace the max attribute.

Args

x: float or PyoObject: New max attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property min¶: float or PyoObject. Minimum possible value.

property max¶: float or PyoObject. Maximum possible value.

Expand¶

class Expand(input, downthresh=-40, upthresh=-10, ratio=2, risetime=0.01, falltime=0.1, lookahead=5.0, outputAmp=False, mul=1, add=0)[source]¶

Expand the dynamic range of an audio signal.

The Expand object will boost the volume of the input sound if it rises above the upper threshold. It will also reduce the volume of the input sound if it falls below the lower threshold. This process will “expand” the audio signal’s dynamic range.

Parent

PyoObject

Args

input: PyoObject

Input signal to process.

downthresh: float or PyoObject, optional

Level, expressed in dB, below which the signal is getting softer, according to the ratio. Reference level is 0dB. Defaults to -20.

upthresh: float or PyoObject, optional

Level, expressed in dB, above which the signal is getting louder, according to the same ratio as the lower threshold. Reference level is 0dB. Defaults to -20.

ratio: float or PyoObject, optional

The ratio argument controls is the amount of expansion (with a ratio of 4, if there is a rise of 2 dB above the upper threshold, the output signal will rises by 8 dB), and contrary for the lower threshold. Defaults to 2.

risetime: float or PyoObject, optional

Used in amplitude follower, time to reach upward value in seconds. Defaults to 0.01.

falltime: float or PyoObject, optional

Used in amplitude follower, time to reach downward value in seconds. Defaults to 0.1.

lookahead: float, optional

Delay length, in ms, for the “look-ahead” buffer. Range is 0 -> 25 ms. Defaults to 5.0.

outputAmp: boolean, optional

If True, the object’s output signal will be the expansion level alone, not the expanded signal.

It can be useful if 2 or more channels need to be linked on the same expansion slope. Defaults to False.

Available at initialization only.

See also

Compress, Gate

>>> s = Server().boot()
>>> s.start()
>>> # original to the left channel
>>> sf = SfPlayer(SNDS_PATH + "/transparent.aif", loop=True, mul=0.7)
>>> ori = Delay(sf, 0.005).out()
>>> # expanded to the right channel
>>> ex = Expand(sf, downthresh=-20, upthresh=-20, ratio=4, mul=0.5).out(1)

Public Data Attributes:

`input`	PyoObject.
`downthresh`	float or PyoObject.
`upthresh`	float or PyoObject.
`ratio`	float or PyoObject.
`risetime`	float or PyoObject.
`falltime`	float or PyoObject.
`lookahead`	float.

Inherited from PyoObject

`mul`	float or PyoObject.
`add`	float or PyoObject.

Public Methods:

`__init__`(input[, downthresh, upthresh, ...])
`setInput`(x[, fadetime])	Replace the input attribute.
`setDownThresh`(x)	Replace the downthresh attribute.
`setUpThresh`(x)	Replace the upthresh attribute.
`setRatio`(x)	Replace the ratio attribute.
`setRiseTime`(x)	Replace the risetime attribute.
`setFallTime`(x)	Replace the falltime attribute.
`setLookAhead`(x)	Replace the lookahead attribute.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObject

`__init__`([mul, add])
`__add__`(x)
`__radd__`(x)
`__iadd__`(x)
`__sub__`(x)
`__rsub__`(x)
`__isub__`(x)
`__mul__`(x)
`__rmul__`(x)
`__imul__`(x)
`__truediv__`(x)
`__rtruediv__`(x)
`__itruediv__`(x)
`__div__`(x)
`__rdiv__`(x)
`__idiv__`(x)
`__pow__`(x)
`__rpow__`(x)
`__mod__`(x)
`__neg__`()
`__lt__`(x)	Return self<value.
`__le__`(x)	Return self<=value.
`__eq__`(x)	Return self==value.
`__ne__`(x)	Return self!=value.
`__gt__`(x)	Return self>value.
`__ge__`(x)	Return self>=value.
`__do_comp__`(comp, mode[, default])
`isPlaying`([all])	Returns True if the object is currently playing, otherwise, returns False.
`isOutputting`([all])	Returns True if the object is outputting.
`get`([all])	Return the first sample of the current buffer as a float.
`play`([dur, delay])	Start processing without sending samples to output.
`out`([chnl, inc, dur, delay])	Start processing and send samples to audio output beginning at chnl.
`stop`([wait])	Stop processing.
`mix`([voices])	Mix the object's audio streams into voices streams and return a Mix object.
`range`(min, max)	Adjust mul and add attributes according to a given range.
`setMul`(x)	Replace the mul attribute.
`setAdd`(x)	Replace the add attribute.
`setSub`(x)	Replace and inverse the add attribute.
`setDiv`(x)	Replace and inverse the mul attribute.
`set`(attr, value[, port, callback])	Replace any attribute with portamento.
`ctrl`([map_list, title, wxnoserver])	Opens a sliders window to control the parameters of the object.

Inherited from PyoObjectBase

`__init__`()
`dump`()	Print infos about the current state of the object.
`getBaseObjects`()	Return a list of Stream objects managed by the instance.
`getServer`()	Return a reference to the current Server object.
`getSamplingRate`()	Return the current sampling rate (samples per second), as a float.
`getBufferSize`()	Return the current buffer size (samples per buffer), as an integer.
`allowAutoStart`([switch])	When autoStartChildren is activated in the Server, call this method with False as argument to stop the propagation of play/out/stop methods to and from this object.
`useWaitTimeOnStop`()	When autoStartChildren is activated in the Server, call this method to force an object given to the mul attribute of another object to use the wait time from the stop method instead of being stopped immediately.
`addLinkedObject`(x)	When autoStartChildren is activated in the Server, use this method to explicitly add an object in a dsp chain, which is generally controlled by the last object of the chain.
`setStopDelay`(x)	Set a specific waiting time when calling the stop method on this object.
`getStopDelay`()	Return the waiting time applied when calling the stop method on this object.
`__iter__`()
`__next__`()
`next`()	Alias for __next__ method.
`__getitem__`(i)
`__setitem__`(i, x)
`__len__`()
`__repr__`()	Return repr(self).
`__dir__`()	Default dir() implementation.

Private Data Attributes:

Inherited from PyoObject

_STREAM_TYPE

Inherited from PyoObjectBase

_STREAM_TYPE

Private Methods:

Inherited from PyoObject

`_init_play`()
`_reset_from_set`([attr])

Inherited from PyoObjectBase

`_autoplay`([dur, delay])
`_autostop`([wait])

setInput(x, fadetime=0.05)[source]¶

Replace the input attribute.

Args

x: PyoObject: New signal to process.
fadetime: float, optional: Crossfade time between old and new input. Defaults to 0.05.

setDownThresh(x)[source]¶

Replace the downthresh attribute.

Args

x: float or PyoObject: New downthresh attribute.

setUpThresh(x)[source]¶

Replace the upthresh attribute.

Args

x: float or PyoObject: New upthresh attribute.

setRatio(x)[source]¶

Replace the ratio attribute.

Args

x: float or PyoObject: New ratio attribute.

setRiseTime(x)[source]¶

Replace the risetime attribute.

Args

x: float or PyoObject: New risetime attribute.

setFallTime(x)[source]¶

Replace the falltime attribute.

Args

x: float or PyoObject: New falltime attribute.

setLookAhead(x)[source]¶

Replace the lookahead attribute.

Args

x: float: New lookahead attribute.

ctrl(map_list=None, title=None, wxnoserver=False)[source]¶

Opens a sliders window to control the parameters of the object. SLMap has a dataOnly attribute to identify parameters that don’t audio signal as control but only discrete values.

If a list of values are given to a parameter, a multisliders will be used to control each stream independently.

Args

map_list: list of SLMap objects, optional: Users defined set of parameters scaling. There is default scaling for each object that accept ctrl method.
title: string, optional: Title of the window. If none is provided, the name of the class is used.
wxnoserver: boolean, optional: With wxPython graphical toolkit, if True, tells the interpreter that there will be no server window.

If wxnoserver is set to True, the interpreter will not wait for the server GUI before showing the controller window.

property input¶: PyoObject. Input signal to process.

property downthresh¶: float or PyoObject. Level below which the signal is reduced.

property upthresh¶: float or PyoObject. Level above which the signal is boosted.

property ratio¶: float or PyoObject. in/out ratio for signals outside thresholds.

property risetime¶: float or PyoObject. Time to reach upward value in seconds.

property falltime¶: float or PyoObject. Time to reach downward value in seconds.

property lookahead¶: float. Delay length, in ms, of the “look-ahead” buffer.

Table of Contents

Search

Dynamic management¶

Objects in this category¶

Clip¶

Degrade¶

Mirror¶

Compress¶

Gate¶

Balance¶

Min¶

Max¶

Wrap¶

Expand¶