Caution

You're reading the documentation for a development version. For the latest released version, please have a look at 0.10.1.

librosa.display.NoteFormatter

class librosa.display.NoteFormatter(octave=True, major=True, key='C:maj', unicode=True)[source]

Ticker formatter for Notes

Parameters:
octavebool

If True, display the octave number along with the note name.

Otherwise, only show the note name (and cent deviation)

majorbool

If True, ticks are always labeled.

If False, ticks are only labeled if the span is less than 2 octaves

keystr

Key for determining pitch spelling.

unicodebool

If True, use unicode symbols for accidentals.

If False, use ASCII symbols for accidentals.

Examples

>>> import matplotlib.pyplot as plt
>>> values = librosa.midi_to_hz(np.arange(48, 72))
>>> fig, ax = plt.subplots(nrows=2)
>>> ax[0].bar(np.arange(len(values)), values)
>>> ax[0].set(ylabel='Hz')
>>> ax[1].bar(np.arange(len(values)), values)
>>> ax[1].yaxis.set_major_formatter(librosa.display.NoteFormatter())
>>> ax[1].set(ylabel='Note')
../_images/librosa-display-NoteFormatter-1.png
__init__(octave=True, major=True, key='C:maj', unicode=True)[source]

Methods

__init__([octave, major, key, unicode])

create_dummy_axis(**kwargs)

fix_minus(s)

Some classes may want to replace a hyphen for minus with the proper Unicode symbol (U+2212) for typographical correctness. This is a helper method to perform such a replacement when it is enabled via :rc:`axes.unicode_minus`.

format_data(value)

Return the full string representation of the value with the position unspecified.

format_data_short(value)

Return a short string version of the tick value.

format_ticks(values)

Return the tick labels for all the ticks at once.

get_offset()

set_axis(axis)

set_locs(locs)

Set the locations of the ticks.

Attributes

axis

locs