├── .ackrc
├── .coveragerc
├── .github
    ├── dependabot.yml
    └── workflows
    │   └── main.yml
├── .gitignore
├── LICENSE
├── Makefile
├── README.rst
├── conftest.py
├── docs
    ├── Makefile
    ├── make.bat
    └── source
    │   ├── _mothballed
    │       ├── accumulation.rst
    │       ├── bibliography.rst
    │       ├── colophon.rst
    │       ├── containerized-model.rst
    │       ├── custom-context-creation.rst
    │       ├── glossary.rst
    │       ├── images
    │       │   ├── lci-1.png
    │       │   ├── lci-2.png
    │       │   ├── lci-3.png
    │       │   └── lci-4.png
    │       ├── instruments.rst
    │       ├── lilypond-literals.rst
    │       ├── lilypond-wellformedness.rst
    │       ├── organization.rst
    │       ├── parentage.rst
    │       ├── pitch-conventions.rst
    │       ├── score-fragment-strings.rst
    │       ├── summer-workshop.rst
    │       ├── understanding-reprs.rst
    │       ├── virtual-environments.rst
    │       ├── working-with-named-pitches.rst
    │       ├── working-with-tuplets.rst
    │       └── written-duration.rst
    │   ├── _pending
    │       ├── hexachordal-recombination-all-interval.rst
    │       ├── interval-cycle-intersection.rst
    │       ├── rotation-by-row-index.rst
    │       ├── row-derivation-by-trichord.rst
    │       ├── scale-derivation-by-sieve.rst
    │       ├── superimposition-of-partials.rst
    │       ├── tone-clock-tesselation.rst
    │       └── trichord-definition-by-ratio.rst
    │   ├── _static
    │       ├── abjad-logo.png
    │       ├── abjad.css
    │       ├── abjad.js
    │       ├── favicon.ico
    │       ├── ga.js
    │       └── lightbox2
    │       │   ├── css
    │       │       └── lightbox.css
    │       │   ├── images
    │       │       ├── close.png
    │       │       ├── loading.gif
    │       │       ├── next.png
    │       │       └── prev.png
    │       │   └── js
    │       │       └── lightbox.js
    │   ├── _templates
    │       ├── breadcrumbs.html
    │       ├── footer.html
    │       └── layout.html
    │   ├── appendices
    │       ├── best-practices.rst
    │       ├── changes.rst
    │       ├── community.rst
    │       ├── configuration.rst
    │       ├── developer-installation.rst
    │       ├── lilypond-context-concatenation.rst
    │       └── publications.rst
    │   ├── conf.py
    │   ├── examples
    │       ├── corpus-selection.rst
    │       ├── design-by-dyads.rst
    │       ├── enumeration.rst
    │       ├── images
    │       │   └── mozart-tables.png
    │       ├── magic-square-from-twelve-tone-row.rst
    │       ├── scales-diatonic.rst
    │       └── score-fragment-piano.rst
    │   ├── first_steps
    │       ├── audience.rst
    │       ├── install.rst
    │       ├── linux.rst
    │       ├── macos.rst
    │       └── windows.rst
    │   ├── gallery-2010.rst
    │   ├── gallery-2015.rst
    │   ├── gallery-2020.rst
    │   ├── gallery
    │       ├── agostinho-cartography-11-page-4-thumbnail.png
    │       ├── agostinho-cartography-11-page-4.png
    │       ├── agostinho-cartography-11-page-5-thumbnail.png
    │       ├── agostinho-cartography-11-page-5.png
    │       ├── agostinho-whtt-page-4-thumbnail.png
    │       ├── agostinho-whtt-page-4.png
    │       ├── agostinho-whtt-page-5-thumbnail.png
    │       ├── agostinho-whtt-page-5.png
    │       ├── baca-akasha-page-7-thumbnail.png
    │       ├── baca-akasha-page-7.png
    │       ├── baca-akasha-page-8-thumbnail.png
    │       ├── baca-akasha-page-8.png
    │       ├── baca-archipel-page-10-thumbnail.png
    │       ├── baca-archipel-page-10.png
    │       ├── baca-archipel-page-9-thumbnail.png
    │       ├── baca-archipel-page-9.png
    │       ├── baca-cary-page-5-thumbnail.png
    │       ├── baca-cary-page-5.png
    │       ├── baca-cary-page-6-thumbnail.png
    │       ├── baca-cary-page-6.png
    │       ├── baca-desir-page-14-thumbnail.png
    │       ├── baca-desir-page-14.png
    │       ├── baca-desir-page-15-thumbnail.png
    │       ├── baca-desir-page-15.png
    │       ├── baca-dornen-page-1-thumbnail.png
    │       ├── baca-dornen-page-1.png
    │       ├── baca-dornen-page-2-thumbnail.png
    │       ├── baca-dornen-page-2.png
    │       ├── baca-faberge-page-1-thumbnail.png
    │       ├── baca-faberge-page-1.png
    │       ├── baca-faberge-page-36-thumbnail.png
    │       ├── baca-faberge-page-36.png
    │       ├── baca-harmony-page-10-thumbnail.png
    │       ├── baca-harmony-page-10.png
    │       ├── baca-harmony-page-29-thumbnail.png
    │       ├── baca-harmony-page-29.png
    │       ├── baca-huitzil-page-12-thumbnail.png
    │       ├── baca-huitzil-page-12.png
    │       ├── baca-huitzil-page-13-thumbnail.png
    │       ├── baca-huitzil-page-13.png
    │       ├── baca-ikribu-page-16-thumbnail.png
    │       ├── baca-ikribu-page-16.png
    │       ├── baca-ikribu-page-17-thumbnail.png
    │       ├── baca-ikribu-page-17.png
    │       ├── baca-imaginaire-page-4-thumbnail.png
    │       ├── baca-imaginaire-page-4.png
    │       ├── baca-imaginaire-page-5-thumbnail.png
    │       ├── baca-imaginaire-page-5.png
    │       ├── baca-ins-wasser-page-3-thumbnail.png
    │       ├── baca-ins-wasser-page-3.png
    │       ├── baca-ins-wasser-page-4-thumbnail.png
    │       ├── baca-ins-wasser-page-4.png
    │       ├── baca-khamr-page-10-thumbnail.png
    │       ├── baca-khamr-page-10.png
    │       ├── baca-khamr-page-11-thumbnail.png
    │       ├── baca-khamr-page-11.png
    │       ├── baca-krummzeit-page-80-thumbnail.png
    │       ├── baca-krummzeit-page-80.png
    │       ├── baca-krummzeit-page-81-thumbnail.png
    │       ├── baca-krummzeit-page-81.png
    │       ├── baca-lidercfeny-page-22-thumbnail.png
    │       ├── baca-lidercfeny-page-22.png
    │       ├── baca-lidercfeny-page-23-thumbnail.png
    │       ├── baca-lidercfeny-page-23.png
    │       ├── baca-mraz-page-4-thumbnail.png
    │       ├── baca-mraz-page-4.png
    │       ├── baca-mraz-page-5-thumbnail.png
    │       ├── baca-mraz-page-5.png
    │       ├── baca-myrkr-page-1-thumbnail.png
    │       ├── baca-myrkr-page-1.png
    │       ├── baca-myrkr-page-2-thumbnail.png
    │       ├── baca-myrkr-page-2.png
    │       ├── baca-naehte-page-1-thumbnail.png
    │       ├── baca-naehte-page-1.png
    │       ├── baca-naehte-page-2-thumbnail.png
    │       ├── baca-naehte-page-2.png
    │       ├── baca-poeme-recursif-page-3-thumbnail.png
    │       ├── baca-poeme-recursif-page-3.png
    │       ├── baca-poeme-recursif-page-4-thumbnail.png
    │       ├── baca-poeme-recursif-page-4.png
    │       ├── baca-sekka-page-5-thumbnail.png
    │       ├── baca-sekka-page-5.png
    │       ├── baca-sekka-page-6-thumbnail.png
    │       ├── baca-sekka-page-6.png
    │       ├── baca-traiettorie-page-6-thumbnail.png
    │       ├── baca-traiettorie-page-6.png
    │       ├── baca-traiettorie-page-7-thumbnail.png
    │       ├── baca-traiettorie-page-7.png
    │       ├── evans-adumbration-page-11-thumbnail.png
    │       ├── evans-adumbration-page-11.png
    │       ├── evans-adumbration-page-7-thumbnail.png
    │       ├── evans-adumbration-page-7.png
    │       ├── evans-chalk-line-page-1-thumbnail.png
    │       ├── evans-chalk-line-page-1.png
    │       ├── evans-chalk-line-page-4-thumbnail.png
    │       ├── evans-chalk-line-page-4.png
    │       ├── evans-guerrero-page-1-thumbnail.svg
    │       ├── evans-guerrero-page-1.svg
    │       ├── evans-guerrero-page-10-thumbnail.svg
    │       ├── evans-guerrero-page-10.svg
    │       ├── evans-hamonshu-page-1-thumbnail.png
    │       ├── evans-hamonshu-page-1.png
    │       ├── evans-hamonshu-page-4-thumbnail.png
    │       ├── evans-hamonshu-page-4.png
    │       ├── oberholtzer-armilla-page-8-thumbnail.png
    │       ├── oberholtzer-armilla-page-8.png
    │       ├── oberholtzer-armilla-page-9-thumbnail.png
    │       ├── oberholtzer-armilla-page-9.png
    │       ├── oberholtzer-aurora-page-6-thumbnail.png
    │       ├── oberholtzer-aurora-page-6.png
    │       ├── oberholtzer-aurora-page-7-thumbnail.png
    │       ├── oberholtzer-aurora-page-7.png
    │       ├── oberholtzer-demarest-page-19-thumbnail.png
    │       ├── oberholtzer-demarest-page-19.png
    │       ├── oberholtzer-demarest-page-28-thumbnail.png
    │       ├── oberholtzer-demarest-page-28.png
    │       ├── oberholtzer-ersilia-page-10-thumbnail.png
    │       ├── oberholtzer-ersilia-page-10.png
    │       ├── oberholtzer-ersilia-page-9-thumbnail.png
    │       ├── oberholtzer-ersilia-page-9.png
    │       ├── oberholtzer-lagartija-page-4-thumbnail.png
    │       ├── oberholtzer-lagartija-page-4.png
    │       ├── oberholtzer-lagartija-page-5-thumbnail.png
    │       ├── oberholtzer-lagartija-page-5.png
    │       ├── oberholtzer-plague-water-page-12-thumbnail.png
    │       ├── oberholtzer-plague-water-page-12.png
    │       ├── oberholtzer-plague-water-page-13-thumbnail.png
    │       ├── oberholtzer-plague-water-page-13.png
    │       ├── oberholtzer-zaira-page-16-thumbnail.png
    │       ├── oberholtzer-zaira-page-16.png
    │       ├── oberholtzer-zaira-page-17-thumbnail.png
    │       ├── oberholtzer-zaira-page-17.png
    │       ├── trevino-refrain-page-1-thumbnail.png
    │       ├── trevino-refrain-page-1.png
    │       ├── trevino-refrain-page-2-thumbnail.png
    │       ├── trevino-refrain-page-2.png
    │       ├── trevino-world-all-around-page-1-thumbnail.png
    │       ├── trevino-world-all-around-page-1.png
    │       ├── trevino-world-all-around-page-2-thumbnail.png
    │       ├── trevino-world-all-around-page-2.png
    │       ├── wallberg-cartography-bass-flute-thumbnail.png
    │       └── wallberg-cartography-bass-flute.png
    │   ├── index.rst
    │   ├── overview
    │       ├── containers-basic-operations-on.rst
    │       ├── containers-retrieving-by-name.rst
    │       ├── containers-time-interpretation-of.rst
    │       ├── containers.rst
    │       ├── contexts-lilypond-type-of.rst
    │       ├── indicators.rst
    │       ├── lilypond-files-preamble-of.rst
    │       └── lilypond-format-of-abjad-objects.rst
    │   └── welcome
    │       ├── abstract.rst
    │       ├── example.rst
    │       ├── quickstart.rst
    │       └── welcome.rst
├── hello.png
├── ly
    ├── Makefile
    ├── contexts.ly
    ├── current_module.ly
    ├── engravers.ly
    ├── grob_interfaces.ly
    ├── guile_interpreter.ly
    ├── helpers.scm
    ├── interface_properties.ly
    ├── language_pitch_names.ly
    ├── markup_functions.ly
    └── music_glyphs.ly
├── pyproject.toml
├── scripts
    ├── prime_parser_tables.py
    ├── timer.py
    └── write_parser_syntax_skeleton.py
├── source
    └── abjad
    │   ├── __init__.py
    │   ├── _getlib.py
    │   ├── _indentlib.py
    │   ├── _iterlib.py
    │   ├── _updatelib.py
    │   ├── _version.py
    │   ├── bind.py
    │   ├── configuration.py
    │   ├── contextmanagers.py
    │   ├── contributions.py
    │   ├── cyclictuple.py
    │   ├── deprecated.py
    │   ├── duration.py
    │   ├── enumerate.py
    │   ├── enums.py
    │   ├── exceptions.py
    │   ├── ext
    │       ├── __init__.py
    │       └── sphinx.py
    │   ├── format.py
    │   ├── get.py
    │   ├── grace_corner_cases.py
    │   ├── illustrators.py
    │   ├── indicators.py
    │   ├── instruments.py
    │   ├── io.py
    │   ├── iterate.py
    │   ├── iterpitches.py
    │   ├── label.py
    │   ├── lilypondfile.py
    │   ├── lyconst.py
    │   ├── lyenv.py
    │   ├── lyproxy.py
    │   ├── makers.py
    │   ├── math.py
    │   ├── meter.py
    │   ├── metricmodulation.py
    │   ├── mutate.py
    │   ├── obgc.py
    │   ├── overrides.py
    │   ├── parentage.py
    │   ├── parsers
    │       ├── __init__.py
    │       ├── base.py
    │       ├── parse.py
    │       ├── parser.py
    │       ├── reduced.py
    │       └── scheme.py
    │   ├── pattern.py
    │   ├── pcollections.py
    │   ├── persist.py
    │   ├── pitch.py
    │   ├── py.typed
    │   ├── rhythmtrees.py
    │   ├── scm
    │       ├── abjad-coloring.ily
    │       ├── abjad-hairpins.ily
    │       ├── abjad-make-music-functions.ily
    │       ├── abjad-metric-modulations.ily
    │       ├── abjad-metronome-marks.ily
    │       ├── abjad-spanners.ily
    │       ├── abjad-text-spanner-line-styles.ily
    │       ├── abjad.ily
    │       ├── all-edo-markups-example.ily
    │       ├── default-et-accidental-markups.ily
    │       ├── ekmelos-edo-accidental-markups.ily
    │       ├── ekmelos-ji-accidental-markups.ily
    │       ├── fraction-accidental-markups.ily
    │       ├── general-et-accidental-markups.ily
    │       ├── harmonic-series-layout.ily
    │       ├── heji2-ji-accidental-markups.ily
    │       ├── markup-functions.ily
    │       ├── nalesnik-slash.ily
    │       └── nalesnik-text-spanner-id.ily
    │   ├── score.py
    │   ├── select.py
    │   ├── sequence.py
    │   ├── setclass.py
    │   ├── spanners.py
    │   ├── string.py
    │   ├── tag.py
    │   ├── timespan.py
    │   ├── tweaks.py
    │   ├── verticalmoment.py
    │   └── wf.py
└── tests
    ├── conftest.py
    ├── roots
        └── test-ext-sphinx
        │   ├── _static
        │       └── .gitignore
        │   ├── conf.py
        │   └── index.rst
    ├── test_Accidental.py
    ├── test_AfterGraceContainer.py
    ├── test_Chord.py
    ├── test_Cluster.py
    ├── test_Component.py
    ├── test_Container.py
    ├── test_Leaf.py
    ├── test_LogicalTie.py
    ├── test_Meter.py
    ├── test_MultimeasureRest.py
    ├── test_NamedInterval.py
    ├── test_NamedIntervalClass.py
    ├── test_NamedPitch.py
    ├── test_NamedPitchClass.py
    ├── test_Note.py
    ├── test_NoteHead.py
    ├── test_NoteHeadList.py
    ├── test_NumberedInterval.py
    ├── test_NumberedIntervalClass.py
    ├── test_NumberedPitch.py
    ├── test_NumberedPitchClass.py
    ├── test_Octave.py
    ├── test_Rest.py
    ├── test_Skip.py
    ├── test_Staff.py
    ├── test_Tuplet.py
    ├── test_Voice.py
    ├── test_bind.py
    ├── test_class_design.py
    ├── test_dynamic.py
    ├── test_ext_sphinx.py
    ├── test_get.py
    ├── test_get_leaf.py
    ├── test_get_timespan.py
    ├── test_indicators.py
    ├── test_io.py
    ├── test_iterpitches.py
    ├── test_ly_environment.py
    ├── test_makers.py
    ├── test_mutate_copy.py
    ├── test_mutate_extract.py
    ├── test_mutate_fuse.py
    ├── test_mutate_helpers.py
    ├── test_mutate_replace.py
    ├── test_mutate_split.py
    ├── test_mutate_swap.py
    ├── test_obgc.py
    ├── test_overrides.py
    ├── test_parentage.py
    ├── test_parser.py
    ├── test_pcollections.py
    ├── test_persist.py
    ├── test_rhythmtrees.py
    ├── test_score.py
    └── test_setting.py


/.ackrc:
--------------------------------------------------------------------------------
1 | --ignore-directory=*.egg-info
2 | --ignore-directory=.mypy_cache
3 | --ignore-directory=.pytest_cache
4 | --ignore-directory=build
5 | --ignore-directory=dist
6 | --ignore-directory=docs/build
7 | --ignore-directory=docs/source/api
8 | --ignore-directory=htmlcov
9 | 


--------------------------------------------------------------------------------
/.coveragerc:
--------------------------------------------------------------------------------
 1 | [html]
 2 | directory = htmlcov
 3 | 
 4 | [report]
 5 | exclude_lines = 
 6 |     raise NotImplementedError
 7 |     pragma: no cover
 8 |     if TYPE_CHECKING:
 9 | 
10 | [run]
11 | branch = True
12 | cover_pylib = False
13 | source = abjad/
14 | 


--------------------------------------------------------------------------------
/.github/dependabot.yml:
--------------------------------------------------------------------------------
1 | version: 2
2 | 
3 | updates:
4 |   - package-ecosystem: "github-actions"
5 |     directory: "/"
6 |     schedule:
7 |       interval: "weekly"
8 | 


--------------------------------------------------------------------------------
/.github/workflows/main.yml:
--------------------------------------------------------------------------------
 1 | name: abjad
 2 | 
 3 | on:
 4 |   push:
 5 |     branches: [ main ]
 6 |   pull_request:
 7 |     branches: [ main ]
 8 |   workflow_dispatch:
 9 | 
10 | jobs:
11 |   ci-tests:
12 |     runs-on: ubuntu-latest
13 | 
14 |     strategy:
15 |       matrix:
16 |         lilypond-version: ["2.25.26"]
17 |         python-version: ["3.12", "3.13"]
18 | 
19 |     steps:
20 |     - name: Check out repository
21 |       uses: actions/checkout@v4
22 | 
23 |     - name: Set up Python ${{ matrix.python-version }}
24 |       uses: actions/setup-python@v5
25 |       with:
26 |         python-version: ${{ matrix.python-version }}
27 | 
28 |     - name: Cache dependencies
29 |       uses: actions/cache@v4
30 |       with:
31 |         path: ~/.cache/pip
32 |         key: >
33 |           ${{ runner.os }}-pip-
34 |           ${{ matrix.python-version }}-
35 |           ${{ hashFiles('pyproject.toml') }}
36 |         restore-keys: |
37 |           ${{ runner.os }}-pip-${{ matrix.python-version }}-
38 |           ${{ runner.os }}-pip-
39 |           ${{ runner.os }}-
40 | 
41 |     - name: Write environment variables
42 |       run: |
43 |         PATH="/tmp/lilypond-${{ matrix.lilypond-version }}/bin:home/runner/bin:$PATH"
44 |         echo "PATH=$PATH" >> $GITHUB_ENV
45 |         echo "PYTHONUNBUFFERED=TRUE" >> $GITHUB_ENV
46 | 
47 |     - name: Log environment variables
48 |       run: |
49 |         echo "HOME: $HOME"
50 |         echo "GITHUB_WORKSPACE: $GITHUB_WORKSPACE"
51 |         echo "PATH: $PATH"
52 |         echo "PYTHONUNBUFFERED: ${PYTHONUNBUFFERED:-not set}"
53 |         echo "PYTHONPATH: ${PYTHONPATH:-not set}"
54 | 
55 |     - name: Install LilyPond
56 |       uses: Abjad/install-lilypond@main
57 |       with:
58 |         lilypond-version: ${{ matrix.lilypond-version }}
59 | 
60 |     - name: Install this repo
61 |       run: |
62 |         # [dev] for black, flake8, etc
63 |         python -m pip install --upgrade pip
64 |         python -m pip install -e ".[dev]"
65 |         python -c "import abjad; print(abjad.Configuration().configuration_file_path)"
66 |         python scripts/prime_parser_tables.py 2>/dev/null
67 | 
68 |     - name: Log Python dependencies
69 |       run: |
70 |         black --version
71 |         flake8 --version
72 |         isort --version
73 |         mypy --version
74 |         pip --version
75 |         pytest --version
76 | 
77 |     - name: Run lints
78 |       run: |
79 |         make black-check
80 |         make flake8
81 |         make isort-check
82 |         make mypy
83 | 
84 |     - name: Run tests
85 |       run: |
86 |         make pytest
87 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # builds
 2 | *.tar.gz
 3 | *.whl
 4 | build/
 5 | dist/
 6 | 
 7 | # docs
 8 | docs/.sphinx.log
 9 | docs/build
10 | docs/source/api
11 | docs/source/_static/uqbar.css
12 | 
13 | # macOS
14 | .DS_Store
15 | 
16 | # mypy
17 | .mypy_cache/
18 | 
19 | # pytest
20 | .cache/
21 | .coverage
22 | .pytest_cache/
23 | htmlcov/
24 | 
25 | # python
26 | *.egg
27 | *.egg-info
28 | *.manifest
29 | *.py[cod]
30 | *.spec
31 | __pycache__
32 | .env/
33 | venv/
34 | 


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
 1 | .PHONY: black-check black-reformat build clean docs flake8 gh-pages isort-check \
 2 | 	isort-reformat mypy pytest pytest-coverage reformat release lint test
 3 | 
 4 | black-check:
 5 | 	black --check --diff .
 6 | 
 7 | black-reformat:
 8 | 	black .
 9 | 
