.. _moduleRoman:

music21.roman
=============

.. WARNING: DO NOT EDIT THIS FILE:
   AUTOMATICALLY GENERATED.
   PLEASE EDIT THE .py FILE DIRECTLY.

.. automodule:: music21.roman

RomanNumeral
------------

.. autoclass:: music21.roman.RomanNumeral

.. rubric:: :class:`~music21.roman.RomanNumeral` bases

- :class:`~music21.harmony.Harmony`
- :class:`~music21.chord.Chord`
- :class:`~music21.chord.ChordBase`
- :class:`~music21.note.NotRest`
- :class:`~music21.note.GeneralNote`
- :class:`~music21.base.Music21Object`
- :class:`~music21.prebase.ProtoM21Object`

.. rubric:: :class:`~music21.roman.RomanNumeral` read-only properties

.. autoattribute:: music21.roman.RomanNumeral.figureAndKey

.. autoattribute:: music21.roman.RomanNumeral.scaleDegreeWithAlteration

Read-only properties inherited from :class:`~music21.chord.Chord`:

.. hlist::
   :columns: 3

   - :attr:`~music21.chord.Chord.chordTablesAddress`
   - :attr:`~music21.chord.Chord.commonName`
   - :attr:`~music21.chord.Chord.fifth`
   - :attr:`~music21.chord.Chord.forteClass`
   - :attr:`~music21.chord.Chord.forteClassNumber`
   - :attr:`~music21.chord.Chord.forteClassTn`
   - :attr:`~music21.chord.Chord.forteClassTnI`
   - :attr:`~music21.chord.Chord.fullName`
   - :attr:`~music21.chord.Chord.hasZRelation`
   - :attr:`~music21.chord.Chord.intervalVector`
   - :attr:`~music21.chord.Chord.intervalVectorString`
   - :attr:`~music21.chord.Chord.isPrimeFormInversion`
   - :attr:`~music21.chord.Chord.multisetCardinality`
   - :attr:`~music21.chord.Chord.normalOrder`
   - :attr:`~music21.chord.Chord.normalOrderString`
   - :attr:`~music21.chord.Chord.orderedPitchClasses`
   - :attr:`~music21.chord.Chord.orderedPitchClassesString`
   - :attr:`~music21.chord.Chord.pitchClassCardinality`
   - :attr:`~music21.chord.Chord.pitchClasses`
   - :attr:`~music21.chord.Chord.pitchedCommonName`
   - :attr:`~music21.chord.Chord.primeForm`
   - :attr:`~music21.chord.Chord.primeFormString`
   - :attr:`~music21.chord.Chord.quality`
   - :attr:`~music21.chord.Chord.scaleDegrees`
   - :attr:`~music21.chord.Chord.seventh`
   - :attr:`~music21.chord.Chord.third`

Read-only properties inherited from :class:`~music21.base.Music21Object`:

.. hlist::
   :columns: 3

   - :attr:`~music21.base.Music21Object.beat`
   - :attr:`~music21.base.Music21Object.beatDuration`
   - :attr:`~music21.base.Music21Object.beatStr`
   - :attr:`~music21.base.Music21Object.beatStrength`
   - :attr:`~music21.base.Music21Object.hasEditorialInformation`
   - :attr:`~music21.base.Music21Object.hasStyleInformation`
   - :attr:`~music21.base.Music21Object.measureNumber`

Read-only properties inherited from :class:`~music21.prebase.ProtoM21Object`:

.. hlist::
   :columns: 3

   - :attr:`~music21.prebase.ProtoM21Object.classSet`
   - :attr:`~music21.prebase.ProtoM21Object.classes`

.. rubric:: :class:`~music21.roman.RomanNumeral` read/write properties

.. autoattribute:: music21.roman.RomanNumeral.figure

.. autoattribute:: music21.roman.RomanNumeral.functionalityScore

.. autoattribute:: music21.roman.RomanNumeral.key

.. autoattribute:: music21.roman.RomanNumeral.romanNumeral

Read/write properties inherited from :class:`~music21.harmony.Harmony`:

.. hlist::
   :columns: 3

   - :attr:`~music21.harmony.Harmony.writeAsChord`

Read/write properties inherited from :class:`~music21.chord.Chord`:

