Table Of Contents

Previous topic

music21.stream

Next topic

music21.tempo

This Page

music21.serial

This module defines objects for defining and manipulating structures common to serial and/or twelve-tone music, including ToneRow subclasses.

music21.serial.pcToToneRow(pcSet)

A convenience function that, given a list of pitch classes represented as integers

>>> a = pcToToneRow(range(12))
>>> matrixObj = a.matrix()
>>> print matrixObj
0  1  2  3  4  5  6  7  8  9  A  B
B  0  1  2  3  4  5  6  7  8  9  A
...
>>> import random
>>> a = pcToToneRow([4,5,0,6,7,2,'a',8,9,1,'b',3])
>>> matrixObj = a.matrix()
>>> print matrixObj
0  1  8  2  3  A  6  4  5  9  7  B
B  0  7  1  2  9  5  3  4  8  6  A
...
music21.serial.rowToMatrix(p)

ToneRow

class music21.serial.ToneRow

A Stream representation of a tone row, or an ordered sequence of pitches.

inherits from: Stream, Music21Object

TwelveToneRow

class music21.serial.TwelveToneRow

A Stream representation of a twelve-tone row, capable of producing a 12-tone matrix.

inherits from: ToneRow, Stream, Music21Object

TwelveToneRow attributes

row
A list representing the pitch class values of the row.

Attributes inherited from Stream: isMeasure, flattenedRepresentationOf, classNames, isFlat, isSorted

Attributes inherited from Music21Object: classSortOrder, id, groups

TwelveToneRow properties

Properties inherited from Stream: measures, notes, pitches, duration, elements, flat, highestOffset, highestTime, isGapless, lily, lowestOffset, metadata, musicxml, mx, semiFlat, sorted

Properties inherited from Music21Object: offset, parent, priority

TwelveToneRow methods

matrix()

Returns a TwelveToneMatrix object for the row. That object can just be printed (or displayed via .show())

>>> s37 = RowSchoenbergOp37().matrix()
>>> print s37
0  B  7  8  3  1  2  A  6  5  4  9
1  0  8  9  4  2  3  B  7  6  5  A
5  4  0  1  8  6  7  3  B  A  9  2
4  3  B  0  7  5  6  2  A  9  8  1
...

Methods inherited from Stream: append(), insert(), insertAndShift(), transpose(), augmentOrDiminish(), scaleOffsets(), scaleDurations(), addGroupForElements(), allPlayingWhileSounding(), attachIntervalsBetweenStreams(), attributeCount(), bestClef(), extendDuration(), extractContext(), findConsecutiveNotes(), findGaps(), getClefs(), getElementAfterElement(), getElementAfterOffset(), getElementAtOrAfter(), getElementAtOrBefore(), getElementBeforeElement(), getElementBeforeOffset(), getElementById(), getElementsByClass(), getElementsByGroup(), getElementsByOffset(), getElementsNotOfClass(), getInstrument(), getKeySignatures(), getMeasure(), getMeasureRange(), getMeasures(), getOffsetByElement(), getOverlaps(), getSimultaneous(), getTimeSignatures(), groupCount(), groupElementsByOffset(), index(), indexList(), insertAtNativeOffset(), isClass(), isSequence(), makeAccidentals(), makeBeams(), makeMeasures(), makeNotation(), makeRests(), makeTies(), measureOffsetMap(), melodicIntervals(), pitchAttributeCount(), playingWhenAttacked(), plot(), pop(), remove(), repeatAppend(), repeatInsert(), replace(), setupPickleScaffold(), shiftElements(), simultaneousAttacks(), splitByClass(), stripTies(), teardownPickleScaffold(), transferOffsetToElements(), trimPlayingWhileSounding()

Methods inherited from Music21Object: addContext(), addLocation(), addLocationAndParent(), freezeIds(), getContextAttr(), getContextByClass(), getOffsetBySite(), getSiteIds(), getSites(), hasContext(), purgeLocations(), removeLocationBySite(), removeLocationBySiteId(), searchParentByAttr(), setContextAttr(), setOffsetBySite(), show(), unfreezeIds(), unwrapWeakref(), wrapWeakref(), write()