10 | build:
11 | 	python -m build
12 | 
13 | clean:
14 | 	find . -name '*.pyc' -delete
15 | 	rm -rf __pycache__ .cache .tox build dist htmlcov prof source/*.egg-info
16 | 
17 | docs:
18 | 	make -C docs/ html
19 | 
20 | flake_ignore = --ignore=E203,E266,E501,W503
21 | flake_options = --isolated --max-line-length=88
22 | 
23 | flake8:
24 | 	flake8 ${flake_ignore} ${flake_options}
25 | 
26 | gh-pages:
27 | 	rm -rf gh-pages/
28 | 	git clone --depth=1 https://github.com/Abjad/abjad.github.io.git gh-pages
29 | 	rsync -rtv --delete --exclude=.git docs/build/html/ gh-pages/
30 | 	cd gh-pages && \
31 | 		touch .nojekyll && \
32 | 		git add --all . && \
33 | 		git commit --allow-empty -m "Update docs" && \
34 | 		git push origin master
35 | 	rm -rf gh-pages/
36 | 
37 | isort-check:
38 | 	isort --case-sensitive --check-only --diff --line-width=88 --multi-line=3 \
39 | 		--project=abjad --thirdparty=ply --thirdparty=roman --thirdparty=uqbar \
40 | 		--trailing-comma --use-parentheses .
41 | 
42 | isort-reformat:
43 | 	isort --case-sensitive --line-width=88 --multi-line=3 \
44 | 		--project=abjad --thirdparty=ply --thirdparty=roman --thirdparty=uqbar \
45 | 		--trailing-comma  --use-parentheses .
46 | 
47 | mypy:
48 | 	mypy source
49 | 	mypy tests
50 | 
51 | pytest:
52 | 	pytest source tests
53 | 
54 | pytest-coverage:
55 | 	pytest --cov-config=.coveragerc --cov-report=html --cov=abjad abjad tests \
56 | 		&& rm -rf htmlcov/
57 | 
58 | reformat: black-reformat isort-reformat
59 | 
60 | release:
61 | 	make -C docs/ clean html
62 | 	make clean
63 | 	make build
64 | 	twine upload dist/*
65 | 	make gh-pages
66 | 
67 | lint: black-check flake8 isort-check mypy
68 | 
69 | test: lint pytest
70 | 


--------------------------------------------------------------------------------
/README.rst:
--------------------------------------------------------------------------------
 1 | Abjad 3.22
 2 | ==========
 3 | 
 4 | Abjad helps composers build up complex pieces of music notation in iterative
 5 | and incremental ways. Use Abjad to create a symbolic representation of all the
 6 | notes, rests, chords, tuplets, beams and slurs in any score. Because Abjad
 7 | extends the Python programming language, you can use Abjad to make systematic
 8 | changes to music as you work. Because Abjad wraps the LilyPond music notation
 9 | package, you can use Abjad to control the typographic detail of symbols on the
10 | page.
11 | 
12 | ..  image:: https://img.shields.io/badge/python-3.12-blue.svg
13 |     :target: https://www.python.org/downloads/release/python-312/
14 |     :alt: Python 3.12
15 | 
16 | ..  image:: https://img.shields.io/badge/python-3.13-blue.svg
17 |     :target: https://www.python.org/downloads/release/python-313/
18 |     :alt: Python 3.13
19 | 
20 | ..  image:: https://img.shields.io/pypi/v/abjad.svg?style=flat-square
21 |     :target: https://pypi.python.org/pypi/abjad
22 | 
23 | ..  image:: https://img.shields.io/pypi/dm/abjad.svg?style=flat-square
24 |     :target: https://pypi.python.org/pypi/abjad
25 | 
26 | ..  image:: https://img.shields.io/badge/code%20style-black-000000.svg
27 |     :target: https://github.com/ambv/black
28 | 
29 | ----
30 | 
31 | Abjad's documentation is available here: https://abjad.github.io
32 | 
33 | Abjad's install instructions are tested on macOS and Linux.
34 | 
35 | Abjad requires Python 3.12 or later:
36 | 
37 | ..  code-block::
38 | 
39 |     ~$ python --version
40 |     Python 3.13.2
41 | 
42 | Abjad requires LilyPond 2.23.6 or later.
43 | 
44 | Make sure LilyPond is installed:
45 | http://lilypond.org/development.html
46 | 
47 | Make sure LilyPond is callable from the commandline:
48 | 
49 | ..  code-block::
50 | 
51 |     $ lilypond --version
52 |     GNU LilyPond 2.25.24 (running Guile 3.0)
53 | 
54 |     Copyright (c) 1996--2023 by
55 |       Han-Wen Nienhuys <hanwen@xs4all.nl>
56 |       Jan Nieuwenhuizen <janneke@gnu.org>
57 |       and others.
58 | 
59 |     This program is free software.  It is covered by the GNU General Public
60 |     License and you are welcome to change it and/or distribute copies of it
61 |     under certain conditions.  Invoke as `lilypond --warranty' for more
62 |     information.
63 | 
64 | Create a Python 3 virtual environment for Abjad:
65 | https://docs.python.org/3/tutorial/venv.html
66 | 
67 | Activate the virtual environment and then use pip to install Abjad:
68 | 
69 | ..  code-block::
70 | 
71 |     ~$ python -m pip install abjad
72 | 
73 | Start Python, import Abjad, start making music notation:
74 | 
75 | ..  code-block::
76 | 
77 |     ~$ python
78 |     >>> import abjad
79 |     >>> note = abjad.Note("c'4")
80 |     >>> abjad.show(note)
81 | 
82 | ..
83 |     ..  image:: hello.png
84 | 
85 | ----
86 | 
87 | Join the Abjad community: https://abjad.github.io/appendices/community.html
88 | 


--------------------------------------------------------------------------------
/conftest.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | @pytest.fixture(autouse=True)
 7 | def inject_abjad_into_doctest_namespace(doctest_namespace):
 8 |     """
 9 |     Inject Abjad into doctest namespace.
10 |     """
11 |     doctest_namespace["abjad"] = abjad
12 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/containerized-model.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | A containerized model of music notation
 4 | =======================================
 5 | 
 6 | Abjad implements a containerized model of music notation: notes, rests, chords
 7 | are collected into voices, staves, scores, and other types of container. Because
 8 | Abjad's containers may contain each other, the core of Abjad's object model
 9 | constitutes a graph-theoretic tree.
10 | 
11 | .. image:: images/lci-1.png
12 | 
13 | The example above shows 14 notes contained in three tuplets, themselves
14 | contained in yet another tuplet; that tuplet is contained in a musical voice;
15 | the voice is contained in a staff; the staff is contained in a score. The
16 | tuplets' nesting makes the tree-like structure of the example easy to see.
17 | 
18 | Abjad declines to model musical measures as containers. Much notation software
19 | of the early 2000s lost its way trying to model the musical measure as a
20 | centrally important object of notation. The result was a confusion about the
21 | function of barlines and the frequent inability of tuplets to cross measure
22 | boundaries. Abjad's solution is to model the musical measure as a logical
23 | concept rather than a container: composers may select notes grouped by measure
24 | in Abjad any time a time signature is present; no containerized measures are
25 | required.
26 | 
27 | What about the  many elements of music notation that are attached to the notes,
28 | rests, chords that fill a page of music? Should the beaming patterns in the
29 | examples below be modeled with containers, too?
30 | 
31 | .. image:: images/lci-2.png
32 | 
33 | .. image:: images/lci-3.png
34 | 
35 | .. image:: images/lci-4.png
36 | 
37 | Perhaps surprisingly, only a small number of musical symbols carry a duration:
38 | notes, rests, chords and, by extension, the tuplets, voices, staves that
39 | contain them. All the other symbols used to notate music are dependent on
40 | notes, rests, chords for their moment of performance, and for their location on
41 | the page: articulations, fingerings, pedal markings, slurs, phrase groupings,
42 | clefs, key signatures all depend on notes, rests, chords for their location,
43 | both temporal and spatial.
44 | 
45 | Abjad formalizes this distinction between durated and non-durated objects in
46 | the idea of an indicator. Abjad's indicators model all the symbols that may be
47 | attached to notes, rests, chords during composition. (The beamed examples above
48 | were created by attaching "start-beam" and "stop-beam" indicators to different
49 | notes.)
50 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/custom-context-creation.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | Custom context creation
 4 | =======================
 5 | 
 6 | What if you define a custom LilyPond context in an external stylesheet? Just set the
 7 | LilyPond type of an Abjad context the same way. The name of the custom context will
 8 | appear in the LilyPond output you create with Abjad. Make sure to include the name of
 9 | your external stylesheet and LilyPond will style your output accordingly:
10 | 
11 | ::
12 | 
13 |     >>> voice = abjad.Voice(name="Flute_Voice", lilypond_type="Custom_Flute_Voice")
14 |     >>> voice.extend("c'8 d' e' f' g' a' b' c''")
15 |     >>> string = abjad.lilypond(voice)
16 |     >>> print(string)
17 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/glossary.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | Glossary
 4 | ========
 5 | 
 6 | **Assignability.** Western notation makes it easy to notate notes, rests and chords with
 7 | durations like ``1/4`` and ``3/16``. But notating notes, rests and chords with durations
 8 | like ``1/3`` can only be done with recourse to tuplets or ties. Abjad formalizes the
 9 | difference between durations like ``1/4`` and ``1/5`` in the concept of assignability: a
10 | duration ``n/d`` is assignable when and only when numerator ``n`` is of the form
11 | ``2**i-2**j`` with ``i>j`` and denominator ``d`` is of the form ``2**v``. In this
12 | definition ``i`` must be a positive integer, and ``j`` and ``v`` must be nonnegative
13 | integers. Assignability is important because it explains why you can set the duration of
14 | any note, rest or chord to ``1/4`` or ``7/4`` but never to ``1/5`` or ``7/5``.
15 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/images/lci-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_mothballed/images/lci-1.png


--------------------------------------------------------------------------------
/docs/source/_mothballed/images/lci-2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_mothballed/images/lci-2.png


--------------------------------------------------------------------------------
/docs/source/_mothballed/images/lci-3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_mothballed/images/lci-3.png


--------------------------------------------------------------------------------
/docs/source/_mothballed/images/lci-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_mothballed/images/lci-4.png


--------------------------------------------------------------------------------
/docs/source/_mothballed/instruments.rst:
--------------------------------------------------------------------------------
  1 | :orphan:
  2 | 
  3 | Instruments
  4 | ===========
  5 | 
  6 | Creating instruments
  7 | --------------------
  8 | 
  9 | Initialize instruments like this:
 10 | 
 11 | ::
 12 | 
 13 |     >>> violin = abjad.Violin()
 14 | 
 15 | Understanding the interpreter representation of an instrument
 16 | -------------------------------------------------------------
 17 | 
 18 | The interpreter representation of an instrument tells you the instrument's class:
 19 | 
 20 | ::
 21 | 
 22 |     >>> violin
 23 | 
 24 | Attaching instruments to a component
 25 | ------------------------------------
 26 | 
 27 | Use ``abjad.attach()`` to attach an instrument to a leaf:
 28 | 
 29 | ::
 30 | 
 31 |     >>> staff = abjad.Staff("c'4 d'4 e'4 f'4")
 32 |     >>> abjad.attach(violin, staff[0])
 33 |     >>> abjad.show(staff)
 34 | 
 35 | Getting the instrument attached to a component
 36 | ----------------------------------------------
 37 | 
 38 | Get the instrument attached to a leaf:
 39 | 
 40 | ::
 41 | 
 42 |     >>> abjad.get.indicator(staff[0], abjad.Instrument)
 43 | 
 44 | Getting a component's effective instrument
 45 | ------------------------------------------
 46 | 
 47 | Get the instrument currently in effect for a component:
 48 | 
 49 | ::
 50 | 
 51 |     >>> for note in staff:
 52 |     ...     abjad.get.effective(note, abjad.Instrument)
 53 |     ...
 54 | 
 55 | Detaching instruments from a component
 56 | --------------------------------------
 57 | 
 58 | Use ``abjad.detach()`` to detach an instrument from a component:
 59 | 
 60 | ::
 61 | 
 62 |     >>> abjad.detach(violin, staff[0])
 63 |     >>> abjad.show(staff)
 64 | 
 65 | Getting an instrument's range
 66 | -----------------------------
 67 | 
 68 | Use ``pitch_range`` to get the range of any instrument:
 69 | 
 70 | ::
 71 | 
 72 |     >>> violin.pitch_range
 73 | 
 74 | ::
 75 | 
 76 |     >>> lilypond_file = abjad.illustrate(violin.pitch_range)
 77 |     >>> abjad.show(lilypond_file)
 78 | 
 79 | Getting an instrument's level of transposition
 80 | ----------------------------------------------
 81 | 
 82 | Use ``middle_c_sounding_pitch`` to get an instrument's level of transposition:
 83 | 
 84 | ::
 85 | 
 86 |     >>> violin.middle_c_sounding_pitch
 87 | 
 88 | ::
 89 | 
 90 |     >>> note = abjad.Note(violin.middle_c_sounding_pitch, 4)
 91 |     >>> abjad.show(note)
 92 | 
 93 | Getting an instrument's clefs
 94 | -----------------------------
 95 | 
 96 | Use ``clefs`` to get clefs on which an instrument is conventionally notated:
 97 | 
 98 | ::
 99 | 
100 |     >>> violin.clefs
101 | 
102 | Customizing instrument properties
103 | ---------------------------------
104 | 
105 | You can change the properties of any instrument at initialization:
106 | 
107 | ::
108 | 
109 |     >>> viola = abjad.Viola(
110 |     ...     clefs=("alto", "treble"),
111 |     ...     pitch_range=abjad.PitchRange("[C3, C6]"),
112 |     ... )
113 | 
114 | ::
115 | 
116 |     >>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
117 |     >>> abjad.attach(viola, staff[0])
118 |     >>> clef = abjad.Clef("alto")
119 |     >>> abjad.attach(clef, staff[0])
120 |     >>> abjad.show(staff)
121 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/lilypond-literals.rst:
--------------------------------------------------------------------------------
  1 | :orphan:
  2 | 
  3 | LilyPond literals
  4 | =================
  5 | 
  6 | LilyPond literals allow you to attach arbitrary LilyPond literals to Abjad score
  7 | components.
  8 | 
  9 | Creating LilyPond literals
 10 | --------------------------
 11 | 
 12 | Use ``abjad.LilyPondLiteral`` to create a LilyPond literal:
 13 | 
 14 | ::
 15 | 
 16 |     >>> literal = abjad.LilyPondLiteral(r'\bar "||"', site="after")
 17 | 
 18 | Understanding the interpreter representation of LilyPond literals
 19 | -----------------------------------------------------------------
 20 | 
 21 | ::
 22 | 
 23 |     >>> literal
 24 | 
 25 | ``LilyPondLiteral`` tells you the literal's class.
 26 | 
 27 | ``r'\bar "||"'`` tells you the LilyPond literal to be formatted.
 28 | 
 29 | ``"after"`` tells you where the literal will be formatted relative to the leaf to which
 30 | it is attached.
 31 | 
 32 | Attaching LilyPond literals to Abjad components
 33 | -----------------------------------------------
 34 | 
 35 | Use ``abjad.attach()`` to attach a LilyPond literal to any Abjad leaf:
 36 | 
 37 | ::
 38 | 
 39 |     >>> staff = abjad.Staff()
 40 |     >>> staff.extend("{ d''16 ( c''16 fs''16 g''16 ) }")
 41 |     >>> staff.extend("{ f''16 ( e''16 d''16 c''16 ) }")
 42 |     >>> staff.extend("{ cs''16 ( d''16 f''16 d''16 ) }")
 43 |     >>> staff.extend("{ a'8 b'8 }")
 44 |     >>> staff.extend("{ d''16 ( c''16 fs''16 g''16 )} ")
 45 |     >>> staff.extend("{ f''16 ( e''16 d''16 c''16 ) }")
 46 |     >>> staff.extend("{ cs''16 ( d''16 f''16 d''16 ) }")
 47 |     >>> staff.extend("{ a'8 b'8 c''2 }")
 48 |     >>> key_signature = abjad.KeySignature(
 49 |     ...     abjad.NamedPitchClass("f"), abjad.Mode("major")
 50 |     ... )
 51 |     >>> leaf = abjad.get.leaf(staff, 0)
 52 |     >>> abjad.attach(key_signature, leaf)
 53 | 
 54 | ::
 55 | 
 56 |     >>> abjad.attach(literal, staff[-2])
 57 | 
 58 | ::
 59 | 
 60 |     >>> abjad.show(staff)
 61 | 
 62 | 
 63 | Getting the LilyPond literals attached to a leaf
 64 | ------------------------------------------------
 65 | 
 66 | Get the LilyPond literals attached to a leaf:
 67 | 
 68 | ::
 69 | 
 70 |     >>> abjad.get.indicators(staff[-2], abjad.LilyPondLiteral)
 71 | 
 72 | 
 73 | Detaching LilyPond literals
 74 | ---------------------------
 75 | 
 76 | Use ``abjad.detach()`` to detach LilyPond literals:
 77 | 
 78 | ::
 79 | 
 80 |     >>> abjad.detach(literal, staff[-2])
 81 | 
 82 | ::
 83 | 
 84 |     >>> abjad.show(staff)
 85 | 
 86 | 
 87 | Getting the argument of a LilyPond literal
 88 | ------------------------------------------
 89 | 
 90 | Use ``argument`` to get the argument of a LilyPond literal:
 91 | 
 92 | ::
 93 | 
 94 |     >>> literal.argument
 95 | 
 96 | 
 97 | Comparing LilyPond literals
 98 | ---------------------------
 99 | 
100 | LilyPond literals compare equal with equal names. Otherwise LilyPond literals do not
101 | compare equal:
102 | 
103 | ::
104 | 
105 |     >>> literal_1 = abjad.LilyPondLiteral(r'\bar "||"', site="after")
106 |     >>> literal_2 = abjad.LilyPondLiteral(r'\bar "||"', site="before")
107 |     >>> literal_3 = abjad.LilyPondLiteral(r"\slurUp")
108 | 
109 | ::
110 | 
111 |     >>> literal_1 == literal_1
112 |     >>> literal_1 == literal_2
113 |     >>> literal_1 == literal_3
114 | 
115 | ::
116 | 
117 |     >>> literal_2 == literal_1
118 |     >>> literal_2 == literal_2
119 |     >>> literal_2 == literal_3
120 | 
121 | ::
122 | 
123 |     >>> literal_3 == literal_1
124 |     >>> literal_3 == literal_2
125 |     >>> literal_3 == literal_3
126 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/organization.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | **Organization.** Abjad isn't a stand-alone application so much as an extension to an
 4 | existing programming language: learning Abjad doesn't mean mastering a reference manual;
 5 | learning Abjad means leveraging the techniques of programming to create PDFs of music
 6 | notation. If your compositional thinking derives musical phrases from the multiplication
 7 | of small cells, you can write code to model that process. If your compositional thinking
 8 | superimposes partials to create verticalities, you can write code to model that process.
 9 | If your compositional thinking operates in set-theoretic-like ways on starting
10 | collections of pitches, you can write code to model that process. If your compositional
11 | thinking foregrounds (historical or newly-conceived) dissonance handling, you can write
12 | code to model the input/output and rules of your dissonance handling. If your
13 | compositional thinking is informed by 20th-century ideas of mapping data (statistical
14 | distributions, measurements from nature, corpus data from texts) to pitch or rhythmic
15 | structures, you can write code to read different data sources and visualize the results
16 | as notation. And if your compositional thinking involves writing notes according to
17 | intuition, you can write code to capture the outlines of that process, too.
18 | 
19 | However you decide to model your compositional thinking, you'll need to master the basics
20 | of notes, rests, chords, tuplets, voices, staves, scores in Abjad. You'll also need to
21 | develop an understanding of five concepts:
22 | 
23 |     * construction
24 |     * inspection
25 |     * iteration
26 |     * encapsulation
27 |     * mutation
28 | 
29 | You'll use the first three of these --- construction, inspection, iteration --- as the
30 | everyday basics of the code you write. Encapsulation becomes important when you start to
31 | model compositional procedures you do on a repeated basis --- when you move from writing
32 | code to architecting code. Mutation concerns making broad, but computationally expensive,
33 | changes to your work. The sections of the overview that follow are organized according to
34 | these ideas.
35 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/parentage.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | ..  todo:: Include under discussion of score structure.
 4 | 
 5 | Parentage
 6 | =========
 7 | 
 8 | Many score objects contain other score objects:
 9 | 
10 | ::
11 | 
12 |     >>> string = r"\times 2/3 { c'4 d' e' } \times 2/3 { c'4 d' e' }"
13 |     >>> staff = abjad.Staff(string)
14 |     >>> score = abjad.Score([staff])
15 |     >>> abjad.show(score)
16 | 
17 | Abjad uses the idea of parentage to model the way objects contain each other:
18 | 
19 | ::
20 | 
21 |     >>> note = abjad.get.leaf(score, 0)
22 |     >>> parentage = abjad.get.parentage(note)
23 |     >>> parentage
24 | 
25 | Use parentage to find the immediate parent of a component:
26 | 
27 | ::
28 | 
29 |     >>> parentage.parent
30 | 
31 | Or the root of the score in the which the component resides:
32 | 
33 | ::
34 | 
35 |     >>> parentage.root
36 | 
37 | Or to find the depth at which the component is embedded in its score:
38 | 
39 | ::
40 | 
41 |     >>> parentage.count(abjad.Tuplet)
42 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/summer-workshop.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | Summer workshop
 4 | ===============
 5 | 
 6 | Summers | Palo Alto, CA
 7 | 
 8 | https://ccrma.stanford.edu/workshops/python-and-abjad-in-music-comp-2018
 9 | 
10 | Hosted at Stanford's CCMRA, the course provides an introduction to the production of
11 | professionally engraved musical scores using the Python programming language and the
12 | Abjad API for Formalized Score Control as part of compositional practice.
13 | 
14 | The course introduces Abjad's object-oriented approach to music notation and algorithmic
15 | composition through real-world examples and hands-on coding activities. No previous
16 | programming experience is required. Python basics will be taught from the ground up
17 | during the course with musical examples designed to make sense to composers.
18 | 
19 | Topics covered include:
20 | 
21 | * system installation and configuration
22 | * defining your own functions, classes and modules
23 | * generating structured tableaux of rhythms, pitch collections and other
24 |   materials during precomposition
25 | * managing polyphony with operations on voices, staves and other musical containers
26 | * working with parametric score layout
27 | * understanding the document structure of complex scores
28 | * controlling the details of musical typography programmatically
29 | 
30 | Taught by Jeff Treviño, Trevor Bača and Joséphine Wolf Oberholtzer.
31 | 
32 | Visit the `CCRMA`_ website for the most up-to-date scheduling information about this
33 | annual course.
34 | 
35 | :author:`[Treviño (2.19)]`
36 | 
37 | ..  _CCRMA: https://ccrma.stanford.edu
38 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/understanding-reprs.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | Understanding reprs
 4 | ===================
 5 | 
 6 | Python's interpreter will show you a summary of the objects you create. The second and
 7 | third examples below work because you can index Abjad voices the same way you index
 8 | Python lists:
 9 | 
10 | ::
11 | 
12 |     >>> string = "d'8 f' a' d'' f'' gs'4 r8 e' gs' b' e'' gs'' a'4"
13 |     >>> voice = abjad.Voice(string)
14 |     >>> staff = abjad.Staff([voice])
15 |     >>> abjad.show(staff)
16 | 
17 | ::
18 | 
19 |     >>> voice
20 | 
21 |     >>> voice[5]
22 | 
23 |     >>> voice[6]
24 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/working-with-named-pitches.rst:
--------------------------------------------------------------------------------
  1 | :orphan:
  2 | 
  3 | ..  todo:: Include in complete overview of Abjad's pitch system.
  4 | 
  5 | Working with named pitches
  6 | ==========================
  7 | 
  8 | Abjad's named pitches model the everyday pitches of notes and chords:
  9 | 
 10 | ::
 11 | 
 12 |     >>> note = abjad.Note("cs''8")
 13 |     >>> abjad.show(note)
 14 | 
 15 |     >>> pitch = note.written_pitch
 16 |     >>> pitch
 17 | 
 18 | ----
 19 | 
 20 | **Properties.** Get the accidental of a named pitch like this:
 21 | 
 22 | ::
 23 | 
 24 |     >>> pitch.accidental
 25 | 
 26 | Get the octave of a named pitch like this:
 27 | 
 28 | ::
 29 | 
 30 |     >>> pitch.octave
 31 | 
 32 | ----
 33 | 
 34 | **Equality testing.** Named pitches compare equal with equal pitch-class and octave:
 35 | 
 36 | ::
 37 | 
 38 |     >>> pitch_1 = abjad.NamedPitch("cs''")
 39 |     >>> pitch_2 = abjad.NamedPitch("df''")
 40 | 
 41 | ::
 42 | 
 43 |     >>> pitch_1 == pitch_1
 44 |     >>> pitch_1 == pitch_2
 45 | 
 46 | ::
 47 | 
 48 |     >>> pitch_2 == pitch_1
 49 |     >>> pitch_2 == pitch_2
 50 | 
 51 | You can also compare named pitches with greater-than and less-than:
 52 | 
 53 | ::
 54 | 
 55 |     >>> pitch_1 < pitch_1
 56 |     >>> pitch_1 < pitch_2
 57 |     >>> pitch_2 < pitch_1
 58 |     >>> pitch_2 < pitch_2
 59 | 
 60 | ::
 61 | 
 62 |     >>> pitch_1 <= pitch_1
 63 |     >>> pitch_1 <= pitch_2
 64 |     >>> pitch_2 <= pitch_1
 65 |     >>> pitch_2 <= pitch_2
 66 | 
 67 | ::
 68 | 
 69 |     >>> pitch_1 > pitch_1
 70 |     >>> pitch_1 > pitch_2
 71 |     >>> pitch_2 > pitch_1
 72 |     >>> pitch_2 > pitch_2
 73 | 
 74 | ::
 75 | 
 76 |     >>> pitch_1 >= pitch_1
 77 |     >>> pitch_1 >= pitch_2
 78 |     >>> pitch_2 >= pitch_1
 79 |     >>> pitch_2 >= pitch_2
 80 | 
 81 | ----
 82 | 
 83 | **Conversion.** Change a named pitch to a named pitch-class like this:
 84 | 
 85 | ::
 86 | 
 87 |     >>> pitch.pitch_class
 88 | 
 89 |     >>> abjad.NamedPitchClass(pitch)
 90 | 
 91 | Change a named pitch to a numbered pitch like this:
 92 | 
 93 | ::
 94 | 
 95 |     >>> abjad.NumberedPitch(pitch)
 96 | 
 97 | Change a named pitch to a numbered pitch-class like this:
 98 | 
 99 | ::
100 | 
101 |     >>> abjad.NumberedPitchClass(pitch)
102 | 


--------------------------------------------------------------------------------
/docs/source/_mothballed/written-duration.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | What's the difference between duration and written duration?
 4 | ============================================================
 5 | 
 6 | Abjad uses the term "written duration" to refer to the face value of notes, rests and
 7 | chords prior to time-scaling effects of tuplets or measures with unusual time signatures.
 8 | Abjad's written duration corresponds to the informal names most frequently used when
 9 | talking about note duration.
10 | 
11 | Consider the measure below:
12 | 
13 | ::
14 | 
15 |     >>> staff = abjad.Staff(r"\time 5/15 c16 [ c c c c ]", lilypond_type="RhythmicStaff")
16 |     >>> leaves = abjad.select.leaves(staff)
17 | 
18 | ::
19 | 
20 |     >>> abjad.show(staff)
21 | 
22 | Every note in the measure equals one sixteenth of a whole note:
23 | 
24 | ::
25 | 
26 |     >>> note = staff[0]
27 |     >>> abjad.get.duration(note)
28 | 
29 | But now consider this measure:
30 | 
31 | ::
32 | 
33 |     >>> tuplet = abjad.Tuplet((4, 5), r"\time 4/16 c16 [ c c c c ]")
34 |     >>> staff = abjad.Staff([tuplet], lilypond_type="RhythmicStaff")
35 |     >>> leaves = abjad.select.leaves(staff)
36 | 
37 | ::
38 | 
39 |     >>> abjad.show(staff)
40 | 
41 | The notes in this measure are equal to only one twentieth of a whole note:
42 | 
43 | ::
44 | 
45 |     >>> note = tuplet[0]
46 |     >>> abjad.get.duration(note)
47 | 
48 | The notes in this measure are "sixteenth notes" with a duration equal to a value other
49 | than ``1/16``. Abjad formalizes this distinction in the difference between the duration
50 | of these notes (``1/20``) and written duration of these notes (``1/16``).
51 | 
52 | Written duration is a user-assignable value. Users can assign and reassign the written
53 | duration of notes, rests and chords at initialization or any time thereafter. But the
54 | (unqualified) duration of a note, rest or chord is a derived property Abjad calculates
55 | based on the rhythmic context governing the note, rest or chord.
56 | 


--------------------------------------------------------------------------------
/docs/source/_pending/row-derivation-by-trichord.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | Row derivation, by trichord
 4 | ===========================
 5 | 
 6 | Derived tone rows in Anton Webern's `Concerto for Nine Instruments, Op.24`.
 7 | 
 8 | ----
 9 | 
10 | First we define functions to illustrate the examples that follow:
11 | 
12 | ::
13 | 
14 |     >>> def illustrate_row(row):
15 |     ...     notes = [abjad.Note(_, (1, 8)) for _ in row]
16 |     ...     score = abjad.illustrators.make_piano_score(notes)
17 |     ...     treble_staff = score["Treble_Staff"]
18 |     ...     abjad.override(treble_staff).BarLine.stencil = False
19 |     ...     abjad.override(treble_staff).BarNumber.stencil = False
20 |     ...     abjad.override(treble_staff).Beam.stencil = False
21 |     ...     abjad.override(treble_staff).Flag.stencil = False
22 |     ...     abjad.override(treble_staff).Rest.stencil = False
23 |     ...     abjad.override(treble_staff).SpacingSpanner.strict_note_spacing = True
24 |     ...     abjad.override(treble_staff).SpanBar.stencil = False
25 |     ...     abjad.override(treble_staff).Stem.stencil = False
26 |     ...     abjad.override(treble_staff).TimeSignature.stencil = False
27 |     ...     string = r"\musicLength 1*1/25"
28 |     ...     abjad.setting(treble_staff).proportionalNotationDuration = string
29 |     ...     string = "#(set-global-staff-size 16)"
30 |     ...     lilypond_file = abjad.LilyPondFile([string, treble_staff])
31 |     ...     return lilypond_file
32 | 
33 | ----
34 | 
35 | Define trichord source and tone-row-forming transformations:
36 | 
37 | ::
38 | 
39 |     >>> source_trichord = abjad.PitchClassSegment([0, 1, 4])
40 |     >>> webern_source = source_trichord.invert().rotate(1).transpose(-8)
41 |     >>> first_part = webern_source.transpose(7)
42 |     >>> second_part = webern_source.invert().retrograde().transpose(6)
43 |     >>> third_part = webern_source.retrograde().transpose(1)
44 |     >>> fourth_part = webern_source.invert()
45 |     >>> row = abjad.TwelveToneRow(first_part + second_part + third_part + fourth_part)
46 | 
47 | Show prime form:
48 | 
49 | ::
50 | 
51 |     >>> file = illustrate_row(row)
52 |     >>> abjad.show(file)
53 | 
54 | Show retrograde:
55 | 
56 | ::
57 | 
58 |     >>> file = illustrate_row(row.retrograde())
59 |     >>> abjad.show(file)
60 | 
61 | Show inversion:
62 | 
63 | ::
64 | 
65 |     >>> file = illustrate_row(row.invert())
66 |     >>> abjad.show(file)
67 | 
68 | Show retrograde inversion:
69 | 
70 | ::
71 | 
72 |     >>> file = illustrate_row(row.invert().retrograde())
73 |     >>> abjad.show(file)
74 | 
75 | :author:`[Evans (3.2), Bača (3.7)]`
76 | 


--------------------------------------------------------------------------------
/docs/source/_pending/scale-derivation-by-sieve.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | Scale derivation, by sieve
 4 | ==========================
 5 | 
 6 | The derivation of nonoctave scales by sieve is a 20th-century technique due to Xenakis.
 7 | 
 8 | ----
 9 | 
10 | First we define a function to illustrate the examples that follow:
11 | 
12 | ::
13 | 
14 |     >>> def illustrate_scale(pattern, length, transposition):
15 |     ...     pitches = list(range(length))
16 |     ...     pitches = abjad.sequence.retain_pattern(pitches, pattern)
17 |     ...     notes = [abjad.Note(_ + transposition, (1, 16)) for _ in pitches]
18 |     ...     score = abjad.illustrators.make_piano_score(notes)
19 |     ...     treble_staff = score["Treble_Staff"]
20 |     ...     abjad.override(score).BarLine.stencil = False
21 |     ...     abjad.override(score).BarNumber.stencil = False
22 |     ...     abjad.override(score).Beam.stencil = False
23 |     ...     abjad.override(score).Flag.stencil = False
24 |     ...     abjad.override(score).Rest.stencil = False
25 |     ...     abjad.override(score).SpacingSpanner.strict_note_spacing = True
26 |     ...     abjad.override(score).SpanBar.stencil = False
27 |     ...     abjad.override(score).Stem.stencil = False
28 |     ...     abjad.override(score).TimeSignature.stencil = False
29 |     ...     abjad.setting(score).proportionalNotationDuration = r"\musicLength 1*1/25"
30 |     ...     lilypond_file = abjad.LilyPondFile(
31 |     ...         items=[
32 |     ...             "#(set-global-staff-size 16)",
33 |     ...             score,
34 |     ...             abjad.Block("layout"),
35 |     ...         ],
36 |     ...     )
37 |     ...     lilypond_file["layout"].items.append("indent = #0")
38 |     ...     return lilypond_file
39 | 
40 | ----
41 | 
42 | **Jonchaies.** The sieve underlying Xenakis's orchestra piece *Jonchaies*
43 | (1977) structures a series of 8 consecutive intervals that repeat every 17 semitones.
44 | 
45 | First three elements of sieve:
46 | 
47 | ::
48 | 
49 |     >>> first_half = abjad.Pattern(indices=[0, 1, 4], period=17)
50 |     >>> lilypond_file = illustrate_scale(first_half, 56, -15)
51 |     >>> abjad.show(lilypond_file)
52 | 
53 | Remainder of sieve:
54 | 
55 | ::
56 | 
57 |     >>> second_half = abjad.Pattern(indices=[5, 7, 11, 12, 16], period=17)
58 |     >>> lilypond_file = illustrate_scale(second_half, 56, -15)
59 |     >>> abjad.show(lilypond_file)
60 | 
61 | Complete sieve:
62 | 
63 | ::
64 | 
65 |     >>> sieve = first_half | second_half
66 |     >>> lilypond_file = illustrate_scale(sieve, 56, -15)
67 |     >>> abjad.show(lilypond_file)
68 | 
69 | Non-octave scale in Joel Hoffman's **Piano Concerto**:
70 | 
71 | ::
72 | 
73 |     >>> scale = abjad.Pattern(indices=[0, 2, 3, 4, 5, 6, 8, 9, 10, 11, 13], period=14)
74 |     >>> lilypond_file = illustrate_scale(scale, 84, -37)
75 |     >>> abjad.show(lilypond_file)
76 | 
77 | :author:`[Evans (3.2)]`
78 | 


--------------------------------------------------------------------------------
/docs/source/_pending/tone-clock-tesselation.rst:
--------------------------------------------------------------------------------
 1 | :orphan:
 2 | 
 3 | Tone-clock tesselation
 4 | ======================
 5 | 
 6 | Tone-clock tesselation in Jenny McLeod's `Tone Clock Piece I`.
 7 | 
 8 | ----
 9 | 
10 | ::
11 | 
12 |     >>> def illustrate_trichords(trichords):
13 |     ...     group = abjad.StaffGroup([abjad.Staff(), abjad.Staff(), abjad.Staff()])
14 |     ...     score = abjad.Score([group])
15 |     ...     for triad in trichords:
16 |     ...         for i, pitch in enumerate(triad):
17 |     ...             staff = group[i]
18 |     ...             note = abjad.Note(pitch, (1, 1))
19 |     ...             staff.append(note)
20 |     ...     abjad.override(score).Rest.stencil = False
21 |     ...     abjad.override(score).SpacingSpanner.strict_note_spacing = True
22 |     ...     abjad.override(score).TimeSignature.stencil = False
23 |     ...     abjad.override(score).BarLine.stencil = False
24 |     ...     abjad.override(score).BarNumber.stencil = False
25 |     ...     abjad.override(score).SpanBar.stencil = False
26 |     ...     abjad.setting(score).proportionalNotationDuration = r"\musicLength 1*1/25"
27 |     ...     string = "#(set-global-staff-size 16)"
28 |     ...     lilypond_file = abjad.LilyPondFile([string, score])
29 |     ...     return lilypond_file
30 |     ...
31 | 
32 | ::
33 | 
34 |     >>> def tesselate_segment(segment, steering, inversions):
35 |     ...     field = []
36 |     ...     for bool, i in zip(inversions, steering):
37 |     ...         transposition = ipf
38 |     ...         if bool:
39 |     ...             transposition = transposition.invert().retrograde()
40 |     ...             val = transposition[0].number
41 |     ...             transposition = transposition.transpose((0 - val))
42 |     ...             transposition = transposition.transpose(i)
43 |     ...         else:
44 |     ...             transposition = transposition.transpose(i)
45 |     ...         field.append(transposition)
46 |     ...     return field
47 |     ...
48 | 
49 | ----
50 | 
51 | 
52 | Trichord reservoir in Jenny McLeod's **Tone Clock Piece I**:
53 | 
54 | ::
55 | 
56 |     >>> ipf = abjad.PitchSegment([0, 2, 7])
57 |     >>> steering = [abjad.NumberedInterval(_) for _ in [0, 1, 3, 4]]
58 |     >>> tesselation = tesselate_segment(
59 |     ...     ipf,
60 |     ...     steering,
61 |     ...     [False, True, False, True],
62 |     ... )
63 |     ...
64 |     >>> lilypond_file = illustrate_trichords(tesselation)
65 |     >>> abjad.show(lilypond_file)
66 | 
67 | Alternate reservoir:
68 | 
69 | ::
70 | 
71 |     >>> ipf = abjad.PitchSegment([0, 1, 6])
72 |     >>> steering = [abjad.NumberedInterval(_) for _ in [0, 1, 4, 6]]
73 |     >>> tesselation = tesselate_segment(
74 |     ...     ipf,
75 |     ...     steering,
76 |     ...     [False, False, True, True],
77 |     ... )
78 |     ...
79 |     >>> lilypond_file = illustrate_trichords(tesselation)
80 |     >>> abjad.show(lilypond_file)
81 | 
82 | :author:`[Evans (3.2), Bača (3.7)]`
83 | 


--------------------------------------------------------------------------------
/docs/source/_static/abjad-logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_static/abjad-logo.png


--------------------------------------------------------------------------------
/docs/source/_static/abjad.css:
--------------------------------------------------------------------------------
 1 | .table-row {
 2 |     display: table-row;
 3 |     }
 4 | 
 5 | .table-row :first-child {
 6 |     padding-left: 0px;
 7 |     }
 8 | 
 9 | .table-row :last-child {
10 |     padding-right: 0px;
11 |     }
12 | 
13 | .table-cell {
14 |     display: table-cell;
15 |     padding-left: 12px;
16 |     padding-right: 12px;
17 |     padding-bottom: 24px;
18 |     }
19 | 
20 | a.table-cell img {
21 |     -moz-border-radius: 2px;
22 |     -moz-box-shadow: 0px 0px 10px #eee;
23 |     -webkit-border-radius: 2px;
24 |     -webkit-box-shadow: 0px 0px 10px #eee;
25 |     border-radius: 2px;
26 |     border: 1px solid #ddd;
27 |     box-shadow: 0px 0px 10px #eee;
28 |     background-color: white;
29 |     }
30 | 
31 | a.thumbnail {
32 |     cursor: zoom-in;
33 |     }
34 | 
35 | .author {
36 |     font-size: small;
37 |     font-style: italic;
38 |     }
39 | 
40 | .exception {
41 |     background-color: #fff4f8;
42 |     }
43 | 
44 | .expression {
45 |     background-color: #eff5ff;
46 |     }
47 | 
48 | p {
49 |     text-align: justify;
50 | }
51 | 


--------------------------------------------------------------------------------
/docs/source/_static/abjad.js:
--------------------------------------------------------------------------------
1 | $(document).ready(function() {
2 |     $("div.abjad-book-image-source").toggle();
3 |     $("div.abjad-book-image > img").click(function(event) {
4 |         $(this).parent().siblings("div.abjad-book-image-source").toggle(250);
5 |     });
6 | });


--------------------------------------------------------------------------------
/docs/source/_static/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_static/favicon.ico


--------------------------------------------------------------------------------
/docs/source/_static/ga.js:
--------------------------------------------------------------------------------
1 |   (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
2 |   (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
3 |   m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
4 |   })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
5 | 
6 |   ga('create', 'UA-7286453-1', 'auto');
7 |   ga('send', 'pageview');


--------------------------------------------------------------------------------
/docs/source/_static/lightbox2/images/close.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_static/lightbox2/images/close.png


--------------------------------------------------------------------------------
/docs/source/_static/lightbox2/images/loading.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_static/lightbox2/images/loading.gif


--------------------------------------------------------------------------------
/docs/source/_static/lightbox2/images/next.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_static/lightbox2/images/next.png


--------------------------------------------------------------------------------
/docs/source/_static/lightbox2/images/prev.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/_static/lightbox2/images/prev.png


--------------------------------------------------------------------------------
/docs/source/_templates/breadcrumbs.html:
--------------------------------------------------------------------------------
 1 | {# This empty file exists to *overwrite* RTD's breadcrumbs.html file.
 2 |    The purpose is to remove RTD's breadcrumbs banner at the top of every page.
 3 |    Adapted from https://docs.readthedocs.io/en/stable/guides/remove-edit-buttons.html
 4 | #}
 5 | 
 6 | {# If we ever set prev_next_buttons_location="both" then uncomment these instead:
 7 | 
 8 |     {%- extends "sphinx_rtd_theme/breadcrumbs.html" %}
 9 |     {% block breadcrumbs %}{% endblock %}
10 | 
11 | #}
12 | 


--------------------------------------------------------------------------------
/docs/source/_templates/footer.html:
--------------------------------------------------------------------------------
 1 | {# This is a copy-and-paste of sphinx_rtd_theme/footer.html.
 2 |    The only difference is the single <hr/> tag above the navigation buttons.
 3 |    A lot of copied code, but couldn't figure out how to insert the tag otherwise.
 4 |    (Bača.)
 5 | #}
 6 | 
 7 | <footer>
 8 |   {% if (theme_prev_next_buttons_location == 'bottom' or theme_prev_next_buttons_location == 'both') and (next or prev) %}
 9 |     <hr/>
10 |     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
11 |       {% if next %}
12 |         <a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}" accesskey="n" rel="next">{{ _('Next') }} <span class="fa fa-arrow-circle-right"></span></a>
13 |       {% endif %}
14 |       {% if prev %}
15 |         <a href="{{ prev.link|e }}" class="btn btn-neutral float-left" title="{{ prev.title|striptags|e }}" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> {{ _('Previous') }}</a>
16 |       {% endif %}
17 |     </div>
18 |   {% endif %}
19 | 
20 |   <hr/>
21 | 
22 |   <div role="contentinfo">
23 |     <p>
24 |     {%- if show_copyright %}
25 |       {%- if hasdoc('copyright') %}
26 |         {% set path = pathto('copyright') %}
27 |         {% set copyright = copyright|e %}
28 |         &copy; <a href="{{ path }}">{% trans %}Copyright{% endtrans %}</a> {{ copyright }}
29 |       {%- else %}
30 |         {% set copyright = copyright|e %}
31 |         &copy; {% trans %}Copyright{% endtrans %} {{ copyright }}
32 |       {%- endif %}
33 |     {%- endif %}
34 | 
35 |     {%- if build_id and build_url %}
36 |       <span class="build">
37 |         {# Translators: Build is a noun, not a verb #}
38 |         {% trans %}Build{% endtrans %}
39 |         <a href="{{ build_url }}">{{ build_id }}</a>.
40 |       </span>
41 |     {%- elif commit %}
42 |       <span class="commit">
43 |         {# Translators: the phrase "revision" comes from Git, referring to a commit #}
44 |         {% trans %}Revision{% endtrans %} <code>{{ commit }}</code>.
45 |       </span>
46 |     {%- elif last_updated %}
47 |       <span class="lastupdated">
48 |         {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
49 |       </span>
50 |     {%- endif %}
51 | 
52 |     </p>
53 |   </div>
54 | 
55 |   {%- if show_sphinx %}
56 |     {% set sphinx_web = '<a href="http://sphinx-doc.org/">Sphinx</a>' %}
57 |     {% set readthedocs_web = '<a href="https://readthedocs.org">Read the Docs</a>'  %}
58 |     {# Translators: the variable "sphinx_web" is a link to the Sphinx project documentation with the text "Sphinx" #}
59 |     {% trans sphinx_web=sphinx_web, readthedocs_web=readthedocs_web %}Built with {{ sphinx_web }} using a{% endtrans %}
60 |     {# Translators: "theme" refers to a theme for Sphinx, which alters the appearance of the generated documenation #}
61 |     <a href="https://github.com/rtfd/sphinx_rtd_theme">{% trans %}theme{% endtrans %}</a>
62 |     {# Translators: this is always used as "provided by Read the Docs", and should not imply Read the Docs is an author of the generated documentation. #}
63 |     {% trans %}provided by {{ readthedocs_web }}{% endtrans %}.
64 |   {%- endif %}
65 | 
66 |   {%- block extrafooter %} {% endblock %}
67 | 
68 | </footer>
69 | 
70 | 


--------------------------------------------------------------------------------
/docs/source/_templates/layout.html:
--------------------------------------------------------------------------------
 1 | {# This is a copy-and-paste of two blocks in sphinx_rtd_theme/layout.html.
 2 |    First block is sidebartitle:
 3 |      Abjad moves version number to appear after project name.
 4 |    Second block is content:
 5 |      Abjad changes nothing in content block;
 6 |      Content block duplicated here to correctly include local footer.html file.
 7 |    (Bača)
 8 | #}
 9 | 
10 | {%- extends "sphinx_rtd_theme/layout.html" %}
11 | 
12 | {% block sidebartitle %}
13 | 
14 | {% if logo and theme_logo_only %}
15 |     <a href="{{ pathto(master_doc) }}">
16 | {% else %}
17 |     <a href="{{ pathto(master_doc) }}" class="icon icon-home" alt="{{ _("Documentation
18 |     Home") }}"> {{ project }} {{ version }}
19 | {% endif %}
20 | 
21 | {% if logo %}
22 |     <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="{{ _('Logo') }}"/>
23 | {% endif %}
24 | </a>
25 | 
26 | {% if theme_display_version %}
27 |     {%- set nav_version = version %}
28 |     {% if READTHEDOCS and current_version %}
29 |         {%- set nav_version = current_version %}
30 |     {% endif %}
31 |     {% if nav_version %}
32 |         <div class="version">
33 |             {{ nav_version }}
34 |         </div>
35 |     {% endif %}
36 | {% endif %}
37 | 
38 | {% include "searchbox.html" %}
39 | 
40 | {% endblock %}
41 | 
42 | 
43 | 
44 | {%- block content %}
45 | {% if theme_style_external_links|tobool %}
46 | <div class="rst-content style-external-links">
47 | {% else %}
48 | <div class="rst-content">
49 | {% endif %}
50 |     {% include "breadcrumbs.html" %}
51 |     <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
52 |     {%- block document %}
53 |     <div itemprop="articleBody">
54 |     {% block body %}{% endblock %}
55 |     </div>
56 |     {% if self.comments()|trim %}
57 |     <div class="articleComments">
58 |     {% block comments %}{% endblock %}
59 |     </div>
60 |     {% endif%}
61 |     </div>
62 |     {%- endblock %}
63 |     {% include "footer.html" %}
64 | </div>
65 | {%- endblock %}
66 | 


--------------------------------------------------------------------------------
/docs/source/appendices/changes.rst:
--------------------------------------------------------------------------------
 1 | Changes
 2 | =======
 3 | 
 4 | ..
 5 | 
 6 | ----
 7 | 
 8 | Use the links below for a summary changes in past releases:
 9 | 
10 | https://github.com/Abjad/abjad/releases/tag/v3.7 (2022-04-06)
11 | 
12 | https://github.com/Abjad/abjad/releases/tag/v3.6 (2022-03-01)
13 | 
14 | https://github.com/Abjad/abjad/releases/tag/v3.5 (2022-02-01)
15 | 
16 | https://github.com/Abjad/abjad/releases/tag/v3.4 (2021-05-01)
17 | 
18 | https://github.com/Abjad/abjad/releases/tag/v3.3 (2021-03-01)
19 | 
20 | https://github.com/Abjad/abjad/releases/tag/v3.2 (2021-01-19)
21 | 
22 | https://github.com/Abjad/abjad/releases/tag/v3.1 (2019-12-18)
23 | 
24 | https://github.com/Abjad/abjad/releases/tag/v3.0.0 (2018-07-29)
25 | 
26 | https://github.com/Abjad/abjad/releases/tag/v2.21 (2017-08-04)
27 | 
28 | https://github.com/Abjad/abjad/releases/tag/v2.20 (2017-05-04)
29 | 
30 | https://github.com/Abjad/abjad/releases/tag/v2.19 (2016-10-23)
31 | 
32 | https://github.com/Abjad/abjad/releases/tag/2.18 (2016-07-08)
33 | 
34 | https://github.com/Abjad/abjad/releases/tag/2.17 (2016-08-25)
35 | 
36 | https://github.com/Abjad/abjad/releases/tag/2.16 (2016-04-25)
37 | 
38 | https://github.com/Abjad/abjad/releases/tag/2.15 (2014-08-08)
39 | 
40 | https://github.com/Abjad/abjad/releases/tag/2.14 (2013-12-27)
41 | 


--------------------------------------------------------------------------------
/docs/source/appendices/community.rst:
--------------------------------------------------------------------------------
 1 | ..  _appendix-community:
 2 | 
 3 | Community
 4 | =========
 5 | 
 6 | The Abjad mailing list is hosted on Google Groups. The list is moderated.
 7 | Follow the instructions on this Google Groups page to join:
 8 | 
 9 | https://groups.google.com/g/abjad-user
10 | 
11 | Abjad encourages contributions, discussions and usage from all people
12 | interested in music and computers. This encouragement extends to all people
13 | regardless of gender, race, sexual orientation, disability, religion,
14 | appearance, veteran status, gender identity, socioeconomic status or
15 | nationality. Members of the community strive to be friendly, patient and
16 | welcoming, especially of viewpoints and experiences different from our own. We
17 | reject harassment and contributions that belittle individuals or groups of
18 | people. We ask all members of the community to be mindful particularly about
19 | assumptions of the gender of users. Violations of this code will result in
20 | users being asked to apologize; repeated violations may result in users being
21 | asked to leave the community. Please contact trevor.baca@gmail.com if you
22 | notice problems that should be corrected. Confidentiality will always be
23 | respected. We are proud of the overwhelming positivity and helpfulness of Abjad
24 | users, developers and contributors everywhere. And we gratefully acknowledge
25 | the example of our friends at `music21
26 | <https://github.com/cuthbertLab/music21>`_ from whom this text was adapted.
27 | 
28 | ----
29 | 
30 | Visit Abjad's GitHub repository here:
31 | 
32 | https://github.com/Abjad/abjad
33 | 


--------------------------------------------------------------------------------
/docs/source/appendices/configuration.rst:
--------------------------------------------------------------------------------
 1 | Configuration
 2 | =============
 3 | 
 4 | Abjad creates a ``~/.abjad`` directory the first time it runs. In the ``~/.abjad``
 5 | directory you will find an ``abjad.cfg`` file. This is the Abjad configuration file. You
 6 | can use the Abjad configuration file to tell Abjad about your preferred PDF file viewer,
 7 | MIDI player, LilyPond language and so on.
 8 | 
 9 | Your configuration file will look something like this the first time you open it:
10 | 
11 | ::
12 | 
13 |     # Abjad configuration file created by Abjad on 31 January 2014 00:08:17.
14 |     # File is interpreted by ConfigObj and should follow ini syntax.
15 | 
16 |     # Set to the directory where all Abjad-generated files
17 |     # (such as PDFs and LilyPond files) should be saved.
18 |     # Defaults to $HOME.abjad/output/
19 |     abjad_output_directory = /Users/username/.abjad/output
20 | 
21 |     # Comma-separated list of LilyPond files that 
22 |     # Abjad will "\include" in all generated *.ly files
23 |     lilypond_includes = ,
24 | 
25 |     # Language to use in all generated LilyPond files.
26 |     lilypond_language = english
27 | 
28 |     # Lilypond executable path. Set to override dynamic lookup.
29 |     lilypond_path = lilypond
30 | 
31 |     # MIDI player to open MIDI files.
32 |     # When unset your OS should know how to open MIDI files.
33 |     midi_player = 
34 | 
35 |     # PDF viewer to open PDF files.
36 |     # When unset your OS should know how to open PDFs.
37 |     pdf_viewer = 
38 | 
39 |     # Text editor to edit text files.
40 |     # When unset your OS should know how to open text files.
41 |     text_editor = 
42 | 
43 | Follow the basics of ``ini`` syntax when editing the Abjad configuration file. Background
44 | information is available at http://en.wikipedia.org/wiki/INI_file. Under macOS you might
45 | want to set you ``midi_player`` to iTunes. Under Linux you might want to set your
46 | ``pdf_viewer`` to ``evince`` and your ``midi_player`` to ``tiMIDIty``, and so on.
47 | 


--------------------------------------------------------------------------------
/docs/source/appendices/developer-installation.rst:
--------------------------------------------------------------------------------
 1 | Developer installation
 2 | ======================
 3 | 
 4 | What's the difference between "packaged" and "cloned" installation? How can a local build
 5 | of Abjad's docs be made for viewing offline?
 6 | 
 7 | "Packaged" versus "cloned" installs of Abjad
 8 | --------------------------------------------
 9 | 
10 | The majority of users install Abjad from the Python Package Index:
11 | 
12 | https://abjad.github.io/first_steps/macos.html
13 | 
14 | https://abjad.github.io/first_steps/linux.html
15 | 
16 | "Packaged" installation of Abjad is recommended for most users. Python installs the
17 | current release of Abjad into the site-packages directory of the Python virtual
18 | environment active at the time of installation. Installing Abjad from package means that
19 | a user intends to compose with Abjad, but not develop Abjad.
20 | 
21 | Abjad can be installed another way, too. Clone Abjad from GitHub and then use pip to
22 | install the clone in "editable" mode:
23 | 
24 | ..  code-block:: bash
25 | 
26 |     ~$ git clone https://github.com/Abjad/abjad.git
27 |     ~$ cd abjad
28 |     abjad$ python -m pip install --editable .[dev]
29 | 
30 | "Cloned" installation of Abjad is necessary for users who want to develop Abjad. Cloned
31 | installation is also required for users who want to build Abjad's docs locally.
32 | 
33 | Building Abjad's docs locally
34 | -----------------------------
35 | 
36 | The most recent version of Abjad's docs is hosted here:
37 | 
38 | https://abjad.github.io/
39 | 
40 | This means that most users do not need to build Abjad's docs locally. Users who do want
41 | to build Abjad's docs locally should clone and install Abjad as shown above. Then make
42 | sure `TeXLive`_ and `Graphviz`_ are installed.
43 | 
44 | To install Graphviz on macOS via Homebrew:
45 | 
46 | ..  code-block:: bash
47 | 
48 |     ~$ brew install graphviz
49 | 
50 | To install Graphviz on Debian and Ubuntu:
51 | 
52 | ..  code-block:: bash
53 | 
54 |     ~$ sudo apt-get install graphviz
55 | 
56 | To check that Graphviz is callable from the commandline after install:
57 | 
58 | ..  code-block:: bash
59 | 
60 |     ~$ dot -V
61 |     dot - graphviz version 2.40.1 (20161225.0304)
62 | 
63 | Make a local version of the docs like this:
64 | 
65 | ..  code-block:: bash
66 | 
67 |     ~$ cd path/to/abjad/docs
68 |     ~$ make html
69 | 
70 | The build process takes a long time the first time it runs. Finished output is available
71 | here:
72 | 
73 | ..  code-block:: bash
74 | 
75 |     ~$ ls path/to/abjad/docs/build/html
76 |     _images           _static           gallery-2010.html objects.inv       sidebar.html
77 |     _modules          api               gallery-2015.html overview          welcome
78 |     _mothballed       appendices        gallery-2020.html py-modindex.html
79 |     _pending          examples          genindex.html     search.html
80 |     _sources          first_steps       index.html        searchindex.js
81 | 
82 | Browse ``file:///path/to//abjad/docs/build/html/index.html`` to naviagate the build.
83 | 
84 | ..  _Graphviz: http://graphviz.org/
85 | ..  _Sphinx: http://sphinx-doc.org/
86 | ..  _TeXLive: https://www.tug.org/texlive/
87 | 


--------------------------------------------------------------------------------
/docs/source/appendices/publications.rst:
--------------------------------------------------------------------------------
 1 | Publications
 2 | ============
 3 | 
 4 | A number of publications discussing Abjad are available for download here:
 5 | 
 6 | * Bača, Trevor, Joséphine Wolf Oberholtzer, Jeffrey Treviño and Víctor Adán.
 7 |   `"Abjad: An Open-Software System For Formalized Score Control."
 8 |   <https://github.com/Abjad/tenor2015/blob/master/abjad.pdf>`_
 9 |   Proceedings of the First International Conference on Technologies for Music
10 |   Notation and Representation. 2015.
11 | 
12 | * Davancens, Joseph.
13 |   `"Heave, Sway, Surge."
14 |   <https://github.com/jdavancens/dissertationpdf/blob/master/Heave%2C%20Sway%2C%20Surge%20-%20Essay.pdf>`_
15 |   Doctoral dissertation,
16 |   University of California, Santa Cruz.
17 |   2019.
18 | 
19 | * Evans, Gregory Rowland.
20 |   `"An introduction to modeling composition through Abjad's model of music notation."
21 |   <https://github.com/GregoryREvans/thesis/blob/master/An_Introduction_to_Modeling_Composition_through_Abjad's_Model_of_Music_Notation.pdf>`_
22 |   Master's thesis,
23 |   University of Miami.
24 |   2019.
25 | 
26 | * Oberholtzer, Joséphine Wolf.
27 |   `A Computational Model of Music Composition.
28 |   <http://dash.harvard.edu/handle/1/17463123>`_
29 |   Doctoral dissertation,
30 |   Harvard University,
31 |   Graduate School of Arts & Sciences.
32 |   2015.
33 | 
34 | * Treviño, Jeffrey Robert.
35 |   `Compositional and analytic applications of automated music notation via
36 |   object-oriented programming.
37 |   <https://escholarship.org/uc/item/3kk9b4rv.pdf>`_
38 |   Doctoral dissertation,
39 |   University of California, San Diego.
40 |   2013.
41 | 


--------------------------------------------------------------------------------
/docs/source/conf.py:
--------------------------------------------------------------------------------
  1 | import os
  2 | import pathlib
  3 | import re
  4 | import sys
  5 | 
  6 | import abjad
  7 | 
  8 | sys.path.insert(0, os.path.abspath("../../source"))
  9 | version_file = pathlib.Path("../../source/abjad/_version.py").read_text()
 10 | match = re.search(r'__version__ = ["\'](.+?)["\']', version_file)
 11 | version = match.group(1) if match else "unknown"
 12 | 
 13 | autodoc_member_order = "groupwise"
 14 | 
 15 | copyright = "2008-2025, Trevor Bača & Joséphine Oberholtzer."
 16 | 
 17 | extensions = [
 18 |     "abjad.ext.sphinx",
 19 |     "sphinx.ext.autodoc",
 20 |     "sphinx.ext.autosummary",
 21 |     "sphinx.ext.coverage",
 22 |     "sphinx.ext.doctest",
 23 |     "sphinx.ext.graphviz",
 24 |     "sphinx.ext.intersphinx",
 25 |     "sphinx.ext.todo",
 26 |     "sphinx.ext.viewcode",
 27 |     "sphinx_toggleprompt",
 28 |     "uqbar.sphinx.api",
 29 |     "uqbar.sphinx.book",
 30 |     "uqbar.sphinx.inheritance",
 31 |     "uqbar.sphinx.style",
 32 | ]
 33 | 
 34 | graphviz_dot_args = ["-s32"]
 35 | graphviz_output_format = "svg"
 36 | 
 37 | html_favicon = "_static/favicon.ico"
 38 | html_last_updated_fmt = "%b %d, %Y"
 39 | html_logo = "_static/abjad-logo.png"
 40 | html_show_sphinx = False
 41 | html_static_path = ["_static"]
 42 | html_theme = "sphinx_rtd_theme"
 43 | html_theme_options = {
 44 |     "canonical_url": "https://abjad.github.io",
 45 |     "navigation_depth": 1,
 46 |     "sticky_navigation": False,
 47 |     "style_external_links": True,
 48 |     "style_nav_header_background": "#996633",
 49 | }
 50 | 
 51 | intersphinx_mapping = {
 52 |     "python": ("https://docs.python.org/3", None),
 53 |     "sphinx": ("http://www.sphinx-doc.org/en/master/", None),
 54 | }
 55 | 
 56 | project = "Abjad"
 57 | pygments_style = "sphinx"
 58 | 
 59 | release = version
 60 | rst_epilog = """
 61 | ..  _Bača: https://github.com/trevorbaca
 62 | ..  _Florian Hollerweger: https://www.hfmt-koeln.de/musik/lehrende-musik/prof-dr-florian-hollerweger/
 63 | ..  _Fredrik Wallberg: http://quesebifurcan.github.io/music
 64 | ..  _Gilberto Agostinho: https://soundcloud.com/gilberto-agostinho
 65 | ..  _Jeffrey Treviño: https://soundcloud.com/jefftrevino
 66 | ..  _Joséphine Wolf Oberholtzer: http://josephine-wolf-oberholtzer.com
 67 | ..  _Gregory Rowland Evans: http://www.gregoryrowlandevans.com
 68 | ..  _Oberholtzer: https://github.com/josephine-wolf-oberholtzer
 69 | ..  _Trevor Bača: http://www.trevorbaca.com
 70 | """
 71 | rst_prolog = """
 72 | ..  role:: author
 73 | """
 74 | 
 75 | smartquotes = True
 76 | 
 77 | templates_path = ["_templates"]
 78 | todo_include_todos = True
 79 | 
 80 | uqbar_api_member_documenter_classes = [
 81 |     "uqbar.apis.FunctionDocumenter",
 82 |     "uqbar.apis.SummarizingClassDocumenter",
 83 | ]
 84 | uqbar_api_module_documenter_class = "uqbar.apis.SummarizingModuleDocumenter"
 85 | uqbar_api_root_documenter_class = "uqbar.apis.SummarizingRootDocumenter"
 86 | uqbar_api_source_paths = ["abjad"]
 87 | uqbar_api_title = "Abjad API"
 88 | uqbar_book_console_setup = [
 89 |     "import abjad",
 90 |     "from fractions import Fraction",
 91 | ]
 92 | uqbar_book_console_teardown = []
 93 | uqbar_book_extensions = [
 94 |     "uqbar.book.extensions.GraphExtension",
 95 |     "abjad.ext.sphinx.LilyPondExtension",
 96 | ]
 97 | uqbar_book_strict = False
 98 | uqbar_book_use_black = True
 99 | uqbar_book_use_cache = True
100 | 
101 | version = abjad.__version__
102 | 


--------------------------------------------------------------------------------
/docs/source/examples/images/mozart-tables.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/examples/images/mozart-tables.png


--------------------------------------------------------------------------------
/docs/source/examples/score-fragment-piano.rst:
--------------------------------------------------------------------------------
 1 | Score fragment, piano
 2 | =====================
 3 | 
 4 | ..
 5 | 
 6 | ----
 7 | 
 8 | Here's one way of modeling piano music with a bit of polyphony in the left hand.
 9 | 
10 | Make an empty score:
11 | 
12 | ::
13 | 
14 |     >>> rh_voice = abjad.Voice(name="RH_Voice")
15 |     >>> rh_staff = abjad.Staff([rh_voice], name="RH_Staff")
16 |     >>> lh_voice_1 = abjad.Voice(name="LH_Voice_1")
17 |     >>> lh_voice_2 = abjad.Voice(name="LH_Voice_2")
18 |     >>> lh_staff = abjad.Staff(name="LH_Staff", simultaneous=True)
19 |     >>> lh_staff.extend([lh_voice_1, lh_voice_2])
20 |     >>> piano_staff = abjad.StaffGroup(lilypond_type="PianoStaff", name="Piano_Staff")
21 |     >>> piano_staff.extend([rh_staff, lh_staff])
22 |     >>> score = abjad.Score([piano_staff], name="Score")
23 | 
24 | Type LilyPond input:
25 | 
26 | ::
27 | 
28 |     >>> rh = r"""
29 |     ...     a'8 \pp [ ( g' f' e' ] d'4 )
30 |     ...     g'8 \mp [ ( f' e' d' ] c'8 \< d'16 e' f'8 e' \! d'2 \> ~ d' \! )
31 |     ... """
32 |     >>> lh_1 = r"s1 * 2/4 s1 * 3/4 s1 * 2/4 \voiceOne b2 ~ b"
33 |     >>> lh_2 = r"""
34 |     ...     b4 d'8 \pp [ ( c' b a ] af4 )
35 |     ...     c'8 \mp [ ( bf a g ] fs g16 a16 \voiceTwo b4 a g2 )
36 |     ... """
37 | 
38 | Extend the voices:
39 | 
40 | ::
41 | 
42 |     >>> rh_voice.extend(rh)
43 |     >>> lh_voice_1.extend(lh_1)
44 |     >>> lh_voice_2.extend(lh_2)
45 | 
46 | Attach time signatures:
47 | 
48 | ::
49 | 
50 |     >>> time_signature = abjad.TimeSignature((2, 4))
51 |     >>> note = abjad.select.note(rh_voice, 0)
52 |     >>> abjad.attach(time_signature, note)
53 |     >>> time_signature = abjad.TimeSignature((3, 4))
54 |     >>> note = abjad.select.note(rh_voice, 4)
55 |     >>> abjad.attach(time_signature, note)
56 |     >>> time_signature = abjad.TimeSignature((2, 4))
57 |     >>> note = abjad.select.note(rh_voice, 9)
58 |     >>> abjad.attach(time_signature, note)
59 | 
60 | Attach a clef and final bar line:
61 | 
62 | ::
63 | 
64 |     >>> clef = abjad.Clef("bass")
65 |     >>> note = abjad.select.note(lh_voice_2, 0)
66 |     >>> abjad.attach(clef, note)
67 |     >>> bar_line = abjad.BarLine("|.")
68 |     >>> note = abjad.select.note(lh_voice_2, -1)
69 |     >>> abjad.attach(bar_line, note)
70 | 
71 | Override LilyPond's hairpin formatting:
72 | 
73 |     >>> note = abjad.select.note(rh_voice, -2)
74 |     >>> abjad.override(note).Hairpin.to_barline = False
75 |     >>> abjad.show(score)
76 | 
77 | :author:`[Adán (1.1), Bača (3.2); ex. Béla Bartók, "Wandering," Mikrokosmos, vol. III]`
78 | 


--------------------------------------------------------------------------------
/docs/source/first_steps/audience.rst:
--------------------------------------------------------------------------------
 1 | Audience
 2 | ========
 3 | 
 4 | Unlike `Max <https://cycling74.com/products/max>`_, `OpenMusic
 5 | <http://repmus.ircam.fr/openmusic/home>`_ or `Pure Data <https://puredata.info/>`_, Abjad
 6 | is not a stand-alone piece of consumer software: Abjad provides no graphic user
 7 | interface, and Abjad provides no audio output beyond LilyPond's built-in MIDI
 8 | functionality. Abjad is for making PDFs of music meant for human musicians, and for doing
 9 | this with the techniques of computer programming. Abjad does this by extending the Python
10 | programming language with a set of classes and functions. Abjad's classes and functions
11 | "teach" Python about music notation. You can think of Abjad as a Python API for building
12 | LilyPond files. You can also think of Abjad as an API for working with data structures
13 | that model music notation. When you compose with Abjad you can:
14 | 
15 | * Model compositional thinking programmatically.
16 | * Generate precompositional material programmatically.
17 | * Generate complete scores programmatically.
18 | * Create musical objects with a subset of LilyPond's input language.
19 | * Inspect derived properties of the objects you create.
20 | * Iterate objects with Abjad's selectors.
21 | * Style everything with LilyPond.
22 | 
23 | The primary intuition behind Abjad is that music tends to be full of patterns, and
24 | composers should be able to work programmatically with the patterned parts of music we
25 | compose. Abjad provides an interface to this type of thinking: string manipulation,
26 | pattern matching, all the techniques of programming become available as parts of
27 | music composition.
28 | 
29 | Do you have to know LilyPond to work with Abjad? Yes, though you can get started without
30 | being an expert LilyPond user. Styling the notation you produce with Abjad means styling
31 | notation with LilyPond:
32 | 
33 | https://lilypond.org/doc/v2.20/Documentation/learning/tutorial 
34 | 
35 | Do you have to know Python to work with Abjad? Yes, though again you can get started
36 | without being an expert Python programmer. Working with Abjad means adding computer
37 | programming to the practice of music composition:
38 | 
39 | https://docs.python.org/3/tutorial/
40 | 


--------------------------------------------------------------------------------
/docs/source/first_steps/install.rst:
--------------------------------------------------------------------------------
 1 | Check Python
 2 | ------------
 3 | 
 4 | Abjad requires Python 3.12 or later:
 5 | 
 6 | ..  code-block::
 7 | 
 8 |     ~$ python --version
 9 |     Python 3.12.8
10 | 
11 | Check LilyPond
12 | --------------
13 | 
14 | Abjad requires LilyPond 2.23.6 or later.
15 | 
16 | Make sure LilyPond is installed: http://lilypond.org/development.html
17 | 
18 | Make sure LilyPond is callable from the commandline:
19 | 
20 | ..  code-block::
21 | 
22 |     ~$ lilypond --version
23 |     GNU LilyPond 2.23.22
24 | 
25 |     Copyright (c) 1996--2023 by
26 |     Han-Wen Nienhuys <hanwen@xs4all.nl>
27 |     Jan Nieuwenhuizen <janneke@gnu.org>
28 |     and others.
29 | 
30 |     This program is free software.  It is covered by the GNU General Public
31 |     License and you are welcome to change it and/or distribute copies of it
32 |     under certain conditions.  Invoke as `lilypond --warranty' for more
33 |     information.
34 | 
35 | Install Abjad in a Python 3 virtual environment
36 | -----------------------------------------------
37 | 
38 | Create a Python 3 virtual environment for Abjad:
39 | https://docs.python.org/3/tutorial/venv.html
40 | 
41 | Activate the virtual environment and then use pip to install Abjad:
42 | 
43 | ..  code-block::
44 | 
45 |     ~$ python -m pip install abjad
46 | 


--------------------------------------------------------------------------------
/docs/source/first_steps/linux.rst:
--------------------------------------------------------------------------------
1 | Linux
2 | =====
3 | 
4 | ..  include:: /first_steps/install.rst
5 | 


--------------------------------------------------------------------------------
/docs/source/first_steps/macos.rst:
--------------------------------------------------------------------------------
1 | macOS
2 | =====
3 | 
4 | ..  include:: /first_steps/install.rst
5 | 


--------------------------------------------------------------------------------
/docs/source/first_steps/windows.rst:
--------------------------------------------------------------------------------
 1 | Windows
 2 | =======
 3 | 
 4 | Check Python
 5 | ------------
 6 | 
 7 | Abjad requires Python 3.12 or later:
 8 | 
 9 | ..  code-block::
10 | 
11 |     > py --version
12 |     Python 3.12.8
13 | 
14 | Check LilyPond
15 | --------------
16 | 
17 | Abjad requires LilyPond 2.23.6 or later.
18 | 
19 | Make sure LilyPond is installed: http://lilypond.org/development.html
20 | 
21 | When installing LilyPond, first unzip the archive downloaded from the site above.
22 | 
23 | You should get a directory like ``lilypond-2.23.22``.
24 | 
25 | Move the resulting folder to ``C:\Program Files (x86)``.
26 | 
27 | Add ``C:\Program Files (x86)\Lilypond/bin`` to the Windows path.
28 | 
29 | Make sure LilyPond is callable from the commandline:
30 | 
31 | ..  code-block::
32 | 
33 |     > lilypond --version
34 |     GNU LilyPond 2.23.22
35 | 
36 |     Copyright (c) 1996--2023 by
37 |     Han-Wen Nienhuys <hanwen@xs4all.nl>
38 |     Jan Nieuwenhuizen <janneke@gnu.org>
39 |     and others.
40 | 
41 |     This program is free software.  It is covered by the GNU General Public
42 |     License and you are welcome to change it and/or distribute copies of it
43 |     under certain conditions.  Invoke as `lilypond --warranty' for more
44 |     information.
45 | 
46 | Install Abjad in a Python 3 virtual environment
47 | -----------------------------------------------
48 | 
49 | Create a Python 3 virtual environment for Abjad:
50 | https://docs.python.org/3/tutorial/venv.html
51 | 
52 | ..  code-block::
53 | 
54 |     > py -m venv FirstAbjad
55 | 
56 | Activate the virtual environment:
57 | 
58 | ..  code-block::
59 | 
60 |     > FirstAbjad\Scripts\activate
61 | 
62 | Update pip:
63 | 
64 | ..  code-block::
65 | 
66 |     > py -m pip install --upgrade pip
67 | 
68 | Install Abjad:
69 | 
70 | ..  code-block::
71 | 
72 |     > py -m pip install abjad
73 | 
74 | Test installation:
75 | 
76 | ..  code-block::
77 | 
78 |     > py
79 |     > import abjad
80 |     > note = abjad.Note("c'4")
81 |     > abjad.show(note)
82 | 
83 | :author:`[Hollerweger (3.20).]`
84 | 


--------------------------------------------------------------------------------
/docs/source/gallery/agostinho-cartography-11-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/agostinho-cartography-11-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/agostinho-cartography-11-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/agostinho-cartography-11-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/agostinho-cartography-11-page-5-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/agostinho-cartography-11-page-5-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/agostinho-cartography-11-page-5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/agostinho-cartography-11-page-5.png


--------------------------------------------------------------------------------
/docs/source/gallery/agostinho-whtt-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/agostinho-whtt-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/agostinho-whtt-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/agostinho-whtt-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/agostinho-whtt-page-5-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/agostinho-whtt-page-5-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/agostinho-whtt-page-5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/agostinho-whtt-page-5.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-akasha-page-7-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-akasha-page-7-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-akasha-page-7.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-akasha-page-7.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-akasha-page-8-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-akasha-page-8-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-akasha-page-8.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-akasha-page-8.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-archipel-page-10-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-archipel-page-10-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-archipel-page-10.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-archipel-page-10.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-archipel-page-9-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-archipel-page-9-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-archipel-page-9.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-archipel-page-9.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-cary-page-5-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-cary-page-5-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-cary-page-5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-cary-page-5.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-cary-page-6-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-cary-page-6-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-cary-page-6.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-cary-page-6.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-desir-page-14-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-desir-page-14-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-desir-page-14.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-desir-page-14.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-desir-page-15-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-desir-page-15-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-desir-page-15.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-desir-page-15.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-dornen-page-1-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-dornen-page-1-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-dornen-page-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-dornen-page-1.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-dornen-page-2-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-dornen-page-2-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-dornen-page-2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-dornen-page-2.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-faberge-page-1-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-faberge-page-1-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-faberge-page-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-faberge-page-1.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-faberge-page-36-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-faberge-page-36-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-faberge-page-36.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-faberge-page-36.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-harmony-page-10-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-harmony-page-10-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-harmony-page-10.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-harmony-page-10.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-harmony-page-29-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-harmony-page-29-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-harmony-page-29.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-harmony-page-29.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-huitzil-page-12-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-huitzil-page-12-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-huitzil-page-12.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-huitzil-page-12.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-huitzil-page-13-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-huitzil-page-13-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-huitzil-page-13.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-huitzil-page-13.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-ikribu-page-16-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-ikribu-page-16-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-ikribu-page-16.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-ikribu-page-16.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-ikribu-page-17-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-ikribu-page-17-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-ikribu-page-17.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-ikribu-page-17.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-imaginaire-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-imaginaire-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-imaginaire-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-imaginaire-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-imaginaire-page-5-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-imaginaire-page-5-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-imaginaire-page-5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-imaginaire-page-5.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-ins-wasser-page-3-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-ins-wasser-page-3-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-ins-wasser-page-3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-ins-wasser-page-3.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-ins-wasser-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-ins-wasser-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-ins-wasser-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-ins-wasser-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-khamr-page-10-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-khamr-page-10-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-khamr-page-10.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-khamr-page-10.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-khamr-page-11-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-khamr-page-11-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-khamr-page-11.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-khamr-page-11.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-krummzeit-page-80-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-krummzeit-page-80-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-krummzeit-page-80.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-krummzeit-page-80.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-krummzeit-page-81-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-krummzeit-page-81-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-krummzeit-page-81.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-krummzeit-page-81.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-lidercfeny-page-22-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-lidercfeny-page-22-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-lidercfeny-page-22.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-lidercfeny-page-22.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-lidercfeny-page-23-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-lidercfeny-page-23-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-lidercfeny-page-23.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-lidercfeny-page-23.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-mraz-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-mraz-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-mraz-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-mraz-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-mraz-page-5-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-mraz-page-5-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-mraz-page-5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-mraz-page-5.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-myrkr-page-1-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-myrkr-page-1-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-myrkr-page-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-myrkr-page-1.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-myrkr-page-2-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-myrkr-page-2-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-myrkr-page-2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-myrkr-page-2.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-naehte-page-1-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-naehte-page-1-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-naehte-page-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-naehte-page-1.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-naehte-page-2-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-naehte-page-2-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-naehte-page-2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-naehte-page-2.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-poeme-recursif-page-3-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-poeme-recursif-page-3-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-poeme-recursif-page-3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-poeme-recursif-page-3.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-poeme-recursif-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-poeme-recursif-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-poeme-recursif-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-poeme-recursif-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-sekka-page-5-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-sekka-page-5-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-sekka-page-5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-sekka-page-5.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-sekka-page-6-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-sekka-page-6-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-sekka-page-6.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-sekka-page-6.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-traiettorie-page-6-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-traiettorie-page-6-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-traiettorie-page-6.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-traiettorie-page-6.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-traiettorie-page-7-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-traiettorie-page-7-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/baca-traiettorie-page-7.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/baca-traiettorie-page-7.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-adumbration-page-11-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-adumbration-page-11-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-adumbration-page-11.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-adumbration-page-11.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-adumbration-page-7-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-adumbration-page-7-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-adumbration-page-7.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-adumbration-page-7.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-chalk-line-page-1-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-chalk-line-page-1-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-chalk-line-page-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-chalk-line-page-1.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-chalk-line-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-chalk-line-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-chalk-line-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-chalk-line-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-hamonshu-page-1-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-hamonshu-page-1-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-hamonshu-page-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-hamonshu-page-1.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-hamonshu-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-hamonshu-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/evans-hamonshu-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/evans-hamonshu-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-armilla-page-8-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-armilla-page-8-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-armilla-page-8.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-armilla-page-8.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-armilla-page-9-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-armilla-page-9-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-armilla-page-9.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-armilla-page-9.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-aurora-page-6-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-aurora-page-6-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-aurora-page-6.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-aurora-page-6.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-aurora-page-7-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-aurora-page-7-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-aurora-page-7.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-aurora-page-7.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-demarest-page-19-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-demarest-page-19-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-demarest-page-19.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-demarest-page-19.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-demarest-page-28-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-demarest-page-28-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-demarest-page-28.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-demarest-page-28.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-ersilia-page-10-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-ersilia-page-10-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-ersilia-page-10.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-ersilia-page-10.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-ersilia-page-9-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-ersilia-page-9-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-ersilia-page-9.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-ersilia-page-9.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-lagartija-page-4-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-lagartija-page-4-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-lagartija-page-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-lagartija-page-4.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-lagartija-page-5-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-lagartija-page-5-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-lagartija-page-5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-lagartija-page-5.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-plague-water-page-12-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-plague-water-page-12-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-plague-water-page-12.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-plague-water-page-12.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-plague-water-page-13-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-plague-water-page-13-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-plague-water-page-13.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-plague-water-page-13.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-zaira-page-16-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-zaira-page-16-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-zaira-page-16.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-zaira-page-16.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-zaira-page-17-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-zaira-page-17-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/oberholtzer-zaira-page-17.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/oberholtzer-zaira-page-17.png


--------------------------------------------------------------------------------
/docs/source/gallery/trevino-refrain-page-1-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/trevino-refrain-page-1-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/trevino-refrain-page-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/trevino-refrain-page-1.png


--------------------------------------------------------------------------------
/docs/source/gallery/trevino-refrain-page-2-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/trevino-refrain-page-2-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/trevino-refrain-page-2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/trevino-refrain-page-2.png


--------------------------------------------------------------------------------
/docs/source/gallery/trevino-world-all-around-page-1-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/trevino-world-all-around-page-1-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/trevino-world-all-around-page-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/trevino-world-all-around-page-1.png


--------------------------------------------------------------------------------
/docs/source/gallery/trevino-world-all-around-page-2-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/trevino-world-all-around-page-2-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/trevino-world-all-around-page-2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/trevino-world-all-around-page-2.png


--------------------------------------------------------------------------------
/docs/source/gallery/wallberg-cartography-bass-flute-thumbnail.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/wallberg-cartography-bass-flute-thumbnail.png


--------------------------------------------------------------------------------
/docs/source/gallery/wallberg-cartography-bass-flute.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/docs/source/gallery/wallberg-cartography-bass-flute.png


--------------------------------------------------------------------------------
/docs/source/index.rst:
--------------------------------------------------------------------------------
 1 | Welcome
 2 | =======
 3 | 
 4 | ..  include:: welcome/welcome.rst
 5 | 
 6 | ..  toctree::
 7 |     :caption: First steps
 8 |     :hidden:
 9 | 
10 |     first_steps/audience
11 |     first_steps/macos
12 |     first_steps/linux
13 |     first_steps/windows
14 | 
15 | ..  toctree::
16 |     :caption: Overview
17 |     :hidden:
18 |     :maxdepth: 0
19 | 
20 |     overview/containers
21 |     overview/containers-basic-operations-on
22 |     overview/containers-retrieving-by-name
23 |     overview/containers-time-interpretation-of
24 |     overview/contexts-lilypond-type-of
25 |     overview/indicators
26 |     overview/lilypond-files-preamble-of
27 |     overview/lilypond-format-of-abjad-objects
28 | 
29 | ..  toctree::
30 |     :caption: Examples
31 |     :hidden:
32 | 
33 |     examples/corpus-selection
34 |     examples/design-by-dyads
35 |     examples/enumeration
36 |     examples/magic-square-from-twelve-tone-row
37 |     examples/scales-diatonic
38 |     examples/score-fragment-piano
39 | 
40 | ..  toctree::
41 |     :caption: All classes & functions
42 |     :hidden:
43 | 
44 |     api/index
45 | 
46 | ..  toctree::
47 |     :caption: Appendices
48 |     :hidden:
49 | 
50 |     appendices/best-practices
51 |     appendices/changes
52 |     appendices/community
53 |     appendices/configuration
54 |     appendices/developer-installation
55 |     appendices/lilypond-context-concatenation
56 |     appendices/publications
57 | 
58 | ..  toctree::
59 |     :caption: Score gallery
60 |     :hidden:
61 | 
62 |     gallery-2020
63 |     gallery-2015
64 |     gallery-2010
65 | 


--------------------------------------------------------------------------------
/docs/source/overview/containers-basic-operations-on.rst:
--------------------------------------------------------------------------------
  1 | Containers, basic operations on
  2 | ===============================
  3 | 
  4 | Abjad containers work like Python lists.
  5 | 
  6 | ----
  7 | 
  8 | ..  rubric:: Container properties
  9 | 
 10 | The length of a container is defined equal to the number of components in the container:
 11 | 
 12 | ::
 13 | 
 14 |     >>> container = abjad.Container("ds'16 cs'16 e'16 c'16 d'2 ~ d'8")
 15 |     >>> abjad.show(container)
 16 | 
 17 | ::
 18 | 
 19 |     >>> len(container)
 20 | 
 21 | ----
 22 | 
 23 | ..  rubric:: Iteration
 24 | 
 25 | Containers iterate their contents like lists:
 26 | 
 27 | ::
 28 | 
 29 |     >>> for item in container:
 30 |     ...     item
 31 | 
 32 | ----
 33 | 
 34 | ..  rubric:: Item getting
 35 | 
 36 | Item getting returns one component at a time:
 37 | 
 38 | ::
 39 | 
 40 |     >>> container[0]
 41 | 
 42 |     >>> container[1]
 43 | 
 44 |     >>> container[2]
 45 | 
 46 | Slicing returns a selection of components:
 47 | 
 48 | ::
 49 | 
 50 |     >>> container[:3]
 51 | 
 52 | ----
 53 | 
 54 | ..  rubric:: Containment testing
 55 |     
 56 | Containment testing and indexing work like lists:
 57 | 
 58 | ::
 59 | 
 60 |     >>> note = container[0]
 61 |     >>> note in container
 62 | 
 63 |     >>> container.index(note)
 64 | 
 65 |     >>> rest = abjad.Rest("r4")
 66 |     >>> rest in container
 67 | 
 68 | ----
 69 | 
 70 | ..  rubric:: Adding components
 71 | 
 72 | Append, extend and insert work like lists:
 73 | 
 74 | ::
 75 | 
 76 |     >>> container.append("af'32")
 77 |     >>> abjad.show(container)
 78 | 
 79 |     >>> container.extend("c''32 a'32")
 80 |     >>> abjad.show(container)
 81 | 
 82 |     >>> container.insert(-3, "g'32")
 83 |     >>> abjad.show(container)
 84 | 
 85 | ----
 86 | 
 87 | ..  rubric:: Removing components
 88 | 
 89 | And pop and remove work like lists, too:
 90 | 
 91 | ::
 92 | 
 93 |     >>> note = container.pop(-1)
 94 |     >>> abjad.show(container)
 95 | 
 96 |     >>> note = container[-1]
 97 |     >>> container.remove(note)
 98 |     >>> abjad.show(container)
 99 | 
100 | ..  The musical example on this page derives from Xenakis's Jalons (1986) for contrabass.
101 | 


--------------------------------------------------------------------------------
/docs/source/overview/containers-retrieving-by-name.rst:
--------------------------------------------------------------------------------
 1 | Containers, retrieving by name
 2 | ==============================
 3 | 
 4 | ..
 5 | 
 6 | ----
 7 | 
 8 | Assembling a score means nesting containers:
 9 | 
10 | ::
11 | 
12 |     >>> string = "d'8 f' a' d'' f'' gs'4 r8 e' gs' b' e'' gs'' a'4"
13 |     >>> voice = abjad.Voice(string, name="RH_Voice")
14 |     >>> staff = abjad.Staff([voice], name="RH_Staff")
15 |     >>> score = abjad.Score([staff], name="Score")
16 |     >>> abjad.show(score)
17 | 
18 | Use integer indices to retrieve nested containers:
19 | 
20 | ::
21 | 
22 |     >>> score[0]
23 | 
24 |     >>> score[0][0]
25 | 
26 | Or use container names:
27 | 
28 | ::
29 | 
30 |     >>> score["RH_Staff"]
31 | 
32 |     >>> score["RH_Voice"]
33 | 


--------------------------------------------------------------------------------
/docs/source/overview/containers-time-interpretation-of.rst:
--------------------------------------------------------------------------------
 1 | Containers, time interpretation of
 2 | ==================================
 3 | 
 4 | ..
 5 | 
 6 | ----
 7 | 
 8 | Time interpretation defaults
 9 | ----------------------------
10 | 
11 | The time interpretation of Abjad containers initializes to either sequential or
12 | simultaneous. Defaults correspond to the most common use of each type of container.
13 | Abjad's vanilla containers, voices and staves all default to sequential time
14 | interpretation:
15 | 
16 | ::
17 | 
18 |     >>> abjad.Container(name="Example_Container").simultaneous is None
19 | 
20 |     >>> abjad.Voice(name="Example_Voice").simultaneous is None
21 | 
22 |     >>> abjad.Staff(name="Example_Staff").simultaneous is None
23 | 
24 | Abjad's staff groups and scores default to simultaneous time interpretation:
25 | 
26 | ::
27 | 
28 |     >>> abjad.StaffGroup(name="Example_Staff_Group").simultaneous
29 | 
30 |     >>> abjad.Score(name="Example_Score").simultaneous
31 | 
32 | ----
33 | 
34 | Setting time interpretation at initialization
35 | ---------------------------------------------
36 | 
37 | You can set the time interpretation of any container at initialization. If you know how
38 | you will use a container, go ahead and set the container's time interpretation when you
39 | create it. The staff below initializes as simultaneous to allow two-voice polyphony:
40 | 
41 | ::
42 | 
43 |     >>> voice_1 = abjad.Voice(r"e''4 f''4 g''4 g''4 f''4 e''4 d''4 d''4 \fermata")
44 |     >>> voice_2 = abjad.Voice(r"c''4 c''4 b'4 c''4 c''8 b'8 c''4 b'4 b'4 \fermata")
45 |     >>> staff = abjad.Staff([voice_1, voice_2], simultaneous=True)
46 |     >>> command = abjad.VoiceNumber(1)
47 |     >>> abjad.attach(command, voice_1[0])
48 |     >>> command = abjad.VoiceNumber(2)
49 |     >>> abjad.attach(command, voice_2[0])
50 |     >>> abjad.show(staff)
51 | 
52 | ----
53 | 
54 | Changing time interpretation after initialization
55 | -------------------------------------------------
56 | 
57 | You can also set the time interpretation of containers after you create them. The staff
58 | below initializes as sequential. But you can change the staff's time interpretation after
59 | you initialization:
60 | 
61 | ::
62 | 
63 |     >>> voice_1 = abjad.Voice(r"e''4 f''4 g''4 g''4 f''4 e''4 d''4 d''4 \fermata")
64 |     >>> voice_2 = abjad.Voice(r"c''4 c''4 b'4 c''4 c''8 b'8 c''4 b'4 b'4 \fermata")
65 |     >>> staff = abjad.Staff([voice_1, voice_2])
66 |     >>> command = abjad.VoiceNumber(1)
67 |     >>> abjad.attach(command, voice_1[0])
68 |     >>> command = abjad.VoiceNumber(2)
69 |     >>> abjad.attach(command, voice_2[0])
70 |     >>> abjad.show(staff)
71 | 
72 |     >>> staff.simultaneous = True
73 |     >>> abjad.show(staff)
74 | 


--------------------------------------------------------------------------------
/docs/source/overview/containers.rst:
--------------------------------------------------------------------------------
 1 | Containers
 2 | ==========
 3 | 
 4 | ..  
 5 | 
 6 | ----
 7 | 
 8 | Abjad models voices, staves, scores as types of container. Newcomers usually find it easy
 9 | to get started working with Abjad by typing LilyPond input into a container. This works
10 | because Abjad understands the basics of LilyPond's input language:
11 | 
12 | ::
13 | 
14 |     >>> string = "d'8 f' a' d'' f'' gs'4 r8 e' gs' b' e'' gs'' a'4"
15 |     >>> voice = abjad.Voice(string, name="RH_Voice")
16 |     >>> staff = abjad.Staff([voice], name="RH_Staff")
17 |     >>> score = abjad.Score([staff], name="Score")
18 |     >>> abjad.show(score)
19 | 
20 | Abjad displays pitch information in English. But LilyPond's other input languages are
21 | available, too:
22 | 
23 | ::
24 | 
25 |     >>> string = "re'8 fa' la' re'' fa'' sold'4 r8 mi' sold' si' mi'' sold'' la'4"
26 |     >>> voice = abjad.Voice(string, language="français", name="RH_Voice")
27 |     >>> staff = abjad.Staff([voice], name="RH_Staff")
28 |     >>> score = abjad.Score([staff], name="Score")
29 |     >>> abjad.show(score)
30 | 


--------------------------------------------------------------------------------
/docs/source/overview/contexts-lilypond-type-of.rst:
--------------------------------------------------------------------------------
 1 | Contexts, LilyPond type of
 2 | ==========================
 3 | 
 4 | Working with LilyPond means understanding LilyPond contexts. Abjad implements only four
 5 | concrete contexts: voice, staff, staff group, score. But LilyPond comes preloaded with 20
 6 | contexts: 9 voice contexts, 6 staff contexts, 4 staff group contexts and a score context:
 7 | 
 8 | http://lilypond.org/doc/v2.20/Documentation/notation/contexts-explained
 9 | 
10 | Use Abjad's concept of "LilyPond type" to work with any of LilyPond's 20 predefined
11 | contexts.
12 | 
13 | ----
14 | 
15 | Setting LilyPond type at initialization
16 | ---------------------------------------
17 | 
18 | If you know the LilyPond type of a context you want to work with, you can set it at
19 | initialization:
20 | 
21 | ::
22 | 
23 |     >>> voice = abjad.Voice("c'4 d' e' f'", name="Music_Voice")
24 |     >>> staff = abjad.Staff([voice], lilypond_type="RhythmicStaff", name="Woodblock_Staff")
25 |     >>> abjad.show(staff)
26 | 
27 | ----
28 | 
29 | Setting LilyPond type after initialization
30 | ------------------------------------------
31 | 
32 | You can change the LilyPond type of a context after initialization, too:
33 | 
34 | ::
35 | 
36 |     >>> voice = abjad.Voice("c'4 d' e' f'", name="Music_Voice")
37 |     >>> staff = abjad.Staff([voice], name="Woodblock_Staff")
38 |     >>> abjad.show(staff)
39 | 
40 |     >>> staff.lilypond_type = "RhythmicStaff"
41 |     >>> abjad.show(staff)
42 | 


--------------------------------------------------------------------------------
/docs/source/overview/indicators.rst:
--------------------------------------------------------------------------------
 1 | Indicators
 2 | ==========
 3 | 
 4 | ..
 5 | 
 6 | ----
 7 | 
 8 | ..  rubric:: What's an indicator?
 9 | 
10 | Only a small number of musical objects carry a duration: notes, rests, chords and the
11 | tuplets, voices, staves that contain them. All the other symbols used to notate music are
12 | dependent on notes, rests, chords for their moment of performance (and their location on
13 | the page). These include articulations, fingerings, pedal markings, slurs, phrase
14 | groupings, clefs, key signatures, and many others. Abjad formalizes this idea of a
15 | non-durated object as an indicator. You attach indicators to notes, rests, chords as you
16 | compose:
17 | 
18 | ::
19 | 
20 |     >>> string = "d'8 f' a' d'' f'' gs'4 r8 e' gs' b' e'' gs'' a'4"
21 |     >>> voice = abjad.Voice(string, name="RH_Voice")
22 |     >>> staff = abjad.Staff([voice], name="RH_Staff")
23 |     >>> score = abjad.Score([staff], name="Score")
24 |     >>> abjad.show(score)
25 | 
26 | ::
27 | 
28 |     >>> key_signature = abjad.KeySignature(
29 |     ...     abjad.NamedPitchClass("g"), abjad.Mode("major")
30 |     ... )
31 |     >>> abjad.attach(key_signature, voice[0])
32 |     >>> time_signature = abjad.TimeSignature((2, 4), partial=abjad.Duration(1, 8))
33 |     >>> abjad.attach(time_signature, voice[0])
34 |     >>> articulation = abjad.Articulation("turn")
35 |     >>> abjad.attach(articulation, voice[5])
36 |     >>> abjad.show(score)
37 | 
38 | ----
39 | 
40 | ..  rubric:: Attach? Or write by hand?
41 | 
42 | You can type indicators into LilyPond input, too. But over time you'll probably
43 | migrate to the make-then-attach pattern show above. The reasons for this have to do with
44 | the way you're likely to incrementally build up musical expressions, with experience.
45 | Important, too, is the Abjad parses only a basic subset of LilyPond's input language;
46 | parsing all of LilyPond's input language would too tightly couple the two systems. (The
47 | time signature must still be created explicitly in the example above because Abjad
48 | doesn't parse LilyPond's partial measure command.) Attaching becomes powerful when
49 | coupled with a loop:
50 | 
51 | ::
52 | 
53 |     >>> for leaf in voice[:6]:
54 |     ...     staccato = abjad.Articulation("staccato")
55 |     ...     abjad.attach(staccato, leaf)
56 |     ...
57 | 
58 |     >>> abjad.show(score)
59 | 
60 | ----
61 | 
62 | ..  rubric:: Getting indicators
63 | 
64 | Get all the indicators attached to a note, rest, chord like this:
65 | 
66 | ::
67 | 
68 |     >>> indicators = abjad.get.indicators(voice[0])
69 |     >>> for indicator in indicators:
70 |     ...     indicator
71 | 
72 | 
73 | Filter by type and get just the articulations attached to a note, rest, chord like this:
74 | 
75 | ::
76 | 
77 |     >>> abjad.get.indicators(voice[0], abjad.Articulation)
78 | 
79 | ----
80 | 
81 | ..  rubric:: Detaching indicators
82 | 
83 | 
84 | Detach the articulations from a note, rest, chord like this:
85 | 
86 | 
87 | ::
88 | 
89 |     >>> indicators = abjad.detach(abjad.Articulation, voice[0])
90 |     >>> abjad.show(score)
91 | 
92 | The function returns a tuple of the indicators detached:
93 | 
94 | ::
95 | 
96 |     >>> indicators
97 | 
98 | :author:`[Ex. Joseph Haydn, Piano sonata 42, Hob. XVI/27.]`
99 | 


--------------------------------------------------------------------------------
/docs/source/overview/lilypond-files-preamble-of.rst:
--------------------------------------------------------------------------------
 1 | LilyPond files, preamble of
 2 | ===========================
 3 | 
 4 | Abjad's LilyPond file class accepts a list of items. Many LilyPond files comprise just a
 5 | score:
 6 | 
 7 | ::
 8 | 
 9 |     >>> voice = abjad.Voice("c'4 d'4 e'4 f'4", name="Violin_Voice")
10 |     >>> staff = abjad.Staff([voice], name="Violin_Staff")
11 |     >>> score = abjad.Score([staff], name="Score")
12 |     >>> lilypond_file = abjad.LilyPondFile([score])
13 | 
14 | LilyPond version and language commands are inserted automatically:
15 | 
16 | ::
17 | 
18 |     >>> string = abjad.lilypond(lilypond_file)
19 |     >>> print(string)
20 | 
21 | You can type all other LilyPond settings directly into a string:
22 | 
23 | ::
24 | 
25 |     >>> preamble = r"""#(set-global-staff-size 14)
26 |     ...
27 |     ... \header {
28 |     ...     composer = \markup { Josquin }
29 |     ...     subtitle = \markup { Agnus dei }
30 |     ...     title = \markup { Missa sexti toni }
31 |     ... }
32 |     ...
33 |     ... \layout {
34 |     ...     indent = 0
35 |     ... }"""
36 | 
37 | Bundle the preamble and score like this:
38 | 
39 | ::
40 | 
41 |     >>> lilypond_file = abjad.LilyPondFile([preamble, score])
42 | 
43 | Then everything appears together:
44 | 
45 | ::
46 | 
47 |     >>> string = abjad.lilypond(lilypond_file)
48 |     >>> print(string)
49 | 
50 | Click on the image below. Abjad generates this same LilyPond input behind the scenes when
51 | you call show:
52 | 
53 |     >>> abjad.show(lilypond_file)
54 | 


--------------------------------------------------------------------------------
/docs/source/overview/lilypond-format-of-abjad-objects.rst:
--------------------------------------------------------------------------------
 1 | LilyPond format, of Abjad objects
 2 | =================================
 3 | 
 4 | ..
 5 | 
 6 | ----
 7 | 
 8 | Many Abjad objects can be transformed into LilyPond input:
 9 | 
10 | ::
11 | 
12 |     >>> string = r"\tuplet 3/2 { gs''32 \sfp ( b'' cs''' } b''4.. \trill )"
13 |     >>> voice_1 = abjad.Voice(4 * string, name="Voice_1")
14 |     >>> note = abjad.select.note(voice_1, 0)
15 |     >>> key_signature = abjad.KeySignature(
16 |     ...     abjad.NamedPitchClass("e"), abjad.Mode("major")
17 |     ... )
18 |     >>> abjad.attach(key_signature, note)
19 |     >>> command = abjad.VoiceNumber(1)
20 |     >>> abjad.attach(command, note)
21 |     >>> literal = abjad.LilyPondLiteral(r"\dynamicUp")
22 |     >>> abjad.attach(literal, note)
23 |     >>> string = r"""
24 |     ...     r4 \tuplet 3/2 { b'32 \sfp ( e'' fs'' } e''4.. \trill )
25 |     ...     \tuplet 3/2 { b'32 \sfp ( e'' fs'' } e''8. ~ \trill )
26 |     ...     e''4 \tuplet 3/2 { b'32 \sfp ( fs'' gs'' } fs''4.. \trill )
27 |     ...    \tuplet 3/2 { b'32 \sfp ( fs'' gs'' } fs''8. \trill )"""
28 |     >>> voice_2 = abjad.Voice(string, name="Voice_2")
29 |     >>> abjad.override(voice_2).script.direction = "#down"
30 |     >>> abjad.override(voice_2).slur.direction = "#down"
31 |     >>> abjad.override(voice_2).tie.direction = "#down"
32 |     >>> abjad.override(voice_2).tuplet_bracket.stencil = "##f"
33 |     >>> staff = abjad.Staff([voice_1, voice_2], name="Example_Staff", simultaneous=True)
34 |     >>> score = abjad.Score([staff], name="Example_Score")
35 |     >>> abjad.show(score)
36 | 
37 | Here's LilyPond input for the score above:
38 | 
39 | ::
40 | 
41 |     >>> string = abjad.lilypond(score)
42 |     >>> print(string)
43 | 
44 | Here's LilyPond input for just voice 1:
45 | 
46 | ::
47 | 
48 |     >>> string = abjad.lilypond(voice_1)
49 |     >>> print(string)
50 | 
51 | Here's LilyPond input for the very first note:
52 | 
53 | ::
54 | 
55 |     >>> note = abjad.select.note(score, 0)
56 |     >>> string = abjad.lilypond(note)
57 |     >>> print(string)
58 | 
59 | ----
60 | 
61 | **Discussion.**
62 | 
63 | * The output of :func:`abjad.lilypond` is a string.
64 | 
65 | * Indentation (4 spaces per level) shows container nesting.
66 | 
67 | :author:`[Bača (3.2); ex. Gustav Mahler, Symphony 6, movt III, 3 after 94.]`
68 | 


--------------------------------------------------------------------------------
/docs/source/welcome/abstract.rst:
--------------------------------------------------------------------------------
1 | Abjad helps composers build up complex pieces of music notation in iterative and incremental ways. Use Abjad to create a symbolic representation of all the notes, rests, chords, tuplets, beams and slurs in any score. Because Abjad extends the Python programming language, you can use Abjad to make systematic changes to music as you work. Because Abjad wraps the LilyPond music notation package, you can use Abjad to control the typographic detail of symbols on the page.
2 | 


--------------------------------------------------------------------------------
/docs/source/welcome/quickstart.rst:
--------------------------------------------------------------------------------
 1 | Abjad requires Python 3.12 and LilyPond 2.23.6 (or later).
 2 | 
 3 | Make sure LilyPond is installed: http://lilypond.org/development.html
 4 | 
 5 | Create a Python 3 virtual environment for Abjad:
 6 | https://docs.python.org/3/tutorial/venv.html
 7 | 
 8 | Activate the virtual environment and then use pip to install Abjad:
 9 | 
10 | ::
11 | 
12 |     ~$ python -m pip install abjad
13 | 


--------------------------------------------------------------------------------
/docs/source/welcome/welcome.rst:
--------------------------------------------------------------------------------
 1 | ..  include:: /welcome/abstract.rst
 2 | 
 3 | ----
 4 | 
 5 | ..  include:: /welcome/quickstart.rst
 6 | 
 7 | ----
 8 | 
 9 | ..  include:: /welcome/example.rst
10 | 
11 | Read Abjad's docs using the table of contents to the left. Happy composing and welcome to
12 | Abjad!
13 | 


--------------------------------------------------------------------------------
/hello.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/hello.png


--------------------------------------------------------------------------------
/ly/Makefile:
--------------------------------------------------------------------------------
 1 | all:
 2 | 	lilypond -dno-print-pages contexts.ly > ../abjad/lyscrape.py
 3 | 	echo "" >> ../abjad/lyscrape.py
 4 | 	lilypond -dno-print-pages current_module.ly >> ../abjad/lyscrape.py
 5 | 	echo "" >> ../abjad/lyscrape.py
 6 | 	lilypond -dno-print-pages engravers.ly >> ../abjad/lyscrape.py
 7 | 	echo "" >> ../abjad/lyscrape.py
 8 | 	lilypond -dno-print-pages grob_interfaces.ly >> ../abjad/lyscrape.py
 9 | 	echo "" >> ../abjad/lyscrape.py
10 | 	lilypond -dno-print-pages interface_properties.ly >> ../abjad/lyscrape.py
11 | 	echo "" >> ../abjad/lyscrape.py
12 | 	lilypond -dno-print-pages language_pitch_names.ly >> ../abjad/lyscrape.py
13 | 	echo "" >> ../abjad/lyscrape.py
14 | 	# lilypond -dno-print-pages markup_functions.ly >> ../abjad/lyscrape.py
15 | 	# echo "" >> ../abjad/lyscrape.py
16 | 	lilypond -dno-print-pages music_glyphs.ly >> ../abjad/lyscrape.py
17 | 	black --target-version=py38 ../abjad/lyscrape.py
18 | 
19 | 


--------------------------------------------------------------------------------
/ly/contexts.ly:
--------------------------------------------------------------------------------
 1 | \version "2.25.19"
 2 | 
 3 | #
 4 | (load "helpers.scm")
 5 | 
 6 | #
 7 | (load-from-path "lily-sort")
 8 | 
 9 | #
10 |   (define (context-doc context-desc)
11 |     (let* ((name-sym (assoc-get 'context-name context-desc))
12 |         (name (symbol->string name-sym))
13 |         (aliases (sort 
14 |             (map symbol->string (assoc-get 'aliases context-desc))
15 |             ly:string-ci<?))
16 |         (accepts (sort
17 |             (map symbol->string (assoc-get 'accepts context-desc))
18 |             ly:string-ci<?))
19 |         (consists (sort
20 |             (map symbol->string (assoc-get 'consists context-desc))
21 |             ly:string-ci<?))
22 |         (defaultchild (assoc-get 'default-child context-desc))
23 |         ;;and then as strings
24 |         (accepts-entry (format-dict-entry "accepts"
25 |           (format-string-set (format-string-list accepts 8)) 8))
26 |         (aliases-entry (format-dict-entry "aliases"
27 |           (format-string-set (format-string-list aliases 8)) 8))
28 |         (consists-entry (format-dict-entry "consists"
29 |           (format-string-set (format-string-list consists 8)) 8)) 
30 |         (defaultchild-entry (if defaultchild
31 |             (format "        \"default_child\": \"~A\",\n" 
32 |                 (symbol->string defaultchild)
33 |                 )
34 |             ""))
35 |         (all-entries (string-append
36 |           accepts-entry
37 |           aliases-entry
38 |           consists-entry
39 |           defaultchild-entry
40 |           )))
41 |       (string-append
42 |         "    \"" name "\": {\n"
43 |         all-entries
44 |         "        },\n")))
45 | 
46 | #
47 | (define (all-contexts-doc)
48 |   (let* (
49 |     (layout-alist
50 |       (sort (ly:output-description $defaultlayout)
51 |         (lambda (x y) (ly:symbol-ci<? (car x) (car y)))))
52 |     (names (sort (map symbol->string (map car layout-alist)) ly:string-ci<?))
53 |     (contexts (map cdr layout-alist)))
54 |   (string-join (map context-doc contexts) "")))
55 | 
56 | #
57 | (display (string-append
58 |   (format "lilypond_version = \"~A\"\n\n" (lilypond-version))
59 |   "contexts = {\n"
60 |   (all-contexts-doc)
61 |   "    }\n"))
62 | 


--------------------------------------------------------------------------------
/ly/engravers.ly:
--------------------------------------------------------------------------------
 1 | \version "2.25.19"
 2 | 
 3 | #
 4 | (load-from-path "lily-sort")
 5 | 
 6 | #
 7 | (load "helpers.scm")
 8 | 
 9 | #
10 | (define name->engraver-table (make-hash-table 61))
11 | 
12 | #
13 | (for-each
14 |   (lambda (x)
15 |     (hash-set! name->engraver-table (ly:translator-name x) x))
16 |       (ly:get-all-translators))
17 | 
18 | #
19 | (define (get-all-translator-names)
20 |   (sort-symbol-list
21 |     (map ly:translator-name (ly:get-all-translators))))
22 | 
23 | #
24 | (define (find-engraver-by-name name)
25 |   (hash-ref name->engraver-table name #f))
26 | 
27 | #
28 | (define (get-grobs-created engraver)
29 |   (map symbol->string 
30 |     (sort-symbol-list
31 |       (assoc-get 'grobs-created (ly:translator-description engraver)))))
32 | 
33 | #
34 | (define (get-properties-read engraver)
35 |   (map symbol->string
36 |     (sort-symbol-list
37 |       (assoc-get 'properties-read (ly:translator-description engraver)))))
38 | 
39 | #
40 | (define (get-properties-written engraver)
41 |   (map symbol->string
42 |     (sort-symbol-list
43 |       (assoc-get 'properties-written (ly:translator-description engraver)))))
44 | 
45 | #
46 | (define (format-engraver-info engraver-name-symbol)
47 |   (let* (
48 |     (engraver (find-engraver-by-name engraver-name-symbol))
49 |     (name (symbol->string engraver-name-symbol))
50 |     (grobs-created-entry
51 |       (format-dict-entry "grobs_created"
52 |         (format-string-set (format-string-list (get-grobs-created engraver) 8)) 
53 |         8))
54 |     (properties-read-entry
55 |       (format-dict-entry "properties_read"
56 |         (format-string-set 
57 |             (format-string-list (get-properties-read engraver) 8)) 
58 |             8))
59 |     (properties-written-entry
60 |       (format-dict-entry "properties_written"
61 |         (format-string-set 
62 |             (format-string-list (get-properties-written engraver) 8)) 
63 |             8))
64 |     (all-entries (string-append
65 |       grobs-created-entry
66 |       properties-read-entry
67 |       properties-written-entry
68 |       )))
69 |   (string-append
70 |     "    \"" name "\": {\n"
71 |     all-entries
72 |     "    },\n")))
73 | 
74 | #
75 | (display
76 |   (string-append
77 |     (format "lilypond_version = \"~A\"\n\n" (lilypond-version))
78 |     "engravers = {\n"
79 |     (string-join (map format-engraver-info (get-all-translator-names)) "")
80 |     "    }\n"))
81 | 


--------------------------------------------------------------------------------
/ly/grob_interfaces.ly:
--------------------------------------------------------------------------------
 1 | \version "2.25.19"
 2 | 
 3 | #(load "helpers.scm")
 4 | 
 5 | #(begin
 6 | 
 7 |   (define (format-grob-interfaces)
 8 |     "writes out all grob interfaces as a Python dict"
 9 |     (string-append
10 |      (fold (lambda (k p)
11 |              (string-append
12 |               p
13 |               (format-dict-entry
14 |                (symbol->string k)
15 |                (format-string-list
16 |                 (sort
17 |                  (map symbol->string
18 |                    (assq-ref
19 |                     (assq-ref
20 |                      (assq-ref all-grob-descriptions k)
21 |                      'meta)
22 |                     'interfaces))
23 |                  string<)
24 |                 4)
25 |                4)))
26 |        "grob_interfaces = {\n"
27 |        (sort-symbol-list (alist-keys all-grob-descriptions)))
28 |      "    }\n"))
29 | 
30 |   (display
31 |     (string-append
32 |       (format "lilypond_version = \"~A\"\n\n" (lilypond-version))
33 |       (format-grob-interfaces)
34 |       )))
35 | 


--------------------------------------------------------------------------------
/ly/guile_interpreter.ly:
--------------------------------------------------------------------------------
1 | \version "2.25.19"
2 | 
3 | #(module-define! (resolve-module '(guile-user))
4 |                  'lilypond-module (current-module))
5 | 
6 | #(top-repl)
7 | 


--------------------------------------------------------------------------------
/ly/helpers.scm:
--------------------------------------------------------------------------------
 1 | (begin
 2 | 
 3 |   (define (sort-symbol-list list)
 4 |     "sort a list of symbols"
 5 |     (sort list (lambda (s1 s2)
 6 |                  (string<
 7 |                   (symbol->string s1)
 8 |                   (symbol->string s2)))))
 9 |   
10 |   (define (hash-keys h)
11 |     "returns the list of keys of a hash table"
12 |     (hash-fold
13 |      (lambda (k v p)
14 |        (append p (list k)))
15 |      '()
16 |      h))
17 |   
18 |   ;; the list of properties we also want to complete, besides all
19 |   ;; user properties
20 |   (define accepted-properties
21 |     '(
22 |       cross-staff
23 |       positioning-done
24 |       ))
25 |   
26 |   (define (user-property? prop)
27 |     "is the property a user property?"
28 |     (or (memq prop accepted-properties)
29 |         (memq prop all-user-grob-properties)))
30 |   
31 |   (define (format-string-list list indent)
32 |     "formats a list of strings as a Python list"
33 |     (cond
34 |      ((null? list) "[]")
35 |      (else 
36 |       (string-append
37 |        "[\n"
38 |        (string-join
39 |         (map (lambda (s)
40 |                (string-append
41 |                 (make-string (+ 4 indent) #\space)
42 |                 "\""
43 |                 s
44 |                 "\",\n"))
45 |           list)
46 |         "")
47 |        (make-string indent #\space)
48 |        "    ]"))))
49 |   
50 |   (define (format-string-set list)
51 |     "format a string-list as a Python set"
52 |     (string-append
53 |       "set("
54 |       list 
55 |       ")"))
56 | 
57 |   (define (format-dict-entry k v indent)
58 |     "formats a dictionary entry: key and value are string"
59 |     (string-append
60 |      (make-string indent #\space)
61 |      "\"" k "\": " v ",\n"))
62 |   
63 |   (define (alist-keys alist)
64 |     "returns the list of keys of the specified alist"
65 |     (fold 
66 |      (lambda (l p)
67 |        (append p (list (car l))))
68 |      '()
69 |      alist))
70 |   ) 


--------------------------------------------------------------------------------
/ly/interface_properties.ly:
--------------------------------------------------------------------------------
 1 | \version "2.25.19"
 2 | 
 3 | #(load "helpers.scm")
 4 | 
 5 | #(begin
 6 | 
 7 |   (define (format-interface-properties h)
 8 |     "formats the interfaces from ly:all-grob-interfaces as a Python dict"
 9 |     (string-append
10 |      (fold (lambda (k p)
11 |              (string-append
12 |               p
13 |               (format-dict-entry
14 |                (symbol->string k)
15 |                (format-string-list
16 |                 (sort
17 |                  (map symbol->string
18 |                    (filter user-property?
19 |                            (list-ref (hashq-ref h k) 2)))
20 |                  string<)
21 |                 4)
22 |                4)))
23 |        "interface_properties = {\n"
24 |        (sort-symbol-list (hash-keys h)))
25 |      "    }\n"))
26 | 
27 |   (display
28 |     (string-append
29 |       (format "lilypond_version = \"~A\"\n\n" (lilypond-version))
30 |       (format-interface-properties (ly:all-grob-interfaces))
31 |       )))
32 | 


--------------------------------------------------------------------------------
/ly/language_pitch_names.ly:
--------------------------------------------------------------------------------
 1 | \version "2.25.19"
 2 | 
 3 | %%% DEFINITIONS %%%
 4 | 
 5 | #(define alterations '(
 6 |   (-1 . "ff")
 7 |   (-3/4 . "tqf")
 8 |   (-1/2 . "f")
 9 |   (-1/4 . "qf")
10 |   (0 . "")
11 |   (1/4 . "qs")
12 |   (1/2 . "s")
13 |   (3/4 . "tqs")
14 |   (1 . "ss")))
15 | 
16 | #(define notenames '(
17 |   (0 . "c")
18 |   (1 . "d")
19 |   (2 . "e")
20 |   (3 . "f")
21 |   (4 . "g")
22 |   (5 . "a")
23 |   (6 . "b") ))
24 | 
25 | #(define (print-language language)
26 |   (display (format "~%    '~A': " (car language))))
27 | 
28 | #(define (print-pitch pitch-pair)
29 |   (let*
30 |     ; DECLARATIONS
31 |     ((ly-pitch-name (car pitch-pair))
32 |     (ly-pitch-obj (cdr pitch-pair))
33 |     (ly-notename (ly:pitch-notename ly-pitch-obj))
34 |     (ly-alteration (ly:pitch-alteration ly-pitch-obj))
35 |     (abj-pitch-name (ly:assoc-get ly-notename notenames))
36 |     (abj-accidental (ly:assoc-get ly-alteration alterations))
37 |     (pitch-name (format "~A~A" abj-pitch-name abj-accidental)))
38 |     ; BODY
39 |     (display (format "        '~A': '~A',\n"
40 |       ly-pitch-name pitch-name))))
41 | 
42 | #(define handle-language (lambda (x) (begin
43 |   (print-language x)
44 |   (display " {\n")
45 |   (map print-pitch (cdr x))
46 |   (display "    },\n"))))
47 | 
48 | %%% MAIN %%%
49 | 
50 | #(begin
51 |   (display (format "lilypond_version = \"~A\"\n\n" (lilypond-version)))
52 |   (display "language_pitch_names = {")
53 |   (map handle-language language-pitch-names)
54 |   (display "\n    }"))
55 | 


--------------------------------------------------------------------------------
/ly/markup_functions.ly:
--------------------------------------------------------------------------------
 1 | \version "2.25.19"
 2 | 
 3 | 
 4 | #(define (markup-function? func)
 5 |   (and (markup-command-signature func)
 6 |     (not (object-property func 'markup-list-command))))
 7 | 
 8 | 
 9 | #(define (markup-list-function? func)
10 |   (and (markup-command-signature func)
11 |     (object-property func 'markup-list-command)))
12 | 
13 | 
14 | #(define (sort-procedures procs)
15 |   (sort procs
16 |     (lambda (x y)
17 |       (symbol<? (procedure-name x) (procedure-name y)))))
18 | 
19 | 
20 | #(define (strip-procedure-suffix proc)
21 |   (let
22 |     ((proc-name (symbol->string (procedure-name proc))))
23 |     (cond
24 |       ((markup-function? proc)
25 |         (substring proc-name 0 (string-contains proc-name "-markup")))
26 |       ((markup-list-function? proc)
27 |         (substring proc-name 0 (string-contains proc-name "-markup-list"))))))
28 | 
29 | 
30 | #(define (document-procedure proc)
31 |   (let*
32 |     ((proc-name (strip-procedure-suffix proc))
33 |     (signature (object-property proc 'markup-signature))
34 |     (signature-syms (map (lambda (x) (procedure-name x)) signature))
35 |     (signature-string
36 |       (if (< 0 (length signature))
37 |         (format "(~A,)" (string-join (map (lambda (x)
38 |           (format "'~A'" x))
39 |           signature-syms) ", "))
40 |         "()")))
41 |     (display (format "    '~A': ~A,\n" proc-name signature-string))))
42 | 
43 | 
44 | #(define all-markup-functions (sort-procedures
45 |   (filter procedure?
46 |     (flatten-list
47 |       (map (lambda (x) (hash-table->alist (cdr x)))
48 |         (hash-table->alist markup-functions-by-category))))))
49 | 
50 | 
51 | #(define all-markup-list-functions (sort-procedures
52 |   (map car 
53 |     (hash-table->alist markup-list-functions))))
54 | 
55 | 
56 | #(display (format "lilypond_version = \"~A\"\n\n" (lilypond-version)))
57 | #(display "markup_functions = {\n")
58 | #(map document-procedure all-markup-functions)
59 | #(display "    }\n\n")
60 | #(display "markup_list_functions = {\n")
61 | #(map document-procedure all-markup-list-functions)
62 | #(display "    }\n")
63 | 


--------------------------------------------------------------------------------
/ly/music_glyphs.ly:
--------------------------------------------------------------------------------
 1 | \version "2.25.19"
 2 | 
 3 | #(load "helpers.scm")
 4 | 
 5 | #(begin
 6 | 
 7 |   (define (format-musicglyphs)
 8 |     (string-append
 9 |       "music_glyphs = "
10 |       (format-string-set
11 |         (format-string-list
12 |           (sort
13 |             (delete ".notdef"
14 |               (ly:otf-glyph-list (ly:system-font-load "emmentaler-20")))
15 |             string<)
16 |           0))
17 |       "\n"))
18 | 
19 |   ;;; output
20 |   (display
21 |     (string-append
22 |       (format "lilypond_version = \"~A\"\n\n" (lilypond-version))
23 |       (format-musicglyphs)
24 |       )))
25 | 
26 | % EOF
27 | 


--------------------------------------------------------------------------------
/pyproject.toml:
--------------------------------------------------------------------------------
 1 | [build-system]
 2 | requires = ["setuptools>=61.0", "wheel"]
 3 | build-backend = "setuptools.build_meta"
 4 | 
 5 | [project]
 6 | name = "abjad"
 7 | version = "3.25"
 8 | description = "Abjad is a Python API for building LilyPond files."
 9 | license = { text = "MIT" }
10 | readme = "README.rst"
11 | requires-python = ">=3.12"
12 | keywords = ["lilypond", "music composition", "music notation"]
13 | classifiers = [
14 |     "Development Status :: 5 - Production/Stable",
15 |     "License :: OSI Approved :: GNU General Public License (GPL)",
16 |     "Programming Language :: Python :: 3.12",
17 |     "Programming Language :: Python :: 3.13",
18 |     "Topic :: Artistic Software"
19 | ]
20 | dependencies = [
21 |     "ply>=3.11",
22 |     "roman>=5.0",
23 |     "uqbar>=0.7.4"
24 | ]
25 | 
26 | [[project.authors]]
27 | name = "Trevor Bača"
28 | email = "trevor.baca@gmail.com"
29 | 
30 | [[project.authors]]
31 | name = "Joséphine Wolf Oberholtzer"
32 | email = "josephine.wolf.oberholtzer@gmail.com"
33 | 
34 | [project.optional-dependencies]
35 | dev = [
36 |     "black==25.1.0",
37 |     "build==1.2.2.post1",
38 |     "flake8==7.2.0",
39 |     "isort==6.0.1",
40 |     "mypy==1.15.0",
41 |     "pytest==8.3.5",
42 |     "pytest-cov==6.1.1",
43 |     "pytest-helpers-namespace==2021.12.29",
44 |     "setuptools==80.0.0",
45 |     "sphinx==8.1.3",
46 |     "sphinx-rtd-theme==3.0.2",
47 |     "sphinx-toggleprompt==0.6.0",
48 |     "twine==6.1.0"
49 | ]
50 | 
51 | [project.urls]
52 | Homepage = "https://abjad.github.io"
53 | 
54 | [[tool.mypy.overrides]]
55 | module = "docutils.*"
56 | ignore_missing_imports = true
57 | 
58 | [[tool.mypy.overrides]]
59 | module = "ply"
60 | ignore_missing_imports = true
61 | 
62 | [[tool.mypy.overrides]]
63 | module = "ply.yacc"
64 | ignore_missing_imports = true
65 | 
66 | [[tool.mypy.overrides]]
67 | module = "roman"
68 | ignore_missing_imports = true
69 | 
70 | [tool.pytest.ini_options]
71 | addopts = "--doctest-modules"
72 | doctest_optionflags = "ELLIPSIS NORMALIZE_WHITESPACE"
73 | markers = "sphinx"
74 | testpaths = ["tests", "source"]
75 | 
76 | [tool.setuptools]
77 | include-package-data = true
78 | packages = ["abjad"]
79 | package-dir = { "" = "source" }
80 | 
81 | [tool.setuptools.package-data]
82 | "*" = ["LICENSE", "README.rst", "conftest.py"]
83 | "abjad" = ["**/*"]
84 | 
85 | [tool.setuptools.exclude-package-data]
86 | "*" = ["docs/*"]
87 | 


