wavesongs.plot

wavesongs.plot#

A collection of functions to dsplay songs and results.

Functions

alpha_beta(obj[, xlim, ylim, figsize, save, ...])

phsyical_variables(obj[, xlim, figsize, ...])

scores(obj, obj_synth[, figsize, ylim, ...])

spectrogram_data([syllable, ff_on, tlim, ...])

spectrogram_waveform(obj[, syllable, ...])

spectrum_comparison(obj, obj_synth[, cmap, ...])

syllables(obj, obj_synth[, ff_on, figsize, ...])

wavesongs.plot.f1(x, y, alpha, beta, gamma)#

Created with lambdify. Signature:

func(x, y, alpha, beta, gamma)

Expression:

y

Source code:

def _lambdifygenerated(x, y, alpha, beta, gamma):

return y

Imported modules:

wavesongs.plot.f2(x, y, alpha, beta, gamma)#

Created with lambdify. Signature:

func(x, y, alpha, beta, gamma)

Expression:

gamma**2*(-alpha - beta*x - x**3 + x**2) - gamma*x*y*(x + 1)

Source code:

def _lambdifygenerated(x, y, alpha, beta, gamma):

return gamma**2*(-alpha - beta*x - x**3 + x**2) - gamma*x*y*(x + 1)

Imported modules:

wavesongs.plot._suptitle(obj) → AnyStr[source]#
Parameters:

obj (Syllable | Song) – _description_

Returns:

title – Title template

Return type:

AnyStr

wavesongs.plot.alpha_beta(obj: Any, xlim: Tuple[float] = (-0.05, 0.2), ylim: Tuple[float] = (-0.2, 0.9), figsize: Tuple[float] = (10, 6), save: bool = True, show: bool = True) → None[source]#
Parameters:

  • obj (Syllabe|Song) – Song or Syllable to be displayed

  • xlim (tuple = (-0.05,.2)) – Time range

  • ylim (tuple = (-0.2,0.9)) – Frequency range

  • figsize (tuple = (10,6)) – Fogure size (width, height)

  • save (bool = True) – Enable save plot

  • show (bool = True) – Enable display plot

Return type:

None

Example

>>>
wavesongs.plot.phsyical_variables(obj: Any, xlim: Tuple[float] = (), figsize: Tuple[float] = (10, 6), save: bool = True, show: bool = True) → None[source]#
Parameters:

  • obj (Syllabe|Song) – Song or Syllable to be displayed

  • xlim (tuple = (-0.05,.2)) – Time range

  • figsize (tuple = (10,6)) – Fogure size (width, height)

  • save (bool = True) – Save plot

  • show (bool = True) – Display plot

Returns:

files_names – List with the audios files names

Return type:

list

Example

>>>
wavesongs.plot.spectrogram_data(syllable: Syllable | None = None, ff_on: bool = False, tlim: Tuple[float] | None = None, figsize: Tuple[float] = (10, 6), ms: int = 7, labels: List = ['$f_{max/min}$', '$theme_{ini}$', '$theme_{end}$', '$trill_{ini}$', '$trill_{end}$'], colors: List = ['cyan', 'olivedrab', 'darkgreen', 'steelblue', 'royalblue'], markers: List = ['p', '*', '*', 'o', 'o']) → clicker[source]#
Parameters:

  • obj (Syllabe|Song) – Song or Syllable to be displayed

  • syllable (Syllable|None = None,)

  • chunck (Any|None = None,)

  • ff_on (bool =False,)

  • select_time (bool = False,)

  • tlim (tuple = (-0.05,.2)) – Time range

  • figsize (tuple = (10,6)) – Fogure size (width, height)

  • save (bool = True) – Save plot

  • show (bool = True) – Display plot

  • ms (int = 7) – Marker size

Returns:

klicker – Clicker object with the points selected

Return type:

cliker

Example

>>>
wavesongs.plot.spectrogram_waveform(obj: Any, syllable: Any | None = None, chunck: Any | None = None, ff_on: bool = False, select_time: bool = False, tlim: Tuple[float] | None = None, figsize: Tuple[float] = (10, 6), save: bool = True, show: bool = True, ms: int = 7) → clicker[source]#
Parameters:

  • obj (Syllabe|Song) – Song or Syllable to be displayed

  • syllable (Syllable|None = None,)

  • chunck (Any|None = None,)

  • ff_on (bool =False,)

  • select_time (bool = False,)

  • tlim (tuple = (-0.05,.2)) – Time range

  • figsize (tuple = (10,6)) – Fogure size (width, height)

  • save (bool = True) – Save plot

  • show (bool = True) – Display plot

  • ms (int = 7) – Marker size

Returns:

klicker – Clicker object with the points selected

Return type:

cliker

Example

>>>
wavesongs.plot.syllables(obj: Any, obj_synth: Any, ff_on: bool = False, figsize: Tuple[float] = (11, 6), save: bool = True, show: bool = True) → None[source]#
Parameters:

  • obj (Syllable | Song)

  • obj

  • ff_on (bool = False) – Falg to enable fundamental frequency visualization

  • save (bool = True) – Flag to save plot

  • show (bool = True) – Flag to display plot

Return type:

None

Example

>>>
wavesongs.plot.scores(obj: Any, obj_synth: Any, figsize: Tuple[float] = (11, 8), ylim: Tuple[float] = (), save: bool = True, show: bool = True) → None[source]#
Parameters:

  • obj (Syllable | Song)

  • obj_synth (Syllable | Song)

  • figsize (tuple = (10,10)) – Size of the figure (width, height)

  • ylim (tuple = ()) – Frequnecy range

  • save (bool = True) – Flag to save plot

  • show (bool = True) – Flag to display plot

Return type:

None

Example

>>>
wavesongs.plot.spectrum_comparison(obj: Any, obj_synth: Any, cmap: AnyStr = 'afmhot_r', figsize: Tuple[float] = (11, 6), sharey: bool = True, save: bool = True, show: bool = True) → None[source]#
Parameters:

  • obj (Syllable | Song)

  • obj_synth (Syllable | Song)

  • figsize (tuple = (10,10)) – Size of the figure (width, height)

  • sharey (bool = True,) – Enable share y axis

  • save (bool = True) – Flag to save plot

  • show (bool = True) – Flag to display plot

Return type:

None

Example

>>>
Contents