3jdZddlmZddlmZddlmZddlmZGddeZ e dk(rdd l Z e jy y ) z The FiguredBass object is a subclass of Harmony that will (eventually) be able to represent figured bass symbols in music notation and also realize it. BETA at this point. Based on work by Jose Cabal-Ugaz. ) annotations)Iterable)Harmony)notationceZdZdZ d dd d fdZeddZejddZeddZejddZedd Z e jdd Z d Z xZ S) FiguredBassa *BETA*: FiguredBass objects are currently in beta and may change without warning. The FiguredBass objects store information about thorough bass figures. It is created as a representation for tags in MEI and tags in MusicXML. The FiguredBass object derives from the Harmony object and can be used in the following way: >>> fb = figuredBass.FiguredBass('#,6#') >>> fb (note that the FiguredBass object can be found in either music21.figuredBass.FiguredBass or music21.figuredBass.harmony.FiguredBass. It is the same class) The single figures are stored as figuredBass.notation.Figure objects: >>> fb.notation.figures[0] > The figures can be accessed and manipulated individually by passing in `figureStrings` (plural), and extenders are allowed as with `_`: >>> fb2 = figuredBass.FiguredBass(figureStrings=['#_', '6#']) >>> fb2 >>> fb2.notation.hasExtenders True Currently, figured bass objects do not have associated pitches. This will change. >>> fb.pitches () * New in v9.3. ) figureStringsc t|di|d|_|dk7r||_n|rdj ||_t j |j|_y)N,r )super__init___figs figureStringjoinrNotation _figNotation)selfrr keywords __class__s H/DATA/.local/lib/python3.12/site-packages/music21/figuredBass/harmony.pyrzFiguredBass.__init__AsW $8$ 2  ,D   # 7D /7/@/@/Lc|jS)a Gets or sets the notation property of the FiguresBass object >>> fb = figuredBass.FiguredBass('6,#') >>> fb.figureString '6,#' >>> fb.notation When setting, this updates the figureString property as well. >>> fb.notation = figuredBass.notation.Notation('7b,b') >>> fb.notation >>> fb.figureString '7b,b' )rrs rrzFiguredBass.notationQs&   rc4||_|j|_yN)rnotationColumnr)rfigureNotations rrzFiguredBass.notationfs*#22 rc|jS)a Get the figures as strings of the FiguresBass object. >>> fb = figuredBass.FiguredBass('6,#') >>> fb.figureString '6,#' >>> fb.notation When setting the figureString the notation property is updated as well: >>> fb.figureString = '5,b' >>> fb.figureString '5,b' >>> fb.notation )rrs rrzFiguredBass.figureStringks&zzrcZ||_tj|j|_yr)rrr)rrs rrzFiguredBass.figureStrings!  ))$**5 rc8|jjdS)a Does the same as figureStrings but returns a list: >>> fb = figuredBass.FiguredBass('6,#') >>> fb.figureStrings ['6', '#'] Like figureString, figureStrings can be set as well and updates the notation property: >>> fb.figureStrings = ['5', 'b'] >>> fb.figureStrings ['5', 'b'] >>> fb.notation r )rsplitrs rr zFiguredBass.figureStringss"  &&s++rc0dj||_y)Nr )rr)rr s rr zFiguredBass.figureStringssHH]3rc.|jjSr)rrrs r _reprInternalzFiguredBass._reprInternals}}+++r)r )rstrr Iterable[str])returnnotation.Notation)rr*)r)r')rr')r)z list[str])r r(r)None) __name__ __module__ __qualname____doc__rpropertyrsetterrr r& __classcell__)rs@rrrs#J&(M13M"M!.M !!(__33(66,,$44,rr__main__N) r/ __future__rcollections.abcrmusic21.harmonyrmusic21.figuredBassrrr,music21mainTestr rrr:sG#$#(A,'A,J zGr