--------------------------------------------------------------------------------
/scripts/prime_parser_tables.py:
--------------------------------------------------------------------------------
 1 | #! /usr/bin/env python
 2 | 
 3 | """
 4 | If no pickled parser tables have been created, e.g. because Abjad has just
 5 | been downloaded and installed for the first time, PLY will print an error
 6 | message along the lines of "WARNING: yacc table file version is out of date.".
 7 | This can cause doctests to fail should the warning appear during the middle of
 8 | those tests.
 9 | 
10 | This script simply finds each Parser subclass in Abjad and instantiates it,
11 | thereby causing PLY to create and persist the appropriate parser tables.
12 | """
13 | 
14 | import abjad
15 | from abjad.parsers.parser import LilyPondParser
16 | from abjad.parsers.reduced import ReducedLyParser
17 | from abjad.parsers.scheme import SchemeParser
18 | 
19 | parsers = (
20 |     LilyPondParser,
21 |     SchemeParser,
22 |     abjad.rhythmtrees.RhythmTreeParser,
23 |     ReducedLyParser,
24 | )
25 | 
26 | for parser in parsers:
27 |     print(f"Priming {parser.__name__} parser tables.")
28 |     parser()
29 | 


--------------------------------------------------------------------------------
/scripts/timer.py:
--------------------------------------------------------------------------------
 1 | #! /usr/bin/env python
 2 | 
 3 | """
 4 | Called by abjad.contextmanager.Timer on __enter__().
 5 | """
 6 | 
 7 | import sys
 8 | import time
 9 | 
