pctheory
pctheory is a Python library for using atonal music theory. Ordered and unordered collections use basic Python data structures like set and list. The library features extensive functionality, including operations (Tn, I, Mm, R, and rr) as well as general TTO and RO classes for standardized opreators, twelve-tone matrices, invariance matrices, rotational arrays, array operations, searches, subsets, microtonal support, generating eleven‐interval and all‐trichord rows, and much more.
pctheory is much more specialized than music21, and offers substantially more functionality in atonal theory. Additionally, it does not use music21 objects, so there is less computational overhead when using pctheory. It is not difficult to create music21 objects from pctheory objects, which allows pctheory to be used along with music21.
Installation
pctheory is a Python package and can be installed with the command pip install pctheory from the terminal on your computer (Command Prompt or PowerShell on Windows, Terminal on Linux or macOS). Note that you need Python 3.10 or newer. If you are running Windows, you can get Python by going to the Python website. If you are running macOS, you will need to install Python 3.x, and you can do that by following the instructions here. You need to have pip installed – if you are running Linux and need to install pip, you can find instructions here.
System Requirements
pctheory requires Python 3.0 or newer.
Documentation
Documentation can be found here.
Sample code
Sample code to help you get started with pctheory is available here.
Source code
Source code for pctheory can be found here.
Copyright and license
pctheory is copyright © 2022 by Jeffrey Martin. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. To view the GNU General Public License v.3.0, visit https://www.gnu.org/licenses/gpl-3.0.en.html.