.. hlist::
   :columns: 3

   - :attr:`~music21.chord.Chord.duration`
   - :attr:`~music21.chord.Chord.notes`
   - :attr:`~music21.chord.Chord.pitchNames`
   - :attr:`~music21.chord.Chord.pitches`

Read/write properties inherited from :class:`~music21.chord.ChordBase`:

.. hlist::
   :columns: 3

   - :attr:`~music21.chord.ChordBase.tie`
   - :attr:`~music21.chord.ChordBase.volume`

Read/write properties inherited from :class:`~music21.note.NotRest`:

.. hlist::
   :columns: 3

   - :attr:`~music21.note.NotRest.notehead`
   - :attr:`~music21.note.NotRest.noteheadFill`
   - :attr:`~music21.note.NotRest.noteheadParenthesis`
   - :attr:`~music21.note.NotRest.stemDirection`
   - :attr:`~music21.note.NotRest.storedInstrument`

Read/write properties inherited from :class:`~music21.note.GeneralNote`:

.. hlist::
   :columns: 3

   - :attr:`~music21.note.GeneralNote.lyric`

Read/write properties inherited from :class:`~music21.base.Music21Object`:

.. hlist::
   :columns: 3

   - :attr:`~music21.base.Music21Object.activeSite`
   - :attr:`~music21.base.Music21Object.derivation`
   - :attr:`~music21.base.Music21Object.editorial`
   - :attr:`~music21.base.Music21Object.id`
   - :attr:`~music21.base.Music21Object.offset`
   - :attr:`~music21.base.Music21Object.priority`
   - :attr:`~music21.base.Music21Object.quarterLength`
   - :attr:`~music21.base.Music21Object.seconds`
   - :attr:`~music21.base.Music21Object.style`

.. rubric:: :class:`~music21.roman.RomanNumeral` methods

.. automethod:: music21.roman.RomanNumeral.__eq__

.. automethod:: music21.roman.RomanNumeral.adjustMinorVIandVIIByQuality

.. automethod:: music21.roman.RomanNumeral.bassScaleDegreeFromNotation

.. automethod:: music21.roman.RomanNumeral.isMixture

.. automethod:: music21.roman.RomanNumeral.isNeapolitan

Methods inherited from :class:`~music21.harmony.Harmony`:

.. hlist::
   :columns: 3

   - :meth:`~music21.harmony.Harmony.addChordStepModification`
   - :meth:`~music21.harmony.Harmony.findFigure`
   - :meth:`~music21.harmony.Harmony.getChordStepModifications`

Methods inherited from :class:`~music21.chord.Chord`:

