music21.graph.utilities¶
Methods for finding external modules, converting colors to Matplotlib colors, etc.
Functions¶
-
music21.graph.utilities.accidentalLabelToUnicode(label)¶ Changes a label possibly containing a modifier such as “-” or “#” into a unicode string.
>>> print(graph.utilities.accidentalLabelToUnicode('B-4')) B♭4
Since matplotlib’s default fonts do not support double sharps or double flats, etc. these are converted as best we can...
>>> print(graph.utilities.accidentalLabelToUnicode('B--4')) B♭♭4
In Python 2, all strings are converted to unicode strings even if there is no need to.
-
music21.graph.utilities.getColor(color)¶ Convert any specification of a color to a hexadecimal color used by matplotlib.
>>> graph.utilities.getColor('red') '#ff0000' >>> graph.utilities.getColor('r') '#ff0000' >>> graph.utilities.getColor('Steel Blue') '#4682b4' >>> graph.utilities.getColor('#f50') '#ff5500' >>> graph.utilities.getColor([0.5, 0.5, 0.5]) '#808080' >>> graph.utilities.getColor(0.8) '#cccccc' >>> graph.utilities.getColor([0.8]) '#cccccc' >>> graph.utilities.getColor([255, 255, 255]) '#ffffff'
Invalid colors raise GraphExceptions:
>>> graph.utilities.getColor('l') Traceback (most recent call last): music21.graph.utilities.GraphException: invalid color abbreviation: l
>>> graph.utilities.getColor('chalkywhitebutsortofgreenish') Traceback (most recent call last): music21.graph.utilities.GraphException: invalid color name: chalkywhitebutsortofgreenish
>>> graph.utilities.getColor(True) Traceback (most recent call last): music21.graph.utilities.GraphException: invalid color specification: True
-
music21.graph.utilities.getExtendedModules()¶ this is done inside a function, so that the slow import of matplotlib is not done in
from music21 import *unless it’s actually needed.Returns a namedtuple: (matplotlib, Axes3D, collections, patches, plt, networkx)
ExtendedModules¶
-
class
music21.graph.utilities.ExtendedModules(matplotlib, Axes3D, collections, patches, plt, networkx)¶
ExtendedModules read-only properties
-
ExtendedModules.Axes3D¶ Alias for field number 1
-
ExtendedModules.collections¶ Alias for field number 2
-
ExtendedModules.matplotlib¶ Alias for field number 0
-
ExtendedModules.networkx¶ Alias for field number 5
-
ExtendedModules.patches¶ Alias for field number 3
-
ExtendedModules.plt¶ Alias for field number 4