.. _usersGuide_34_instruments:

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

User’s Guide, Chapter 34: Instruments
=====================================

All music is made through instruments (if we consider the human voice
and synthesis types of instruments). Music21 uses instruments in
analysis and in giving hints to output how music should sound.
Instruments live in the :ref:`moduleInstrument` module and all
subclass :class:`~music21.articulations.Articulation`.

Instruments and Streams
-----------------------

Instruments are :class:`~music21.base.Music21Object` subclasses. Thus,
they live in streams. Generally a part represents music for one
instrument, though it can also represent a single playing performing on
multiple instruments (“doublers” or percussionists playing a kit).

You can iterate through all Instruments in a stream using the same
``getElementsByClass()`` with ``recurse()`` filters as for any other
music21 objects, or through the ``[instrument.Instrument]`` shortcut:

.. code:: ipython3

    from music21 import *
    
    # weber = corpus.parse('weber')
    lili = corpus.parse('aloha_oe')
    for inst in lili[instrument.Instrument]:
        print(repr(inst), inst.midiProgram, inst.getContextByClass(stream.Part))
        


.. parsed-literal::
   :class: ipython-result

    <music21.instrument.Soprano 'P1: Soprano'> 53 <music21.stream.Part Soprano>
    <music21.instrument.Alto 'P2: Alto'> 53 <music21.stream.Part Alto>
    <music21.instrument.Tenor 'P3: Tenor'> 53 <music21.stream.Part Tenor>
    <music21.instrument.Bass 'P4: Bass'> 53 <music21.stream.Part Bass>
    <music21.instrument.Vocalist 'P5: Solo Voice'> 53 <music21.stream.Part Solo Voice>
    <music21.instrument.Piano 'P6: Piano'> 0 <music21.stream.PartStaff P6-Staff1>
    <music21.instrument.Piano 'P6: Piano'> 0 <music21.stream.PartStaff P6-Staff2>


.. code:: ipython3

    # weber.measures(9, 13).show()
    
    lili.measures(12, 16).show()



.. image:: usersGuide_34_instruments_3_0.png
   :width: 708px
   :height: 597px



.. raw:: html

    <p style="padding-top: 20px">&nbsp;</p>



.. image:: usersGuide_34_instruments_3_2.png
   :width: 708px
   :height: 590px



.. raw:: html

    <p style="padding-top: 20px">&nbsp;</p>



.. image:: usersGuide_34_instruments_3_4.png
   :width: 708px
   :height: 978px



.. raw:: html

    <p style="padding-top: 20px">&nbsp;</p>



.. image:: usersGuide_34_instruments_3_6.png
   :width: 708px
   :height: 511px


.. code:: ipython3

    lili.measures(12, 16).show('midi')



.. raw:: html

    
    <div id="midiPlayerDiv13694">
        <p class="m21-trust-warning">
            This MIDI player only runs in <em>trusted</em> notebooks.
            In JupyterLab: File &rarr; Trust Notebook, then re-run this cell.
        </p>
    </div>
    <script>
    (function() {
        const outputId = "midiPlayerDiv13694";
        const b64 = "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";
        const jsUrl = "https://cdn.jsdelivr.net/npm/music21j@0.23.1/releases/music21.debug.min.js";
        const cssUrl = "https://cdn.jsdelivr.net/npm/music21j@0.23.1/releases/music21j.min.css";
    
        const root = document.getElementById(outputId);
        const warning = root && root.querySelector(".m21-trust-warning");
        if (warning) warning.remove();
    
        function play(music21) {
            music21.common.urls.soundfontUrl = "https://cdn.jsdelivr.net/gh/cuthbertLab/midi-js-soundfonts@2026.05.15/FluidR3_GM/";
            music21.common.urls.midiPlayer = "https://cdn.jsdelivr.net/gh/cuthbertLab/music21j@v0.23.1/webResources/midiPlayer";
            const mp = new music21.miditools.MidiPlayer();
            mp.addPlayer("#" + outputId);
            mp.base64Load("data:audio/midi;base64," + b64);
        }
    
        window.m21conf = window.m21conf || { loadSoundfont: false };
        if (!document.querySelector("link[data-music21j]")) {
            const link = document.createElement("link");
            link.rel = "stylesheet";
            link.href = cssUrl;
            link.dataset.music21j = "1";
            document.head.appendChild(link);
        }
    
        // RequireJS / AMD route (Sphinx/nbsphinx HTML, classic Jupyter):
        // the music21j UMD bundle registers as an AMD module when define.amd
        // is present and never sets window.music21, so the script-tag/global
        // path below would fire play() with music21 undefined.
        if (typeof window.require === "function"
                && typeof window.require.config === "function") {
            window.require.config({
                paths: { music21: jsUrl.replace(/\.js$/, "") }
            });
            window.require(["music21"], play);
            return;
        }
    
        if (window.music21) {
            play(window.music21);
            return;
        }
        let script = document.querySelector("script[data-music21j]");
        if (!script) {
            script = document.createElement("script");
            script.src = jsUrl;
            script.dataset.music21j = "1";
            document.head.appendChild(script);
        }
        script.addEventListener("load", function() { play(window.music21); });
    })();
    </script>