10 | interval = int(sys.argv[1])
11 | i = 0
12 | while True:
13 |     time.sleep(interval)
14 |     i += interval
15 |     unit = "seconds"
16 |     if i == 1:
17 |         unit = "second"
18 |     message = "\n[{} {}]"
19 |     message = message.format(i, unit)
20 |     print(message)
21 | 


--------------------------------------------------------------------------------
/scripts/write_parser_syntax_skeleton.py:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env python
 2 | import os
 3 | import sys
 4 | 
 5 | from abjad.parser.LilyPondGrammarGenerator import LilyPondGrammarGenerator
 6 | 
 7 | 
 8 | def usage():
 9 |     result = []
10 |     result.append("")
11 |     result.append("Usage:")
12 |     result.append("")
13 |     result.append(
14 |         "write_parser_syntax_skeleton.py PARSER_output_PATH PARSER_TAB_HH_PATH SKELETON_PATH"
15 |     )
16 |     result.append("")
17 |     result.append(
18 |         "Given PARSER_output_PATH (to parser.output) and PARSER_TAB_HH_PATH (to parser.tab.hh),"
19 |     )
20 |     result.append(
21 |         "generate a PLY-compliant parser skeleton, and write it to SKELETON_PATH."
22 |     )
23 |     result.append("")
24 |     result = "\n".join(["\t" + line for line in result])
25 |     return result
26 | 
27 | 
28 | def write(parser_output_path, parser_tab_hh_path, skeleton_path):
29 |     assert os.path.exists(parser_output_path)
30 |     assert os.path.exists(parser_tab_hh_path)
31 |     LilyPondGrammarGenerator()._write_parser_syntax_skeleton(
32 |         skeleton_path,
33 |         parser_output_path,
34 |         parser_tab_hh_path,
35 |     )
36 | 
37 | 
38 | if __name__ == "__main__":
39 |     if len(sys.argv) < 4:
40 |         print(usage())
41 |         sys.exit(2)
42 |     parser_output_path = sys.argv[1]
43 |     parser_tab_hh_path = sys.argv[2]
44 |     skeleton_path = sys.argv[3]
45 |     write(parser_output_path, parser_tab_hh_path, skeleton_path)
46 | 