.. hlist::
   :columns: 3

   - :meth:`~music21.chord.Chord.__getitem__`
   - :meth:`~music21.chord.Chord.add`
   - :meth:`~music21.chord.Chord.annotateIntervals`
   - :meth:`~music21.chord.Chord.areZRelations`
   - :meth:`~music21.chord.Chord.bass`
   - :meth:`~music21.chord.Chord.canBeDominantV`
   - :meth:`~music21.chord.Chord.canBeTonic`
   - :meth:`~music21.chord.Chord.closedPosition`
   - :meth:`~music21.chord.Chord.containsSeventh`
   - :meth:`~music21.chord.Chord.containsTriad`
   - :meth:`~music21.chord.Chord.formatVectorString`
   - :meth:`~music21.chord.Chord.geometricNormalForm`
   - :meth:`~music21.chord.Chord.getChordStep`
   - :meth:`~music21.chord.Chord.getColor`
   - :meth:`~music21.chord.Chord.getNotehead`
   - :meth:`~music21.chord.Chord.getNoteheadFill`
   - :meth:`~music21.chord.Chord.getStemDirection`
   - :meth:`~music21.chord.Chord.getTie`
   - :meth:`~music21.chord.Chord.getVolume`
   - :meth:`~music21.chord.Chord.getZRelation`
   - :meth:`~music21.chord.Chord.hasAnyEnharmonicSpelledPitches`
   - :meth:`~music21.chord.Chord.hasAnyRepeatedDiatonicNote`
   - :meth:`~music21.chord.Chord.hasRepeatedChordStep`
   - :meth:`~music21.chord.Chord.intervalFromChordStep`
   - :meth:`~music21.chord.Chord.inversion`
   - :meth:`~music21.chord.Chord.inversionName`
   - :meth:`~music21.chord.Chord.inversionText`
   - :meth:`~music21.chord.Chord.isAugmentedSixth`
   - :meth:`~music21.chord.Chord.isAugmentedTriad`
   - :meth:`~music21.chord.Chord.isConsonant`
   - :meth:`~music21.chord.Chord.isDiminishedSeventh`
   - :meth:`~music21.chord.Chord.isDiminishedTriad`
   - :meth:`~music21.chord.Chord.isDominantSeventh`
   - :meth:`~music21.chord.Chord.isFalseDiminishedSeventh`
   - :meth:`~music21.chord.Chord.isFrenchAugmentedSixth`
   - :meth:`~music21.chord.Chord.isGermanAugmentedSixth`
   - :meth:`~music21.chord.Chord.isHalfDiminishedSeventh`
   - :meth:`~music21.chord.Chord.isIncompleteMajorTriad`
   - :meth:`~music21.chord.Chord.isIncompleteMinorTriad`
   - :meth:`~music21.chord.Chord.isItalianAugmentedSixth`
   - :meth:`~music21.chord.Chord.isMajorTriad`
   - :meth:`~music21.chord.Chord.isMinorTriad`
   - :meth:`~music21.chord.Chord.isNinth`
   - :meth:`~music21.chord.Chord.isSeventh`
   - :meth:`~music21.chord.Chord.isSeventhOfType`
   - :meth:`~music21.chord.Chord.isSwissAugmentedSixth`
   - :meth:`~music21.chord.Chord.isTranspositionallySymmetrical`
   - :meth:`~music21.chord.Chord.isTriad`
   - :meth:`~music21.chord.Chord.removeRedundantPitchClasses`
   - :meth:`~music21.chord.Chord.removeRedundantPitchNames`
   - :meth:`~music21.chord.Chord.removeRedundantPitches`
   - :meth:`~music21.chord.Chord.root`
   - :meth:`~music21.chord.Chord.semiClosedPosition`
   - :meth:`~music21.chord.Chord.semitonesFromChordStep`
   - :meth:`~music21.chord.Chord.setColor`
   - :meth:`~music21.chord.Chord.setNotehead`
   - :meth:`~music21.chord.Chord.setNoteheadFill`
   - :meth:`~music21.chord.Chord.setStemDirection`
   - :meth:`~music21.chord.Chord.setTie`
   - :meth:`~music21.chord.Chord.setVolume`
   - :meth:`~music21.chord.Chord.simplifyEnharmonics`
   - :meth:`~music21.chord.Chord.sortAscending`
   - :meth:`~music21.chord.Chord.sortChromaticAscending`
   - :meth:`~music21.chord.Chord.sortDiatonicAscending`
   - :meth:`~music21.chord.Chord.sortFrequencyAscending`
   - :meth:`~music21.chord.Chord.transpose`

Methods inherited from :class:`~music21.chord.ChordBase`:

.. hlist::
   :columns: 3

   - :meth:`~music21.chord.ChordBase.hasComponentVolumes`
   - :meth:`~music21.chord.ChordBase.remove`
   - :meth:`~music21.chord.ChordBase.setVolumes`

Methods inherited from :class:`~music21.note.NotRest`:

.. hlist::
   :columns: 3

   - :meth:`~music21.note.NotRest.getInstrument`
   - :meth:`~music21.note.NotRest.hasVolumeInformation`

Methods inherited from :class:`~music21.note.GeneralNote`:

.. hlist::
   :columns: 3

   - :meth:`~music21.note.GeneralNote.addLyric`
   - :meth:`~music21.note.GeneralNote.augmentOrDiminish`
   - :meth:`~music21.note.GeneralNote.getGrace`
   - :meth:`~music21.note.GeneralNote.insertLyric`

Methods inherited from :class:`~music21.base.Music21Object`:

