rhN#SSKJr SSKrSSKJr SSKJr SSKJr "SS\R5r"SS 5r "S S \R5r \ /r \ S :XaSSKr\R"\ 5 gg) ) annotationsN)pitch) exceptions21) instrumentc\rSrSrSrg)MIDIPercussionExceptionN)__name__ __module__ __qualname____firstlineno____static_attributes__r Q/home/james-whalen/.local/lib/python3.13/site-packages/music21/midi/percussion.pyrrsrrc\rSrSrSr\r0S\R_S\R_S\R_S\R_S\R_S\R_S \R_S \R_S \R_S \R_S \R_S\R_S\R_S\R_S\R_S\R_S\R_0S\R_S\R_S\R_S\R_S\R _S\R _S\R _S\R"_S\R"_S\R$_S\R$_S\R&_S \R(_S!\R(_S"\R*_S#\R*_S$\R,_ES%\R,0ErS&rS'r\\/rS(rg))*PercussionMappera* PercussionMapper provides tools to convert between 0-indexed MIDI pitches and music21 instruments, based on the official General MIDI Level 1 Percussion Key Map. This mapping is conventionally applied to MIDI channel 10; see https://midi.org/general-midi-level-1 for more info. Give me the instrument that corresponds to MIDI note 58! >>> pm = midi.percussion.PercussionMapper() >>> pm.reverseInstrumentMapping[58] That's right, vibraslap. But you're better off using the midiPitchToInstrument() method below! #$%&()*+,-./012689:<=>?@ABCDFGHLMPQc>[U[5(aUnO URnX R;a[ U<S35eURUnU"5nUR SLa5[ US5(a$X$R;aURUnXTlU$)a Takes a pitch.Pitch object or int ranging from 0-127 and returns the corresponding instrument in the GM Percussion Map. >>> pm = midi.percussion.PercussionMapper() >>> cowPitch = pitch.Pitch(56) >>> cowbell = pm.midiPitchToInstrument(cowPitch) >>> cowbell Or it can just take an integer (representing MIDI note) for the pitch instead: >>> moreCowbell = pm.midiPitchToInstrument(56) >>> moreCowbell The standard GM Percussion list goes from 35 to 81; pitches outside this range raise an exception. >>> bassDrum1Pitch = pitch.Pitch('B-1') >>> pm.midiPitchToInstrument(bassDrum1Pitch) Traceback (most recent call last): music21.midi.percussion.MIDIPercussionException: 34 does not map to a valid instrument! Also, certain GM instruments do not have corresponding music21 instruments, so at present they also raise an exception. >>> cabasaPitch = 69 >>> pm.midiPitchToInstrument(cabasaPitch) Traceback (most recent call last): music21.midi.percussion.MIDIPercussionException: 69 does not map to a valid instrument! Some music21 Instruments have more than one MidiPitch. In this case you'll get the same Instrument object but with a different modifier >>> acousticBassDrumPitch = pitch.Pitch(35) >>> acousticBDInstrument = pm.midiPitchToInstrument(acousticBassDrumPitch) >>> acousticBDInstrument >>> acousticBDInstrument.modifier 'acoustic' >>> oneBassDrumPitch = pitch.Pitch(36) >>> oneBDInstrument = pm.midiPitchToInstrument(oneBassDrumPitch) >>> oneBDInstrument >>> oneBDInstrument.modifier '1' z$ does not map to a valid instrument!T_percMapPitchToModifier) isinstanceintmidireverseInstrumentMappingr inGMPercMaphasattrr9modifier)self midiPitch midiNumbermidiInstrumentmidiInstrumentObjectr@s rmidiPitchToInstrument&PercussionMapper.midiPitchToInstrumentbsj i % %"J"J :: :)ZN:^*_` `66zB-/ , , 402KLLIII/GG S08-##rc[US5(aURSLa[U<S35eURn[R "5nX#lU$)a Takes an instrument.Instrument object and returns a pitch object with the corresponding 1-indexed MIDI note, according to the GM Percussion Map. >>> pm = midi.percussion.PercussionMapper() >>> myCow = instrument.Cowbell() >>> cowPitch = pm.midiInstrumentToPitch(myCow) >>> cowPitch.midi 56 Note that cowPitch is an actual pitch.Pitch object even though it's meaningless! >>> cowPitch If the instrument does not have an equivalent in the GM Percussion Map, return an Exception: >>> myBagpipes = instrument.Bagpipes() >>> pipePitch = pm.midiInstrumentToPitch(myBagpipes) Traceback (most recent call last): music21.midi.percussion.MIDIPercussionException: is not in the GM Percussion Map! r>Fz! is not in the GM Percussion Map!)r?r>r percMapPitchrPitchr<)rArDrB pitchObjects rmidiInstrumentToPitch&PercussionMapper.midiInstrumentToPitchsU6~}559S9SW\9\)^,>>_*`a a"// kkm $rr N)r r r r__doc__riBassDrum SnareDrumTomTom HiHatCymbal CrashCymbals TambourineCowbell Vibraslap BongoDrums CongaDrumTimbalesAgogoMaracasWhistle WoodblockTriangler=rFrL _DOC_ORDERrr rrrrsl" A/ "AJJ/ " "AJJ/ " "AKK/ "!#AKK/ " !#AKK / " !#AHH / "!#AMM/ "!#AHH/ "!#AMM/ "!#AHH/ "!#AMM/ "!#AHH/ "!#AHH/ "!#ANN/ "!#AHH/ "&!#ALL'/ "*!#AII+/ ",!#ANN-/ ".!#AKK// "2!#ALL3/ "4!#ALL5/ "6!#AKK7/ "8!#AKK9/ ":!#AKK;/ "<!#AJJ=/ ">!#AJJ?/ "@!#AGGA/ "B!#AGGC/ "F!#AIIG/ "H!#AIII/ "J!#AIIK/ "R!#AKKS/ "T!#AKKU/ "Z!#AJJ[/ "\!#AJJ]/ "lD$L D()>?Jrrc\rSrSrSrSrg)Testc2SSKJn U"U[55 g)Nr) testCopyAll)music21.test.commonTestreglobals)rAres rtestCopyAndDeepcopyTest.testCopyAndDeepcopys7D')$rr N)r r r rrhrr rrrbrbs%rrb__main__) __future__runittestmusic21rrrMusic21ExceptionrrTestCaserbr`r mainTestr rrrqss#  l;; q@q@h%8  %   z Tr