--------------------------------------------------------------------------------
/source/abjad/_indentlib.py:
--------------------------------------------------------------------------------
1 | INDENT = 4 * " "
2 | 


--------------------------------------------------------------------------------
/source/abjad/_version.py:
--------------------------------------------------------------------------------
1 | __version__ = "3.25"
2 | 


--------------------------------------------------------------------------------
/source/abjad/deprecated.py:
--------------------------------------------------------------------------------
1 | pass
2 | 


--------------------------------------------------------------------------------
/source/abjad/enums.py:
--------------------------------------------------------------------------------
 1 | """
 2 | Enumerations.
 3 | """
 4 | 
 5 | import enum
 6 | 
 7 | 
 8 | class Comparison(enum.Enum):
 9 |     """
10 |     Enumeration of amount comparisons.
11 |     """
12 | 
13 |     LESS = -1
14 |     EXACT = 0
15 |     MORE = 1
16 | 
17 | 
18 | class Horizontal(enum.Enum):
19 |     """
20 |     Enumeration of horizontal alignments.
21 |     """
22 | 
23 |     LEFT = -1
24 |     MIDDLE = 0
25 |     RIGHT = 1
26 | 
27 | 
28 | class Vertical(enum.Enum):
29 |     """
30 |     Enumeration of vertical alignments.
31 |     """
32 | 
33 |     DOWN = -1
34 |     CENTER = 0
35 |     UP = 1
36 | 
37 | 
38 | CENTER = Vertical.CENTER
39 | DOWN = Vertical.DOWN
40 | EXACT = Comparison.EXACT
41 | LEFT = Horizontal.LEFT
42 | LESS = Comparison.LESS
43 | MIDDLE = Horizontal.MIDDLE
44 | MORE = Comparison.MORE
45 | RIGHT = Horizontal.RIGHT
46 | UP = Vertical.UP
47 | 