.. code:: ipython3

    x = stream.Stream()
    x.insert(0, instrument.Clarinet())
    x.append(note.Note('C5', type='whole'))
    x.show('midi')




.. raw:: html

    
    <div id="midiPlayerDiv4576">
        <p class="m21-trust-warning">
            This MIDI player only runs in <em>trusted</em> notebooks.
            In JupyterLab: File &rarr; Trust Notebook, then re-run this cell.
        </p>
    </div>
    <script>
    (function() {
        const outputId = "midiPlayerDiv4576";
        const b64 = "TVRoZAAAAAYAAQACJ2BNVHJrAAAAFAD/UQMHoSAA/1gEBAIYCM5g/y8ATVRyawAAACYA/wMIQ2xhcmluZXQAwEcA4ABAAMBHzmCQSFqCuwCASADOYP8vAA==";
        const jsUrl = "https://cdn.jsdelivr.net/npm/music21j@0.23.1/releases/music21.debug.min.js";
        const cssUrl = "https://cdn.jsdelivr.net/npm/music21j@0.23.1/releases/music21j.min.css";
    
        const root = document.getElementById(outputId);
        const warning = root && root.querySelector(".m21-trust-warning");
        if (warning) warning.remove();
    
        function play(music21) {
            music21.common.urls.soundfontUrl = "https://cdn.jsdelivr.net/gh/cuthbertLab/midi-js-soundfonts@2026.05.15/FluidR3_GM/";
            music21.common.urls.midiPlayer = "https://cdn.jsdelivr.net/gh/cuthbertLab/music21j@v0.23.1/webResources/midiPlayer";
            const mp = new music21.miditools.MidiPlayer();
            mp.addPlayer("#" + outputId);
            mp.base64Load("data:audio/midi;base64," + b64);
        }
    
        window.m21conf = window.m21conf || { loadSoundfont: false };
        if (!document.querySelector("link[data-music21j]")) {
            const link = document.createElement("link");
            link.rel = "stylesheet";
            link.href = cssUrl;
            link.dataset.music21j = "1";
            document.head.appendChild(link);
        }
    
        // RequireJS / AMD route (Sphinx/nbsphinx HTML, classic Jupyter):
        // the music21j UMD bundle registers as an AMD module when define.amd
        // is present and never sets window.music21, so the script-tag/global
        // path below would fire play() with music21 undefined.
        if (typeof window.require === "function"
                && typeof window.require.config === "function") {
            window.require.config({
                paths: { music21: jsUrl.replace(/\.js$/, "") }
            });
            window.require(["music21"], play);
            return;
        }
    
        if (window.music21) {
            play(window.music21);
            return;
        }
        let script = document.querySelector("script[data-music21j]");
        if (!script) {
            script = document.createElement("script");
            script.src = jsUrl;
            script.dataset.music21j = "1";
            document.head.appendChild(script);
        }
        script.addEventListener("load", function() { play(window.music21); });
    })();
    </script>