TwelveToneMatrix

class music21.serial.TwelveToneMatrix(*arguments, **keywords)

An object representation of a 2-dimensional array of 12 pitches. Internal representation is as a Stream, which stores 12 Streams, each Stream a horizontal row of pitches in the matrix. This object is commonly used by calling the matrix() method of TwelveToneRow() (or a subclass).

>>> aMatrix = TwelveToneMatrix()

inherits from: Stream, Music21Object

HistoricalTwelveToneRow

class music21.serial.HistoricalTwelveToneRow

A 12-tone row used in the historical literature. Added attributes to document the the historical context of the row.

inherits from: TwelveToneRow, ToneRow, Stream, Music21Object

HistoricalTwelveToneRow attributes

composer
The composers name.
opus
The opus of the work, or None.
title
The title of the work.

Attributes inherited from TwelveToneRow: row

Attributes inherited from Stream: isMeasure, flattenedRepresentationOf, classNames, isFlat, isSorted

Attributes inherited from Music21Object: classSortOrder, id, groups

HistoricalTwelveToneRow properties

Properties inherited from Stream: measures, notes, pitches, duration, elements, flat, highestOffset, highestTime, isGapless, lily, lowestOffset, metadata, musicxml, mx, semiFlat, sorted

Properties inherited from Music21Object: offset, parent, priority

HistoricalTwelveToneRow methods

Methods inherited from TwelveToneRow: matrix()

Methods inherited from Stream: append(), insert(), insertAndShift(), transpose(), augmentOrDiminish(), scaleOffsets(), scaleDurations(), addGroupForElements(), allPlayingWhileSounding(), attachIntervalsBetweenStreams(), attributeCount(), bestClef(), extendDuration(), extractContext(), findConsecutiveNotes(), findGaps(), getClefs(), getElementAfterElement(), getElementAfterOffset(), getElementAtOrAfter(), getElementAtOrBefore(), getElementBeforeElement(), getElementBeforeOffset(), getElementById(), getElementsByClass(), getElementsByGroup(), getElementsByOffset(), getElementsNotOfClass(), getInstrument(), getKeySignatures(), getMeasure(), getMeasureRange(), getMeasures(), getOffsetByElement(), getOverlaps(), getSimultaneous(), getTimeSignatures(), groupCount(), groupElementsByOffset(), index(), indexList(), insertAtNativeOffset(), isClass(), isSequence(), makeAccidentals(), makeBeams(), makeMeasures(), makeNotation(), makeRests(), makeTies(), measureOffsetMap(), melodicIntervals(), pitchAttributeCount(), playingWhenAttacked(), plot(), pop(), remove(), repeatAppend(), repeatInsert(), replace(), setupPickleScaffold(), shiftElements(), simultaneousAttacks(), splitByClass(), stripTies(), teardownPickleScaffold(), transferOffsetToElements(), trimPlayingWhileSounding()

Methods inherited from Music21Object: addContext(), addLocation(), addLocationAndParent(), freezeIds(), getContextAttr(), getContextByClass(), getOffsetBySite(), getSiteIds(), getSites(), hasContext(), purgeLocations(), removeLocationBySite(), removeLocationBySiteId(), searchParentByAttr(), setContextAttr(), setOffsetBySite(), show(), unfreezeIds(), unwrapWeakref(), wrapWeakref(), write()

RowBergChamberConcerto

class music21.serial.RowBergChamberConcerto
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowBergDerWein

class music21.serial.RowBergDerWein
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowBergLulu

class music21.serial.RowBergLulu
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowBergLuluActIIScene1

class music21.serial.RowBergLuluActIIScene1
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowBergLuluActIScene20

class music21.serial.RowBergLuluActIScene20
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowBergLyricSuite

class music21.serial.RowBergLyricSuite
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowBergLyricSuitePerm

class music21.serial.RowBergLyricSuitePerm
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowBergViolinConcerto

class music21.serial.RowBergViolinConcerto
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowBergWozzeckPassacaglia

class music21.serial.RowBergWozzeckPassacaglia
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergFragOrganSonata

class music21.serial.RowSchoenbergFragOrganSonata
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergFragPiano

class music21.serial.RowSchoenbergFragPiano
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergFragPianoPhantasia

class music21.serial.RowSchoenbergFragPianoPhantasia
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergIsraelExists

class music21.serial.RowSchoenbergIsraelExists
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergJakobsleiter

class music21.serial.RowSchoenbergJakobsleiter
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergMosesAron

class music21.serial.RowSchoenbergMosesAron
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp23No5

class music21.serial.RowSchoenbergOp23No5
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp24Mvmt4

class music21.serial.RowSchoenbergOp24Mvmt4
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp24Mvmt5

class music21.serial.RowSchoenbergOp24Mvmt5
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp25

class music21.serial.RowSchoenbergOp25
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp26

class music21.serial.RowSchoenbergOp26
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp27No1

class music21.serial.RowSchoenbergOp27No1
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp27No2

class music21.serial.RowSchoenbergOp27No2
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp27No3

class music21.serial.RowSchoenbergOp27No3
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp27No4

class music21.serial.RowSchoenbergOp27No4
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp28No1

class music21.serial.RowSchoenbergOp28No1
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp28No3

class music21.serial.RowSchoenbergOp28No3
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp29

class music21.serial.RowSchoenbergOp29
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp30

class music21.serial.RowSchoenbergOp30
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp31

class music21.serial.RowSchoenbergOp31
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp32

class music21.serial.RowSchoenbergOp32
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp33A

class music21.serial.RowSchoenbergOp33A
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp33B

class music21.serial.RowSchoenbergOp33B
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp34

class music21.serial.RowSchoenbergOp34
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp35No1

class music21.serial.RowSchoenbergOp35No1
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp35No2

class music21.serial.RowSchoenbergOp35No2
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp35No3

class music21.serial.RowSchoenbergOp35No3
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp35No5

class music21.serial.RowSchoenbergOp35No5
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp36

class music21.serial.RowSchoenbergOp36
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp37

class music21.serial.RowSchoenbergOp37
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp41

class music21.serial.RowSchoenbergOp41
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp42

class music21.serial.RowSchoenbergOp42
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp44

class music21.serial.RowSchoenbergOp44
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp45

class music21.serial.RowSchoenbergOp45
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp46

class music21.serial.RowSchoenbergOp46
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp47

class music21.serial.RowSchoenbergOp47
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp48No1

class music21.serial.RowSchoenbergOp48No1
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp48No2

class music21.serial.RowSchoenbergOp48No2
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp48No3

class music21.serial.RowSchoenbergOp48No3
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp50A

class music21.serial.RowSchoenbergOp50A
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp50B

class music21.serial.RowSchoenbergOp50B
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowSchoenbergOp50C

class music21.serial.RowSchoenbergOp50C
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp17No2

class music21.serial.RowWebernOp17No2
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp17No3

class music21.serial.RowWebernOp17No3
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp18No1

class music21.serial.RowWebernOp18No1
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp18No2

class music21.serial.RowWebernOp18No2
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp18No3

class music21.serial.RowWebernOp18No3
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp19No1

class music21.serial.RowWebernOp19No1
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp19No2

class music21.serial.RowWebernOp19No2
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp20

class music21.serial.RowWebernOp20
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp21

class music21.serial.RowWebernOp21
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp22

class music21.serial.RowWebernOp22
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp23

class music21.serial.RowWebernOp23
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp24

class music21.serial.RowWebernOp24
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp25

class music21.serial.RowWebernOp25
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp26

class music21.serial.RowWebernOp26
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp27

class music21.serial.RowWebernOp27
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp28

class music21.serial.RowWebernOp28
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp29

class music21.serial.RowWebernOp29
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp30

class music21.serial.RowWebernOp30
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOp31

class music21.serial.RowWebernOp31
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object

RowWebernOpNo17No1

class music21.serial.RowWebernOpNo17No1
inherits from: HistoricalTwelveToneRow, TwelveToneRow, ToneRow, Stream, Music21Object