.. hlist::
   :columns: 3

   - :meth:`~music21.base.Music21Object.clearCache`
   - :meth:`~music21.base.Music21Object.containerHierarchy`
   - :meth:`~music21.base.Music21Object.contextSites`
   - :meth:`~music21.base.Music21Object.getAllContextsByClass`
   - :meth:`~music21.base.Music21Object.getContextByClass`
   - :meth:`~music21.base.Music21Object.getOffsetBySite`
   - :meth:`~music21.base.Music21Object.getOffsetInHierarchy`
   - :meth:`~music21.base.Music21Object.getSpannerSites`
   - :meth:`~music21.base.Music21Object.informSites`
   - :meth:`~music21.base.Music21Object.mergeAttributes`
   - :meth:`~music21.base.Music21Object.next`
   - :meth:`~music21.base.Music21Object.previous`
   - :meth:`~music21.base.Music21Object.purgeLocations`
   - :meth:`~music21.base.Music21Object.purgeOrphans`
   - :meth:`~music21.base.Music21Object.setOffsetBySite`
   - :meth:`~music21.base.Music21Object.show`
   - :meth:`~music21.base.Music21Object.sortTuple`
   - :meth:`~music21.base.Music21Object.splitAtDurations`
   - :meth:`~music21.base.Music21Object.splitAtQuarterLength`
   - :meth:`~music21.base.Music21Object.splitByQuarterLengths`
   - :meth:`~music21.base.Music21Object.write`

Methods inherited from :class:`~music21.prebase.ProtoM21Object`:

.. hlist::
   :columns: 3

   - :meth:`~music21.prebase.ProtoM21Object.isClassOrSubclass`

.. rubric:: :class:`~music21.roman.RomanNumeral` instance variables

.. attribute:: RomanNumeral.addedSteps

	
	Returns a list of the added steps, each as a tuple of
	modifier as a string (which might be empty) and a chord factor as an int.
	
	>>> rn = roman.RomanNumeral('V7[addb6]', 'C')
	>>> rn.addedSteps
	[('-', 6)]
	>>> rn.pitches
	(<music21.pitch.Pitch G4>,
	<music21.pitch.Pitch B4>,
	<music21.pitch.Pitch D5>,
	<music21.pitch.Pitch E-5>,
	<music21.pitch.Pitch F5>)
	
	You can add multiple added steps:
	
	>>> strange = roman.RomanNumeral('V7[addb6][add#6][add-8]')
	>>> strange.addedSteps
	[('-', 6), ('#', 6), ('-', 8)]
	>>> ' '.join([p.nameWithOctave for p in strange.pitches])
	'G4 B4 D5 E-5 E#5 F5 G-5'
	
	NOTE: The modifier name is currently changed from 'b' to '-', but
	this might change in a future version to match `bracketedAlteration`.
	

.. attribute:: RomanNumeral.bracketedAlterations

	
	Returns a list of the bracketed alterations, each as a tuple of
	modifier as a string and a chord factor as an int.
	
	>>> rn = roman.RomanNumeral('V7[b5]')
	>>> rn.bracketedAlterations
	[('b', 5)]
	>>> rn.pitches
	(<music21.pitch.Pitch G4>,
	<music21.pitch.Pitch B4>,
	<music21.pitch.Pitch D-5>,
	<music21.pitch.Pitch F5>)
	
	NOTE: The bracketed alteration name is currently left as 'b', but
	this might change in a future version to match `addedSteps`.
	
	The difference between a bracketed alteration and just
	putting b5 in is that, a bracketed alteration changes
	notes already present in a chord and does not imply that
	the normally present notes would be missing.  Here, the
	presence of 7 and b5 means that no 3rd should appear.
	
	>>> rn2 = roman.RomanNumeral('V7b5')
	>>> rn2.bracketedAlterations
	[]
	>>> len(rn2.pitches)
	3
	>>> [p.name for p in rn2.pitches]
	['G', 'D-', 'F']
	
	Changed in v6.5 -- always returns a list, even if it is empty.
	

.. attribute:: RomanNumeral.caseMatters

	
	Boolean to determine whether the case (upper or lowercase) of the
	figure determines whether it is major or minor.  Defaults to True;
	not everything has been tested with False yet.
	
	>>> roman.RomanNumeral('viiø7', 'd').caseMatters
	True
	

