j"ddlmZddlZddlmZdZdZdZdefdefd efgZe d Z d Z d Z d Z dZdZde fde fde fde fdefdefgZe dZdZdZdZdZdZdZdefdefdefd efd!efd"efd#efgZe Gd$d%ejZGd&d'ejZed(krddlZejedSdS))) annotationsN)prebasezTrue by default. If True, :meth:`~music21.figuredBass.possibility.isIncomplete` is applied to all possibA, and all those possibilities for which the method returns False are retained.a 12 by default. A number, in semitones, representing the maxSemitoneSeparation argument provided to :meth:`~music21.figuredBass.possibility.upperPartsWithinLimit`. Method is applied to all possibA, and all those possibilities for which the method returns True are retained.zTrue by default. If True, :meth:`~music21.figuredBass.possibility.voiceCrossing` is applied to all possibA, and all those possibilities for which the method returns False are retained.forbidIncompletePossibilitiesupperPartsMaxSemitoneSeparationforbidVoiceCrossingzTrue by default. If True, :meth:`~music21.figuredBass.possibility.parallelFifths` is applied to all (possibA, possibB) pairs, and all those pairs for which the method returns False are retained.zTrue by default. If True, :meth:`~music21.figuredBass.possibility.parallelOctaves` is applied to all (possibA, possibB) pairs, and all those pairs for which the method returns False are retained.zTrue by default. If True, :meth:`~music21.figuredBass.possibility.hiddenFifth` is applied to all (possibA, possibB) pairs, and all those pairs for which the method returns False are retained.zTrue by default. If True, :meth:`~music21.figuredBass.possibility.hiddenOctave` is applied to all (possibA, possibB) pairs, and all those pairs for which the method returns False are retained.zTrue by default. If True, :meth:`~music21.figuredBass.possibility.voiceOverlap` is applied to all (possibA, possibB) pairs, and all those pairs for which the method returns False are retained.a*[] (empty list) by default. Contains (partNumber, maxSeparation) pairs provided as arguments to :meth:`~music21.figuredBass.possibility.partMovementsWithinLimits`. Method is applied to all (possibA, possibB) pairs, and all those pairs for which the method returns True are retained.forbidParallelFifthsforbidParallelOctavesforbidHiddenFifthsforbidHiddenOctavesforbidVoiceOverlappartMovementLimitszTrue by default. If True, Segments whose :attr:`~music21.figuredBass.segment.Segment.segmentChord` spells out a dominant seventh chord are resolved properly by using :meth:`~music21.figuredBass.segment.Segment.resolveDominantSeventhSegment`.aTrue by default. If True, Segments whose :attr:`~music21.figuredBass.segment.Segment.segmentChord` spells out a fully-diminished seventh chord are resolved properly by using :meth:`~music21.figuredBass.segment.Segment.resolveDiminishedSeventhSegment`.zTrue by default. If True, Segments whose :attr:`~music21.figuredBass.segment.Segment.segmentChord` spells out an augmented sixth chord are resolved properly by using :meth:`~music21.figuredBass.segment.Segment.resolveAugmentedSixthSegment`.aFalse by default. If True, Diminished seventh resolutions to the tonic will contain a doubled *root*, as opposed to a doubled *third*. Rule is ignored (determined in context) if :attr:`~music21.figuredBass.segment.Segment.segmentChord` is in first inversion.z`False by default. If True, single possibility rules are applied to resolution possibilities.zrFalse by default. If True, consecutive possibility rules are applied between (specialPossib, resPossib) pairs.aTrue by default. If True, then doublings in the It+6 chord are limited to the tonic, or fifth. Setting this to False allows doubling of the root or third, most likely through parallel unisons if :attr:`~music21.figuredBass.rules.Rules.forbidParallelOctaves` is set to True.resolveDominantSeventhProperly resolveDiminishedSeventhProperlyresolveAugmentedSixthProperlydoubledRootInDim7"applySinglePossibRulesToResolution'applyConsecutivePossibRulesToResolution&restrictDoublingsInItalianA6ResolutionceZdZUdZdeDdeDzdeDzZeeezezZ de d<dZ dZ d S) RulesaO A Rules object is provided as an input to a :class:`~music21.figuredBass.segment.Segment`, and controls the application of methods designed to filter out undesired possibilities in a single Segment or undesired progressions between two consecutive Segments. The rules are categorized in an identical manner to methods in :mod:`~music21.figuredBass.possibility`: 1) Single Possibility Rules. These rules apply to any possibility within a single Segment (possibA), and are applied in finding correct possibilities for a Segment in :meth:`~music21.figuredBass.segment.Segment.allCorrectSinglePossibilities`. 2) Consecutive Possibility Rules. These rules apply between any correct single possibility in segmentA (possibA) and any correct single possibility in segmentB (possibB), segmentB coming directly after segmentA. They are applied in finding correct (possibA, possibB) pairs between two Segments in :meth:`~music21.figuredBass.segment.Segment.allCorrectConsecutivePossibilities`. 3) Special Resolution Rules. These rules apply to Segments whose :attr:`~music21.figuredBass.segment.Segment.segmentChord` is an augmented sixth, dominant seventh, or diminished seventh chord, and are applied as necessary in :meth:`~music21.figuredBass.segment.Segment.allCorrectConsecutivePossibilities`. >>> from music21.figuredBass import rules >>> fbRules = rules.Rules() >>> fbRules >>> fbRules.forbidParallelFifths = False >>> fbRules.upperPartsMaxSemitoneSeparation = None cg|] }|d Sr).0_xs /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/figuredBass/rules.py zRules.s888R2a5888cg|] }|d Srr)r_ys rrzRules.s???rRU???rcg|] }|d Srr)r_zs rrzRules.s333rRU333rzdict[str, str] _DOC_ATTRcd|_d|_d|_d|_d|_d|_d|_d|_g|_d|_ d|_ d|_ d|_ d|_ d|_d|_d|_g|_g|_dS)NT F)rrrrr r r r r rrrrrrr_upperPartsRemainSame_partPitchLimits _partsToCheckselfs r__init__zRules.__init__s-1*/1,#' %)!%)""&#' "&"$/3+04--1*!&27/7<46:3%*" "rcdS)Nrr)s r _reprInternalzRules._reprInternalsrrN) __name__ __module__ __qualname____doc__singlePossibilityDocconsecutivePossibilityDoc specialResDoc _DOC_ORDERdictr#__annotations__r+r.rrrrres!!F98#7888??%>???@33]3334J!% # $  !!I    6rrceZdZdS)TestN)r/r0r1rrrr:r:sDrr:__main__) __future__runittestmusic21r!doc_forbidIncompletePossibilities#doc_upperPartsMaxSemitoneSeparationdoc_forbidVoiceCrossingr3sortdoc_parallelFifthsdoc_parallelOctavesdoc_hiddenFifthsdoc_hiddenOctavesdoc_voiceOverlapdoc_partMovementLimitsr4doc_domSeventhdoc_dimSeventh doc_augSixthdoc_doubledRootInDim7doc_singleToResdoc_consecutiveToRes doc_doublingsr5ProtoM21ObjectrTestCaser:r/mainTestrrrrSs5#"""""%T!'# T9:[\:<_`.0GHJ7 /012+,-.+,12  Y[X [!1 3NC4nE1<@%'<=6H;=QR:MJ L IIIIIG "IIIZ     8     zNNNGTr