--------------------------------------------------------------------------------
/source/abjad/exceptions.py:
--------------------------------------------------------------------------------
 1 | """
 2 | Custom exceptions.
 3 | """
 4 | 
 5 | 
 6 | class AssignabilityError(Exception):
 7 |     """
 8 |     Duration can not be assigned to note, rest or chord.
 9 |     """
10 | 
11 |     pass
12 | 
13 | 
14 | class ImpreciseMetronomeMarkError(Exception):
15 |     """
16 |     MetronomeMark is imprecise.
17 |     """
18 | 
19 |     pass
20 | 
21 | 
22 | class LilyPondParserError(Exception):
23 |     """
24 |     Can not parse input.
25 |     """
26 | 
27 |     pass
28 | 
29 | 
30 | class MissingContextError(Exception):
31 |     """
32 |     No context found.
33 |     """
34 | 
35 |     pass
36 | 
37 | 
38 | class MissingMetronomeMarkError(Exception):
39 |     """
40 |     No metronome mark found.
41 |     """
42 | 
43 |     pass
44 | 
45 | 
46 | class ParentageError(Exception):
47 |     """
48 |     A parentage error.
49 |     """
50 | 
51 |     pass
52 | 
53 | 
54 | class PersistentIndicatorError(Exception):
55 |     """
56 |     Persistent indicator already attached at same context.
57 |     """
58 | 
59 |     pass
60 | 
61 | 
62 | class SchemeParserFinishedError(Exception):
63 |     """
64 |     SchemeParser has finished parsing.
65 |     """
66 | 
67 |     pass
68 | 
69 | 
70 | class UnboundedTimeIntervalError(Exception):
71 |     """
72 |     Time interval has no bounds.
73 |     """
74 | 
75 |     pass
76 | 
77 | 
78 | class WellformednessError(Exception):
79 |     """
80 |     Score not well formed.
81 |     """
82 | 
83 |     pass
84 | 


--------------------------------------------------------------------------------
/source/abjad/ext/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/source/abjad/ext/__init__.py


--------------------------------------------------------------------------------
/source/abjad/parsers/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/source/abjad/parsers/__init__.py


--------------------------------------------------------------------------------
/source/abjad/parsers/parse.py:
--------------------------------------------------------------------------------
 1 | from .parser import LilyPondParser
 2 | from .reduced import parse_reduced_ly_syntax
 3 | 
 4 | _lilypond_parsers_by_language: dict = {}
 5 | 
 6 | 
 7 | def parse(string: str, language: str = "english", *, tag=None):
 8 |     r"""
 9 |     Parses LilyPond ``string``.
10 | 
11 |     ..  container:: example
12 | 
13 |         Parses LilyPond string with English note names:
14 | 
15 |         >>> container = abjad.parse("{c'4 d'4 e'4 f'4}")
16 |         >>> abjad.show(container) # doctest: +SKIP
17 | 
18 |         Parses LilyPond string with Dutch note names:
19 | 
20 |         >>> container = abjad.parse("{c'8 des' e' fis'}", language='nederlands')
21 |         >>> abjad.show(container) # doctest: +SKIP
22 | 
23 |         Tags output:
24 | 
25 |         >>> container = abjad.parse("{c'4 d'4 e'4 f'4}", tag=abjad.Tag("FOO"))
26 |         >>> string = abjad.lilypond(container, tags=True)
27 |         >>> print(string)
28 |           %! FOO
29 |         {
30 |               %! FOO
31 |             c'4
32 |               %! FOO
33 |             d'4
34 |               %! FOO
35 |             e'4
36 |               %! FOO
37 |             f'4
38 |           %! FOO
39 |         }
40 | 
41 |     Returns Abjad component.
42 |     """
43 |     if string.startswith("abj:"):
44 |         return parse_reduced_ly_syntax(string[4:])
45 |     if language not in _lilypond_parsers_by_language:
46 |         parser = LilyPondParser(default_language=language)
47 |         _lilypond_parsers_by_language[language] = parser
48 |     parser = _lilypond_parsers_by_language[language]
49 |     parser.tag = tag
50 |     if hasattr(parser, "_guile"):
51 |         parser._guile.tag = tag
52 |     if hasattr(parser, "_lexdef"):
53 |         parser._lexdef.tag = tag
54 |     if hasattr(parser, "_syndef"):
55 |         parser._syndef.tag = tag
56 |     result = parser(string)
57 |     return result
58 | 


--------------------------------------------------------------------------------
/source/abjad/py.typed:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/source/abjad/py.typed


--------------------------------------------------------------------------------
/source/abjad/scm/abjad-coloring.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | % COLORED MUSIC
 4 | 
 5 | abjad-color-music = #(
 6 |     define-music-function (color music) (symbol? ly:music?)
 7 |     #{
 8 |     \once \override Accidental.color = #(x11-color color)
 9 |     \once \override Beam.color = #(x11-color color)
10 |     \once \override Dots.color = #(x11-color color)
11 |     \once \override Flag.color = #(x11-color color)
12 |     \once \override MultiMeasureRest.color = #(x11-color color)
13 |     \once \override NoteHead.color = #(x11-color color)
14 |     \once \override RepeatTie.color = #(x11-color color)
15 |     \once \override Rest.color = #(x11-color color)
16 |     \once \override Stem.color = #(x11-color color)
17 |     \once \override StemTremolo.color = #(x11-color color)
18 |     $music
19 |     #}
20 |     )
21 | 
22 | abjad-invisible-music = #(
23 |     define-music-function (music) (ly:music?)
24 |     #{
25 |     \once \override Accidental.transparent = ##t
26 |     \once \override Dots.transparent = ##t
27 |     \once \override MultiMeasureRest.transparent = ##t
28 |     \once \override NoteHead.no-ledgers = ##t
29 |     \once \override NoteHead.transparent = ##t
30 |     \once \override RepeatTie.transparent = ##t
31 |     \once \override Stem.transparent = ##t
32 |     \once \override StemTremolo.transparent = ##t
33 |     $music
34 |     #}
35 |     )
36 | 
37 | abjad-invisible-music-coloring = #(
38 |     define-music-function (music) (ly:music?)
39 |     #{
40 |     \abjad-color-music #'salmon
41 |     $music
42 |     #}
43 |     )
44 | 