.. attribute:: RomanNumeral.figuresNotationObj

	
	Returns a :class:`~music21.figuredBass.notation.Notation` object
	that represents the figures in a RomanNumeral
	
	>>> rn = roman.RomanNumeral('V65')
	>>> notationObj = rn.figuresNotationObj
	>>> notationObj
	<music21.figuredBass.notation.Notation 6,5>
	>>> notationObj.numbers
	(6, 5, 3)
	
	>>> rn = roman.RomanNumeral('Ib75#3')
	>>> notationObj = rn.figuresNotationObj
	>>> notationObj.numbers
	(7, 5, 3)
	>>> notationObj.modifiers
	(<music21.figuredBass.notation.Modifier b flat>,
	<music21.figuredBass.notation.Modifier None None>,
	<music21.figuredBass.notation.Modifier # sharp>)
	

.. attribute:: RomanNumeral.figuresWritten

	
	Returns a string containing any figured-bass figures as passed in:
	
	>>> roman.RomanNumeral('V65').figuresWritten
	'65'
	>>> roman.RomanNumeral('V').figuresWritten
	''
	>>> roman.RomanNumeral('Fr43', 'c').figuresWritten
	'43'
	>>> roman.RomanNumeral('I7#5b3').figuresWritten
	'7#5b3'
	
	Note that the `o` and `ø` symbols are quality designations and not
	figures:
	
	>>> roman.RomanNumeral('viio6').figuresWritten
	'6'
	>>> roman.RomanNumeral('viiø7').figuresWritten
	'7'
	

.. attribute:: RomanNumeral.frontAlterationAccidental

	
	An optional :class:`~music21.pitch.Accidental` object
	representing the chromatic alteration of a RomanNumeral, if any
	
	>>> roman.RomanNumeral('bII43/vi', 'C').frontAlterationAccidental
	<music21.pitch.Accidental flat>
	
	>>> roman.RomanNumeral('##IV').frontAlterationAccidental
	<music21.pitch.Accidental double-sharp>
	
	For most roman numerals this will be None:
	
	>>> roman.RomanNumeral('V', 'f#').frontAlterationAccidental
	
	Changing this value will not change existing pitches.
	
	Changed in v6.5 -- always returns a string, never None
	

.. attribute:: RomanNumeral.frontAlterationString

	
	A string representing the chromatic alteration of a RomanNumeral, if any
	
	>>> roman.RomanNumeral('bII43/vi', 'C').frontAlterationString
	'b'
	>>> roman.RomanNumeral('V', 'f#').frontAlterationString
	''
	
	Changing this value will not change existing pitches.
	
	Changed in v6.5 -- always returns a string, never None
	

.. attribute:: RomanNumeral.frontAlterationTransposeInterval

	
	An optional :class:`~music21.interval.Interval` object
	representing the transposition of a chromatically altered chord from
	the normal scale degree:
	
	>>> sharpFour = roman.RomanNumeral('#IV', 'C')
	>>> sharpFour.frontAlterationTransposeInterval
	<music21.interval.Interval A1>
	>>> sharpFour.frontAlterationTransposeInterval.niceName
	'Augmented Unison'
	
	Flats, as in this Neapolitan (bII6) chord, are given as diminished unisons:
	
	>>> roman.RomanNumeral('N6', 'C').frontAlterationTransposeInterval
	<music21.interval.Interval d1>
	
	Most RomanNumerals will have None and not a perfect unison for this value
	(this is for the speed of creating objects)
	
	>>> intv = roman.RomanNumeral('V', 'e-').frontAlterationTransposeInterval
	>>> intv is None
	True
	
	Changing this value will not change existing pitches.
	

.. attribute:: RomanNumeral.impliedQuality

	
	The quality of the chord implied by the figure:
	
	>>> roman.RomanNumeral('V', 'C').impliedQuality
	'major'
	>>> roman.RomanNumeral('ii65', 'C').impliedQuality
	'minor'
	>>> roman.RomanNumeral('viio7', 'C').impliedQuality
	'diminished'
	
	The impliedQuality can differ from the actual quality
	if there are not enough notes to satisfy the implied quality,
	as in this half-diminished chord on vii which does not also
	have a seventh:
	
	>>> incorrectSeventh = roman.RomanNumeral('vii/o', 'C')
	>>> incorrectSeventh.impliedQuality
	'half-diminished'
	>>> incorrectSeventh.quality
	'diminished'
	
	>>> powerChordMinor = roman.RomanNumeral('v[no3]', 'C')
	>>> powerChordMinor.impliedQuality
	'minor'
	>>> powerChordMinor.quality
	'other'
	
	If case does not matter then an empty quality is implied:
	
	>>> roman.RomanNumeral('II', 'C', caseMatters=False).impliedQuality
	''
	
	

.. attribute:: RomanNumeral.impliedScale

	
	If no key or scale is passed in as the second object, then
	impliedScale will be set to C major:
	
	>>> roman.RomanNumeral('V').impliedScale
	<music21.scale.MajorScale C major>
	
	Otherwise this will be empty:
	
	>>> roman.RomanNumeral('V', key.Key('D')).impliedScale
	

.. attribute:: RomanNumeral.omittedSteps

	
	A list of integers showing chord factors that have been
	specifically omitted:
	
	>>> emptyNinth = roman.RomanNumeral('V9[no7][no5]', 'C')
	>>> emptyNinth.omittedSteps
	[7, 5]
	>>> emptyNinth.pitches
	(<music21.pitch.Pitch G4>,
	<music21.pitch.Pitch B4>,
	<music21.pitch.Pitch A5>)
	
	Usually an empty list:
	
	>>> roman.RomanNumeral('IV6').omittedSteps
	[]
	

.. attribute:: RomanNumeral.pivotChord

	
	Defaults to None; if not None, stores another interpretation of the
	same RN in a different key; stores a RomanNumeral object.
	
	While not enforced, for consistency the pivotChord should be
	the new interpretation going forward (to the right on the staff)
	
	>>> rn = roman.RomanNumeral('V7/IV', 'C')
	>>> rn.pivotChord is None
	True
	>>> rn.pivotChord = roman.RomanNumeral('V7', 'F')
	

.. attribute:: RomanNumeral.primaryFigure

	
	A string representing everything before the slash
	in a RomanNumeral with applied chords.  In other roman numerals
	it is the same as `figure`:
	
	>>> rn = roman.RomanNumeral('bII43/vi', 'C')
	>>> rn.primaryFigure
	'bII43'
	
	>>> rnSimple = roman.RomanNumeral('V6', 'a')
	>>> rnSimple.primaryFigure
	'V6'
	
	Changing this value will not change existing pitches.
	

.. attribute:: RomanNumeral.romanNumeralAlone

	
	Returns a string of just the roman numeral part (I-VII or i-vii) of
	the figure:
	
	>>> roman.RomanNumeral('V6').romanNumeralAlone
	'V'
	
	Chromatic alterations and secondary numerals are omitted:
	
	>>> rn = roman.RomanNumeral('#II7/vi', 'C')
	>>> rn.romanNumeralAlone
	'II'
	
	Neapolitan chords are changed to 'II':
	
	>>> roman.RomanNumeral('N6').romanNumeralAlone
	'II'
	
	Currently augmented-sixth chords return the "national" base.  But this
	behavior may change in future versions:
	
	>>> roman.RomanNumeral('It6').romanNumeralAlone
	'It'
	>>> roman.RomanNumeral('Ger65').romanNumeralAlone
	'Ger'
	
	This will be controversial in some circles, but it's based on a root in
	isolation, and does not imply tonic quality:
	
	>>> roman.RomanNumeral('Cad64').romanNumeralAlone
	'I'
	

.. attribute:: RomanNumeral.scaleCardinality

	
	Stores how many notes are in the scale; defaults to 7 for diatonic, obviously.
	
	>>> roman.RomanNumeral('IV', 'a').scaleCardinality
	7
	
	Probably you should not need to change this.  And most code is untested
	with other cardinalities.  But it is (in theory) possible to create
	roman numerals on octatonic scales, etc.
	
	Changing this value will not change existing pitches.
	

.. attribute:: RomanNumeral.scaleDegree

	
	An int representing what degree of the scale the figure
	(or primary figure in the case of secondary/applied numerals)
	is on.  Discounts any front alterations:
	
	>>> roman.RomanNumeral('vi', 'E').scaleDegree
	6
	
	Note that this is 2, not 1.5 or 6 or 6.5 or something like that:
	
	>>> roman.RomanNumeral('bII43/vi', 'C').scaleDegree
	2
	
	Empty RomanNumeral objects have the special scaleDegree of 0:
	
	>>> roman.RomanNumeral().scaleDegree
	0
	
	Changing this value will not change existing pitches.
	
	Changed in v6.5 -- empty RomanNumeral objects get scaleDegree 0, not None.
	

.. attribute:: RomanNumeral.secondaryRomanNumeral

	
	An optional roman.RomanNumeral object that represents the part
	after the slash in a secondary/applied RomanNumeral object.  For instance,
	in the roman numeral, `C: V7/vi`, the `secondaryRomanNumeral` would be
	the roman numeral `C: vi`.  The key of the `secondaryRomanNumeral`
	is the key of the original RomanNumeral.  In cases such as
	V/V/V, the `secondaryRomanNumeral` can itself have a
	`secondaryRomanNumeral`.
	
	>>> rn = roman.RomanNumeral('V7/vi', 'C')
	>>> rn.secondaryRomanNumeral
	<music21.roman.RomanNumeral vi in C major>
	

.. attribute:: RomanNumeral.secondaryRomanNumeralKey

	
	An optional key.Key object for secondary/applied RomanNumeral that
	represents the key that the part of the figure *before* the slash
	will be interpreted in.  For instance in the roman numeral,
	`C: V7/vi`, the `secondaryRomanNumeralKey` would be `a minor`, since
	the vi (submediant) refers to an a-minor triad, and thus the `V7`
	part is to be read as the dominant seventh in `a minor`.
	
	>>> rn = roman.RomanNumeral('V7/vi', 'C')
	>>> rn.secondaryRomanNumeralKey
	<music21.key.Key of a minor>
	

.. attribute:: RomanNumeral.seventhMinor

	
	How should vii, viio,  and VII be parsed in minor?
	Defaults to Minor67Default.QUALITY.
	
	This value should be passed into the constructor initially.
	Changing it after construction will not change the pitches.
	

.. attribute:: RomanNumeral.sixthMinor

	
	How should vi, vio and VI be parsed in minor?
	Defaults to Minor67Default.QUALITY.
	
	This value should be passed into the constructor initially.
	Changing it after construction will not change the pitches.
	

.. attribute:: RomanNumeral.useImpliedScale

	
	A boolean indicating whether an implied scale is being used:
	
	>>> roman.RomanNumeral('V').useImpliedScale
	True
	>>> roman.RomanNumeral('V', 'A').useImpliedScale
	False
	

Instance variables inherited from :class:`~music21.chord.Chord`:

.. hlist::
   :columns: 3

   - :attr:`~music21.chord.Chord.beams`
   - :attr:`~music21.chord.Chord.isChord`
   - :attr:`~music21.chord.Chord.isNote`
   - :attr:`~music21.chord.Chord.isRest`

Instance variables inherited from :class:`~music21.chord.ChordBase`:

.. hlist::
   :columns: 3

   - :attr:`~music21.chord.ChordBase.beams`
   - :attr:`~music21.chord.ChordBase.isNote`
   - :attr:`~music21.chord.ChordBase.isRest`

Instance variables inherited from :class:`~music21.note.NotRest`:

.. hlist::
   :columns: 3

   - :attr:`~music21.note.NotRest.beams`

Instance variables inherited from :class:`~music21.note.GeneralNote`:

.. hlist::
   :columns: 3

   - :attr:`~music21.note.GeneralNote.articulations`
   - :attr:`~music21.note.GeneralNote.expressions`
   - :attr:`~music21.note.GeneralNote.isChord`
   - :attr:`~music21.note.GeneralNote.lyrics`

Instance variables inherited from :class:`~music21.base.Music21Object`:

.. hlist::
   :columns: 3

   - :attr:`~music21.base.Music21Object.classSortOrder`
   - :attr:`~music21.base.Music21Object.groups`
   - :attr:`~music21.base.Music21Object.isStream`
   - :attr:`~music21.base.Music21Object.sites`

ChordFigureTuple
----------------

.. autoclass:: music21.roman.ChordFigureTuple

FigureTuple
-----------

.. autoclass:: music21.roman.FigureTuple

Minor67Default
--------------

.. autoclass:: music21.roman.Minor67Default

Functions
---------

.. autofunction:: music21.roman.correctRNAlterationForMinor

.. autofunction:: music21.roman.correctSuffixForChordQuality

.. autofunction:: music21.roman.expandShortHand

.. autofunction:: music21.roman.figureTupleSolo

.. autofunction:: music21.roman.figureTuples

.. autofunction:: music21.roman.identifyAsTonicOrDominant

.. autofunction:: music21.roman.postFigureFromChordAndKey

.. autofunction:: music21.roman.romanInversionName

.. autofunction:: music21.roman.romanNumeralFromChord
