"""
Tools to perform arithmetic operations on audio signals.
"""
"""
Copyright 2009-2015 Olivier Belanger
This file is part of pyo, a python module to help digital signal
processing script creation.
pyo is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
pyo is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with pyo. If not, see <http://www.gnu.org/licenses/>.
"""
from ._core import *
from ._maps import *
[docs]class Sin(PyoObject):
"""
Performs a sine function on audio signal.
Returns the sine of audio signal as input.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal, angle in radians.
>>> s = Server().boot()
>>> s.start()
>>> import math
>>> a = Phasor(500, mul=math.pi*2)
>>> b = Sin(a, mul=.3).mix(2).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Sin_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Cos(PyoObject):
"""
Performs a cosine function on audio signal.
Returns the cosine of audio signal as input.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal, angle in radians.
>>> s = Server().boot()
>>> s.start()
>>> import math
>>> a = Phasor(500, mul=math.pi*2)
>>> b = Cos(a, mul=.3).mix(2).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Cos_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Tan(PyoObject):
"""
Performs a tangent function on audio signal.
Returns the tangent of audio signal as input.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal, angle in radians.
>>> s = Server().boot()
>>> s.start()
>>> # Tangent panning function
>>> import math
>>> src = Sine(mul=.3)
>>> a = Phasor(freq=1, mul=90, add=-45)
>>> b = Tan(Abs(a*math.pi/180))
>>> b1 = 1.0 - b
>>> oL = src * b
>>> oR = src * b1
>>> oL.out()
>>> oR.out(1)
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Tan_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Abs(PyoObject):
"""
Performs an absolute function on audio signal.
Returns the absolute value of audio signal as input.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal to process.
>>> s = Server().boot()
>>> s.start()
>>> # Back-and-Forth playback
>>> t = SndTable(SNDS_PATH + "/transparent.aif")
>>> a = Phasor(freq=t.getRate()*0.5, mul=2, add=-1)
>>> b = Pointer(table=t, index=Abs(a), mul=0.5).mix(2).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Abs_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Sqrt(PyoObject):
"""
Performs a square-root function on audio signal.
Returns the square-root value of audio signal as input.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal to process.
>>> s = Server().boot()
>>> s.start()
>>> # Equal-power panning function
>>> src = Sine(mul=.3)
>>> a = Abs(Phasor(freq=1, mul=2, add=-1))
>>> left = Sqrt(1.0 - a)
>>> right = Sqrt(a)
>>> oL = src * left
>>> oR = src * right
>>> oL.out()
>>> oR.out(1)
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Sqrt_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Log(PyoObject):
"""
Performs a natural log function on audio signal.
Returns the natural log value of of audio signal as input.
Values less than 0.0 return 0.0.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal to process.
>>> s = Server().boot()
>>> s.start()
# Logarithmic amplitude envelope
>>> a = LFO(freq=1, type=3, mul=0.2, add=1.2) # triangle
>>> b = Log(a)
>>> c = SineLoop(freq=[300,301], feedback=0.05, mul=b).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Log_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Log2(PyoObject):
"""
Performs a base 2 log function on audio signal.
Returns the base 2 log value of audio signal as input.
Values less than 0.0 return 0.0.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal to process.
>>> s = Server().boot()
>>> s.start()
# Logarithmic amplitude envelope
>>> a = LFO(freq=1, type=3, mul=0.1, add=1.1) # triangle
>>> b = Log2(a)
>>> c = SineLoop(freq=[300,301], feedback=0.05, mul=b).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Log2_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Log10(PyoObject):
"""
Performs a base 10 log function on audio signal.
Returns the base 10 log value of audio signal as input.
Values less than 0.0 return 0.0.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal to process.
>>> s = Server().boot()
>>> s.start()
# Logarithmic amplitude envelope
>>> a = LFO(freq=1, type=3, mul=0.4, add=1.4) # triangle
>>> b = Log10(a)
>>> c = SineLoop(freq=[300,301], feedback=0.05, mul=b).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Log10_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Atan2(PyoObject):
"""
Computes the principal value of the arc tangent of b/a.
Computes the principal value of the arc tangent of b/a,
using the signs of both arguments to determine the quadrant
of the return value.
:Parent: :py:class:`PyoObject`
:Args:
b: float or PyoObject, optional
Numerator. Defaults to 1.
a: float or PyoObject, optional
Denominator. Defaults to 1.
>>> s = Server().boot()
>>> s.start()
>>> # Simple distortion
>>> a = Sine(freq=[200,200.3])
>>> lf = Sine(freq=1, mul=.2, add=.2)
>>> dist = Atan2(a, lf)
>>> lp = Tone(dist, freq=2000, mul=.1).out()
"""
def __init__(self, b=1, a=1, mul=1, add=0):
pyoArgsAssert(self, "OOOO", b, a, mul, add)
PyoObject.__init__(self, mul, add)
self._b = b
self._a = a
b, a, mul, add, lmax = convertArgsToLists(b, a, mul, add)
self._base_objs = [M_Atan2_base(wrap(b, i), wrap(a, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
[docs] def setB(self, x):
"""
Replace the `b` attribute.
:Args:
x: float or PyoObject
new `b` attribute.
"""
pyoArgsAssert(self, "O", x)
self._b = x
x, lmax = convertArgsToLists(x)
[obj.setB(wrap(x, i)) for i, obj in enumerate(self._base_objs)]
[docs] def setA(self, x):
"""
Replace the `a` attribute.
:Args:
x: float or PyoObject
new `a` attribute.
"""
pyoArgsAssert(self, "O", x)
self._a = x
x, lmax = convertArgsToLists(x)
[obj.setA(wrap(x, i)) for i, obj in enumerate(self._base_objs)]
@property
def b(self):
"""float or PyoObject. Numerator."""
return self._b
@b.setter
def b(self, x):
self.setB(x)
@property
def a(self):
"""float or PyoObject. Denominator."""
return self._a
@a.setter
def a(self, x):
self.setA(x)
[docs]class Floor(PyoObject):
"""
Rounds to largest integral value not greater than audio signal.
For each samples in the input signal, rounds to the largest integral
value not greater than the sample value.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal to process.
>>> s = Server().boot()
>>> s.start()
>>> # Clipping frequencies
>>> sweep = Phasor(freq=[1,.67], mul=4)
>>> flo = Floor(sweep, mul=50, add=200)
>>> a = SineLoop(freq=flo, feedback=.1, mul=.3).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Floor_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Ceil(PyoObject):
"""
Rounds to smallest integral value greater than or equal to the input signal.
For each samples in the input signal, rounds to the smallest integral
value greater than or equal to the sample value.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal to process.
>>> s = Server().boot()
>>> s.start()
>>> # Clipping frequencies
>>> sweep = Phasor(freq=[1,.67], mul=4)
>>> flo = Ceil(sweep, mul=50, add=200)
>>> a = SineLoop(freq=flo, feedback=.1, mul=.3).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Ceil_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Round(PyoObject):
"""
Rounds to the nearest integer value in a floating-point format.
For each samples in the input signal, rounds to the nearest integer
value of the sample value.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal to process.
>>> s = Server().boot()
>>> s.start()
>>> # Clipping frequencies
>>> sweep = Phasor(freq=[1,.67], mul=4)
>>> flo = Round(sweep, mul=50, add=200)
>>> a = SineLoop(freq=flo, feedback=.1, mul=.3).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Round_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Tanh(PyoObject):
"""
Performs a hyperbolic tangent function on audio signal.
Returns the hyperbolic tangent of audio signal as input.
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal, angle in radians.
>>> s = Server().boot()
>>> s.start()
>>> import math
>>> a = Phasor(250, mul=math.pi*2)
>>> b = Tanh(Sin(a, mul=10), mul=0.3).mix(2).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Tanh_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Exp(PyoObject):
"""
Calculates the value of e to the power of x.
Returns the value of e to the power of x, where e is the base of the
natural logarithm, 2.718281828...
:Parent: :py:class:`PyoObject`
:Args:
input: PyoObject
Input signal, the exponent.
>>> s = Server().boot()
>>> s.start()
>>> a = Sine(freq=200)
>>> lf = Sine(freq=.5, mul=5, add=6)
>>> # Tanh style distortion
>>> t = Exp(2 * a * lf)
>>> th = (t - 1) / (t + 1)
>>> out = (th * 0.3).out()
"""
def __init__(self, input, mul=1, add=0):
pyoArgsAssert(self, "oOO", input, mul, add)
PyoObject.__init__(self, mul, add)
self._input = input
self._in_fader = InputFader(input)
in_fader, mul, add, lmax = convertArgsToLists(self._in_fader, mul, add)
self._base_objs = [M_Exp_base(wrap(in_fader, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
@property
def input(self):
"""PyoObject. Input signal to process."""
return self._input
@input.setter
def input(self, x):
self.setInput(x)
[docs]class Div(PyoObject):
"""
Divides a by b.
:Parent: :py:class:`PyoObject`
:Args:
a: float or PyoObject, optional
Numerator. Defaults to 1.
b: float or PyoObject, optional
Denominator. Defaults to 1.
>>> s = Server().boot()
>>> s.start()
>>> a = Sine(freq=[400, 500])
>>> b = Randi(min=1, max=10, freq=5.00)
>>> c = Div(a, b, mul=0.3).out()
"""
def __init__(self, a=1, b=1, mul=1, add=0):
pyoArgsAssert(self, "OOOO", a, b, mul, add)
PyoObject.__init__(self, mul, add)
self._a = a
self._b = b
a, b, mul, add, lmax = convertArgsToLists(a, b, mul, add)
self._base_objs = [M_Div_base(wrap(a, i), wrap(b, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
[docs] def setA(self, x):
"""
Replace the `a` attribute.
:Args:
x: float or PyoObject
new `a` attribute.
"""
pyoArgsAssert(self, "O", x)
self._a = x
x, lmax = convertArgsToLists(x)
[obj.setA(wrap(x, i)) for i, obj in enumerate(self._base_objs)]
[docs] def setB(self, x):
"""
Replace the `b` attribute.
:Args:
x: float or PyoObject
new `b` attribute.
"""
pyoArgsAssert(self, "O", x)
self._b = x
x, lmax = convertArgsToLists(x)
[obj.setB(wrap(x, i)) for i, obj in enumerate(self._base_objs)]
@property
def a(self):
"""float or PyoObject. Numerator."""
return self._a
@a.setter
def a(self, x):
self.setA(x)
@property
def b(self):
"""float or PyoObject. Denominator."""
return self._b
@b.setter
def b(self, x):
self.setB(x)
[docs]class Sub(PyoObject):
"""
Substracts b from a.
:Parent: :py:class:`PyoObject`
:Args:
a: float or PyoObject, optional
Left operand. Defaults to 1.
b: float or PyoObject, optional
Right operand. Defaults to 1.
>>> s = Server().boot()
>>> s.start()
>>> a = Sig([400, 500])
>>> b = Randi(min=50, max=100, freq=5.00)
>>> c = Sub(a, b)
>>> d = SineLoop(freq=c, feedback=0.08, mul=0.3).out()
"""
def __init__(self, a=1, b=1, mul=1, add=0):
pyoArgsAssert(self, "OOOO", a, b, mul, add)
PyoObject.__init__(self, mul, add)
self._a = a
self._b = b
a, b, mul, add, lmax = convertArgsToLists(a, b, mul, add)
self._base_objs = [M_Sub_base(wrap(a, i), wrap(b, i), wrap(mul, i), wrap(add, i)) for i in range(lmax)]
self._init_play()
[docs] def setA(self, x):
"""
Replace the `a` attribute.
:Args:
x: float or PyoObject
new `a` attribute.
"""
pyoArgsAssert(self, "O", x)
self._a = x
x, lmax = convertArgsToLists(x)
[obj.setA(wrap(x, i)) for i, obj in enumerate(self._base_objs)]
[docs] def setB(self, x):
"""
Replace the `b` attribute.
:Args:
x: float or PyoObject
new `b` attribute.
"""
pyoArgsAssert(self, "O", x)
self._b = x
x, lmax = convertArgsToLists(x)
[obj.setB(wrap(x, i)) for i, obj in enumerate(self._base_objs)]
@property
def a(self):
"""float or PyoObject. Left operand."""
return self._a
@a.setter
def a(self, x):
self.setA(x)
@property
def b(self):
"""float or PyoObject. Right operand."""
return self._b
@b.setter
def b(self, x):
self.setB(x)