--------------------------------------------------------------------------------
/source/abjad/scm/abjad-hairpins.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | %{
 4 | 
 5 |   LilyPond includes a \flared-hairpin command. The length of the flares created
 6 |   by LilyPond's built-in \flared-hairpin command vary (very slightly) with the
 7 |   total length of the hairpin.
 8 | 
 9 |   The \abjad-flared-hairpin command defined here creates fixed-width flares;
10 |   these do not vary as a function of total hairpin length.
11 | 
12 |   The \elbowed-hairpin function is included in LilyPond and was originally
13 |   implemented by Mike Solomon. The fixed-width calculations included here were
14 |   inspired by a post Aaron Hill made on the LilyPond user list on 2019-11-17.
15 | 
16 | %}
17 | 
18 | abjad-flared-hairpin = #(lambda (grob)
19 |      (let* ((sten (ly:hairpin::print grob))
20 |             (xex (ly:stencil-extent sten X))
21 |             (yex (ly:stencil-extent sten Y))
22 |             (width (interval-length xex))
23 |             (height (/ (interval-length yex) 2))
24 |             (x (- 1 (/ 0.25 width)))
25 |             (y (* -1 (- 1 (/ 1 height)))))
26 |        (elbowed-hairpin `((0 . 0) (,x . ,y) (1 . 1)) #t)))
27 | 


--------------------------------------------------------------------------------
/source/abjad/scm/abjad-make-music-functions.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | % Use these functions to make music inside markup functions.
 4 | % Note that these are music functions and not markup functions.
 5 | % But you can use these music functions within markup functions.
 6 | 
 7 | 
 8 | abjad-make-note = #(define-music-function (length dots) (number? number?)
 9 |     (make-music
10 |         'SequentialMusic
11 |         'elements
12 |         (list (make-music
13 |                 'NoteEvent
14 |                 'duration
15 |                 (ly:make-duration length dots)
16 |                 'pitch
17 |                 (ly:make-pitch 0 0))))
18 |     )
19 | 
20 | abjad-make-tuplet-monad = #(
21 |     define-music-function (length dots n d) (number? number? number? number?)
22 |     (make-music
23 |         'SequentialMusic
24 |         'elements
25 |         (list (make-music
26 |                 'TimeScaledMusic
27 |                 'tweaks
28 |                 (list (cons (quote edge-height) (cons 0.7 0)))
29 |                 'denominator
30 |                 d
31 |                 'numerator
32 |                 n
33 |                 'element
34 |                 (make-music
35 |                     'SequentialMusic
36 |                     'elements
37 |                     (list (make-music
38 |                             'NoteEvent
39 |                             'duration
40 |                             (ly:make-duration length dots n d)
41 |                             'pitch
42 |                             (ly:make-pitch 0 0)))))))
43 |     )
44 | 


--------------------------------------------------------------------------------
/source/abjad/scm/abjad-metronome-marks.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | % METRONOME MARK FUNCTIONS
 4 | 
 5 | #(define-markup-command
 6 |     (abjad-metronome-mark-markup layout props
 7 |     duration-log dot-count stem-height units-per-minute)
 8 |     (number? number? number? markup?)
 9 |     (interpret-markup layout props
10 |     #{
11 |     \markup {
12 |         \fontsize #-6
13 |         \general-align #Y #down
14 |         \note-by-number #duration-log #dot-count #stem-height
15 |         \upright =
16 |         \hspace #-0.15
17 |         \upright
18 |         #units-per-minute
19 |         % TODO: remove final hspace; use TextSpanner overrides instead:
20 |         \hspace #1
21 |     }
22 |     #}
23 |     )
24 | )
25 | 
26 | #(define-markup-command
27 |     (abjad-metronome-mark-mixed-number-markup layout props
28 |     duration-log dot-count stem-height units-per-minute n d)
29 |     (number? number? number? markup? markup? markup?)
30 |     (interpret-markup layout props
31 |     #{
32 |     \markup {
33 |         \fontsize #-6
34 |         \general-align #Y #down
35 |         \note-by-number #duration-log #dot-count #stem-height
36 |         \upright {
37 |             =
38 |             \hspace #-0.15
39 |             #units-per-minute
40 |             \hspace #-0.15
41 |             \raise #0.2
42 |             \fontsize #-4
43 |             \fraction #n #d
44 |         }
45 |         % TODO: remove final hspace; use TextSpanner overrides instead:
46 |         \hspace #1
47 |     }
48 |     #}
49 |     )
50 | )
51 | 
52 | #(define-markup-command
53 |     (abjad-parenthesized-metronome-mark-markup layout props
54 |     duration-log dot-count stem-height units-per-minute)
55 |     (number? number? number? markup?)
56 |     (interpret-markup layout props
57 |     #{
58 |     \markup {
59 |         \upright
60 |         (
61 |         \hspace #-0.75
62 |         \fontsize #-6
63 |         \general-align #Y #down
64 |         \note-by-number #duration-log #dot-count #stem-height
65 |         \upright =
66 |         \hspace #-0.15
67 |         \upright
68 |         #units-per-minute
69 |         \hspace #-0.75
70 |         \upright
71 |         )
72 |         % TODO: remove final hspace; use TextSpanner overrides instead:
73 |         \hspace #0.5
74 |     }
75 |     #}
76 |     )
77 | )
78 | 


--------------------------------------------------------------------------------
/source/abjad/scm/abjad-spanners.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | % GLISSANDO OVERRIDES
 4 | 
 5 | abjad-continuous-glissando = #(
 6 |     define-music-function (music) (ly:music?)
 7 |     #{
 8 |     \override Glissando.bound-details.left.padding = -1
 9 |     \override Glissando.bound-details.left.start-at-dot = ##f
10 |     \override Glissando.bound-details.right.padding = 0
11 |     $music
12 |     #}
13 |     )
14 | 
15 | abjad-revert-continuous-glissando = #(
16 |     define-music-function (music) (ly:music?)
17 |     #{
18 |     \revert Glissando.bound-details.left.padding
19 |     \revert Glissando.bound-details.left.start-at-dot
20 |     \revert Glissando.bound-details.right.padding
21 |     $music
22 |     #}
23 |     )
24 | 


--------------------------------------------------------------------------------
/source/abjad/scm/abjad.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | \include "abjad-coloring.ily"
 3 | \include "abjad-hairpins.ily"
 4 | \include "abjad-metric-modulations.ily"
 5 | \include "abjad-spanners.ily"
 6 | \include "abjad-text-spanner-line-styles.ily"
 7 | \include "default-et-accidental-markups.ily"
 8 | \include "nalesnik-slash.ily"
 9 | \include "nalesnik-text-spanner-id.ily"
10 | 


--------------------------------------------------------------------------------
/source/abjad/scm/all-edo-markups-example.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | #(set-default-paper-size "letterportrait")
 3 | #(set-global-staff-size 15)
 4 | 
 5 | \header {tagline = ##f}
 6 | 
 7 | \paper {
 8 |   system-system-spacing = #'((basic-distance . 30) (minimum-distance . 30) (padding . 6))
 9 | }
10 | 
11 | \layout {
12 | 	indent = #1
13 | 	ragged-last = ##t
14 |     ragged-right = ##t
15 | 	\override Beam.stencil = ##f
16 | 	\override Staff.BarLine.stencil = ##f
17 | 	\override Flag.stencil = ##f
18 | 	\override Staff.TimeSignature.stencil = ##f
19 | 	\override SpacingSpanner.strict-grace-spacing = ##t
20 | 	\override SpacingSpanner.uniform-stretching = ##t
21 | 	\override SpacingSpanner.strict-note-spacing = ##t
22 |     \override SpacingSpanner.uniform-stretching = ##t
23 | \context {
24 | 	\Score
25 | 	proportionalNotationDuration = \musicLength 1*1/30
26 | 	barNumberVisibility = ##f
27 | }
28 | }
29 | 


--------------------------------------------------------------------------------
/source/abjad/scm/default-et-accidental-markups.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | \include "fraction-accidental-markups.ily"
 3 | \include "general-et-accidental-markups.ily"
 4 | 
 5 | % one quarter tone down
 6 | one-quarter-flat-markup = \markup \musicglyph "accidentals.mirroredflat"
 7 | 
 8 | % three quarter tones down
 9 | three-quarters-flat-markup = \markup \musicglyph "accidentals.mirroredflat.flat"
10 | 
11 | % three eighth tones down
12 | three-eighths-flat-markup = \markup
13 |     \combine
14 |     \musicglyph "accidentals.mirroredflat"
15 |     \path #0.15
16 |       #'(
17 |           (moveto 0.6 -0.65)
18 |           (lineto 0.6 -1.4)
19 |           (moveto 0.3 -0.7)
20 |           (lineto 0.6 -1.48)
21 |           (lineto 0.9 -0.7)
22 |           )
23 | 
24 | % seven eighth tones down
25 | seven-eighths-flat-markup = \markup
26 |     \combine
27 |     \musicglyph "accidentals.mirroredflat.flat"
28 |     \path #0.15
29 |       #'(
30 |           (moveto 0.79 -0.65)
31 |           (lineto 0.79 -1.4)
32 |           (moveto 0.49 -0.7)
33 |           (lineto 0.79 -1.48)
34 |           (lineto 1.09 -0.7)
35 |           )
36 | 


--------------------------------------------------------------------------------
/source/abjad/scm/ekmelos-edo-accidental-markups.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | \include "fraction-accidental-markups.ily"
 3 | \include "general-edo-accidental-markups.ily"
 4 | 
 5 | 
 6 | #(define-markup-command
 7 |     (ekmelos-five layout props markup)
 8 |     (markup?)
 9 |     (interpret-markup layout props
10 |     #{
11 |     \markup
12 |     \fontsize #5
13 |     \override #'(font-name . "ekmelos")
14 |     #markup
15 |     #}))
16 | 
17 | one-quarter-flat-markup = \markup \ekmelos-five \char ##xe480
18 | 
19 | three-quarters-flat-markup = \markup \ekmelos-five \char ##xe296
20 | 
21 | three-eighths-flat-markup = \markup
22 |     \ekmelos-five
23 |     \combine
24 |     \char ##xe480
25 |     \path #0.15
26 |       #'(
27 |           (moveto 0.74 -0.65)
28 |           (lineto 0.74 -1.4)
29 |           (moveto 0.44 -0.7)
30 |           (lineto 0.74 -1.48)
31 |           (lineto 1.04 -0.7)
32 |           )
33 | 
34 | seven-eighths-flat-markup = \markup
35 |     \ekmelos-five
36 |     \combine
37 |     \char ##xe296
38 |     \path #0.15
39 |       #'(
40 |           (moveto 0.77 -0.65)
41 |           (lineto 0.77 -1.4)
42 |           (moveto 0.47 -0.7)
43 |           (lineto 0.77 -1.48)
44 |           (lineto 1.07 -0.7)
45 |           )
46 | 


--------------------------------------------------------------------------------
/source/abjad/scm/ekmelos-ji-accidental-markups.ily:
--------------------------------------------------------------------------------
  1 | \version "2.25.16"
  2 | font-name = "ekmelos"
  3 | \include "markup-functions.ily"
  4 | 
  5 | 
  6 | #(define-markup-command
  7 |     (ekmelos-five layout props markup)
  8 |     (markup?)
  9 |     (interpret-markup layout props
 10 |     #{
 11 |     \markup
 12 |     \fontsize #5
 13 |     \override #'(font-name . "ekmelos")
 14 |     #markup
 15 |     #}))
 16 | 
 17 | % tempered accidentals
 18 | tempered-double-flat = \markup
 19 |     \combine
 20 |     \musicglyph "accidentals.flatflat"
 21 |     \path #0.15
 22 |       #'(
 23 |           (moveto 0.4 1.85)
 24 |           (lineto 0.65 1.85)
 25 |           (lineto 0.9 1.85)
 26 |           )
 27 | 
 28 | 
 29 | tempered-three-quarters-flat = \markup
 30 |     \ekmelos-five
 31 |     \combine
 32 |     \char ##xe296
 33 |     \path #0.15
 34 |       #'(
 35 |           (moveto 0.53 1.85)
 36 |           (lineto 0.78 1.85)
 37 |           (lineto 1.03 1.85)
 38 |           )
 39 | 
 40 | tempered-flat = \markup
 41 |     \combine
 42 |     \musicglyph "accidentals.flat"
 43 |     \path #0.15
 44 |       #'(
 45 |           (moveto -0.25 1.85)
 46 |           (lineto 0 1.85)
 47 |           (lineto 0.25 1.85)
 48 |           )
 49 | 
 50 | tempered-quarter-flat = \markup
 51 |     \ekmelos-five
 52 |     \combine
 53 |     \char ##xe480
 54 |     \path #0.15
 55 |       #'(
 56 |           (moveto 0.53 1.85)
 57 |           (lineto 0.78 1.85)
 58 |           (lineto 1.03 1.85)
 59 |           )
 60 | 
 61 | tempered-natural = \markup
 62 |     \combine
 63 |     \musicglyph "accidentals.natural"
 64 |     \path #0.15
 65 |       #'(
 66 |           (moveto -0.18 1.5)
 67 |           (lineto 0.07 1.5)
 68 |           (lineto 0.32 1.5)
 69 |           )
 70 | 
 71 | tempered-quarter-sharp = \markup
 72 |     \combine
 73 |     \musicglyph "accidentals.sharp.slashslash.stem"
 74 |     \path #0.15
 75 |       #'(
 76 |           (moveto 0.1 1.25)
 77 |           (lineto 0.35 1.25)
 78 |           (lineto 0.6 1.25)
 79 |           )
 80 | 
 81 | tempered-sharp = \markup
 82 |     \combine
 83 |     \musicglyph "accidentals.sharp"
 84 |     \path #0.15
 85 |       #'(
 86 |           (moveto 0.55 1.5)
 87 |           (lineto 0.8 1.5)
 88 |           (lineto 1.05 1.5)
 89 |           )
 90 | 
 91 | tempered-three-quarters-sharp = \markup
 92 |     \combine
 93 |     \musicglyph "accidentals.sharp.slashslash.stemstemstem"
 94 |     \path #0.15
 95 |       #'(
 96 |           (moveto 1 1.5)
 97 |           (lineto 1.25 1.5)
 98 |           (lineto 1.5 1.5)
 99 |           )
100 | 
101 | tempered-double-sharp = \markup
102 |     \combine
103 |     \musicglyph "accidentals.doublesharp"
104 |     \path #0.15
105 |       #'(
106 |           (moveto 0.5 0)
107 |           (lineto 0.5 1.05)
108 |           (moveto 0.25 1.05)
109 |           (lineto 0.5 1.05)
110 |           (lineto 0.75 1.05)
111 |           )
112 | 


--------------------------------------------------------------------------------
/source/abjad/scm/fraction-accidental-markups.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | 
 4 | #(define-markup-command
 5 |     (accidental-fraction-down-markup layout props num den)
 6 |     (markup? markup?)
 7 |     (interpret-markup layout props
 8 |     #{
 9 |     \markup
10 |     \pad-markup #0.125
11 | 	\override #'(style . outline)
12 |     \override #'(thickness . 0.8)
13 | 	\whiteout
14 |     \fontsize #-4
15 | 	\bold
16 |     \translate #'(-1 . 0.15)
17 | 	\center-column {
18 |     #num
19 | 	\translate #'(0 . 2/3)
20 | 	#den
21 | 	\translate #'(0 . 25/16)
22 | 	\musicglyph "arrowheads.close.1M1"
23 | 	}
24 |     #}))
25 | 
26 | #(define-markup-command
27 |     (accidental-fraction-up-markup layout props num den)
28 |     (markup? markup?)
29 |     (interpret-markup layout props
30 |     #{
31 |     \markup
32 |     \pad-markup #0.125
33 | 	\override #'(style . outline)
34 |     \override #'(thickness . 0.8)
35 | 	\whiteout
36 |     \fontsize #-4
37 | 	\bold
38 |     \translate #'(-1 . 2)
39 | 	\center-column {
40 | 	\translate #'(0 . -1/12)
41 | 	\musicglyph "arrowheads.close.11"
42 |     #num
43 | 	\translate #'(0 . 2/3)
44 | 	#den
45 | 	}
46 |     #}))
47 | 
48 | 
49 | 
50 | one-third-sharp-markup = \markup \accidental-fraction-up-markup 1 3
51 | two-thirds-sharp-markup = \markup \accidental-fraction-up-markup 2 3
52 | one-third-flat-markup = \markup \accidental-fraction-down-markup 1 3
53 | two-thirds-flat-markup = \markup \accidental-fraction-down-markup 2 3
54 | one-sixth-sharp-markup = \markup \accidental-fraction-up-markup 1 6
55 | five-sixths-sharp-markup = \markup \accidental-fraction-up-markup 5 6
56 | one-sixth-flat-markup = \markup \accidental-fraction-down-markup 1 6
57 | five-sixths-flat-markup = \markup \accidental-fraction-down-markup 5 6
58 | one-twelfth-sharp-markup = \markup \accidental-fraction-up-markup 1 12
59 | five-twelfths-sharp-markup = \markup \accidental-fraction-up-markup 5 12
60 | seven-twelfths-sharp-markup = \markup \accidental-fraction-up-markup 7 12
61 | eleven-twelfths-sharp-markup = \markup \accidental-fraction-up-markup 11 12
62 | one-twelfth-flat-markup = \markup \accidental-fraction-down-markup 1 12
63 | five-twelfths-flat-markup = \markup \accidental-fraction-down-markup 5 12
64 | seven-twelfths-flat-markup = \markup \accidental-fraction-down-markup 7 12
65 | eleven-twelfths-flat-markup = \markup \accidental-fraction-down-markup 11 12
66 | one-fifth-sharp-markup = \markup \accidental-fraction-up-markup 1 5
67 | two-fifths-sharp-markup = \markup \accidental-fraction-up-markup 2 5
68 | three-fifths-sharp-markup = \markup \accidental-fraction-up-markup 3 5
69 | four-fifths-sharp-markup = \markup \accidental-fraction-up-markup 4 5
70 | one-fifth-flat-markup = \markup \accidental-fraction-down-markup 1 5
71 | two-fifths-flat-markup = \markup \accidental-fraction-down-markup 2 5
72 | three-fifths-flat-markup = \markup \accidental-fraction-down-markup 3 5
73 | four-fifths-flat-markup = \markup \accidental-fraction-down-markup 4 5
74 | one-tenth-sharp-markup = \markup \accidental-fraction-up-markup 1 10
75 | three-tenths-sharp-markup = \markup \accidental-fraction-up-markup 3 10
76 | seven-tenths-sharp-markup = \markup \accidental-fraction-up-markup 7 10
77 | one-tenth-flat-markup = \markup \accidental-fraction-down-markup 1 10
78 | three-tenths-flat-markup = \markup \accidental-fraction-down-markup 3 10
79 | seven-tenths-flat-markup = \markup \accidental-fraction-down-markup 7 10
80 | 


--------------------------------------------------------------------------------
/source/abjad/scm/general-et-accidental-markups.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | 
 4 | abjad-natural-markup = \markup
 5 |     \musicglyph "accidentals.natural"
 6 | 
 7 | abjad-sharp-markup = \markup
 8 |     \musicglyph "accidentals.sharp"
 9 | 
10 | abjad-flat-markup = \markup
11 |     \musicglyph "accidentals.flat"
12 | 
13 | double-sharp-markup = \markup
14 |     \musicglyph "accidentals.doublesharp"
15 | 
16 | double-flat-markup = \markup
17 |     \musicglyph "accidentals.flatflat"
18 | 
19 | one-quarter-sharp-markup = \markup
20 |     \musicglyph "accidentals.sharp.slashslash.stem"
21 | 
22 | three-quarters-sharp-markup = \markup
23 |     \musicglyph "accidentals.sharp.slashslash.stemstemstem"
24 | 
25 | one-eighth-sharp-markup = \markup
26 |     \combine
27 |     \musicglyph "accidentals.natural"
28 |     \path #0.15
29 |       #'(
30 |           (moveto -0.22 0.9)
31 |           (lineto 0.08 1.7)
32 |           (lineto 0.38 0.9)
33 |           )
34 | 
35 | three-eighths-sharp-markup = \markup
36 |     \combine
37 |     \musicglyph "accidentals.sharp.slashslash.stem"
38 |     \path #0.15
39 |       #'(
40 |           (moveto 0.35 1.15)
41 |           (lineto 0.35 2.0)
42 |           (moveto 0.05 1.2)
43 |           (lineto 0.35 2.0)
44 |           (lineto 0.65 1.2)
45 |           )
46 | 
47 | five-eighths-sharp-markup = \markup
48 |     \combine
49 |     \musicglyph "accidentals.sharp"
50 |     \path #0.15
51 |       #'(
52 |           (moveto 0.8 1.15)
53 |           (lineto 0.8 2.0)
54 |           (moveto 0.5 1.2)
55 |           (lineto 0.8 2.0)
56 |           (lineto 1.1 1.2)
57 |           )
58 | 
59 | seven-eighths-sharp-markup = \markup
60 |     \combine
61 |     \musicglyph "accidentals.sharp.slashslash.stemstemstem"
62 |     \path #0.15
63 |       #'(
64 |           (moveto 1.25 1.15)
65 |           (lineto 1.25 2.0)
66 |           (moveto 0.95 1.2)
67 |           (lineto 1.25 2.0)
68 |           (lineto 1.55 1.2)
69 |           )
70 | 
71 | one-eighth-flat-markup = \markup
72 |     \combine
73 |     \musicglyph "accidentals.natural"
74 |     \path #0.15
75 |       #'(
76 |           (moveto 0.6 -0.95)
77 |           (lineto 0.6 -1.7)
78 |           (moveto 0.3 -1)
79 |           (lineto 0.6 -1.78)
80 |           (lineto 0.9 -1)
81 |           )
82 | 
83 | five-eighths-flat-markup = \markup
84 |     \combine
85 |     \musicglyph "accidentals.flat"
86 |     \path #0.15
87 |       #'(
88 |           (moveto 0.03 -0.65)
89 |           (lineto 0.03 -1.4)
90 |           (moveto -0.29 -0.7)
91 |           (lineto 0.03 -1.48)
92 |           (lineto 0.33 -0.7)
93 |           )
94 | 


--------------------------------------------------------------------------------
/source/abjad/scm/harmonic-series-layout.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | \layout
 4 | {
 5 |   indent = #1
 6 |   ragged-last = ##t
 7 |   ragged-right = ##t
 8 |   \accidentalStyle dodecaphonic
 9 |   \override Beam.transparent = ##t
10 |   \override Stem.transparent = ##t
11 |   \override Staff.BarLine.stencil = ##f
12 |   \override Flag.transparent = ##t
13 |   \override Staff.TimeSignature.stencil = ##f
14 |   \override SpacingSpanner.strict-grace-spacing = ##t
15 |   \override SpacingSpanner.uniform-stretching = ##t
16 |   \override SpacingSpanner.strict-note-spacing = ##t
17 |   \override SpacingSpanner.uniform-stretching = ##t
18 |   \context
19 |   {
20 |       \Score
21 |       proportionalNotationDuration = \musicLength 1*1/30
22 |   }
23 | }
24 | 


--------------------------------------------------------------------------------
/source/abjad/scm/heji2-ji-accidental-markups.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | font-name = "HEJI2"
 3 | \include "markup-functions.ily"
 4 | 
 5 | % tempered accidentals
 6 | 
 7 | tempered-double-flat = \markup \letter-heji-accidental-markup #"A"
 8 | tempered-three-quarters-flat = \markup \letter-heji-accidental-markup #"ia"
 9 | tempered-flat = \markup \letter-heji-accidental-markup #"a"
10 | tempered-quarter-flat = \markup \letter-heji-accidental-markup #"i"
11 | tempered-natural = \markup \letter-heji-accidental-markup #"j"
12 | tempered-quarter-sharp = \markup \letter-heji-accidental-markup #"r"
13 | tempered-sharp = \markup \letter-heji-accidental-markup #"z"
14 | tempered-three-quarters-sharp = \markup \letter-heji-accidental-markup #"rz"
15 | tempered-double-sharp = \markup \letter-heji-accidental-markup #"Z"
16 | 


--------------------------------------------------------------------------------
/source/abjad/scm/nalesnik-slash.ily:
--------------------------------------------------------------------------------
 1 | \version "2.25.16"
 2 | 
 3 | % FROM DAVID NALESNIK:
 4 | %
 5 | % http://lilypond.1069038.n5.nabble.com/So-slashed-beamed-grace-notes-td152817.html
 6 | %
 7 | % Implements slash command to slash run of beamed notes:
 8 | %
 9 | %    \slash
10 | 
11 | slash = { 
12 |   $(remove-grace-property 'Voice 'Stem 'direction) 
13 |   \once \override Stem.stencil = 
14 |   #(lambda (grob) 
15 |     (let* ((x-parent (ly:grob-parent grob X)) 
16 |            (is-rest? (ly:grob? (ly:grob-object x-parent 'rest)))) 
17 |      (if is-rest? 
18 |       empty-stencil 
19 |       (let* ((dir (ly:grob-property grob 'direction)) 
20 |              (stem (ly:stem::print grob)) 
21 |              (stem-y (ly:grob-extent grob grob Y)) 
22 |              (stem-length (- (cdr stem-y) (car stem-y))) 
23 |              (corr (if (= dir 1) (car stem-y) (cdr stem-y)))) 
24 |        (ly:stencil-add 
25 |         stem 
26 |         (grob-interpret-markup grob 
27 |          (markup #:translate (cons -0.5 (+ corr (* dir (1- (/ stem-length 1.1))))) 
28 |           #:draw-line (cons 1.9 (* dir 1.7))))))))) 
29 | } 
30 | 


--------------------------------------------------------------------------------
/tests/conftest.py:
--------------------------------------------------------------------------------
 1 | import os
 2 | import pathlib
 3 | import shutil
 4 | 
 5 | import pytest
 6 | 
 7 | pytest_plugins = "sphinx.testing.fixtures"
 8 | 
 9 | collect_ignore = ["roots"]
10 | 
11 | 
12 | @pytest.fixture(scope="session")
13 | def remove_sphinx_projects(sphinx_test_tempdir):
14 |     # Even upon exception, remove any directory from temp area
15 |     # which looks like a Sphinx project. This ONLY runs once.
16 |     roots_path = pathlib.Path(sphinx_test_tempdir)
17 |     for d in roots_path.iterdir():
18 |         if d.is_dir():
19 |             if pathlib.Path(d, "_build").exists():
20 |                 # This directory is a Sphinx project, remove it
21 |                 shutil.rmtree(str(d))
22 |     yield
23 | 
24 | 
25 | @pytest.fixture()
26 | def rootdir(remove_sphinx_projects):
27 |     roots = pathlib.Path(os.path.dirname(__file__) or ".").absolute() / "roots"
28 |     yield roots
29 | 


--------------------------------------------------------------------------------
/tests/roots/test-ext-sphinx/_static/.gitignore:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Abjad/abjad/99fecb60a95afda7f32044eefeff0ef4291cb6be/tests/roots/test-ext-sphinx/_static/.gitignore


--------------------------------------------------------------------------------
/tests/roots/test-ext-sphinx/conf.py:
--------------------------------------------------------------------------------
1 | master_doc = "index"
2 | 
3 | extensions = ["uqbar.sphinx.book", "abjad.ext.sphinx"]
4 | 
5 | html_static_path = ["_static"]
6 | 
7 | uqbar_book_console_setup = ["import abjad"]
8 | uqbar_book_extensions = ["abjad.ext.sphinx.LilyPondExtension"]
9 | 


--------------------------------------------------------------------------------
/tests/roots/test-ext-sphinx/index.rst:
--------------------------------------------------------------------------------
 1 | Fake Docs
 2 | =========
 3 | 
 4 | This will show the cropped version of the staff:
 5 | 
 6 | ::
 7 | 
 8 |     >>> staff = abjad.Staff("c' d' e' f'")
 9 |     >>> abjad.show(staff)
10 | 
11 | This will show the uncropped version of the staff:
12 | 
13 | ..  book::
14 |     :lilypond/no-trim:
15 | 
16 |     >>> abjad.show(staff)
17 | 
18 | This will show the single-SVG cropped version of the 4-page staff:
19 | 
20 | ::
21 | 
22 |     >>> multipage_staff = abjad.Staff("c'1 d'1 e'1 f'1")
23 |     >>> for note in multipage_staff:
24 |     ...     page_break = abjad.LilyPondLiteral(r"\pageBreak", site="after")
25 |     ...     abjad.attach(page_break, note)
26 |     ...
27 |     >>> abjad.show(multipage_staff)
28 | 
29 | This will show four individual pages, because there is no single SVG for
30 | uncropped output for the 4-page staff:
31 | 
32 | ..  book::
33 |     :lilypond/no-trim:
34 | 
35 |     >>> abjad.show(multipage_staff)
36 | 
37 | This will show pages 2, 3 and 1 of the 4-page staff:
38 | 
39 | ..  book::
40 |     :lilypond/pages: 2-3,1
41 | 
42 |     >>> abjad.show(multipage_staff)
43 | 
44 | This will show all four pages, in a 2x2 grid:
45 | 
46 | ..  book::
47 |     :lilypond/with-columns: 2
48 |     :lilypond/pages: 1-4
49 | 
50 |     >>> abjad.show(multipage_staff)
51 | 


--------------------------------------------------------------------------------
/tests/test_Accidental.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | values = [
 6 |     ("####", 4.0, "ssss"),
 7 |     ("###", 3.0, "sss"),
 8 |     ("###+", 3.5, "sssqs"),
 9 |     ("##", 2.0, "ss"),
10 |     ("##+", 2.5, "ssqs"),
11 |     ("#", 1.0, "s"),
12 |     ("#+", 1.5, "tqs"),
13 |     ("", 0.0, ""),
14 |     ("+", 0.5, "qs"),
15 |     ("b", -1.0, "f"),
16 |     ("bb", -2.0, "ff"),
17 |     ("bbb", -3.0, "fff"),
18 |     ("bbbb", -4.0, "ffff"),
19 |     ("bbb~", -3.5, "fffqf"),
20 |     ("bb~", -2.5, "ffqf"),
21 |     ("b~", -1.5, "tqf"),
22 |     ("f", -1.0, "f"),
23 |     ("ff", -2.0, "ff"),
24 |     ("fff", -3.0, "fff"),
25 |     ("ffff", -4.0, "ffff"),
26 |     ("fffqf", -3.5, "fffqf"),
27 |     ("ffqf", -2.5, "ffqf"),
28 |     ("fqf", -1.5, "tqf"),
29 |     ("qf", -0.5, "qf"),
30 |     ("qs", 0.5, "qs"),
31 |     ("s", 1.0, "s"),
32 |     ("sqs", 1.5, "tqs"),
33 |     ("ss", 2.0, "ss"),
34 |     ("ssqs", 2.5, "ssqs"),
35 |     ("sss", 3.0, "sss"),
36 |     ("sssqs", 3.5, "sssqs"),
37 |     ("ssss", 4.0, "ssss"),
38 |     ("tqf", -1.5, "tqf"),
39 |     ("tqs", 1.5, "tqs"),
40 |     ("~", -0.5, "qf"),
41 |     (-0, -0.0, ""),
42 |     (-0.0, 0.0, ""),
43 |     (-0.5, -0.5, "qf"),
44 |     (-1, -1.0, "f"),
45 |     (-1.0, -1.0, "f"),
46 |     (-1.5, -1.5, "tqf"),
47 |     (-2, -2.0, "ff"),
48 |     (-2.0, -2.0, "ff"),
49 |     (-2.5, -2.5, "ffqf"),
50 |     (-3, -3.0, "fff"),
51 |     (-3.0, -3.0, "fff"),
52 |     (0, 0.0, ""),
53 |     (0.0, 0.0, ""),
54 |     (0.5, 0.5, "qs"),
55 |     (1, 1.0, "s"),
56 |     (1.0, 1.0, "s"),
57 |     (1.5, 1.5, "tqs"),
58 |     (2, 2.0, "ss"),
59 |     (2.0, 2.0, "ss"),
60 |     (2.5, 2.5, "ssqs"),
61 |     (3, 3.0, "sss"),
62 |     (3.0, 3.0, "sss"),
63 |     (None, 0.0, ""),
64 | ]
65 | 
66 | 
67 | @pytest.mark.parametrize("input_, semitones, string", values)
68 | def test_init(input_, semitones, string):
69 |     accidental = abjad.Accidental(input_)
70 |     assert accidental.semitones == semitones
71 |     assert str(accidental) == string
72 | 
73 | 
74 | values = [
75 |     ("bf,", -1, "f"),
76 |     ("c'", 0, ""),
77 |     ("cs'", 1, "s"),
78 |     ("gff''", -2, "ff"),
79 |     ("dss,,", 2, "ss"),
80 |     (("bf", 2), -1, "f"),
81 |     (("c", 4), 0, ""),
82 |     (("cs", 4), 1, "s"),
83 |     (("dss", 1), 2, "ss"),
84 |     (("gff", 5), -2, "ff"),
85 | ]
86 | 
87 | 
88 | @pytest.mark.parametrize("input_, semitones, string", values)
89 | def test_init_from_named_pitch(input_, semitones, string):
90 |     accidental = abjad.NamedPitch(input_).accidental
91 |     assert accidental.semitones == semitones
92 |     assert str(accidental) == string
93 | 


--------------------------------------------------------------------------------
/tests/test_AfterGraceContainer.py:
--------------------------------------------------------------------------------
 1 | import abjad
 2 | 
 3 | 
 4 | def test_AfterGraceContainer_01():
 5 |     r"""
 6 |     REGRESSION. LilyPond \afterGrace must lexically precede LilyPond \pitchedTrill.
 7 |     """
 8 | 
 9 |     voice = abjad.Voice("c'1")
10 |     container = abjad.IndependentAfterGraceContainer("e'8")
11 |     voice.append(container)
12 |     voice.append("r4")
13 |     start_trill_span = abjad.StartTrillSpan(pitch=abjad.NamedPitch("D4"))
14 |     abjad.attach(start_trill_span, voice[0])
15 |     stop_trill_span = abjad.StopTrillSpan()
16 |     abjad.attach(stop_trill_span, voice[-1])
17 | 
18 |     assert abjad.lilypond(voice) == abjad.string.normalize(
19 |         r"""
20 |         \new Voice
21 |         {
22 |             \afterGrace
23 |             \pitchedTrill
24 |             c'1
25 |             \startTrillSpan d'
26 |             {
27 |                 e'8
28 |             }
29 |             r4
30 |             \stopTrillSpan
31 |         }
32 |         """
33 |     )
34 | 


--------------------------------------------------------------------------------
/tests/test_Cluster.py:
--------------------------------------------------------------------------------
 1 | import abjad
 2 | 
 3 | 
 4 | def test_Cluster___init___01():
 5 |     """
 6 |     Cluster can be empty.
 7 |     """
 8 |     cluster = abjad.Cluster([])
 9 |     assert not cluster.simultaneous
10 |     assert len(cluster) == 0
11 |     assert abjad.lilypond(cluster) == abjad.string.normalize(
12 |         r"""
13 |         \makeClusters {
14 |         }
15 |         """
16 |     )
17 | 
18 | 
19 | def test_Cluster___init___02():
20 |     cluster = abjad.Cluster("cs'4 cs'4 cs'4 cs'4")
21 |     assert isinstance(cluster, abjad.Cluster)
22 |     assert not cluster.simultaneous
23 |     assert len(cluster) == 4
24 |     assert abjad.lilypond(cluster) == abjad.string.normalize(
25 |         r"""
26 |         \makeClusters {
27 |             cs'4
28 |             cs'4
29 |             cs'4
30 |             cs'4
31 |         }
32 |         """
33 |     )
34 | 


--------------------------------------------------------------------------------
/tests/test_Component.py:
--------------------------------------------------------------------------------
 1 | import abjad
 2 | 
 3 | 
 4 | def test_Component__sibling_01():
 5 |     """
 6 |     Returns component when index is in range.
 7 |     """
 8 | 
 9 |     staff = abjad.Staff("c' d' e' f'")
10 |     assert staff[1]._sibling(1) is staff[2]
11 |     assert staff[1]._sibling(-1) is staff[0]
12 | 
13 | 
14 | def test_Component__sibling_02():
15 |     """
16 |     Returns none when component has no parent.
17 |     """
18 | 
19 |     staff = abjad.Staff("c' d' e' f'")
20 |     assert staff._sibling(1) is None
21 | 
22 | 
23 | def test_Component__sibling_03():
24 |     staff = abjad.Staff(r"c'4 \tuplet 3/2 { d'8 e'8 f'8 } g'2")
25 | 
26 |     assert abjad.lilypond(staff) == abjad.string.normalize(
27 |         r"""
28 |         \new Staff
29 |         {
30 |             c'4
31 |             \tuplet 3/2
32 |             {
33 |                 d'8
34 |                 e'8
35 |                 f'8
36 |             }
37 |             g'2
38 |         }
39 |         """
40 |     )
41 | 
42 |     leaves = abjad.select.leaves(staff)
43 |     tuplet = staff[1]
44 | 
45 |     assert leaves[0]._sibling(-1) is None
46 |     assert leaves[0]._sibling(1) is tuplet
47 | 
48 |     assert tuplet._sibling(-1) is leaves[0]
49 |     assert tuplet._sibling(1) is leaves[4]
50 | 
51 |     assert leaves[1]._sibling(-1) is leaves[0]
52 |     assert leaves[1]._sibling(1) is leaves[2]
53 | 


--------------------------------------------------------------------------------
/tests/test_Leaf.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | def test_Leaf_duration_assign_01():
 7 |     """
 8 |     Written duration can be assigned a duration.
 9 |     """
10 | 
11 |     note = abjad.Note(1, (1, 4))
12 |     note.written_duration = abjad.Duration(1, 8)
13 |     assert note.written_duration == abjad.Duration(1, 8)
14 | 
15 | 
16 | def test_Leaf_duration_assign_02():
17 |     """
18 |     Written duration can be assigned an integer.
19 |     """
20 | 
21 |     note = abjad.Note(1, (1, 4))
22 |     note.written_duration = 2
23 |     assert note.written_duration == abjad.Duration(2, 1)
24 | 
25 | 
26 | def test_Leaf_duration_assign_03():
27 |     """
28 |     Written duration can be assigned an tuple.
29 |     """
30 | 
31 |     note = abjad.Note(1, (1, 4))
32 |     note.written_duration = (1, 2)
33 |     assert note.written_duration == abjad.Duration(1, 2)
34 | 
35 | 
36 | def test_Leaf_duration_compare_01():
37 |     """
38 |     Written durations can be evaluated for equality with durations.
39 |     """
40 | 
41 |     note = abjad.Note("c'4")
42 |     assert note.written_duration == abjad.Duration(1, 4)
43 | 
44 | 
45 | def test_Leaf_duration_compare_02():
46 |     """
47 |     Written durations can be evaluated for equality with integers.
48 |     """
49 | 
50 |     note = abjad.Note(0, 1)
51 |     assert note.written_duration == 1
52 | 
53 | 
54 | def test_Leaf_duration_compare_03():
55 |     """
56 |     Written durations can NOT be evaluated for equality with tuples.
57 |     """
58 | 
59 |     note = abjad.Note("c'4")
60 |     assert note.written_duration == abjad.Duration(1, 4)
61 |     assert note.written_duration != (1, 4)
62 |     assert note.written_duration != "foo"
63 | 
64 | 
65 | def test_Leaf_written_duration_01():
66 |     """
67 |     Leaf durations can go up to 'maxima...': duration < (16, 1).
68 |     """
69 | 
70 |     note = abjad.Note(1, 2)
71 | 
72 |     assert abjad.lilypond(note) == "cs'\\breve"
73 |     note.written_duration = abjad.Duration(3)
74 |     assert abjad.lilypond(note) == "cs'\\breve."
75 |     note.written_duration = abjad.Duration(4)
76 |     assert abjad.lilypond(note) == "cs'\\longa"
77 |     note.written_duration = abjad.Duration(6)
78 |     assert abjad.lilypond(note) == "cs'\\longa."
79 |     note.written_duration = abjad.Duration(7)
80 |     assert abjad.lilypond(note) == "cs'\\longa.."
81 |     note.written_duration = abjad.Duration(8)
82 |     assert abjad.lilypond(note) == "cs'\\maxima"
83 |     note.written_duration = abjad.Duration(12)
84 |     assert abjad.lilypond(note) == "cs'\\maxima."
85 |     note.written_duration = abjad.Duration(14)
86 |     assert abjad.lilypond(note) == "cs'\\maxima.."
87 |     note.written_duration = abjad.Duration(15)
88 |     assert abjad.lilypond(note) == "cs'\\maxima..."
89 | 
90 |     with pytest.raises(abjad.AssignabilityError):
91 |         abjad.Note(1, 16)
92 | 


--------------------------------------------------------------------------------
/tests/test_LogicalTie.py:
--------------------------------------------------------------------------------
 1 | import abjad
 2 | 
 3 | 
 4 | def test_LogicalTie_written_duration_01():
 5 |     staff = abjad.Staff("c' ~ c'16")
 6 | 
 7 |     assert abjad.get.logical_tie(staff[0]).written_duration == abjad.Duration(5, 16)
 8 | 
 9 | 
10 | def test_LogicalTie_written_duration_02():
11 |     staff = abjad.Staff("c'")
12 | 
13 |     assert abjad.get.logical_tie(staff[0]).written_duration == abjad.Duration(1, 4)
14 | 


--------------------------------------------------------------------------------
/tests/test_Meter.py:
--------------------------------------------------------------------------------
 1 | import abjad
 2 | 
 3 | 
 4 | def test_Meter___init___01():
 5 |     rtc = abjad.meter.make_best_guess_rtc((2, 4))
 6 |     assert abjad.Meter(rtc).rtm_format == "(2/4 (1/4 1/4))"
 7 | 
 8 | 
 9 | def test_Meter___init___02():
10 |     rtc = abjad.meter.make_best_guess_rtc((3, 4))
11 |     assert abjad.Meter(rtc).rtm_format == "(3/4 (1/4 1/4 1/4))"
12 | 
13 | 
14 | def test_Meter___init___03():
15 |     rtc = abjad.meter.make_best_guess_rtc((4, 4))
16 |     assert abjad.Meter(rtc).rtm_format == "(4/4 (1/4 1/4 1/4 1/4))"
17 | 
18 | 
19 | def test_Meter___init___04():
20 |     rtc = abjad.meter.make_best_guess_rtc((6, 8))
21 |     string = "(6/8 ((3/8 (1/8 1/8 1/8)) (3/8 (1/8 1/8 1/8))))"
22 |     assert abjad.Meter(rtc).rtm_format == string
23 | 
24 | 
25 | def test_Meter___init___05():
26 |     rtc = abjad.meter.make_best_guess_rtc((5, 8))
27 |     string = "(5/8 ((3/8 (1/8 1/8 1/8)) (2/8 (1/8 1/8))))"
28 |     assert abjad.Meter(rtc).rtm_format == string
29 | 
30 | 
31 | def test_Meter___init___06():
32 |     rtc = abjad.meter.make_best_guess_rtc((12, 4))
33 |     string = "(12/4 ((3/4 (1/4 1/4 1/4)) (3/4 (1/4 1/4 1/4))"
34 |     string += " (3/4 (1/4 1/4 1/4)) (3/4 (1/4 1/4 1/4))))"
35 |     abjad.Meter(rtc).rtm_format == string
36 | 
37 | 
38 | def test_Meter___init___07():
39 |     rtc = abjad.meter.make_best_guess_rtc((1, 4))
40 |     assert abjad.Meter(rtc).rtm_format == "(1/4 (1/4))"
41 | 
42 | 
43 | def test_Meter___init___08():
44 |     rtc = abjad.meter.make_best_guess_rtc((10, 4))
45 |     string = "(10/4 ((5/4 ((3/4 (1/4 1/4 1/4)) (2/4 (1/4 1/4))))"
46 |     string += " (5/4 ((3/4 (1/4 1/4 1/4)) (2/4 (1/4 1/4))))))"
47 |     assert abjad.Meter(rtc).rtm_format == string
48 | 
49 | 
50 | def test_Meter___init___09():
51 |     rtc = abjad.meter.make_best_guess_rtc((11, 4))
52 |     string = "(11/4 ((3/4 (1/4 1/4 1/4)) (2/4 (1/4 1/4)) (2/4 (1/4 1/4))"
53 |     string += " (2/4 (1/4 1/4)) (2/4 (1/4 1/4))))"
54 |     assert abjad.Meter(rtc).rtm_format == string
55 | 
56 | 
57 | def test_Meter___iter___01():
58 |     rtc = abjad.meter.make_best_guess_rtc((3, 8))
59 |     meter = abjad.Meter(rtc)
60 |     pairs = [pair for pair in meter]
61 |     assert pairs == [
62 |         ((0, 8), (1, 8)),
63 |         ((1, 8), (2, 8)),
64 |         ((2, 8), (3, 8)),
65 |         ((0, 8), (3, 8)),
66 |     ]
67 | 


--------------------------------------------------------------------------------
/tests/test_MultimeasureRest.py:
--------------------------------------------------------------------------------
 1 | import copy
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | def test_MultimeasureRest___copy___01():
 7 |     multi_measure_rest_1 = abjad.MultimeasureRest((1, 4))
 8 |     multi_measure_rest_2 = copy.copy(multi_measure_rest_1)
 9 | 
10 |     assert isinstance(multi_measure_rest_1, abjad.MultimeasureRest)
11 |     assert isinstance(multi_measure_rest_2, abjad.MultimeasureRest)
12 |     assert abjad.lilypond(multi_measure_rest_1) == abjad.lilypond(multi_measure_rest_2)
13 |     assert multi_measure_rest_1 is not multi_measure_rest_2
14 | 
15 | 
16 | def test_MultimeasureRest___init___01():
17 |     """
18 |     Initializes multimeasure rest from empty input.
19 |     """
20 | 
21 |     multimeasure_rest = abjad.MultimeasureRest()
22 | 
23 |     assert abjad.lilypond(multimeasure_rest) == abjad.string.normalize(
24 |         r"""
25 |         R4
26 |         """
27 |     )
28 | 
29 |     assert abjad.wf.wellformed(multimeasure_rest)
30 | 


--------------------------------------------------------------------------------
/tests/test_NamedPitch.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | values: list[tuple] = []
 6 | values.extend((x / 2, x / 2) for x in range(-48, 49))
 7 | values.extend(
 8 |     [
 9 |         ("bf,", -14),
10 |         ("c'", 0),
11 |         ("cs'", 1),
12 |         ("gff''", 17),
13 |         ("", 0),
14 |         ("dss,,", -32),
15 |         ("fake", ValueError),
16 |         (("bf", 2), -14),
17 |         (("c", 4), 0),
18 |         (("cs", 4), 1),
19 |         (("dss", 1), -32),
20 |         (("gff", 5), 17),
21 |         (abjad.NamedPitch("bs'"), 12),
22 |         (abjad.NamedPitch("c"), -12),
23 |         (abjad.NamedPitch("cf,"), -25),
24 |         (abjad.NamedPitch(), 0),
25 |         (abjad.NamedPitchClass("cs'"), 1),
26 |         (abjad.NamedPitchClass("c"), 0),
27 |         (abjad.NamedPitchClass("cf,"), -1),
28 |         (None, 0),
29 |         (abjad.NumberedPitch("bs'"), 12),
30 |         (abjad.NumberedPitch("c"), -12),
31 |         (abjad.NumberedPitch("cf,"), -25),
32 |         (abjad.NumberedPitch(), 0),
33 |         (abjad.NumberedPitchClass("bs'"), 0),
34 |         (abjad.NumberedPitchClass("c"), 0),
35 |         (abjad.NumberedPitchClass("cf,"), 11),
36 |     ]
37 | )
38 | 
39 | 
40 | @pytest.mark.parametrize("input_, expected_semitones", values)
41 | def test_init(input_, expected_semitones):
42 |     if isinstance(expected_semitones, type) and issubclass(
43 |         expected_semitones, Exception
44 |     ):
45 |         with pytest.raises(expected_semitones):
46 |             abjad.NamedPitch(input_)
47 |         return
48 |     instance = abjad.NamedPitch(input_)
49 |     assert float(instance) == expected_semitones
50 | 


--------------------------------------------------------------------------------
/tests/test_NamedPitchClass.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | values: list[tuple] = []
 6 | values.extend((x / 2, (x / 2) % 12) for x in range(-48, 49))
 7 | values.extend(
 8 |     [
 9 |         ("bf,", 10),
10 |         ("c'", 0),
11 |         ("cs'", 1),
12 |         ("gff''", 5),
13 |         ("", 0),
14 |         ("dss,,", 4),
15 |         ("fake", ValueError),
16 |         (("bf", 2), 10),
17 |         (("c", 4), 0),
18 |         (("cs", 4), 1),
19 |         (("dss", 1), 4),
20 |         (("gff", 5), 5),
21 |         (abjad.NamedPitch("bs'"), 0),
22 |         (abjad.NamedPitch("c"), 0),
23 |         (abjad.NamedPitch("cf,"), 11),
24 |         (abjad.NamedPitch(), 0),
25 |         (abjad.NamedPitchClass("cs'"), 1),
26 |         (abjad.NamedPitchClass("c"), 0),
27 |         (abjad.NamedPitchClass("cf,"), 11),
28 |         (None, 0),
29 |         (abjad.NumberedPitch("bs'"), 0),
30 |         (abjad.NumberedPitch("c"), 0),
31 |         (abjad.NumberedPitch("cf,"), 11),
32 |         (abjad.NumberedPitch(), 0),
33 |         (abjad.NumberedPitchClass("bs'"), 0),
34 |         (abjad.NumberedPitchClass("c"), 0),
35 |         (abjad.NumberedPitchClass("cf,"), 11),
36 |     ]
37 | )
38 | 
39 | 
40 | @pytest.mark.parametrize("input_, expected_semitones", values)
41 | def test_init(input_, expected_semitones):
42 |     if isinstance(expected_semitones, type) and issubclass(
43 |         expected_semitones, Exception
44 |     ):
45 |         with pytest.raises(expected_semitones):
46 |             abjad.NamedPitchClass(input_)
47 |         return
48 |     instance = abjad.NamedPitchClass(input_)
49 |     assert float(instance) == expected_semitones
50 | 


--------------------------------------------------------------------------------
/tests/test_NumberedPitch.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | values: list[tuple] = []
 6 | values.extend((x / 2, x / 2) for x in range(-48, 49))
 7 | values.extend(
 8 |     [
 9 |         ("bf,", -14),
10 |         ("c'", 0),
11 |         ("cs'", 1),
12 |         ("gff''", 17),
13 |         ("", 0),
14 |         ("dss,,", -32),
15 |         ("fake", ValueError),
16 |         (("bf", 2), -14),
17 |         (("c", 4), 0),
18 |         (("cs", 4), 1),
19 |         (("dss", 1), -32),
20 |         (("gff", 5), 17),
21 |         (abjad.NamedPitch("bs'"), 12),
22 |         (abjad.NamedPitch("c"), -12),
23 |         (abjad.NamedPitch("cf,"), -25),
24 |         (abjad.NamedPitch(), 0),
25 |         (abjad.NamedPitchClass("cs'"), 1),
26 |         (abjad.NamedPitchClass("c"), 0),
27 |         (abjad.NamedPitchClass("cf,"), 11),
28 |         (None, 0),
29 |         (abjad.NumberedPitch("bs'"), 12),
30 |         (abjad.NumberedPitch("c"), -12),
31 |         (abjad.NumberedPitch("cf,"), -25),
32 |         (abjad.NumberedPitch(), 0),
33 |         (abjad.NumberedPitchClass("bs'"), 0),
34 |         (abjad.NumberedPitchClass("c"), 0),
35 |         (abjad.NumberedPitchClass("cf,"), 11),
36 |     ]
37 | )
38 | 
39 | 
40 | @pytest.mark.parametrize("input_, expected_semitones", values)
41 | def test_init(input_, expected_semitones):
42 |     if isinstance(expected_semitones, type) and issubclass(
43 |         expected_semitones, Exception
44 |     ):
45 |         with pytest.raises(expected_semitones):
46 |             abjad.NumberedPitch(input_)
47 |         return
48 |     instance = abjad.NumberedPitch(input_)
49 |     assert float(instance) == expected_semitones
50 | 


--------------------------------------------------------------------------------
/tests/test_NumberedPitchClass.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | values: list[tuple] = []
 6 | values.extend((x / 2, (x / 2) % 12) for x in range(-48, 49))
 7 | values.extend(
 8 |     [
 9 |         ("bf,", 10),
10 |         ("c'", 0),
11 |         ("cs'", 1),
12 |         ("gff''", 5),
13 |         ("", 0),
14 |         ("dss,,", 4),
15 |         ("fake", ValueError),
16 |         (("bf", 2), 10),
17 |         (("c", 4), 0),
18 |         (("cs", 4), 1),
19 |         (("dss", 1), 4),
20 |         (("gff", 5), 5),
21 |         (abjad.NamedPitch("bs'"), 0),
22 |         (abjad.NamedPitch("c"), 0),
23 |         (abjad.NamedPitch("cf,"), 11),
24 |         (abjad.NamedPitch(), 0),
25 |         (abjad.NamedPitchClass("cs'"), 1),
26 |         (abjad.NamedPitchClass("c"), 0),
27 |         (abjad.NamedPitchClass("cf,"), 11),
28 |         (None, 0),
29 |         (abjad.NumberedPitch("bs'"), 0),
30 |         (abjad.NumberedPitch("c"), 0),
31 |         (abjad.NumberedPitch("cf,"), 11),
32 |         (abjad.NumberedPitch(), 0),
33 |         (abjad.NumberedPitchClass("bs'"), 0),
34 |         (abjad.NumberedPitchClass("c"), 0),
35 |         (abjad.NumberedPitchClass("cf,"), 11),
36 |     ]
37 | )
38 | 
39 | 
40 | @pytest.mark.parametrize("input_, expected_semitones", values)
41 | def test_init(input_, expected_semitones):
42 |     if isinstance(expected_semitones, type) and issubclass(
43 |         expected_semitones, Exception
44 |     ):
45 |         with pytest.raises(expected_semitones):
46 |             abjad.NumberedPitchClass(input_)
47 |         return
48 |     instance = abjad.NumberedPitchClass(input_)
49 |     assert float(instance) == expected_semitones
50 | 


--------------------------------------------------------------------------------
/tests/test_Octave.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | values = [
 6 |     (-1, -1),
 7 |     (-2, -2),
 8 |     (-3, -3),
 9 |     (-4, -4),
10 |     (0, 0),
11 |     (1, 1),
12 |     (2, 2),
13 |     (3, 3),
14 |     (4, 4),
15 |     (abjad.Octave(), 4),
16 |     (abjad.Octave(3), 3),
17 |     (abjad.Octave(5), 5),
18 | ]
19 | 
20 | 
21 | @pytest.mark.parametrize("input_, expected_number", values)
22 | def test_init(input_, expected_number):
23 |     if isinstance(expected_number, type) and issubclass(expected_number, Exception):
24 |         with pytest.raises(expected_number):
25 |             abjad.Octave(input_)
26 |         return
27 |     octave = abjad.Octave(input_)
28 |     assert octave.number == expected_number
29 | 
30 | 
31 | values = [
32 |     ("'", 4),
33 |     ("''", 5),
34 |     ("'''", 6),
35 |     ("''''", 7),
36 |     ("", 3),
37 |     (",", 2),
38 |     (",,", 1),
39 |     (",,,", 0),
40 | ]
41 | 
42 | 
43 | @pytest.mark.parametrize("input_, expected_number", values)
44 | def test_from_ticks(input_, expected_number):
45 |     if isinstance(expected_number, type) and issubclass(expected_number, Exception):
46 |         with pytest.raises(expected_number):
47 |             abjad.Octave.from_ticks(input_)
48 |         return
49 |     octave = abjad.Octave.from_ticks(input_)
50 |     assert octave.number == expected_number
51 | 
52 | 
53 | values = [
54 |     ("bf,", 2),
55 |     ("c'", 4),
56 |     ("cs'", 4),
57 |     ("gff''", 5),
58 |     ("dss,,", 1),
59 |     (("bf", 2), 2),
60 |     (("c", 4), 4),
61 |     (("cs", 4), 4),
62 |     (("dss", 1), 1),
63 |     (("gff", 5), 5),
64 |     (abjad.NamedPitch("bs'"), 4),
65 |     (abjad.NamedPitch("c"), 3),
66 |     (abjad.NamedPitch("cf,"), 2),
67 |     (abjad.NamedPitch(), 4),
68 |     (abjad.NamedPitchClass("cs'"), 4),
69 |     (abjad.NamedPitchClass("c"), 4),
70 |     (abjad.NamedPitchClass("cf,"), 4),
71 |     (abjad.NumberedPitch("bs'"), 5),
72 |     (abjad.NumberedPitch("c"), 3),
73 |     (abjad.NumberedPitch("cf,"), 1),
74 |     (abjad.NumberedPitch(), 4),
75 |     (abjad.NumberedPitchClass("bs'"), 4),
76 |     (abjad.NumberedPitchClass("c"), 4),
77 |     (abjad.NumberedPitchClass("cf,"), 4),
78 | ]
79 | 
80 | 
81 | @pytest.mark.parametrize("input_, expected_number", values)
82 | def test_init_from_pitch(input_, expected_number):
83 |     octave = abjad.NamedPitch(input_).octave
84 |     assert octave.number == expected_number
85 | 


--------------------------------------------------------------------------------
/tests/test_Tuplet.py:
--------------------------------------------------------------------------------
 1 | import copy
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | def test_Tuplet___copy___01():
 7 |     tuplet_1 = abjad.Tuplet((2, 3), "c'8 d'8 e'8")
 8 |     abjad.override(tuplet_1).NoteHead.color = "#red"
 9 | 
10 |     assert abjad.lilypond(tuplet_1) == abjad.string.normalize(
11 |         r"""
12 |         \override NoteHead.color = #red
13 |         \tuplet 3/2
14 |         {
15 |             c'8
16 |             d'8
17 |             e'8
18 |         }
19 |         \revert NoteHead.color
20 |         """
21 |     )
22 | 
23 |     tuplet_2 = copy.copy(tuplet_1)
24 | 
25 |     assert abjad.lilypond(tuplet_2) == abjad.string.normalize(
26 |         r"""
27 |         \override NoteHead.color = #red
28 |         \tuplet 3/2
29 |         {
30 |         }
31 |         \revert NoteHead.color
32 |         """
33 |     )
34 | 
35 |     assert not len(tuplet_2)
36 | 
37 | 
38 | def test_Tuplet___init___01():
39 |     """
40 |     Initializes tuplet from empty input.
41 |     """
42 | 
43 |     tuplet = abjad.Tuplet()
44 | 
45 |     assert abjad.lilypond(tuplet) == "\\tuplet 3/2\n{\n}"
46 |     assert tuplet.multiplier == (2, 3)
47 |     assert not len(tuplet)
48 | 
49 | 
50 | # TODO: move to test_get_timespan.py
51 | def test_Tuplet_get_timespan_01():
52 |     staff = abjad.Staff(r"c'4 d'4 \tuplet 3/2 { e'4 f'4 g'4 }")
53 |     leaves = abjad.select.leaves(staff)
54 |     score = abjad.Score([staff])
55 |     mark = abjad.MetronomeMark(abjad.Duration(1, 4), 60)
56 |     abjad.attach(mark, leaves[0])
57 | 
58 |     assert abjad.lilypond(score) == abjad.string.normalize(
59 |         r"""
60 |         \new Score
61 |         <<
62 |             \new Staff
63 |             {
64 |                 \tempo 4=60
65 |                 c'4
66 |                 d'4
67 |                 \tuplet 3/2
68 |                 {
69 |                     e'4
70 |                     f'4
71 |                     g'4
72 |                 }
73 |             }
74 |         >>
75 |         """
76 |     )
77 | 
78 |     assert abjad.get.timespan(staff, in_seconds=True) == abjad.Timespan(0, 4)
79 |     assert abjad.get.timespan(staff[0], in_seconds=True) == abjad.Timespan(0, 1)
80 |     assert abjad.get.timespan(staff[1], in_seconds=True) == abjad.Timespan(1, 2)
81 |     assert abjad.get.timespan(staff[-1], in_seconds=True) == abjad.Timespan(2, 4)
82 | 


--------------------------------------------------------------------------------
/tests/test_bind.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | def test_bind_01():
 7 |     """
 8 |     REGRESSION. Make sure no exceptions are raised when updating
 9 |     wrappers that have been orphaned because a context was removed.
10 |     In this example, the metronome mark finds the score context at
11 |     attachment time. After the score is removed, the metronome mark
12 |     must properly update its effective context to none.
13 |     """
14 | 
15 |     voice = abjad.Voice("c'4")
16 |     staff = abjad.Staff([voice])
17 |     score = abjad.Score([staff])
18 |     leaf = abjad.select.leaf(staff, 0)
19 |     mark = abjad.MetronomeMark(abjad.Duration(1, 4), 72)
20 |     abjad.attach(mark, leaf)
21 |     score[:] = []
22 |     string = abjad.lilypond(staff)
23 |     assert string == abjad.string.normalize(
24 |         r"""
25 |         \new Staff
26 |         {
27 |             \new Voice
28 |             {
29 |                 \tempo 4=72
30 |                 c'4
31 |             }
32 |         }
33 |         """
34 |     )
35 | 
36 | 
37 | def test_bind_02():
38 |     """
39 |     Make sure exception is raised when check_duplicate_indicator=True.
40 |     """
41 | 
42 |     score = abjad.Score(r"\new Staff { c'' d'' e'' f'' } \new Staff { c' d' e' f' }")
43 |     mark_1 = abjad.MetronomeMark(abjad.Duration(1, 8), 52)
44 |     mark_2 = abjad.MetronomeMark(abjad.Duration(1, 8), 73)
45 |     abjad.attach(mark_1, score[0][0])
46 | 
47 |     with pytest.raises(Exception):
48 |         abjad.attach(mark_2, score[1][0], check_duplicate_indicator=True)
49 | 


--------------------------------------------------------------------------------
/tests/test_dynamic.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | def test_dynamic_01():
 7 |     """
 8 |     Duplicate dynamics raise exception on attach.
 9 |     """
10 | 
11 |     voice = abjad.Voice("c'4")
12 |     dynamic_1 = abjad.Dynamic("p")
13 |     abjad.attach(dynamic_1, voice[0])
14 |     dynamic_2 = abjad.Dynamic("p")
15 |     with pytest.raises(Exception) as exception:
16 |         abjad.attach(dynamic_2, voice[0])
17 |     assert "attempting to attach conflicting indicator" in str(exception)
18 | 


--------------------------------------------------------------------------------
/tests/test_io.py:
--------------------------------------------------------------------------------
 1 | import platform
 2 | 
 3 | import pytest
 4 | 
 5 | import abjad
 6 | 
 7 | 
 8 | @pytest.mark.skipif(
 9 |     platform.python_implementation() != "CPython",
10 |     reason="Benchmarking is only for CPython.",
11 | )
12 | def test_io_count_function_calls_01():
13 |     result = abjad.io.count_function_calls("abjad.Note('c4')", global_context=globals())
14 |     assert result < 4000
15 | 
16 | 
17 | @pytest.mark.skipif(
18 |     platform.python_implementation() != "CPython",
19 |     reason="Benchmarking is only for CPython.",
20 | )
21 | def test_io_count_function_calls_02():
22 |     result = abjad.io.count_function_calls(
23 |         "abjad.Note(-12, (1, 4))", global_context=globals()
24 |     )
25 |     assert result < 400
26 | 
27 | 
28 | def test_io_spawn_subprocess_01():
29 |     assert abjad.io.spawn_subprocess('echo "hello world"') == 0
30 | 


--------------------------------------------------------------------------------
/tests/test_ly_environment.py:
--------------------------------------------------------------------------------
 1 | import abjad
 2 | 
 3 | 
 4 | def test_ly_environment_01():
 5 |     assert abjad.lyenv.contexts is not None
 6 |     print(abjad.lyenv.contexts)
 7 | 
 8 |     assert abjad.lyenv.current_module is not None
 9 |     print(abjad.lyenv.current_module)
10 | 
11 |     assert abjad.lyenv.engravers is not None
12 |     print(abjad.lyenv.engravers)
13 | 
14 |     assert abjad.lyenv.grob_interfaces is not None
15 |     print(abjad.lyenv.grob_interfaces)
16 | 
17 |     assert abjad.lyenv.interface_properties is not None
18 |     print(abjad.lyenv.interface_properties)
19 | 
20 |     assert abjad.lyenv.language_pitch_names is not None
21 |     print(abjad.lyenv.language_pitch_names)
22 | 
23 |     assert abjad.lyenv.markup_functions is not None
24 |     print(abjad.lyenv.markup_functions)
25 | 
26 |     assert abjad.lyenv.markup_list_functions is not None
27 |     print(abjad.lyenv.markup_list_functions)
28 | 
29 |     assert abjad.lyenv.music_glyphs is not None
30 |     print(abjad.lyenv.music_glyphs)
31 | 


--------------------------------------------------------------------------------
/tests/test_obgc.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | def test_obgc_01():
 7 |     """
 8 |     Raises exception when duration of on-beat grace container exceeds duration
 9 |     of anchor container.
10 |     """
11 | 
12 |     music_voice = abjad.Voice("c'4 d' e' f'", name="MusicVoice")
13 |     string = "g'8 a' b' c'' d'' c'' b' a' b' c'' d''"
14 |     with pytest.raises(Exception):
15 |         abjad.on_beat_grace_container(
16 |             string,
17 |             music_voice[1:2],
18 |             grace_leaf_duration=(1, 8),
19 |         )
20 | 


--------------------------------------------------------------------------------
/tests/test_overrides.py:
--------------------------------------------------------------------------------
 1 | import abjad
 2 | 
 3 | 
 4 | def test_Tuplet_grob_override_01():
 5 |     tuplet = abjad.Tuplet((2, 3), "c'8 d'8 e'8 f'8")
 6 |     abjad.override(tuplet).Glissando.thickness = 3
 7 |     abjad.makers.tweak_tuplet_bracket_edge_height(tuplet)
 8 | 
 9 |     assert abjad.lilypond(tuplet) == abjad.string.normalize(
10 |         r"""
11 |         \override Glissando.thickness = 3
12 |         \tweak edge-height #'(0.7 . 0)
13 |         \tuplet 3/2
14 |         {
15 |             c'8
16 |             d'8
17 |             e'8
18 |             f'8
19 |         }
20 |         \revert Glissando.thickness
21 |         """
22 |     )
23 | 
24 | 
25 | def test_Container_grob_override_01():
26 |     """
27 |     Noncontext containers bracket grob overrides at opening and closing.
28 |     """
29 | 
30 |     container = abjad.Container("c'8 d'8 e'8 f'8")
31 |     abjad.override(container).Glissando.thickness = 3
32 | 
33 |     assert abjad.lilypond(container) == abjad.string.normalize(
34 |         r"""
35 |         {
36 |             \override Glissando.thickness = 3
37 |             c'8
38 |             d'8
39 |             e'8
40 |             f'8
41 |             \revert Glissando.thickness
42 |         }
43 |         """
44 |     )
45 | 


--------------------------------------------------------------------------------
/tests/test_pcollections.py:
--------------------------------------------------------------------------------
 1 | import collections
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | def test_pcollections_sequence():
 7 |     """
 8 |     All pitch collections are registered as sequences.
 9 |     """
10 | 
11 |     for pcollection in (
12 |         abjad.PitchClassSegment([0, 1, 2]),
13 |         abjad.PitchClassSet([0, 1, 2]),
14 |         abjad.PitchSegment([0, 1, 2]),
15 |         abjad.PitchSet([0, 1, 2]),
16 |         abjad.TwelveToneRow([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]),
17 |     ):
18 |         assert isinstance(pcollection, collections.abc.Sequence)
19 | 


--------------------------------------------------------------------------------
/tests/test_persist.py:
--------------------------------------------------------------------------------
 1 | import os
 2 | 
 3 | import abjad
 4 | 
 5 | configuration = abjad.Configuration()
 6 | ly_path = configuration.abjad_directory / "test.ly"
 7 | pdf_path = configuration.abjad_directory / "test.pdf"
 8 | png_path = configuration.abjad_directory / "test.png"
 9 | png_preview_path = configuration.abjad_directory / "test.preview.png"
10 | paths = [ly_path, pdf_path, png_path, png_preview_path]
11 | 
12 | 
13 | def test_persist_as_ly_01():
14 |     """
15 |     Persists LilyPond file when no LilyPond file exists.
16 |     """
17 | 
18 |     note = abjad.Note("c'4")
19 |     with abjad.FilesystemState(remove=[ly_path]):
20 |         result = abjad.persist.as_ly(note, ly_path)
21 |         assert os.path.isfile(ly_path)
22 |         assert isinstance(result, tuple)
23 | 
24 | 
25 | def test_persist_as_ly_02():
26 |     """
27 |     Persists LilyPond file when LilyPond file already exists.
28 |     """
29 | 
30 |     note = abjad.Note("c'4")
31 |     with abjad.FilesystemState(remove=[ly_path]):
32 |         result = abjad.persist.as_ly(note, ly_path)
33 |         assert isinstance(result, tuple)
34 |         assert os.path.isfile(ly_path)
35 |         abjad.persist.as_ly(note, ly_path)
36 |         assert os.path.isfile(ly_path)
37 | 
38 | 
39 | def test_persist_as_pdf_01():
40 |     """
41 |     Persists PDF file when no PDF file exists.
42 |     """
43 | 
44 |     note = abjad.Note("c'4")
45 |     with abjad.FilesystemState(remove=paths):
46 |         result = abjad.persist.as_pdf(note, pdf_path)
47 |         assert os.path.isfile(pdf_path)
48 |         assert isinstance(result, tuple)
49 | 
50 | 
51 | def test_persist_as_pdf_02():
52 |     """
53 |     Persists PDF file when equivalent PDF file already exists.
54 |     """
55 | 
56 |     note = abjad.Note("c'4")
57 |     with abjad.FilesystemState(remove=paths):
58 |         result = abjad.persist.as_pdf(note, pdf_path)
59 |         assert os.path.isfile(pdf_path)
60 |         assert isinstance(result, tuple)
61 |         os.remove(ly_path)
62 |         abjad.persist.as_pdf(note, pdf_path)
63 |         assert os.path.isfile(pdf_path)
64 | 
65 | 
66 | def test_persist_as_png_01():
67 |     """
68 |     Persist PNG.
69 |     """
70 | 
71 |     note = abjad.Note("c'4")
72 |     with abjad.FilesystemState(remove=paths):
73 |         result = abjad.persist.as_png(note, png_path)
74 |         assert os.path.isfile(png_path)
75 |         assert isinstance(result, tuple)
76 |         os.remove(ly_path)
77 |         abjad.persist.as_png(note, png_path)
78 |         assert os.path.isfile(png_path)
79 | 
80 | 
81 | def test_persist_as_png_02():
82 |     """
83 |     Persist PNG with preview.
84 |     """
85 | 
86 |     note = abjad.Note("c'4")
87 |     with abjad.FilesystemState(remove=paths):
88 |         result = abjad.persist.as_png(note, png_path, preview=True)
89 |         assert os.path.isfile(png_path)
90 |         assert os.path.isfile(png_preview_path)
91 |         assert isinstance(result, tuple)
92 |         os.remove(ly_path)
93 |         abjad.persist.as_png(note, png_path, preview=True)
94 |         assert os.path.isfile(png_path)
95 |         assert os.path.isfile(png_preview_path)
96 | 


--------------------------------------------------------------------------------
/tests/test_score.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | 
 3 | import abjad
 4 | 
 5 | 
 6 | def test_score_01():
 7 |     """
 8 |     Slots constrain component attributes.
 9 |     """
10 | 
11 |     for component in (
12 |         abjad.MultimeasureRest((1, 4)),
13 |         abjad.Chord("<ef' cs' f''>4"),
14 |         abjad.Container(),
15 |         abjad.Context(),
16 |         abjad.Note("c'4"),
17 |         abjad.NoteHead("cs''"),
18 |         abjad.Rest((1, 4)),
19 |         abjad.Score(),
20 |         abjad.Skip((1, 4)),
21 |         abjad.Staff(),
22 |         abjad.Tuplet((2, 3), "c'8 d'8 e'8"),
23 |         abjad.Voice(),
24 |     ):
25 |         with pytest.raises(AttributeError):
26 |             component.foo = "bar"
27 | 


--------------------------------------------------------------------------------
/tests/test_setting.py:
--------------------------------------------------------------------------------
 1 | import abjad
 2 | 
 3 | 
 4 | def test_setting_01():
 5 |     r"""
 6 |     Works with score metronome mark interface.
 7 | 
 8 |     Does not include LilyPond \set command.
 9 |     """
10 | 
11 |     staff = abjad.Staff("c'8 d'8 e'8 f'8")
12 |     score = abjad.Score([staff])
13 |     abjad.setting(score).tempoWholesPerMinute = r"\musicLength 1*24"
14 | 
15 |     assert abjad.lilypond(score) == abjad.string.normalize(
16 |         r"""
17 |         \new Score
18 |         \with
19 |         {
20 |             tempoWholesPerMinute = \musicLength 1*24
21 |         }
22 |         <<
23 |             \new Staff
24 |             {
25 |                 c'8
26 |                 d'8
27 |                 e'8
28 |                 f'8
29 |             }
30 |         >>
31 |         """
32 |     )
33 | 
34 | 
35 | def test_setting_02():
36 |     r"""
37 |     Works with leaf metronome mark interface.
38 | 
39 |     Includes LilyPond \set command.
40 |     """
41 | 
42 |     staff = abjad.Staff("c'8 d'8 e'8 f'8")
43 |     score = abjad.Score([staff])
44 |     leaves = abjad.select.leaves(score)
45 |     abjad.setting(leaves[1]).Score.tempoWholesPerMinute = r"\musicLength 1*24"
46 | 
47 |     assert abjad.lilypond(score) == abjad.string.normalize(
48 |         r"""
49 |         \new Score
50 |         <<
51 |             \new Staff
52 |             {
53 |                 c'8
54 |                 \set Score.tempoWholesPerMinute = \musicLength 1*24
55 |                 d'8
56 |                 e'8
57 |                 f'8
58 |             }
59 |         >>
60 |         """
61 |     )
62 | 


--------------------------------------------------------------------------------